01 · PRD/用户流程

用户流程图

三个核心 User Flow。每个流程图带「人类侧动作」「系统侧反应」「关键决策点」三栏。Flow1 / Flow2 是 P0；Flow3 是 P4 才有。

Flow 1 · 启动新项目（US-01）

HUMAN SYSTEM DECISION ① 打开 Dashboard 点击「+ NEW PROJECT」 ② FeedbackModal 弹出 company_id 自动注入 ③ 输入需求 + 提交 "做个 TODO API" ④ POST /api/devloop/projects PM Agent 异步启动 ⑤ PM 写 prd.html v1 归档 history/prd-rev-001.html ⑥ Architect 写 sdd + units.json contract_hash 计算 ⑦ 是否有 conflict / data-question？ → 是：发 SSE conflict ✦ 否：进 L1 ⑧ Dashboard 跳到项目详情
耗时关键产物
0-2sHTTP 201 + project_id
5-30sprd.html v1
30-60ssdd.html v1 + units.json

Flow 2 · 增量反馈（US-02）

HUMAN SYSTEM DECISION ① 看到现状不满意 "还得加个 OAuth" ② 点 + NEW REQUIREMENT FeedbackModal 弹 ③ POST /requirement 入队，立即返 202 ④ PM 追加 PRD section data-rev=N+1 ⑤ 与历史矛盾？ 是：data-conflict ✦ 否：传给 Architect ⑥ Architect diff_units {added, changed, removed} ⑦ 仅 added/changed 入 L1 passed 且 hash 不变的不动
关键设计点：已 passed 且 contract_hash 不变的 Unit 不会被 reset。这是「增量」的本质。

Flow 3 · 集成失败 → 自愈（US-04）

SYSTEM AGENT DECISION ① L2 gate 打开 ② Integrator 起进程 ③ 集成失败 l2_rounds < 3? ④ BugTriager 归因 confidence ≥ 0.5? ⑤a SSE 求人 human_intervention_needed ⑤b Architect patch ⑥ Registry.reset ⑦ 回 L1 重跑 ⑧ shipped 或回 ②

状态可见性约定

三个 Flow 都对人类有可见性要求。Dashboard 必须在 5 秒内反应以下事件：

事件视觉反馈
新 Unit 进 codingDAG 节点变 emerald
Unit 进 testing节点变黄
Unit failed节点变红 + retry 数字
Unit passed节点深绿描边
L2 启动L2 状态卡变 amber pulse
SDD patchedSDD diff 面板高亮新 section
human_intervention_needed右上角 toast violet
shipped整页 confetti 5s（认真的）