PMFlow/EXECUTION_CHECKLIST_SSTC_V3.md

SSTC 看板执行清单 V3（前后端联动可见版）

更新时间：2026-02-25
适用范围：/projects/:id/board 的 SSTC 看板全链路改造（React + FastAPI）

当前基线（基于现有代码）

• 已有最小链路：信号 -> 宪章 -> 任务（frontend/src/components/sstc/SSTCChainView.tsx + backend/app/api/sstc.py）。
• 已有宪章详情页 + 任务创建：frontend/src/pages/CharterDetailPage.tsx。
• 缺口：frontend/src/components/sstc/SSTCGlobalHeader.tsx、SSTCStageNav.tsx、SSTCWorkspace.tsx、SSTCRiskFloatPanel.tsx 当前为空文件。
• 缺口：SSTC 仅有少量接口，缺少发布验证、复盘沉淀、链路健康聚合、阶段锁定校验。
• 缺口：缺少统一操作日志表（全链路追溯要求）。
• ⚠️ 待核实：@dnd-kit/core、@tiptap/* 不在 frontend/package.json，与方案约束不一致。

执行规则

• 每完成 1 步，将该步由 [ ] 改为 [x]。
• 所有接口统一返回：{ code, message, data }（仅 SSTC 新增/改造接口先落地）。
• 所有写操作记录：操作人、操作时间、变更摘要（写入 operation_logs）。
• 所有 AI 调用记录：输入/输出、token、成本（复用 ai_call_logs）。

P0 基础可运行（先打通框架）

• P0-1 建立 SSTC 统一数据契约

  • 后端实现：新增 backend/app/schemas/sstc.py；标准化 stage/status 枚举、DTO、响应结构。
  • 前端实现：更新 frontend/src/api/sstc.ts 类型定义，全部接口适配 data 字段。
  • 可见验收：项目看板可正常加载，不再依赖“隐式字段”。

• P0-2 建立 SSTC 聚合服务层

  • 后端实现：新增 backend/app/services/sstc_service.py，聚合项目头部指标、阶段状态、风险摘要。
  • 前端实现：新增 getBoardOverview(projectId) 调用。
  • 可见验收：看板顶部能显示统一概览数据。

• P0-3 填充 4 个空组件骨架

  • 前端实现：补全 SSTCGlobalHeader.tsx、SSTCStageNav.tsx、SSTCWorkspace.tsx、SSTCRiskFloatPanel.tsx 基础布局。
  • 后端实现：提供骨架所需最小接口（overview、stage health、risk summary）。
  • 可见验收：/projects/:id/board 出现四段式布局，不再只有单卡片链路。

• P0-4 阶段锁定规则后端校验

  • 后端实现：在任务创建/编辑、发布创建、复盘归档接口中增加上游状态校验（禁止前端绕过）。
  • 前端实现：灰态展示 + 按钮禁用 + 原因提示。
  • 可见验收：宪章未对齐时无法创建/确认任务。

P1 核心链路（第一优先级：导航 + 宪章 + 任务 + 执行）

• P1-1 模块1：项目全局信息栏

  • 后端实现：GET /projects/{id}/sstc/overview（基础信息、对齐度、进度、负载健康）。
  • 前端实现：SSTCGlobalHeader 渲染 5 区块；recharts 展示对齐度/进度/负载。
  • 可见验收：顶部 120px 信息栏完整显示指标和操作按钮。

• P1-2 模块2：六阶段链路导航栏

  • 后端实现：GET /projects/{id}/sstc/stages 返回 6 节点状态、风险点、可编辑性。
  • 前端实现：SSTCStageNav 横向 6 节点 + 箭头 + Badge + 红点 + 选中高亮。
  • 可见验收：点击节点切换工作区；未解锁节点只读。

• P1-3 模块3.2：需求宪章工作区

  • 后端实现：补齐宪章版本化、发起对齐、确认对齐、冲突查询与处理接口。
  • 前端实现：宪章编辑器（先 Textarea，后续可替换 Tiptap）、对齐状态卡、冲突卡、模型绑定卡。
  • 可见验收：可发起对齐；成员确认后状态从 对齐中 到 已对齐。

• P1-4 模块3.3：任务拆解工作区

  • 后端实现：AI 拆解任务接口、负责人推荐接口、负载优化接口、任务确认接口。
  • 前端实现：任务树表格（父子折叠）、右侧负载监控与拆解设置卡。
  • 可见验收：点击“AI 重新拆解任务”后生成任务，显示推荐负责人和匹配度。

• P1-5 模块3.4：执行落地工作区

  • 后端实现：任务状态迁移接口、风险预警聚合接口、阻塞处理接口。
  • 前端实现：Kanban 5 泳道、任务卡片详情弹窗、右侧风险栏。
  • 可见验收：拖拽任务卡更新状态并持久化。
  • ⚠️ 待核实：需先安装 @dnd-kit/core（当前未安装）。

P2 扩展链路（第二优先级：信号源 + 发布验证 + 复盘）

• P2-1 模块3.1：信号源工作区

  • 后端实现：信号列表筛选、归档、AI 影响评估、宪章关联接口。
  • 前端实现：左侧信号表格 + 右侧统计/AI/集成卡片。
  • 可见验收：可从信号直接跳转并创建宪章关联。

• P2-2 模块3.5：发布验证工作区

  • 后端实现：发布计划 CRUD、发布状态流转、验证清单生成与提交。
  • 前端实现：发布计划表 + 验证标签页 + 右侧 AI 辅助栏。
  • 可见验收：仅可选择“已完成任务”创建发布计划。

• P2-3 模块3.6：复盘沉淀工作区

  • 后端实现：复盘节点创建/版本/归档、改进项落地接口。
  • 前端实现：6 模块复盘编辑区 + 右侧知识沉淀/改进项/AI 卡片。
  • 可见验收：确认归档后链路锁定，进入只读状态。

P3 全局能力（第三优先级：预警 + 权限 + 可追溯）

• P3-1 模块4：风险/认知冲突悬浮栏

  • 后端实现：统一预警接口（高/中风险 + 未解决冲突）。
  • 前端实现：右下角悬浮窗（可最小化、角标、Tab 切换）。
  • 可见验收：新增高风险时角标数量实时变化。

• P3-2 操作日志全链路追溯

  • 后端实现：新增 operation_logs 模型、迁移、写入中间件/服务封装。
  • 前端实现：关键操作写 x-request-id，便于追踪。
  • 可见验收：任一状态变更可查到操作人/时间/变更前后。

• P3-3 角色权限闭环

  • 后端实现：项目负责人/成员/管理员权限矩阵校验。
  • 前端实现：按钮级权限渲染与禁用提示。
  • 可见验收：成员无法执行负责人专属操作。

• P3-4 AI 调用成本可观测

  • 后端实现：SSTC AI 接口统一落 ai_call_logs，补齐 token/cost 字段。
  • 前端实现：在 AI 操作结果区展示“本次 token 与成本”。
  • 可见验收：每次 AI 操作后可在日志中检索到调用记录。

联调与验收清单（发布前必须全勾）

• E2E-1 项目进入看板后，四大区块均可见且无空白组件。
• E2E-2 六阶段状态与锁定规则生效（前后端双校验）。
• E2E-3 宪章未对齐无法进入任务确认与执行编辑。
• E2E-4 任务拖拽状态迁移成功，刷新后状态保持。
• E2E-5 发布必须绑定已完成任务，复盘必须在发布验证后。
• E2E-6 全部 SSTC 新接口返回统一结构 {code,message,data}。
• E2E-7 关键写操作可在 operation_logs 检索。
• E2E-8 AI 操作可在 ai_call_logs 检索到 token/cost。

实施顺序建议（最短路径看到效果）

• 第 1 周：完成 P0 + P1-1 + P1-2（先把“看起来像完整看板”做出来）。
• 第 2 周：完成 P1-3 + P1-4 + P1-5（核心闭环可操作）。
• 第 3 周：完成 P2（补齐发布与复盘闭环）。
• 第 4 周：完成 P3 + E2E（治理与可追溯收口）。