This commit is contained in:
2026-08-19 09:44:22 +08:00
parent b11d787eda
commit 6f311deef1
+13 -13
View File
@@ -60,7 +60,7 @@ Finance 全链路测试环境实跑报告为 `baiyue-firstleg/reports/finance-fu
## 一、结论 ## 一、结论
当前首期已确定采用人工简化方案:平台财务人工填写账单、收款和成本表单并上传凭证,客户只读;首期不做银行自动对账、自动核销任务、复杂审批、客户钱包、发票、供应商在线结算、汇率、月结或总账。完整原型能力仅作为后续扩展参考,不作为本期开工范围。 当前首期采用人工简化方案:平台财务登记收付款并上传凭证;客户可查询并确认本人已出账对账单。首期不做银行自动对账、自动核销任务、复杂审批、客户钱包、发票、供应商在线结算、汇率、月结或总账。
当前已经实现业务计费闭环,并已落地 Finance 独立服务/数据库、人工账单/收款/成本基础接口、平台与客户权限种子、Admin 财务页面和 Client 只读账单页面。当前不是“整体未开发”,而是已进入专项修复和契约收敛阶段。 当前已经实现业务计费闭环,并已落地 Finance 独立服务/数据库、人工账单/收款/成本基础接口、平台与客户权限种子、Admin 财务页面和 Client 只读账单页面。当前不是“整体未开发”,而是已进入专项修复和契约收敛阶段。
@@ -72,7 +72,7 @@ Finance 全链路测试环境实跑报告为 `baiyue-firstleg/reports/finance-fu
-> 计费规则匹配 -> 计费规则匹配
-> 费用试算与快照 -> 费用试算与快照
-> 发布对客费用 -> 发布对客费用
-> 客户只读查看 -> 客户查看并确认已出账对账单
-> 完成入库 -> 完成入库
``` ```
@@ -134,14 +134,14 @@ Firstleg 已有 `fl_inbound_fee_detail`,包含:
- 入库单、费用项目、方向、业务发生日、币种、单价、金额; - 入库单、费用项目、方向、业务发生日、币种、单价、金额;
- 重量、体积、计费量等业务快照; - 重量、体积、计费量等业务快照;
- 审核状态、审核人、驳回原因; - 审核状态、审核人、驳回原因;
- 发布状态、发布时间、是否参与结算; - 发布状态、发布时间;审核通过后自动发布并成为结算候选;
- 自动计费来源的费用单号和版本。 - 自动计费来源的费用单号和版本。
但当前仍存在以下断点: 但当前仍存在以下断点:
- 自动发布链路只生成 `RECEIVABLE` 对客运费。 - 自动发布链路只生成 `RECEIVABLE` 对客运费。
- 人工明细虽然允许选择 `PAYABLE`,但模型没有完整供应商/往来单位、付款条件、成本归属等应付结算字段。 - 人工 `PAYABLE` 明细使用 Warehouse `supplierId/supplierName` 快照;费用项目 `supplierCategory` 可空,空表示任意启用供应商,非空严格匹配。
- 人工明细审核通过后没有“发布并纳入结算”的完整状态迁移;新建时 `settlementIncluded=false`,现有接口没有形成账单的操作。 - 人工明细采用编辑、提交、审核、调整、作废闭环;审核通过后自动发布,不再存在“是否结算”开关。
- 已发布应收明细只能按单个入库单查询,未形成按客户、币种、账期聚合的财务台账。 - 已发布应收明细只能按单个入库单查询,未形成按客户、币种、账期聚合的财务台账。
- 没有冻结、出账、核销后的费用变更规则,无法保证历史账单金额稳定。 - 没有冻结、出账、核销后的费用变更规则,无法保证历史账单金额稳定。
@@ -152,7 +152,7 @@ Firstleg 已有 `fl_inbound_fee_detail`,包含:
| 原型模块 | 原型展示的主要能力 | 当前代码状态 | 是否能直接纳入首期 | | 原型模块 | 原型展示的主要能力 | 当前代码状态 | 是否能直接纳入首期 |
|---|---|---|---| |---|---|---|---|
| 客户账户 | 原型为余额、冻结、可用余额和充值流水 | 未实现 | 一期保留汇总/详情/流水结构,但改为未收、待出账、本期已收等派生指标;删除充值/钱包能力 | | 客户账户 | 原型为余额、冻结、可用余额和充值流水 | 未实现 | 一期保留汇总/详情/流水结构,但改为未收、待出账、本期已收等派生指标;删除充值/钱包能力 |
| 客户应收应付 | 费用明细、审核、参与结算、按截止时间或勾选生成账单 | 仅有入库费用明细后端基础;无正式财务页面 | 可裁剪为应收费用池 | | 客户应收应付 | 费用明细、编辑审核、按截止时间或勾选生成账单 | 已接入真实费用来源和编辑审核闭环 | 作为应收应付费用池 |
| 客户对账单 | 账期、汇率、应收、已收、结清、明细和支付历史 | 未实现 | 可作为应收闭环核心,但汇率和开票先暂缓 | | 客户对账单 | 账期、汇率、应收、已收、结清、明细和支付历史 | 未实现 | 可作为应收闭环核心,但汇率和开票先暂缓 |
| 结算单应收 | 应收、已收、余额、到期日、审批、部分收款 | 未实现 | 可合并进账单/应收单,避免首期重复建模 | | 结算单应收 | 应收、已收、余额、到期日、审批、部分收款 | 未实现 | 可合并进账单/应收单,避免首期重复建模 |
| 结算单应付 | 供应商应付、已付、余额、审批、部分付款、利润 | 未实现;上游成本来源不完整 | 一期纳入,但删除利润字段/按钮;必须先补真实供应商应付来源和付款凭证链路 | | 结算单应付 | 供应商应付、已付、余额、审批、部分付款、利润 | 未实现;上游成本来源不完整 | 一期纳入,但删除利润字段/按钮;必须先补真实供应商应付来源和付款凭证链路 |
@@ -187,7 +187,7 @@ Firstleg 已有 `fl_inbound_fee_detail`,包含:
| 客户账户 | 客户财务往来派生汇总、详情和流水 | 账单、收款和应收应付来源 | 一期不建设钱包、充值、预收或自动扣款 | | 客户账户 | 客户财务往来派生汇总、详情和流水 | 账单、收款和应收应付来源 | 一期不建设钱包、充值、预收或自动扣款 |
| 客户应收 | 客户欠款、到期、逾期、结清 | 已发布对客费用、补差/冲销 | 收入确认节点和账期规则 | | 客户应收 | 客户欠款、到期、逾期、结清 | 已发布对客费用、补差/冲销 | 收入确认节点和账期规则 |
| 客户应付 | 客户代垫或返还类应付款(如确有业务) | 业务费用或人工单据 | 产品是否真的存在“平台向客户付款”的场景 | | 客户应付 | 客户代垫或返还类应付款(如确有业务) | 业务费用或人工单据 | 产品是否真的存在“平台向客户付款”的场景 |
| 客户对账单 | 期间内费用汇总、明细、平台出账和客户只读查看 | 应收/应付费用池 | 一张账单是否允许混合方向、混合币种 | | 客户对账单 | 期间内费用汇总、明细、平台出账和客户确认 | 应收/应付费用池 | 一张账单是否允许混合方向、混合币种 |
| 结算单应收 | 可审批、可收款、可核销的应收结算单 | 已确认客户账单 | 与客户对账单是一对一还是一对多 | | 结算单应收 | 可审批、可收款、可核销的应收结算单 | 已确认客户账单 | 与客户对账单是一对一还是一对多 |
| 结算单应付 | 供应商成本、付款、余额和结清 | 供应商费用、运力/仓储/报关成本 | 成本确认、供应商账期、审批和付款方式 | | 结算单应付 | 供应商成本、付款、余额和结清 | 供应商费用、运力/仓储/报关成本 | 成本确认、供应商账期、审批和付款方式 |
| 收付款与核销 | 到账/付款凭证,部分结算、反核销 | 银行流水或人工登记 | 是否首期接银行流水,是否允许一笔多单核销 | | 收付款与核销 | 到账/付款凭证,部分结算、反核销 | 银行流水或人工登记 | 是否首期接银行流水,是否允许一笔多单核销 |
@@ -202,7 +202,7 @@ Firstleg 已有 `fl_inbound_fee_detail`,包含:
| 阶段 | 交付范围 | 关键闭环 | 前置依赖 | | 阶段 | 交付范围 | 关键闭环 | 前置依赖 |
|---|---|---|---| |---|---|---|---|
| F0 财务底座 | 独立 Finance 服务/数据库、财务主体、客户/供应商往来单位、币种、费用科目、期间、权限、审计、幂等、金额精度 | 所有后续对象使用同一基础口径 | 服务边界已技术确认;产品确认主体、币种、权限和编码 | | F0 财务底座 | 独立 Finance 服务/数据库、财务主体、客户/供应商往来单位、币种、费用科目、期间、权限、审计、幂等、金额精度 | 所有后续对象使用同一基础口径 | 服务边界已技术确认;产品确认主体、币种、权限和编码 |
| F1 应收与客户对账 | 应收费用池、平台出账、客户只读查看、结算单应收、收款登记、核销、反核销 | 费用 → 账单 → 应收 → 收款 → 结清 | 当前已发布对客费用来源 | | F1 应收与客户对账 | 应收费用池、平台出账、客户确认、结算单应收、收款登记、核销、反核销 | 费用 → 账单 → 客户确认 → 应收 → 收款 → 结清 | 当前已发布对客费用来源 |
| F2 应付与供应商结算 | 成本费用池、供应商账单、结算单应付、付款登记、付款核销、应付调整 | 成本 → 供应商账单 → 应付 → 付款 → 结清 | 供应商主数据和真实成本来源 | | F2 应付与供应商结算 | 成本费用池、供应商账单、结算单应付、付款登记、付款核销、应付调整 | 成本 → 供应商账单 → 应付 → 付款 → 结清 | 供应商主数据和真实成本来源 |
| F3 客户账户与发票 | 一期只做派生客户账户总览;发票暂缓 | 账户只读聚合,不维护资金余额 | 发票不属于一期 | | F3 客户账户与发票 | 一期只做派生客户账户总览;发票暂缓 | 账户只读聚合,不维护资金余额 | 发票不属于一期 |
| F4 分析与利润 | 一期不做 | 不建设菜单、路由或假入口 | 后续重新立项 | | F4 分析与利润 | 一期不做 | 不建设菜单、路由或假入口 | 后续重新立项 |
@@ -218,7 +218,7 @@ F1 先处理当前已经有可靠来源的对客头程费用:
-> 进入待对账费用池 -> 进入待对账费用池
-> 按客户 + 币种 + 账期生成对账单 -> 按客户 + 币种 + 账期生成对账单
-> 内部复核 -> 内部复核
-> 客户只读查看(异议线下反馈) -> 客户在线确认(异议仍线下反馈)
-> 平台财务出账后形成应收 -> 平台财务出账后形成应收
-> 登记实际收款 -> 登记实际收款
-> 将收款核销到应收 -> 将收款核销到应收
@@ -228,11 +228,11 @@ F1 先处理当前已经有可靠来源的对客头程费用:
F1 建议页面: F1 建议页面:
1. 应收费用池:查询、审核状态、是否参与结算、争议/排除原因。 1. 应收费用池:查询、编辑、提交、审核、调整、作废;审核通过自动进入结算候选。
2. 客户对账单:生成、明细、内部复核、发送、关闭;平台财务可重开或调整。 2. 客户对账单:生成、明细、内部复核、发送、关闭;平台财务可重开或调整。
3. 应收与收款:应收余额、到期日、收款登记、附件/凭证号、部分核销。 3. 应收与收款:应收余额、到期日、收款登记、附件/凭证号、部分核销。
4. 核销记录:每笔收款对应哪些应收、核销金额、剩余余额、反核销历史。 4. 核销记录:每笔收款对应哪些应收、核销金额、剩余余额、反核销历史。
5. 客户侧账单:只读明细、查看收款与未结余额;异议通过线下渠道反馈。 5. 客户侧账单:查看明细、收款与未结余额,并在线确认本人已出账账单;不做在线争议。
以下历史排除清单已被 2026-08-11 的五页范围取代。结算单应付现在属于一期;其余未确认能力继续排除: 以下历史排除清单已被 2026-08-11 的五页范围取代。结算单应付现在属于一期;其余未确认能力继续排除:
@@ -263,10 +263,10 @@ F1 建议页面:
|---|---|---| |---|---|---|
| F1 | 一期领导验收范围 | 固定为客户账户、客户应收应付、客户对账单、结算单应收、结算单应付;费用分析和利润表不做 | | F1 | 一期领导验收范围 | 固定为客户账户、客户应收应付、客户对账单、结算单应收、结算单应付;费用分析和利润表不做 |
| F2 | 账单生成维度 | 客户 + 币种 + 账期;不同币种不合并 | | F2 | 账单生成维度 | 客户 + 币种 + 账期;不同币种不合并 |
| F3 | 哪些费用可以进入账单 | `APPROVED + PUBLISHED + settlementIncluded=true` 且未作废、未出账 | | F3 | 哪些费用可以进入账单 | `APPROVED + PUBLISHED + AVAILABLE + CNY + amount>0` 且未出账;无人工结算开关 |
| F4 | 当前已发布头程费用是否自动进入待对账池 | 是,但仍由财务选择并生成账单 | | F4 | 当前已发布头程费用是否自动进入待对账池 | 是,但仍由财务选择并生成账单 |
| F5 | 账单生成后上游费用能否直接调整 | 不能;应走补差单/冲销单并保留原账单 | | F5 | 账单生成后上游费用能否直接调整 | 不能;应走补差单/冲销单并保留原账单 |
| F6 | 客户是否需要在线确认和提出争议 | 首期不需要;客户只读查看,异议线下反馈,由平台财务手动处理 | | F6 | 客户是否需要在线确认和提出争议 | 客户在线确认本人已出账对账单;确认状态独立于主状态,在线争议暂不做 |
| F7 | 是否需要内部复核 | 建议制单与复核权限分离,首期允许同人需业务明确 | | F7 | 是否需要内部复核 | 建议制单与复核权限分离,首期允许同人需业务明确 |
| F8 | 收付款是人工登记还是接银行流水 | F1/F2 先人工登记,F3 再接银行流水;必须保存到账日/付款日、方式、凭证号和附件 | | F8 | 收付款是人工登记还是接银行流水 | F1/F2 先人工登记,F3 再接银行流水;必须保存到账日/付款日、方式、凭证号和附件 |
| F9 | 一笔收款能否核销多张应收,一张应收能否被多次收款 | 两者都允许,禁止累计核销超过余额 | | F9 | 一笔收款能否核销多张应收,一张应收能否被多次收款 | 两者都允许,禁止累计核销超过余额 |