# 08-工作流进度

> 全流程进度跟踪。CC 每完成一项产出就勾选一项。
> - **§ 一 Plan（A0~A6）**：`plan-start` 找第一个未勾 A 子项分发到对应 skill
> - **§ 二 Coding（模块）**：分发以 `docs/02-开发计划.md § 二 开发顺序清单` 为准；`coding-start` 按 docs/02 顺序扫描，对每个 REQ 所属模块查询本 § 二的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'`，找第一个未打里程碑模块分发。本 § 二 行序无语义，仅作模块元数据表

## 一、Plan 阶段（一次性）

- [ ] A0 项目初始化 — project-init
  - [ ] 依赖检查通过
  - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01-需求清单/index.md + docs/04-技术规范.md）
  - [ ] Git 已初始化

- [ ] A1 范围锁定 — scope-lock
  - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）
  - [ ] 技术栈已确认（docs/04 § 零）
  - [ ] 需求清单索引已填写（docs/01-需求清单/index.md）
  - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md，业务内容留待人工填写）

- [ ] A2 骨架生成 — skeleton-gen
  - [ ] 架构文档已生成（docs/04 § 一+、docs/06、docs/07、docs/09）
  - [ ] 工具脚本已生成（scripts/*.mjs、.env.local）
  - [ ] .gitignore 已配置

- [ ] A3 DB 设计 + REQ 回填 — db-design-gen
  - [ ] docs/03-数据库设计文档.md 已生成
  - [ ] docs/01 各 REQ 卡片"依赖表" + 模块头"涉及表" 已回填

- [ ] A4 DB 初始化 — db-init
  - [ ] sql/migrations/V1__initial_schema.sql 已生成
  - [ ] DDL 与 docs/03 全量一致
  - [ ] .env.local 凭据已验证（mysql -e "SELECT 1" OK）
  - [ ] setup-test-db.mjs 防护通过 + DROP+CREATE + apply V1 已执行
  - [ ] DDL ↔ docs/03 apply 后 5 维一致（validate-ddl.mjs）

- [ ] A5 下游文档生成 — downstream-gen
  - [ ] docs/02 开发计划已生成
  - [ ] docs/05 API 契约已生成
  - [ ] docs/06 § 三 页面清单已填入
  - [ ] docs/10 验收清单已生成
  - [ ] 下方模块列表已填入
  - [ ] REQ 卡片依赖接口已回填

- [ ] A6 前端范围锁定 — frontend-scope-lock
  - [ ] docs/06 项目级 UI 约定 + Design Tokens + 组件库已锁定
  - [ ] docs/04 § 二 前端栈已锁定（引用 docs/06）
  - [ ] 各 FE-NN 设计决策表已生成（docs/06 § 三之后 / docs/08 § 三）

## 二、Coding 阶段（后端模块循环）

（A5 填入后，每行一个后端模块。每个模块的 `里程碑:` 字段在 `—` 和 `milestone/<id>` 之间变化，完成由本地 `git tag -l` 判定。`coding-start` 每次按 docs/02 REQ 序扫每模块的里程碑 tag 决定派发。后端模块全部打里程碑后自动进入 § 三 前端阶段。）

<!-- 模块格式示例（由 A5 downstream-gen 追加；功能子项由 coding.mjs 的 review stage 在 approve 时勾选）：
- module_0 系统管理
  - 依赖: —
  - 路径: backend/module/sys/
  - 里程碑: —
  - 功能:
    - [ ] REQ-SYS-001 用户登录
    - [ ] REQ-SYS-002 用户注册
-->

## 三、Coding 阶段（前端整体）

（FE 业务功能清单在 Plan 期 A6 `frontend-scope-lock` 由 prototype/ + docs/01 + docs/05 推导后写入下方"功能:"项；Coding 阶段 `coding.mjs` 的 Router 把全部未完成 FE 聚合为单一 `frontend-phase` 阶段，排在所有后端模块之后。整个前端阶段 1 个里程碑 tag，分支 `frontend-phase`。）

- 整体里程碑: —
- 功能:
  <!-- AI 进入时按以下行格式写入（每行 1 个 FE，可关联多个 REQ / 多份原型）：
  - [ ] FE-NN 功能名 ｜ 关联 REQ：REQ-A, REQ-B ｜ 关联原型：prototype/<file>.html, prototype/<other>.html

  示例：
  - [ ] FE-01 用户登录与注册 ｜ 关联 REQ：REQ-SYS-001, REQ-SYS-002 ｜ 关联原型：prototype/auth.html
  - [ ] FE-02 仪表盘总览 ｜ 关联 REQ：REQ-DASH-001 ｜ 关联原型：prototype/dashboard.html
  -->