docs: 补充三块执行载体与通用成本中心方案

- 新增 docs/成本中心与三块履约模型.md:三块执行载体、统一成本中心、销售事实表、人工 case 模型
- 同步 docs/README.md 口径(执行载体三块、成本只改一处、报表维度)
- 财务系统集成方案 / 影子总账说明 / 多发货平台链路 补充前置关系与边界
- 项目全量分析报告补充生产只读数据与 C1~C5 风险
This commit is contained in:
yml2213
2026-10-17 21:31:46 +08:00
parent a5f2be6669
commit ccd5ed2a80
6 changed files with 635 additions and 14 deletions
+15 -3
View File
@@ -3,7 +3,7 @@
> 最后校准:2026-10-17,代码基线 `main @ 6850bc64`。
> 本文是 `docs/` 的唯一入口。新增文档必须在上表登记状态;过期文档不再直接改写结论,统一移入 `docs/archive/`。
## 一、先记住三条口径
## 一、先记住四条口径
### 1. 来源只有三个,不是四个
@@ -19,9 +19,18 @@
- 骨架:`orders` + `order_items`
- 买家凭证:快手电子凭证(`kuaishou_industry_vouchers`)或抖音券(`redeem_certificates`)
- 执行载体:`affiliate_dash` 自动发货任务,或 `work_orders` 工单,二者业务上互斥
- 执行载体只有三种:`affiliate_dash` 自动发货、`work_orders` 工单、`manual` 人工客服
- 三者业务上互斥;无自动任务且无工单的已支付订单项就是人工块,必须进入人工 case,不能静默消失
### 3. 文档状态
### 3. 成本只在一个地方改
- 商品主数据:`product_catalog`
- 渠道 SKU 映射:`channel_product_mappings`
- 成本金额:只在 `cost_versions` 改,按生效日期新增版本
- 订单/工单/人工单只保存 `cost_snapshot_id`,历史成本永不回写
- 自动发货、接单平台、人工客服共用同一个成本解析器;匹配不到成本进入 `cost_missing`,不默认 0
### 4. 文档状态
| 状态 | 含义 |
| --- | --- |
@@ -34,6 +43,7 @@
| 文档 | 状态 | 用途 |
| --- | --- | --- |
| [项目全量分析报告-2026-10-17.md](项目全量分析报告-2026-10-17.md) | 现行 | 当前架构、业务链路、风险与改进路线 |
| [成本中心与三块履约模型.md](成本中心与三块履约模型.md) | 现行(方案) | 自动发货/接单平台/人工客服三块、统一成本中心、销售事实与人工监管 |
| [财务系统集成方案.md](财务系统集成方案.md) | 现行(方案) | 财务系统边界、复式记账模型、分期落地 |
| [影子总账说明.md](影子总账说明.md) | 现行(方案) | 影子总账的定义、运行方式、对账与转正标准 |
| [接单模板匹配引擎重构设计.md](接单模板匹配引擎重构设计.md) | 现行(P0/P1 已实施) | `kuaishou-91 / pdd / douyin-mashida` 三来源匹配引擎 |
@@ -72,3 +82,5 @@
3. 旧分析不要在原文件上继续堆结论;新建当期报告,旧文件移入 `docs/archive/<日期>/`。
4. 行号只用于当期基线;跨版本引用优先写文件与函数名。
5. 新增来源时只加一个 `ProductMatchSourceKey` + 一个适配器;**91 + 快手 send-code 永远算一个 `kuaishou-91`**。
6. 成本金额只改 `cost_versions`,不要在多个业务表直接改价;历史订单只读 `cost_snapshots`。
7. 报表维度统一用 `canonical_product_id + shop_id + stat_date`,不要直接用原始 `sku_code` 或 `orders.total_amount`。