2.2 KiB
2.2 KiB
Contract: REV-004 一期场景矩阵
1. 目的
用于统一 REV-004 一期各场景在输入依据、关键校验、结果表达和留痕要求上的差异，支撑后续 plan/tasks 拆解。
2. 场景矩阵
| 场景 | 主要输入 | 关键校验 | 结果表达 | 留痕重点 | 备注 |
|---|---|---|---|---|---|
| 水量调整 | chargeId、adjustUsage、reasonCode |
原抄表依据、账单状态可调 | resultStatus、writeBackStatus |
调整前后水量、依据附件 | 不新增跨周期水量独立表 |
| 金额调整 | chargeId、adjustAmount、reasonCode |
差异金额合法性、账单状态可调 | resultStatus、writeBackStatus |
调整前后金额、原因、经办人 | 可涉及重算口径 |
| 退款 | chargeId、adjustAmount、sourceTradeNo |
原交易存在、可退金额、幂等性 | resultStatus、approvalRequired、writeBackStatus |
原交易号、退款金额、处理结果 | 一期仅保留审批能力位 |
| 冲正 | chargeId、sourceTradeNo、reasonCode |
原交易状态、账单状态、可冲正性 | resultStatus、approvalRequired、writeBackStatus |
原交易号、状态变化、处理原因 | 不强接 BPM |
| 坏账申请 | chargeId、reasonCode、remark |
账龄、客户状态、业务条件 | resultStatus、approvalRequired、writeBackStatus |
申请原因、账单状态、审批边界 | 一期仅保留审批能力位与边界说明 |
3. 共性能力
所有场景共享以下能力：
- 统一入口：
IF-REV-007 - 统一账单承接：
biz_charge/biz_charge_detail - 统一原交易校验：
bk_transaction/bk_transaction_callback/bk_transaction_exception - 统一留痕：
biz_operat_log/biz_operat_log_detail - 统一结果表达：
resultStatus/writeBackStatus（前者表示处理结论，后者表示账单回写结论） - 审批边界：只保留
approvalRequired、PENDING_APPROVAL与边界说明，不展开完整 BPM 流程、节点、流转规则或审批回写实现细节
4. 排除说明
以下内容不在本矩阵覆盖范围内：
- 独立账务细表设计
- 发票、银行结算等其他接口族
- backend 实施代码结构
- 完整 BPM 审批流程定义