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.
24 lines
2.1 KiB
Markdown
24 lines
2.1 KiB
Markdown
# 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 与执行手册可用于核对，但不得替代正式结论。
|