This commit is contained in:
2026-08-11 09:25:45 +08:00
parent 87a17e6694
commit f5a0c81286
9 changed files with 482 additions and 66 deletions
@@ -7,19 +7,19 @@
## 一、总控结论
Finance 的服务拆分、独立数据库、服务内部模块边界和 Firstleg 协作方式已经技术确认,可以继续做详细设计和契约测试准备。
Finance 的服务拆分、独立数据库、服务内部模块边界和 Firstleg 协作方式已经技术确认,可以继续做详细设计和契约测试准备。
当前不能直接进入全量业务开发的原因,是产品确认表仍有业务决策待填写,尤其是财务主体/账套、期间、来源入池、账单确认、收款核销、历史迁移和 F1 收入口径。未确认部分只能使用可逆的草案模型,不能生成生产数据或把建议默认值当成正式口径。
F0 的平台主体、首期仅 RMB/CNY、自定义账期、编号、费用冻结、无历史迁移、客户角色和首期简化审批已经确认。当前采用人工简化方案:账单、收款、成本均由平台财务填写表单并上传凭证;客户账户、发票、供应商在线应付、银行接口、复杂审批和月结首期不做。原表状态已归一为 25 项已确认、7 项暂缓。详见[产品确认版差异与剩余待确认](财务管理产品确认版差异与剩余待确认.md)。
## 二、文档交付状态
| 材料 | 状态 | 作用 |
|---|---|---|
| 财务服务边界设计 | 已完成 | 确认 `finance-service`、`baiyue_finance`、9203 预留和部署改造清单 |
| 财务管理产品确认表/XLSX | 待产品填写 | 仅保留需要业务确认的 26 项;技术结论单独列示 |
| 财务管理产品确认表/XLSX | 部分已确认 | 会议继续填写剩余业务项;技术结论单独列示 |
| 财务领域模型与数据字典 | 草案完成 | F0/F1 模型、表和约束;未确认口径显式标记 |
| Firstleg-Finance 跨服务契约 | 草案完成 | 事件、快照查询、幂等、重试、权限和契约测试 |
| 财务历史迁移与上线验收方案 | 草案完成 | 历史费用迁移、防重复、灰度和 F0/F1 验收 |
| 财务历史迁移与上线验收方案 | 首发不启用历史迁移 | 保留未来补迁参考;首发使用其中 F0/F1 灰度和验收部分 |
## 三、分阶段开工门禁
@@ -48,9 +48,9 @@ G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、
进入 F1 前必须满足:
- 账单聚合维度和账期计算规则冻结;
- 账单确认、争议、重开和关闭状态冻结;
- 应收生成节点、到期日、收款登记和多对多核销规则冻结;
- 账单聚合维度(首期固定 RMB/CNY)和账期计算规则冻结;
- 平台出账、关闭、重开和线下异议录入状态冻结;客户首期只读;
- 应收生成节点、人工收款表单字段、凭证关联和到期日冻结;首期不实现复杂多对多核销模型;
- 预收、多收、手续费、退款、反核销的处理方式冻结;
- 至少准备一组真实或脱敏费用来源样本,能够完成费用→账单→应收→收款→核销回归。
@@ -68,10 +68,10 @@ G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、
| F0-T04 | 来源池与事件消费 | Inbox、来源池、快照、事件结果查询 | 契约冻结 | 重复/乱序/重试/冲突均有可验收结果 |
| F0-T05 | 财务权限与审计 | 权限码、客户范围、操作审计和高风险操作保护 | G1-3 | 越权和反核销等操作被服务端拒绝并留痕 |
| F1-T01 | 应收费用池 | 跨入库单筛选、排除原因、来源版本锁定 | F0-T04 | 一条有效来源只能进入一张有效账单 |
| F1-T02 | 客户对账单 | 生成、复核、发送、确认、争议、重开、关闭 | 产品 F1 | 状态迁移和版本并发校验完整 |
| F1-T02 | 客户对账单 | 生成、复核、发送、关闭、平台重开/调整、线下异议录入 | 产品 F1 | 状态迁移和版本并发校验完整 |
| F1-T03 | 应收单 | 应收金额、已核销额、余额、到期/逾期 | F1-T02 | 账单与应收金额可追溯且不可覆盖历史 |
| F1-T04 | 收款与核销 | 收款登记、多对多核销、反核销 | 产品 F1 | 禁止跨币种、超额和重复核销 |
| F1-T05 | 客户侧账单 | 客户查看、确认/争议、余额和收款记录 | F1-T02/F1-T04 | 客户不可见内部备注、供应商成本和内部附件 |
| F1-T05 | 客户侧账单 | 客户只读查看、余额和收款记录 | F1-T02/F1-T04 | 客户不可见内部备注、供应商成本和内部附件 |
| F1-T06 | F1 回归验收 | 正常、重复、并发、越权、冲销、迁移案例 | 以上任务 | 通过迁移与上线验收方案中的 F0/F1 用例 |
## 五、当前可立即执行与必须等待
@@ -80,7 +80,7 @@ G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、
- 把草案契约转换为 OpenAPI/事件契约测试样例;
- 完善 F0/F1 数据字典、状态转移表和权限矩阵;
- 设计 Finance Admin/Client 页面和空态、错误态、争议态;
- 设计 Finance Admin/Client 页面和空态、错误态、线下异议录入态;
- 准备脱敏历史费用样本与迁移校验脚本设计;
- 按 F0-T01~F0-T05 拆解开发任务,但暂不合入业务代码。