docs: 固化分阶段交付与评审流程

This commit is contained in:
que01 committed 2026-09-20 23:18:40 +08:00
1 parent b38e1d4bda
commit 292b398ed7
1 file changed
+52
+52
View File
@@ -158,3 +158,55 @@ docs/
- 相关验证已执行,或明确说明无法执行的原因。
- 变更符合第一版范围和数据/API 约束。
- 用户能根据结果继续下一步工作。
## Trellis 风格交付流程
后续功能按固定阶段推进。阶段之间必须有可检查的产物,不能把“代码能运行”直接当作需求完成。
### 1. 任务定义
- 用一句话写清用户问题、目标用户和期望结果;
- 写明本次包含内容和明确不包含内容;
- 确认是否属于个人品牌核心、配置包,或未来功能插件;
- 检查 PRD、ADR、数据模型和当前状态,记录冲突和假设。
产物:任务说明、范围边界、验收场景。
### 2. 方案边界
- 先定义领域对象、状态转换、权限边界和 API 契约;
- 涉及模板时,先定义声明、版本、安装快照、升级和回滚语义;
- 涉及数据时,先确定迁移兼容、旧数据默认值和恢复策略;
- 明确失败路径、空状态、重复提交和用户可见文案。
产物:必要时新增 ADR;否则在任务记录中写出数据、接口和 UI 方案。
### 3. 实现
- 先完成一个端到端的最小闭环;
- Controller、Service、DTO、API Client 和页面按既有边界分层;
- 任何新增 endpoint 必须同时新增授权测试和成功测试;
- 任何 schema 变更必须同时更新 migration、seed、运行时代码和测试;
- 不在实现过程中顺手扩大产品范围。
产物:可运行的代码、迁移和契约变更。
### 4. 验证
- API:未授权、错误角色、成功、业务校验失败和数据隔离;
- 数据:迁移可执行,旧数据可读,重复执行行为明确;
- UI:loading、empty、error、retry、success、mutation failure 和重复点击;
- 契约:API Client、DTO、响应 envelope 和页面调用一致;
- 运行匹配的 typecheck、integration tests、production build、format check。
产物:测试结果和剩余风险记录。
### 5. Code Review 收口
- 按用户场景重新走一遍,而不是只看 diff;
- 检查是否存在“已实现但未测试”的操作;
- 检查接口名称、产品文案和实际行为是否一致;
- 检查回滚、删除、升级等破坏性语义是否明确;
- 发现重复问题时,先更新本文件或 ADR,再开始下一项相关开发。
只有五个阶段都完成,且没有未解释的高风险项,才允许提交该里程碑。