---
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]]（每个工作流状态的可见性）