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

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

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

- [x] 已有最小链路：`信号 -> 宪章 -> 任务`（`frontend/src/components/sstc/SSTCChainView.tsx` + `backend/app/api/sstc.py`）。
- [x] 已有宪章详情页 + 任务创建：`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 基础可运行（先打通框架）

- [x] **P0-1 建立 SSTC 统一数据契约**
  - 后端实现：新增 `backend/app/schemas/sstc.py`；标准化 stage/status 枚举、DTO、响应结构。
  - 前端实现：更新 `frontend/src/api/sstc.ts` 类型定义，全部接口适配 `data` 字段。
  - 可见验收：项目看板可正常加载，不再依赖“隐式字段”。

- [x] **P0-2 建立 SSTC 聚合服务层**
  - 后端实现：新增 `backend/app/services/sstc_service.py`，聚合项目头部指标、阶段状态、风险摘要。
  - 前端实现：新增 `getBoardOverview(projectId)` 调用。
  - 可见验收：看板顶部能显示统一概览数据。

- [x] **P0-3 填充 4 个空组件骨架**
  - 前端实现：补全 `SSTCGlobalHeader.tsx`、`SSTCStageNav.tsx`、`SSTCWorkspace.tsx`、`SSTCRiskFloatPanel.tsx` 基础布局。
  - 后端实现：提供骨架所需最小接口（overview、stage health、risk summary）。
  - 可见验收：`/projects/:id/board` 出现四段式布局，不再只有单卡片链路。

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

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

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

- [x] **P1-2 模块2：六阶段链路导航栏**
  - 后端实现：`GET /projects/{id}/sstc/stages` 返回 6 节点状态、风险点、可编辑性。
  - 前端实现：`SSTCStageNav` 横向 6 节点 + 箭头 + Badge + 红点 + 选中高亮。
  - 可见验收：点击节点切换工作区；未解锁节点只读。

- [x] **P1-3 模块3.2：需求宪章工作区**
  - 后端实现：补齐宪章版本化、发起对齐、确认对齐、冲突查询与处理接口。
  - 前端实现：宪章编辑器（先 Textarea，后续可替换 Tiptap）、对齐状态卡、冲突卡、模型绑定卡。
  - 可见验收：可发起对齐；成员确认后状态从 `对齐中` 到 `已对齐`。

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

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

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

- [x] **P2-1 模块3.1：信号源工作区**
  - 后端实现：信号列表筛选、归档、AI 影响评估、宪章关联接口。
  - 前端实现：左侧信号表格 + 右侧统计/AI/集成卡片。
  - 可见验收：可从信号直接跳转并创建宪章关联。

- [x] **P2-2 模块3.5：发布验证工作区**
  - 后端实现：发布计划 CRUD、发布状态流转、验证清单生成与提交。
  - 前端实现：发布计划表 + 验证标签页 + 右侧 AI 辅助栏。
  - 可见验收：仅可选择“已完成任务”创建发布计划。

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

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

- [x] **P3-1 模块4：风险/认知冲突悬浮栏**
  - 后端实现：统一预警接口（高/中风险 + 未解决冲突）。
  - 前端实现：右下角悬浮窗（可最小化、角标、Tab 切换）。
  - 可见验收：新增高风险时角标数量实时变化。

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

- [x] **P3-3 角色权限闭环**
  - 后端实现：项目负责人/成员/管理员权限矩阵校验。
  - 前端实现：按钮级权限渲染与禁用提示。
  - 可见验收：成员无法执行负责人专属操作。

- [x] **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（治理与可追溯收口）。