43 lines
4.4 KiB
Markdown
43 lines
4.4 KiB
Markdown
# 财务一期 P0 实现证据矩阵
|
||
|
||
> 日期：2026-08-11
|
||
> 目标契约：`openapi/finance-phase1-five-pages-v1.yaml`、`财务一期P0操作契约与验收用例.md`
|
||
> 使用规则：本文件只记录验收证据，不反向修改目标契约；Controller 文件、编译成功或开发中间态均不能单独关闭门禁
|
||
|
||
## 1. 状态更新规则
|
||
|
||
每个分组只使用两种验收结论：
|
||
|
||
- `FAIL`：后端直接行为测试或 Admin 真实接口接入任一未通过、未提供或不可复核。
|
||
- `PASS`：组内所有 operation 的后端正向/错误态/权限/客户隔离/幂等行为测试全部通过，并且 Admin 已使用真实接口完成对应页面操作验收。
|
||
|
||
代码文件出现、Controller 映射存在、能够编译、间接测试通过、模拟接口成功均只能写入“观察记录”，不能把 `FAIL` 改为 `PASS`。证据更新时必须记录提交或工作树快照、测试类、通过数量、Admin 用例和日期。
|
||
|
||
## 2. G1-G4 稳定验收表
|
||
|
||
| 分组 | 一期 P0 operation | 后端行为测试放行条件 | Admin 真实接入放行条件 | 当前可复核证据 | 结论 |
|
||
|---|---|---|---|---|---|
|
||
| G1 客户账户 | `listDerivedCustomerAccounts`、`listDerivedCustomerAccountLedger` | 派生金额、分页筛选、日期边界、停用客户历史、跨客户隔离、固定 DTO/追踪字段测试全部通过 | 客户账户列表、筛选、详情入口、流水筛选均调用真实接口；无钱包、充值、预收或余额写入口 | 已观察到同路径 Controller/Service/DTO；所在测试集当前 5 run、1 failure、1 error，不能作为通过证据；未提供 Admin 真实接入验收 | `FAIL` |
|
||
| G2 费用来源 | `getFinanceFeeSource`、`reviewFinanceFeeSource`、`updateFeeSourceSettlementInclusion` | 详情、PENDING 审核、非法状态、expectedVersion、占用冻结、完整幂等、跨客户隐藏和 CNY 条件全部通过 | 客户应收应付页详情、审核、参与/禁止结算使用真实接口；权限和服务端错误态可见，不存在假成功 | 已观察到同路径 Controller/Service/DTO；`FinancePhase1OperationBehaviorTest` 当前 5 run、1 failure、1 error，不能作为通过证据；未提供 Admin 真实接入验收 | `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` | 待提供 | 待提供 | `FAIL` |
|
||
| P0-02 | `listDerivedCustomerAccountLedger` | 待提供 | 待提供 | `FAIL` |
|
||
| P0-03 | `getFinanceFeeSource` | 待提供 | 待提供 | `FAIL` |
|
||
| P0-04 | `reviewFinanceFeeSource` | 待提供 | 待提供 | `FAIL` |
|
||
| P0-05 | `updateFeeSourceSettlementInclusion` | 待提供 | 待提供 | `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 不记录或追踪这些实现状态。
|
||
|