45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
---
|
||
title: "Workflow Registry"
|
||
type: concept
|
||
tags: [workflow, documentation, system-modeling]
|
||
last_updated: 2026-04-25
|
||
---
|
||
|
||
## Definition
|
||
工作流注册表——系统所有工作流的权威参考指南，以四个交叉索引视角组织，确保任何角色（工程师、运维、产品负责人、AI Agent）都能从任意角度快速查找所需工作流。
|
||
|
||
## Four Views（四视角）
|
||
|
||
### View 1: By Workflow（按工作流，主列表）
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| Workflow | 工作流名称 |
|
||
| Spec file | 规范文件名 |
|
||
| Status | Approved / Review / Draft / **Missing** / Deprecated |
|
||
| Trigger | 触发条件 |
|
||
| Primary actor | 主要执行者 |
|
||
| Last reviewed | 最近审查日期 |
|
||
|
||
> **Missing** = 代码中存在但无规范，红色警报，立即暴露。
|
||
|
||
### View 2: By Component（按组件）
|
||
每个代码组件映射到其参与的所有工作流。工程师查看任意文件时，可立即知道哪些工作流涉及该文件。
|
||
|
||
### View 3: By User Journey（按用户旅程）
|
||
每条用户旅程映射到其背后的底层工作流，含客户旅程/运营旅程/系统间旅程。
|
||
|
||
### View 4: By State（按状态）
|
||
每个实体状态映射到能转入或转出的工作流。
|
||
|
||
## Maintenance Rules
|
||
- 每发现或规范一个新工作流必须更新注册表（强制）
|
||
- Missing 状态的工作流视为红色警报，需在下一轮审查中处理
|
||
- 四个视角必须交叉引用一致
|
||
- Draft 升为 Approved 时必须同步更新注册表
|
||
- 永不删除行——使用 Deprecated 而非删除以保留历史
|
||
|
||
## Related
|
||
- [[Workflow-Tree-Spec]]（规范格式）
|
||
- [[Discovery-Audit]]（发现隐式工作流的方法）
|
||
- [[Observable-States]]（每个工作流状态的可见性）
|