合并本轮全部文档改动(原 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 约束)。
1.5 KiB
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/、抖音-码速达/消息推送/)。 - 历史文档中的代码行号、测试数量、迁移数量不要直接引用。