2.3 KiB
2.3 KiB
Contract: REV-004 功能缺失判定矩阵
1. 目标
本合同用于统一判定旧账务对象相对当前 backend 的承接成熟度,避免将“旧表缺失”直接误判为“功能缺失”。
2. 判定字段
| Field | Required | Description |
|---|---|---|
legacyObjectName |
Yes | 旧对象名称 |
legacyTable |
Yes | 旧表名 |
expectedCapability |
Yes | 旧对象期望承载的业务能力 |
currentVerdict |
Yes | implemented / partial / readonly / missing |
evidenceType |
Yes | controller / service / do / mapping-doc / none |
evidencePath |
Yes | 证据路径或文档路径 |
whyNotFullyImplemented |
No | 为什么不能判定为完全实现 |
recommendedHandling |
Yes | reuse / extend / readonly-retain / implement-later |
migrationImpact |
Yes | 对迁移的影响:低 / 中 / 高 |
notes |
No | 其他补充说明 |
3. 判定规则
implemented:当前 backend 已有稳定在线能力,且核心业务语义可被当前对象直接承接。partial:已有部分能力、控制器、服务或数据对象,但无法完整表达旧模型全部语义。readonly:不建议在线重建,只要求查询、比对和追溯能力。missing:当前未看到稳定承接能力或映射出口,后续需补设计或开发。
4. 使用约束
- 不允许仅凭“未看到同名表”判定为
missing。 - 必须优先核对统一场景入口、服务逻辑、日志承接和历史只读口径。
- 对于旧审批流相关对象,若当前只保留审批能力位,可优先判为
readonly或partial,而不是默认missing。
5. 示例
| legacyObjectName | currentVerdict | evidencePath | recommendedHandling | 说明 |
|---|---|---|---|---|
| 营业账 | implemented | ChargeDO.java / biz_charge |
reuse | 已有主对象承接 |
| 预存退款详情 | partial | ChargeServiceImpl.adjustAccounting + bk_transaction* |
extend | 退款语义已有,旧细明台账未一对一落地 |
| 账单-呆坏账详情 | partial | ChargeServiceImpl.adjustAccounting |
extend | 坏账申请语义已有,但旧细表未独立承接 |
| 特账明细 | missing | BACKEND_TABLE_MAPPING.md |
implement-later or readonly-retain | 当前未见稳定承接 |