Sync: add workflow registry and review notes
This commit is contained in:
44
wiki/concepts/Workflow-Registry.md
Normal file
44
wiki/concepts/Workflow-Registry.md
Normal file
@@ -0,0 +1,44 @@
|
||||
---
|
||||
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]](每个工作流状态的可见性)
|
||||
Reference in New Issue
Block a user