正文
获取原文件references/change-review.md
适用性与证据
结合原始需求、实际 diff、接口调用方和项目环境判定每项检查:APPLICABLE / NOT_APPLICABLE / UNKNOWN。适用项目给出 PASS / FAIL / INSUFFICIENT_EVIDENCE;不适用项目说明依据。没有某个标题、关键词或独立文档,不能证明该能力不涉及本次改动。
| 检查项目 | 触发条件 | 必需依据 | 可核查结果 |
|---|---|---|---|
| 需求与验收覆盖 | 所有本次范围内任务 | 原始要求、批准需求、AC、任务 | 全部承诺有任务和验收;范围决定可追溯 |
| 决策与分支行为 | 存在未决事项或条件分支 | 当前决策、状态转换和业务规则 | 关键分支有条件和结果;未知仅阻塞相关动作 |
| 字段传播 | 字段、查询、DTO 或响应变化 | 各层定义、映射和调用方 | 字段语义与结果贯穿实际使用路径 |
| 实现替换 | SDK、存储、实现类或协议迁移 | 现有能力清单、目标实现、兼容要求 | 全部适用方法和副作用具有验证 |
| 共享能力 | 权限、日志、字典、配置或共享组件变化 | 归属、实际使用位置、规则 | 使用方完整,重复实现与失效行为有依据 |
| 更新与身份连续性 | 编辑、关联、状态变化 | 稳定 ID、版本与关联规则 | 批准的身份和引用语义保持一致 |
| 验证与记录 | 编码任务交付 | 当前测试、开发记录、索引 | 断言符合需求,证据有效,任务记录可检索 |
字段传播表
| 业务字段 | 数据库/查询列 | ORM/Entity | DTO/序列化 | API Schema | 前端类型/页面 | 转换规则 | 断言与证据 |
|---|
逐项核对实际查询是否选择字段、空值与默认值、枚举、精度、时区和权限。字段名称可以通过明确映射转换;类型和语义必须满足批准接口。存在映射时验证转换及使用方,不按名称差异直接判错。
实现替换表
| 接口/方法 | 批准的现有行为 | 目标行为 | 空值/错误/权限 | 副作用与兼容要求 | 调用方 | 验证证据 |
|---|
从真实接口及调用位置建立检查分母,覆盖同步与异步行为、返回结构、异常、取消、重试、持久化和来源引用。保持身份的编辑、版本化更新等分别依照业务规则验证,不强制某个 ORM 方法适用于所有系统。保留实际缺口,不能用空实现或成功状态代替未完成方法。
状态与分支检查
| 业务对象与当前状态 | 事件及角色 | 条件与权限 | 下一状态 | 写入与外部动作 | 重复/取消/超时/失败语义 | 结果使用方 | AC 与证据 |
|---|
从批准业务规则、真实状态定义和调用路径共同确认覆盖范围,检查条件是否重叠、是否存在没有处理的合法输入、并发请求能否导致无效转换。存在异步动作时核对请求身份、对象版本和完成条件;设计审查验证规则完整性,交付审查核查实际运行结果,分别报告结论。
共享能力检查
| 能力 | 维护位置 | 实际调用方 | 配置及版本来源 | 身份与数据范围 | 失败行为 | 受影响验收 |
|---|
权限、字典、审计、日志、配置和共享组件按真实使用位置建立清单。核查各调用方是否采用共同规范,配置变化何时生效,缓存和异步结果何时失效。不同业务确实需要不同规则时保留明确范围,不为统一形式改变业务语义。评审结果将需要修复的位置、责任任务及回归范围交给 S007/S008/S009。
评审输出具体位置、触发条件、依据、影响和复验入口。修复和复验进入同一任务来源;完成声明同时检查 任务开发记录。