tangweijie
53df134759
Constraint: Keep payment documentation in existing formal docs rather than creating a parallel guide.\nRejected: Treating biz_payment_record as verified production tables | Current evidence only supports target/prototype semantics.\nConfidence: high\nScope-risk: narrow\nDirective: Do not move payment fact ownership into REV004; REV004 should reference REV003/SYS009 payment facts only.\nTested: make validate-file on main touched docs; make check-ai-governance; git diff --check.\nNot-tested: Full export/render pipeline.
2.1 KiB
2.1 KiB
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*；业务支付事实目标层 biz_payment_record* |
退款/冲正必须联动原业务支付事实、渠道交易主状态、回调结果与异常处理状态；支付主域归 REV-003/SYS-009，REV-004 仅引用 |
| 处理结果回写 | REV-004 业务流程/关键规则 | writeBackStatus、resultStatus |
biz_charge 状态承接 |
resultStatus 与 writeBackStatus 必须分离表达 |
| 审批边界 | 审批留痕要求 | approvalRequired、PENDING_APPROVAL |
仅能力位，无独立审批表要求 | 一期不强接 BPM，仅保留边界说明 |
| 留痕与依据 | 操作日志与审批留痕 | remark、attachmentList |
biz_operat_log / biz_operat_log_detail |
必须覆盖处理类型、原交易引用、前后差异与附件依据 |
| 旧系统细粒度台账承接 | 迁移补充表 | 历史查询与迁移校验口径 | 历史只读 + 在线主模型 | 不误写为在线新增实体 |
3. 使用约束
- 本矩阵只服务于文档规划与后续正式主文档修订。
- 若某条追溯关系无法在三份正式文档中对齐，应先回写正式主文档，再继续 tasks 或实施讨论。
- Archive 与执行手册可用于核对，但不得替代正式结论。