ProjectStateMachine

Project State Machine

每个项目由 project.json 驱动（权威状态，revision 递增，事件日志追加）。

阶段状态（status）

PROJECT_CREATED → REQUIREMENT_ANALYSIS → REQUIREMENT_CLARIFICATION
  → REQUIREMENT_APPROVED → PRODUCT_DESIGN → UX_DESIGN → ARCHITECTURE_DESIGN
  → TECH_DESIGN_APPROVED → IMPLEMENTATION_PLANNING → IMPLEMENTATION
  → INTEGRATION → QA → SECURITY_AUDIT → ACCEPTANCE → RELEASE → DELIVERED

运行状态（runStatus）

RUNNING | PAUSED | FAILED | RETRYING | BLOCKED | WAITING_APPROVAL | COMPLETED | CANCELLED

project.json 结构

{
  "id": "p-001",
  "title": "Todo SaaS",
  "status": "DELIVERED",
  "runStatus": "COMPLETED",
  "revision": 18,
  "events": [{ "ts": "…", "type": "requirement.approved", "actor": "…", "note": "…" }],
  "meta": { "stack": ["react", "fastapi", "postgres"] }
}

工具

• templates/scripts/state.mjs — 原子读写（校验合法状态、自动 revision+1、事件追加）
• scripts/pipeline-check.sh — 调度闸：PAUSED/BLOCKED/WAITING_APPROVAL 时拒绝派发
• scripts/impact.js — 任务 DAG 依赖闭包（需求变更影响分析）

事件词汇（示例）

project.created / requirement.approved / plan.created / architecture.gate.passed
implementation.started / implementation.completed / quality.failed / quality.passed
review.request-changes / build.deployed / user.pause / user.resume / release.delivered