docs: 固化分阶段交付与评审流程
This commit is contained in:
1 parent
b38e1d4bda
commit
292b398ed7
1 file changed
+52
@@ -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,再开始下一项相关开发。
|
||||
|
||||
只有五个阶段都完成,且没有未解释的高风险项,才允许提交该里程碑。
|
||||
Reference in new issue
Block a user