5.8 KiB
5.8 KiB
财务一期 P0 实现证据矩阵
日期：2026-08-11
目标契约：openapi/finance-phase1-five-pages-v1.yaml、财务一期P0操作契约与验收用例.md
使用规则：本文件只记录验收证据，不反向修改目标契约；Controller 文件、编译成功或开发中间态均不能单独关闭门禁
1. 状态更新规则
每个分组只使用两种验收结论：
FAIL：后端直接行为测试、Admin 真实接口接入或 IAM 权限初始化任一未通过、未提供或不可复核。PASS：组内所有 operation 的后端正向/错误态/权限/客户隔离/幂等行为测试全部通过，Admin 已使用真实接口完成对应页面操作验收，并且所需权限码已进入 IAM 权限目录、初始化 SQL、统一 SQL且 IAM 测试通过。
代码文件出现、Controller 映射存在、能够编译、间接测试通过、模拟接口成功均只能写入“观察记录”，不能把 FAIL 改为 PASS。证据更新时必须记录提交或工作树快照、测试类、通过数量、Admin 用例和日期。
2. G1-G4 稳定验收表
| 分组 | 一期 P0 operation | 后端行为测试放行条件 | Admin 真实接入放行条件 | 当前可复核证据 | 结论 |
|---|---|---|---|---|---|
| G1 客户账户 | listDerivedCustomerAccounts、listDerivedCustomerAccountLedger |
派生金额、分页筛选、日期边界、停用客户历史、跨客户隔离、固定 DTO/追踪字段测试全部通过 | 客户账户列表、筛选、详情入口、流水筛选均调用真实接口；无钱包、充值、预收或余额写入口 | 后端 G1 专项 4/4、Admin G1 专项 15/15、Finance 专项 21/21 和 Admin typecheck 已通过；platform:finance:account:view 尚未进入 IAM 初始化、权限目录和统一 SQL，IAM 测试证据缺失 |
FAIL |
| G2 费用来源 | getFinanceFeeSource、reviewFinanceFeeSource、updateFeeSourceSettlementInclusion |
详情、PENDING 审核、非法状态、expectedVersion、占用冻结、完整幂等、跨客户隐藏和 CNY 条件全部通过 | 客户应收应付页详情、审核、参与/禁止结算使用真实接口；权限和服务端错误态可见，不存在假成功 | 后端 G2 专项 9/9 已通过；platform:finance:fee-source:view/review/settlement 尚未进入 IAM 初始化、权限目录和统一 SQL，IAM 测试证据缺失；Admin G2 真实接入验收尚待提供 |
FAIL |
| G3 客户对账单 | createReconciliationStatement、actionReconciliationStatement |
BY_CUTOFF/SELECTED、同客户来源、重复占用、提交/审核/出账/调整/作废/重开、revision、乐观锁和完整幂等全部通过 | 客户对账单生成及所有动作使用真实接口；出账冻结、调整历史和错误态在页面可核对 | 已观察到 Controller/Service/DTO 和同路径映射；审计时点编译失败，未发现直接行为测试或 Admin 真实接入验收 | FAIL |
| G4 结算与人工收付款 | createReceivableSettlement、createPayableSettlement、getSettlement、createSettlementPayment；并回归已实现 createReceiptWithAllocations |
AR/AP 生成唯一性、方向权限、详情/revision、部分付/付清、File fail-closed、跨客户/供应商、超额、CNY、完整幂等全部通过；收款 300 元分配 3 张 100 元账单通过 | 应收/应付结算页生成、详情、人工收款/付款、凭证和状态刷新均调用真实接口；客户只读脱敏与状态过滤通过 | 已观察到四个 Controller 映射和 DTO；审计时点所引用 Service 不存在且无直接行为测试；未提供 Admin 真实接入验收 | FAIL |
3. 单项证据登记
| P0 | operationId | 后端测试证据 | Admin 验收证据 | 最终状态 |
|---|---|---|---|---|
| P0-01 | listDerivedCustomerAccounts |
G1 后端 4/4、Finance 专项 21/21 通过 | G1 专项 15/15、typecheck 通过；IAM account:view 待初始化和测试 |
FAIL |
| P0-02 | listDerivedCustomerAccountLedger |
G1 后端 4/4、Finance 专项 21/21 通过 | G1 专项 15/15、typecheck 通过；IAM account:view 待初始化和测试 |
FAIL |
| P0-03 | getFinanceFeeSource |
G2 后端 9/9 通过 | Admin G2 待提供；IAM fee-source:view 待初始化和测试 |
FAIL |
| P0-04 | reviewFinanceFeeSource |
G2 后端 9/9 通过 | Admin G2 待提供；IAM fee-source:review 待初始化和测试 |
FAIL |
| P0-05 | updateFeeSourceSettlementInclusion |
G2 后端 9/9 通过 | Admin G2 待提供；IAM fee-source:settlement 待初始化和测试 |
FAIL |
| P0-06 | createReconciliationStatement |
待提供 | 待提供 | FAIL |
| P0-07 | actionReconciliationStatement |
待提供 | 待提供 | FAIL |
| P0-08 | createReceivableSettlement |
待提供 | 待提供 | FAIL |
| P0-09 | createPayableSettlement |
待提供 | 待提供 | FAIL |
| P0-10 | getSettlement |
待提供 | 待提供 | FAIL |
| P0-11 | createSettlementPayment |
待提供 | 待提供 | FAIL |
“待提供”不表示没有代码，只表示尚未形成满足本矩阵规则的可放行证据。目标 OpenAPI 不记录或追踪这些实现状态。
4. IAM 权限门禁
| 分组 | 权限码 | 当前状态 | 关闭证据 |
|---|---|---|---|
| G1 | platform:finance:account:view |
未进入 IAM 初始化，G1 保持 FAIL |
IAM 权限目录和初始化 SQL包含该权限；统一 SQL同步；IAM 权限初始化/查询/可分配测试通过 |
| G2 | platform:finance:fee-source:view |
未进入 IAM 初始化，G2 保持 FAIL |
同上 |
| G2 | platform:finance:fee-source:review |
未进入 IAM 初始化，G2 保持 FAIL |
同上 |
| G2 | platform:finance:fee-source:settlement |
未进入 IAM 初始化，G2 保持 FAIL |
同上 |
在 IAM 模块权限目录、IAM 初始化 SQL、统一 SQL和对应 IAM 测试证据全部完成前，不因 Finance/Admin 专项测试通过而更新 G1/G2 结论。主契约保持冻结，不写入本门禁的中间状态。