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
@@ -2,12 +2,14 @@
> 版本:V1.0
> 编制日期:2026-08-10
> 状态:开发前设计;技术方案已定,业务数据口径待产品确认
> 状态:首发已确认不迁移历史;本文仅保留为未来补迁/导入参考,不纳入首发门禁
> 适用范围:Finance F0 财务底座、F1 客户应收与对账首发上线
> 关联文档:[财务管理闭环盘点与范围建议](README.md)、[财务服务边界设计](财务服务边界设计.md)、[财务管理产品确认表](财务管理产品确认表.md)
## 一、目标与基本结论
**首发产品结论:没有需要迁移的历史财务数据,Finance 只接收正式启用后的新费用来源。** 因此首发不得执行历史批量导入,也不要求准备线下已结算排除台账。本文后续迁移步骤仅在未来明确提出历史补迁时重新启用并复核。
本方案用于把 Finance 上线前已经存在于 Firstleg 的历史对客费用,安全地接入独立 `finance-service` 和 `baiyue_finance`,并定义 F0/F1 从测试、灰度到正式启用的验收门禁。
本方案不把“费用已发送/已发布”推断为“客户尚欠款”,也不把二期计费状态推断为财务结算状态。历史迁移分成三个明确步骤:
@@ -357,7 +359,7 @@ Finance 待复核来源金额 = 本批纳入原币金额
| G0 测试环境 | 测试数据与脱敏历史样本 | F0/F1 自动化及业务回归通过 |
| G1 生产影子 | 全量或限定来源只入 Inbox/待复核池;用户不可见、不可制单 | 连续观察期无漏单、重复或冲突;观察时长待上线评审确定 |
| G2 内部灰度 | 白名单客户;仅平台财务可见和制单 | 财务逐日对账通过,无 P0/P1 缺陷 |
| G3 客户灰度 | 白名单客户可查看、确认/争议 | 客户侧金额和状态一致,通知无重复 |
| G3 客户灰度 | 白名单客户只读查看 | 客户侧金额和状态一致,通知无重复 |
| G4 全量 | 全部已确认客户 | 灰度总结批准,监控、值守和补偿预案就绪 |
### 9.2 灰度维度
@@ -367,7 +369,7 @@ Finance 待复核来源金额 = 本批纳入原币金额
- 环境;
- 财务主体;
- 客户白名单;
- 功能(来源接入、制单、发送、客户确认、收款、核销、反核销);
- 功能(来源接入、制单、发送、客户只读查看、收款、核销、反核销);
- 历史批次号与实时事件起始水位。
开关由服务端执行,前端隐藏按钮不能代替权限或灰度校验。
@@ -435,8 +437,8 @@ Finance 待复核来源金额 = 本批纳入原币金额
| 编号 | 场景 | 预期结果 |
|---|---|---|
| F1-N01 | 财务从激活来源池按客户+币种+账期生成账单 | 来源只进入一张有效账单,金额合计正确 |
| F1-N02 | 账单内部复核、发送、客户确认 | 状态按确认模型流转,平台与客户显示一致 |
| F1-N03 | 客户提出明细争议 | 记录原因和争议明细,原快照不被覆盖,可重开再发送 |
| F1-N02 | 账单内部复核、发送、客户只读查看 | 状态按平台出账模型流转,平台与客户显示一致 |
| F1-N03 | 平台录入线下异议 | 记录原因和争议明细,原快照不被覆盖,由平台财务调整/作废重开 |
| F1-N04 | 确认账单形成应收 | 应收金额、余额、到期日和来源关系正确 |
| F1-N05 | 登记一笔收款核销多张应收 | 每条分配关系可追溯,收款和应收余额正确 |
| F1-N06 | 一张应收被多笔收款部分核销 | 状态依次为 OPEN/PARTIALLY_SETTLED/SETTLED,累计不超额 |
@@ -496,7 +498,7 @@ Finance 待复核来源金额 = 本批纳入原币金额
- 影子接入和内部灰度观察完成;
- 对应客户历史来源及实时来源逐币种对账通过;
- 该客户线下已结算排除清单已确认;
- 客户侧权限、脱敏、空态、错误态和争议入口验收通过;
- 客户侧只读权限、脱敏、空态和错误态验收通过;平台线下异议录入验收通过;
- 不发送历史自动账单;首张账单由财务人工复核后发送;
- 客服/运营已获得争议、误账和通知失败处理说明。