fujian_water_biz_doc/specs/001-rev004-accounting/contracts/rev004-traceability-matrix.md

Contract: REV-004 一期追溯矩阵

1. 目的

用于建立 spec.md、详细设计、接口设计、数据库设计之间的稳定追溯关系，确保后续正式文档修订与任务拆解基于同一口径。

2. 追溯矩阵

规格需求/场景	详细设计承接	接口设计承接	数据库承接	说明
一期纳入范围：水量调整/金额调整/退款/冲正/坏账申请	12_REV_Detailed.md REV-004 场景表	03_Interface_Design.md IF-REV-007	biz_charge*、biz_operat_log*	五类场景统一纳入一期，排除独立账务细表扩围
统一接口入口	REV-004 接口映射	IF-REV-007 请求/响应定义	账单与日志对象	不扩展到 IF-REV-008、IF-REV-011 等其他接口族
原交易校验	REV-004 关键规则	sourceTradeNo 字段	bk_transaction*	退款/冲正必须联动原交易主状态、回调结果与异常处理状态
处理结果回写	REV-004 业务流程/关键规则	writeBackStatus、resultStatus	biz_charge 状态承接	resultStatus 与 writeBackStatus 必须分离表达
审批边界	审批留痕要求	approvalRequired、PENDING_APPROVAL	仅能力位，无独立审批表要求	一期不强接 BPM，仅保留边界说明
留痕与依据	操作日志与审批留痕	remark、attachmentList	biz_operat_log / biz_operat_log_detail	必须覆盖处理类型、原交易引用、前后差异与附件依据
旧系统细粒度台账承接	迁移补充表	历史查询与迁移校验口径	历史只读 + 在线主模型	不误写为在线新增实体

3. 使用约束

• 本矩阵只服务于文档规划与后续正式主文档修订。
• 若某条追溯关系无法在三份正式文档中对齐，应先回写正式主文档，再继续 tasks 或实施讨论。
• Archive 与执行手册可用于核对，但不得替代正式结论。