Files
order_site/docs/archive/README.md
T
yml2213 7bacb7d5eb 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 约束)。
2026-10-17 22:03:03 +08:00

1.5 KiB

历史文档归档

这里的文档只用于追溯当时的分析过程,不是现行实现说明。 代码、数据库结构与线上行为以仓库当前 main 和 docs/README.md 中标记为「现行」的文档为准。

2026-10-08

文档 归档原因
项目分析报告-发单系统与寄售仓库.md 基线为 ef491660,测试数、迁移数、表数与当前实现已明显不一致;由《项目全量分析报告-2026-10-17》替代
寄卖子系统技术分析报告.md 同上,且部分行号已漂移;寄卖代码仍可参考,但结论需按现行代码复核
寄卖系统优化方案.md 阶段性优化方案,部分事项已完成,不能作为现行路线图
寄卖库存优化现状与进度追踪.md 阶段性进度追踪,完成状态已过时
近期性能与稳定性专项优化分析报告.md 2026-10-01 / 10-02 的生产快照与专项复盘,保留作性能证据,不代表当前容量
寄卖系统迁移079上库前检查.sql 迁移 079 的一次性上库前检查脚本,生产已执行;保留作审计追溯

使用建议

  • 需要当前架构与风险:看 docs/项目全量分析报告-2026-10-17.md。
  • 需要财务系统设计:看 docs/财务系统集成方案.md。
  • 需要某个平台协议:看对应的厂商文档目录(91卡券/、行业电子凭证/、发货平台-2/、抖音-码速达/接口API/、抖音-码速达/消息推送/)。
  • 历史文档中的代码行号、测试数量、迁移数量不要直接引用。