docs: 重构项目文档并补充影子总账与财务集成方案

README.md

@@ -1,8 +1,8 @@
 # order_site
 
-快手自动发货与履约管理系统。
+多渠道订单履约、打手众包接单与寄卖仓库系统。
 
-前后端分离架构：接收外部订单、按规则匹配发货平台、生成统一领取链接，并提供后台做平台配置、任务追踪和人工复核。
+前后端分离架构：接收 `kuaishou-91`、`pdd`、`douyin-mashida` 三个来源的订单，按规则匹配自动发货或生成打手工单，提供统一领取/兑换链接，并支持平台配置、财务结算、审计与人工复核。
 
 ## 技术栈
 
@@ -26,28 +26,43 @@ deploy/
   caddy/                    Caddy 反向代理
   docker/                   前后端 Dockerfile
   mac-dev.sh / ubuntu-deploy.sh
-docs/                       平台接口、履约链路、部署说明
+docs/                       文档索引、架构分析、财务方案、平台接口、部署说明
 docker-compose.dev.yml      本地 Docker 开发环境
 docker-compose.yml          生产 / 服务器 Compose
 ```
 
+## 来源模型（现行）
+
+系统只有三个订单来源：
+
+| sourceKey | 数据通道 | 说明 |
+| --- | --- | --- |
+| `kuaishou-91` | 91 回调 + 快手 send-code | **同一个来源的两条通道**：91 是订单骨架权威源，快手 send-code 是数据补全源与兜底源；共享店铺键空间与同一套匹配上下文 |
+| `pdd` | 拼多多订单同步 | 两段式 `pdd_raw_orders → orders` |
+| `douyin-mashida` | 抖音码速达推送 | 抖店订单、DYC 券、H5/兑换页 |
+
+不要把 91 与快手 send-code 拆成两个来源或两个适配器。代码中的唯一来源键是 `kuaishou-91`（`apps/backend/src/services/product-match/types.ts`）。
+
 ## 业务边界（简图）
 
 ```text
-91 卡券进单
+kuaishou-91（91 回调 + 快手 send-code）
   → 本系统建单 / 匹配商品 / 创建履约任务
   → 返回统一 claimUrl
 用户打开领取页
   → 可选：快手行业电子凭证自动核销
-  → kuaishou-cloud / kuaishou-feifei / 人工 完成发货
+  → affiliate-dash / 人工 完成发货
 后台
   → 订单任务、平台配置、审计、人工复核
 接单平台（打手众包）
   → 工单发布到抢单大厅，打手抢单代练
   → 提交验收 / 问题单处置 / 任务时限超时自动判定
+抖音码速达
+  → 抖店订单推送 → 建单 → DYC 券 → 领取/兑换页 → 核销
 ```
 
 更完整的链路说明见：`docs/履约配置/多发货平台与电子凭证整体链路.md`。
+文档总索引见：`docs/README.md`。
 
 ## 本地开发