实施管理
交付与验收规则
从需求与 API 到真实联调的统一交付标准
单个步骤的交付流程
需求与范围 → 设计/接口草案 → 原型或协议回放 → 实现 → 真实联调与恢复 → 发布交接。可按小切片迭代；一份源码、截图或规范不能同时证明所有阶段完成。
| 阶段 | 必须交付 | 退出条件 |
|---|---|---|
| 需求 | 用户/调用方、操作、范围、规则、待定项 | 能写出可检查的验收场景 |
| 设计 | 页面或数据/状态关系、权限和 API 映射 | 关键状态与数据 Owner 明确 |
| 原型/回放 | 正常、空态、拒绝、失败、网络未知和恢复场景 | UI 可走查；服务请求/响应可解释；模拟部分标识 |
| 接口与实现 | 固定源码、精确规范、代码、迁移和适当测试 | 实际行为符合对应接口与不变量 |
| 联调/恢复 | 真实身份、接口、数据、结果及故障证据 | 重复、断流、超时未知、重启等结果可核对 |
| 发布 | 固定制品、配置、备份、容量及回退交接 | 目标环境验证和操作责任明确 |
API 级交付
后台需求关联接口需求 ID，每项明确方法/路径、Owner、鉴权、Path/Query/Header/Body、响应和错误、单位/分页、状态变化、幂等与恢复，以及验收样例。复用 new-api 的接口也必须核对实际 controller/middleware，Schema 缺失和上游占位分别记录。
保留、适配与新增按源码复用规则记录。新增内部协作或商业差异使用提案 ID，未实现不标为已支持；接口规范同步进入 Contracts，字段不在多个计划页各写一份。
产品和服务的完成证据
产品页面每个操作对应 CA 或产品需求 ID，再对应 API；覆盖加载、空态、无权限、业务失败、网络未知、成功回读。静态页面或组件库按内容/资源验收，不强行新增后台。
服务验收覆盖实际身份、隔离、数据一致性、重复请求、审计与故障恢复；容量报告列环境、负载、时延、错误、资源和账务核对，不能用语言/框架作为并发保证。
文档与交接
文档变更检查正文、链接、导航、历史隔离与构建；目录变更还需核对旧链接、搜索和实际预览。业务测试按所改行为选择，不要求纯文档整理重跑全套业务集成。
交接记录文件位置、版本或未提交摘要、运行方式、测试结果、限制与下一动作。实时记录留工作台和项目进度，主计划保持稳定步骤。源码已有、迁入实现、本机运行、真实联调、生产发布分别记录；GitHub 按需要用于代码审查与备份，不设为本机执行前置。