This commit is contained in:
2026-08-11 18:43:53 +08:00
parent 60d2f8e097
commit 4521cb5218
8 changed files with 80 additions and 56 deletions
@@ -1,12 +1,12 @@
# 财务一期五页产品与接口验收契约
> 日期:2026-08-11
> 状态:产品范围已确认;Finance 来源链与部分五页查询契约已实现并验证;当前 11 个 `NOT_IMPLEMENTED` operation 全部为一期 P0 阻断,禁止排到后续
> 状态:产品范围已确认;一期 11 个 P0 operation 的目标契约已冻结;实现与 Admin 接入只按独立 G1-G4 证据矩阵验收,当前未放行
> 领导验收范围:客户账户、客户应收应付、客户对账单、结算单应收、结算单应付
> 原型依据:`docs/悦/货代SAAS平台后台/货代SaaS平台原型.html`
> 目标 OpenAPI:`openapi/finance-phase1-five-pages-v1.yaml`;当前人工接口继续参考 `openapi/finance-f1-manual-v1.yaml`。
> 11 个 P0 操作的 DTO、状态机、权限、幂等、错误码、隔离和验收用例以 `财务一期P0操作契约与验收用例.md` 为准。
> 11 个 P0 操作的 DTO、状态机、权限、幂等、错误码、隔离和验收用例以 `财务一期P0操作契约与验收用例.md` 为准;实现证据只维护在 `财务一期P0实现证据矩阵.md`。
## 1. 一期范围结论
@@ -63,7 +63,7 @@
| 结算单应收 | 后端已新增 `/receivable-settlements` 固定读 DTO 路径;`fin_bill + fin_receipt` 已有人工状态能力 | 关联审核通过的客户对账单,按原型结构形成应收结算页 | IN_PROGRESS/P0 适配 |
| 结算单应付 | 后端已新增 `/payable-settlements` 固定读 DTO 路径并读取人工成本;付款单和完整供应商来源池仍缺失 | 从真实 PAYABLE 来源生成,审核后人工登记付款与凭证 | IN_PROGRESS/P0 |
Finance 来源写入不再是阻断:内部事件入口、Inbox 幂等、Firstleg 入库/柜子快照、`fin_fee_source` 新版本写入/替代/作废、`PUBLISHED + amount>0` 入池校验、部分五页固定 DTO、完整幂等、File fail-closed、Client 脱敏和稳定错误码均已实现并通过测试。当前 11 个目标 operation 是一期 P0,不是可延期的“剩余优化”;此外还需完成 Admin 五页接入和测试环境跨服务冒烟。
Finance 来源写入不再是阻断:内部事件入口、Inbox 幂等、Firstleg 入库/柜子快照、`fin_fee_source` 新版本写入/替代/作废、`PUBLISHED + amount>0` 入池校验、部分五页固定 DTO、完整幂等、File fail-closed、Client 脱敏和稳定错误码均已实现并通过测试。11 个 P0 operation 不在本契约记录开发中间态;是否放行只看 G1-G4 后端行为测试与 Admin 真实接入证据。
## 4. 费用来源到结算全链路