1.提案与范围
1.1背景与问题
| 主题 | 内容 | 依据 |
|---|---|---|
| 现状 | 待 analyze | 用户输入 / 项目审核稿 / 代码勘察 |
| 问题 | 待 analyze：具体痛点、缺口、失败场景 | 用户输入 |
| 触发原因 | 待 analyze：为什么现在需要做 | 用户输入 |
1.2目标与非目标
| 类型 | 契约内容 | 成功/排除判定 |
|---|---|---|
| 目标 | 待 analyze | 可由 AC 证明 |
| 非目标 | 待 analyze | 后续不得在 plan/exec 中扩大 |
1.3范围契约
| ID | 范围内 | 可交付结果 | 对应 AC |
|---|---|---|---|
| S1 | 待 analyze | 待 analyze | AC1 |
| ID | 范围外 | 排除原因 | 若要纳入需更新 |
|---|---|---|---|
| O1 | 待 analyze | 防止范围扩大 | §1.5、§5、§6 |
1.4术语与角色
| 名称 | 类型 | 定义 | 相关模块/入口 |
|---|---|---|---|
| 待 analyze | 术语/角色/系统 | 待 analyze | 待 analyze |
1.5范围变更
| 时间 | 变更 | 原因 | 影响章节 | 确认人 |
|---|---|---|---|---|
| — | ||||
2.需求契约
2.1功能需求
| ID | 需求 | 优先级 | 来源 | 对应 AC |
|---|---|---|---|---|
| R1 | 待 analyze | Must | 用户输入 | AC1 |
2.2用户场景
| ID | 角色 | 触发条件 | 操作路径 | 期望结果 |
|---|---|---|---|---|
| US1 | 待 analyze | 待 analyze | 待 analyze | 待 analyze |
2.3验收标准
| ID | 标准（可证伪） | 验证方式 | 关联需求 | 结果 |
|---|---|---|---|---|
| AC1 | analyze 自用户输入 | 人工 | R1 | 未测 |
2.4业务规则与不变量
| ID | 规则/不变量 | 违反后影响 | 验证方式 |
|---|---|---|---|
| BR1 | 待 analyze / plan | 待分析 | 人工 / 自动 |
2.5权限、数据与边界
| 主题 | 契约 | 涉及数据/权限 | 边界处理 |
|---|---|---|---|
| 数据/权限/隐私 | 待 analyze / plan | 待分析 | 待分析 |
3.架构设计
3.1方案概述
| 维度 | 设计契约 | 依据 |
|---|---|---|
| 方案 | 待 plan | 项目上下文 / 需求契约 |
| 取舍 | 待 plan | 技术决策 |
3.2架构与组件
| 组件/模块 | 职责 | 输入 | 输出 | 依赖 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
3.3接口与数据契约
| 契约 ID | 类型 | 请求/输入 | 响应/输出 | 兼容性 |
|---|---|---|---|---|
| C1 | API / 数据 / 事件 / 文件 | 待 plan | 待 plan | 待 plan |
3.4错误处理与降级
| 场景 | 错误/边界 | 处理策略 | 用户可见结果 | 验证方式 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
3.5技术决策
| ID | 决策 | 选择 | 理由 | 替代方案 | 锁定阶段 |
|---|---|---|---|---|---|
| D1 | 待 analyze / plan | 待 plan | 待 plan | 待 plan | plan |
4.关键业务流程
4.1主流程图
flowchart TD A[触发入口] --> B[校验输入] B --> C[执行业务规则] C --> D[写入/返回结果]
| 步骤 | 输入 | 处理 | 输出 | 对应需求 |
|---|---|---|---|---|
| F1 | 待 plan | 待 plan | 待 plan | R1 |
4.2状态与数据流
stateDiagram-v2 [*] --> Draft Draft --> Validated Validated --> Completed Validated --> Failed
| 状态/数据 | 来源 | 转换规则 | 落点 | 一致性要求 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
4.3异常流程
| 异常 | 触发条件 | 系统处理 | 用户提示 | 验证方式 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
5.变更范围
5.1代码改动点
| 路径/模块 | 动作 | 变更说明 | 原因 | 关联任务 |
|---|---|---|---|---|
| 待 plan | add/modify/delete | 待 plan | 待 plan | T1 |
5.2数据、配置与迁移
| 对象 | 变更 | 兼容策略 | 迁移/回填 | 回滚 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
5.3兼容性与影响面
| 影响对象 | 影响说明 | 兼容策略 | 验证方式 | 负责人 |
|---|---|---|---|---|
| API / 数据 / UI / 权限 / 性能 / 文档 | 待 plan | 待 plan | 待 plan | — |
5.4风险与回滚
| 风险 | 概率/影响 | 监测信号 | 缓解措施 | 回滚方案 |
|---|---|---|---|---|
| 待 plan | 待 plan | 待 plan | 待 plan | 待 plan |
6.任务拆解
6.1任务列表
| ID | 任务 | 依赖 | 涉及文件 | 关联 AC | 状态 | 完成时间 |
|---|---|---|---|---|---|---|
| T1 | 待 plan | — | 待 plan | AC1 | pending | — |
6.2执行顺序
T1 -> T2 -> T3
6.3任务契约
| 任务 | 前置条件 | 产出 | 不得做 | 验证 |
|---|---|---|---|---|
| T1 | 待 plan | 待 plan | 不扩大范围 | AC1 |
7.执行与验收
7.1执行摘要
| 任务 | 摘要 | 涉及文件 | 偏差/备注 |
|---|---|---|---|
| exec 后填写 | |||
7.2自测缺陷
| 编号 | 现象 | 关联任务 | 状态 | 处理说明 |
|---|---|---|---|---|
| — | ||||
7.3验证记录
| 时间 | AC | 方法/命令 | 结果 | 证据 |
|---|---|---|---|---|
| verify 后填写；测试由人工执行，见 .fw/config.json | ||||
7.4验收结论
未验收
| 结论 | 阻塞项 | 后续动作 | 确认人 |
|---|---|---|---|
| 未验收 | — | 待 verify | 人工 |