财务开工门禁与 F0/F1 任务清单

版本：V1.1 日期：2026-08-11 当前阶段：F0/F1 基础实现已落地，专项修复与测试门禁收敛中结论：本文任务表保留为实施追溯；当前放行依据改为《F1人工财务契约审查与门禁》

一、总控结论

Finance 的服务拆分、独立数据库、基础表、权限、人工账单/收款/成本接口及 Admin/Client 基础页面已经落地。后端真实体积快照、归属、成本凭证、revision、双权限上传、费用来源事件/Relay/快照、固定 DTO、完整幂等、File fail-closed、客户收款 DTO 和稳定错误码已经完成并通过专项测试；当前继续收口 Admin 最终契约适配和五页剩余 operation。

F0 的平台主体、首期仅 RMB/CNY、自定义账期、编号、费用冻结、无历史迁移、客户角色和首期简化审批已经确认。订单与客户领导验收固定为 5 页；客户账户为派生财务往来总览，不做钱包/充值，费用分析和利润表不做。详见财务核心五页产品与接口验收契约。

二、文档交付状态

材料	状态	作用
财务服务边界设计	已完成	确认 `finance-service`、`baiyue_finance`、9203 预留和部署改造清单
财务管理产品确认表/XLSX	首期已确认	CNY、默认 30 天账期、人工账单/收款/成本、客户只读
财务领域模型与数据字典	已形成并进入实现校正	F0/F1 模型、表和约束
Firstleg-Finance 跨服务契约	技术边界已确认	事件、快照查询、幂等、重试、权限和契约测试
财务历史迁移与上线验收方案	首发不启用历史迁移	保留未来补迁参考；首发使用其中 F0/F1 灰度和验收部分

三、分阶段开工门禁

G0：详细设计门禁（已完成）

可立即进行。条件已满足：

独立服务/独立库结论已记录；
Finance 与 Firstleg 的数据归属和禁止事项已记录；
领域模型、跨服务契约、迁移验收方案已有草案；
产品待确认项与技术结论已分离。

G0 允许：完善 API/OpenAPI、数据库迁移草案、契约测试样例、页面线框和任务拆分；不允许写入生产财务数据。

G1：F0 财务底座开发门禁（基础实现已完成）

以下条目保留为实现核对依据，不再表示尚未开工：

产品确认表中的 F0 主体/账套、往来单位、币种精度、汇率预留、期间、编号、来源入池、权限审计和历史迁移口径已填写，或明确书面暂缓方案。其中 F0-11“一客户企业＝一个对客结算对象”已确认；客户子用户仍不成为新的财务主体。
finance-service 的模块目录、端口、数据库名、Nacos 配置和 Gateway 路由完成技术评审。
事件信封、来源版本、Inbox/Outbox、幂等冲突和内部快照查询契约冻结。
Finance 权限码、客户范围校验、平台员工操作范围和审计事件清单冻结。

G2：F1 客户应收开发门禁（基础实现已完成，专项修复中）

当前按以下冻结口径修复和补测：

财务核心P0操作契约与验收用例.md 中的 11 个 operation 全部为订单与客户 P0；目标契约不跟随开发中间态修改，G1-G4 证据矩阵任一组未同时通过后端行为测试和 Admin 真实接入时均不得关闭；
账单聚合维度（首期固定 RMB/CNY）和账期计算规则冻结；
平台出账、关闭、重开和线下异议录入状态冻结；客户首期只读；
应收生成节点、人工收款表单字段、凭证关联和到期日冻结；首期不实现复杂多对多核销模型；
预收、多收、手续费、退款、反核销的处理方式冻结；
至少准备一组真实或脱敏费用来源样本，能够完成费用→账单→应收→收款→核销回归。

G3/G4：订单与客户应付与排除项门禁

结算单应付纳入订单与客户，但必须有供应商和真实 PAYABLE 来源。客户账户只做派生查询。发票、费用分析、利润、汇率和月结不属于订单与客户，禁止保留假入口。

四、F0/F1 任务清单

编号	任务	产出	依赖	放行标准
F0-T01	创建 Finance 服务骨架	`finance/`、Maven 模块、启动类、健康检查	G1-2	独立构建/启动，不改 Firstleg 数据库
F0-T02	建立 Finance 数据库与迁移	`baiyue_finance` 表结构、迁移脚本、版本记录	F0-T01	无跨库外键/Join；迁移可重复执行
F0-T03	财务基础主数据	主体、账套、币种、期间、编号、往来单位快照	产品 F0	关闭期间、币种和编号规则服务端生效
F0-T04	来源池与事件消费	Inbox、来源池、快照、事件结果查询	契约冻结	重复/乱序/重试/冲突均有可验收结果
F0-T05	财务权限与审计	权限码、客户范围、操作审计和高风险操作保护	G1-3	越权和反核销等操作被服务端拒绝并留痕
F1-T01	应收费用池	跨入库单筛选、排除原因、来源版本锁定	F0-T04	一条有效来源只能进入一张有效账单
F1-T02	客户对账单	生成、复核、发送、关闭、平台重开/调整、线下异议录入	产品 F1	状态迁移和版本并发校验完整
F1-T03	应收单	应收金额、已核销额、余额、到期/逾期	F1-T02	账单与应收金额可追溯且不可覆盖历史
F1-T04	收款与核销	收款登记、多对多核销、反核销	产品 F1	禁止跨币种、超额和重复核销
F1-T05	客户侧账单	客户只读查看、余额和收款记录	F1-T02/F1-T04	客户不可见内部备注、供应商成本和内部附件
F1-T06	F1 回归验收	正常、重复、并发、越权、冲销、迁移案例	以上任务	通过迁移与上线验收方案中的 F0/F1 用例

五、当前执行重点

当前继续执行

把草案契约转换为 OpenAPI/事件契约测试样例；
完善 F0/F1 数据字典、状态转移表和权限矩阵；
设计 Finance Admin/Client 页面和空态、错误态、线下异议录入态；
准备脱敏历史费用样本与迁移校验脚本设计；
按 OpenAPI 1.2.0 完成剩余服务端 DTO、File fail-closed、幂等和客户可见 DTO，并让 Admin 移除人工体积、接入账期与 revision。
按五页目标 OpenAPI 和 P0 操作契约逐项实现 11 个 operation；仅在 Controller/DTO 与直接行为测试均有证据后更新实现状态。

本轮不再等待产品确认

订单与客户只支持 CNY，验收 5 页及其真实费用来源、对账、应收/应付和人工收付款链路。
客户账户是派生总览；发票、费用分析、利润、汇率、月结不属于本轮。
首发不迁移历史，不阻塞 F1 修复。

六、总控放行结论

当前状态为：G0 已完成，G1/G2 基础实现已落地，F1 正在按专项测试门禁修复。

当前无需再次等待产品确认或重新创建服务骨架。修复完成、OpenAPI 契约测试和《F1人工财务契约审查与门禁》验收用例通过后，方可放行完整联调。

7.2 KiB Raw Permalink Blame History