docs: 重构项目文档并补充三块载体、成本中心与人工支出方案
合并本轮全部文档改动(原 5 个 docs 提交压成 1 个)。 口径与索引: - 新增 docs/README.md 文档总索引:三来源口径(91 + 快手 send-code = kuaishou-91)、 「一个订单 = 骨架 + 买家凭证 + 一个执行载体」、成本只改一处、文档状态机 - 过期阶段文档移入 docs/archive/2026-10-08/(保留内容,不删除) 分析报告: - docs/项目全量分析报告-2026-10-17.md:架构、五条业务链路、P0/P1/P2 风险与改进路线 - docs/载体判定与成本中心落地-复核与草案-2026-10-17.md:生产只读克隆量化、上一轮结论复核与 4 处修正 方案文档: - docs/成本中心与三块履约模型.md:三块执行载体、标准商品、成本版本与快照、人工支出登记 - docs/财务系统集成方案.md:复式记账模型、分录表、分期落地 - docs/影子总账说明.md:影子期与转正期的边界、对账与转正标准 SQL 草案(docs/drafts/,未接入迁移): - 载体判定与人工块量化.sql:量化查询、carrier_type 判定与回填、守恒校验 - 成本中心与销售事实-DDL草案.sql:product_catalog / channel_product_mappings / cost_items / cost_versions / cost_snapshots / cost_exceptions / sales_daily_facts - 人工支出登记-DDL草案.sql:manual_fulfillment_cases / manual_expense_records / manual_expense_events 业务口径确认(2026-10-17): - 收入 = 用户实付(orders.total_amount),与快手 paymentFen 数据核验 100% 一致 - 打手报酬 = 支出/成本(最终提现打款),按总额法 - 人工块以「支出可追溯」为先,SLA 监管延后 - 退款/仲裁暂未接入,先预留字段与反向冲正关系 三份草案已在一次性沙箱库按依赖顺序零错误应用(10 张新表、27 个 CHECK 约束)。
This commit is contained in:
@@ -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`。
|
||||
|
||||
## 本地开发
|
||||
|
||||
|
||||
Reference in New Issue
Block a user