This commit is contained in:
2026-08-11 11:41:44 +08:00
parent 953a3b0ed9
commit a5b49293ab
8 changed files with 1430 additions and 201 deletions
@@ -1,13 +1,13 @@
# 财务开工门禁与 F0/F1 任务清单
> 版本:V1.0
> 日期:2026-08-10
> 当前阶段:开发前详细设计
> 结论:技术方案可继续;业务开发须按门禁逐项放行
> 版本:V1.1
> 日期:2026-08-11
> 当前阶段:F0/F1 基础实现已落地,专项修复与测试门禁收敛中
> 结论:本文任务表保留为实施追溯;当前放行依据改为《F1人工财务契约审查与门禁》
## 一、总控结论
Finance 的服务拆分、独立数据库、服务内部模块边界和 Firstleg 协作方式已经技术确认,可以继续做详细设计和契约测试准备。
Finance 的服务拆分、独立数据库、基础表、权限、人工账单/收款/成本接口及 Admin/Client 基础页面已经落地。当前不是等待开工,而是按专项测试退回项修复固定 DTO、凭证/File 链路、体积分摊、幂等和客户可见状态。
F0 的平台主体、首期仅 RMB/CNY、自定义账期、编号、费用冻结、无历史迁移、客户角色和首期简化审批已经确认。当前采用人工简化方案:账单、收款、成本均由平台财务填写表单并上传凭证;客户账户、发票、供应商在线应付、银行接口、复杂审批和月结首期不做。原表状态已归一为 25 项已确认、7 项暂缓。详见[产品确认版差异与剩余待确认](财务管理产品确认版差异与剩余待确认.md)。
@@ -16,14 +16,14 @@ F0 的平台主体、首期仅 RMB/CNY、自定义账期、编号、费用冻结
| 材料 | 状态 | 作用 |
|---|---|---|
| 财务服务边界设计 | 已完成 | 确认 `finance-service`、`baiyue_finance`、9203 预留和部署改造清单 |
| 财务管理产品确认表/XLSX | 部分已确认 | 会议继续填写剩余业务项;技术结论单独列示 |
| 财务领域模型与数据字典 | 草案完成 | F0/F1 模型、表和约束;未确认口径显式标记 |
| Firstleg-Finance 跨服务契约 | 草案完成 | 事件、快照查询、幂等、重试、权限和契约测试 |
| 财务管理产品确认表/XLSX | 首期已确认 | CNY、默认 30 天账期、人工账单/收款/成本、客户只读 |
| 财务领域模型与数据字典 | 已形成并进入实现校正 | F0/F1 模型、表和约束 |
| Firstleg-Finance 跨服务契约 | 技术边界已确认 | 事件、快照查询、幂等、重试、权限和契约测试 |
| 财务历史迁移与上线验收方案 | 首发不启用历史迁移 | 保留未来补迁参考;首发使用其中 F0/F1 灰度和验收部分 |
## 三、分阶段开工门禁
### G0:详细设计门禁
### G0:详细设计门禁(已完成)
可立即进行。条件已满足:
@@ -34,9 +34,9 @@ F0 的平台主体、首期仅 RMB/CNY、自定义账期、编号、费用冻结
G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、页面线框和任务拆分;不允许写入生产财务数据。
### G1:F0 财务底座开发门禁
### G1:F0 财务底座开发门禁(基础实现已完成)
进入 F0 开发前必须满足:
以下条目保留为实现核对依据,不再表示尚未开工:
1. 产品确认表中的 F0 主体/账套、往来单位、币种精度、汇率预留、期间、编号、来源入池、权限审计和历史迁移口径已填写,或明确书面暂缓方案。
其中 F0-11“一客户企业=一个对客结算对象”已确认;客户子用户仍不成为新的财务主体。
@@ -44,9 +44,9 @@ G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、
3. 事件信封、来源版本、Inbox/Outbox、幂等冲突和内部快照查询契约冻结。
4. Finance 权限码、客户范围校验、平台员工操作范围和审计事件清单冻结。
### G2:F1 客户应收开发门禁
### G2:F1 客户应收开发门禁(基础实现已完成,专项修复中)
进入 F1 前必须满足:
当前按以下冻结口径修复和补测:
- 账单聚合维度(首期固定 RMB/CNY)和账期计算规则冻结;
- 平台出账、关闭、重开和线下异议录入状态冻结;客户首期只读;
@@ -74,24 +74,24 @@ G0 允许:完善 API/OpenAPI、数据库迁移草案、契约测试样例、
| F1-T05 | 客户侧账单 | 客户只读查看、余额和收款记录 | F1-T02/F1-T04 | 客户不可见内部备注、供应商成本和内部附件 |
| F1-T06 | F1 回归验收 | 正常、重复、并发、越权、冲销、迁移案例 | 以上任务 | 通过迁移与上线验收方案中的 F0/F1 用例 |
## 五、当前可立即执行与必须等待
## 五、当前执行重点
### 现在可以继续
### 当前继续执行
- 把草案契约转换为 OpenAPI/事件契约测试样例;
- 完善 F0/F1 数据字典、状态转移表和权限矩阵;
- 设计 Finance Admin/Client 页面和空态、错误态、线下异议录入态;
- 准备脱敏历史费用样本与迁移校验脚本设计;
- 按 F0-T01~F0-T05 拆解开发任务,但暂不合入业务代码。
- 按 OpenAPI 1.1.0 修复服务端 DTO、凭证链路、体积分摊、幂等和客户可见状态,并补齐契约测试。
### 必须等待产品确认
### 本轮不再等待产品确认
- 生产账单、应收、收款、核销的正式业务规则;
- 客户账户、发票、供应商应付和利润的正式口径;
- 历史费用是否迁移、线下已结算排除台账和灰度客户范围。
- F1 首期只做 CNY 人工账单、人工收款、人工成本和客户只读,产品口径已经冻结。
- 客户账户、发票、供应商在线应付、汇率、月结和利润不属于本轮,不阻塞 F1 修复。
- 首发不迁移历史,不阻塞 F1 修复。
## 六、总控放行结论
当前状态为:**G0 已通过,G1/G2 待产品确认后放行。**
当前状态为:**G0 已完成,G1/G2 基础实现已落地,F1 正在按专项测试门禁修复。**
这意味着可以继续做开发前详细设计和可逆的契约/测试准备;产品回传 XLSX 并冻结 F0/F1 后,即可进入 `finance-service` 骨架、独立数据库和客户应收闭环开发。
当前无需再次等待产品确认或重新创建服务骨架。修复完成、OpenAPI 契约测试和《F1人工财务契约审查与门禁》验收用例通过后,方可放行完整联调。