chore: curate monthly assessment evidence and scripts

yangchanji-plan-ab-compare.md

@@ -0,0 +1,211 @@
+# 养馋记 · 物流台账闭环 · 全量对照总表
+
+> **Make 打开本页：** http://localhost:53817/?projectId=make&doc=yangchanji-plan-ab-compare.md  
+> **主库：** `knowledge/产品线1-项目1/04-产品方案/方案AB对照摘要.md`
+
+| 文档 | Make 打开 |
+|------|-----------|
+| **本页 · A/B 对照** | http://localhost:53817/?projectId=make&doc=yangchanji-plan-ab-compare.md |
+| 方案 A · 可对接 | http://localhost:53817/?projectId=make&doc=yangchanji-plan-a.md |
+| 方案 B · 不可对接 | http://localhost:53817/?projectId=make&doc=yangchanji-plan-b.md |
+| 数智中心评估汇总 | http://localhost:53817/?projectId=make&doc=yangchanji-ledger-eval.md |
+
+| 文档 | 用途 |
+|------|------|
+| 本页 | A/B 与共性一表看清 |
+| 方案 A | 可对接 API 的完整评估（第五、六点） |
+| 方案 B | 不可对接时的完整评估（第五、六点） |
+| 数智中心评估汇总 | 双路径合一稿 |
+
+---
+
+## 一、方案基本信息对照
+
+| 对照项 | 方案 A · 可对接 | 方案 B · 不可对接 |
+|--------|-----------------|-------------------|
+| 前提 | 养馋记 TMS 提供可用 API + 沙箱 | 无可用 API / 短期对不通 |
+| 数据进 OneOS | 对方 API 同步（Excel 兜底） | 导入模板 / 手工建单 + 主数据改造 |
+| 状态回传对方 | 可做（P1） | 本期不做（可导出） |
+| 特有开发 | 对接适配层 | 导入中心 + 字段改造 |
+| 可行性 | 有条件可行 | 有条件可行 |
+| 推荐场景 | 接口确认可用时默认 | 对不通，或先通闭环再切 A |
+| 版本 | V1.2（表格化） | V1.2（表格化） |
+
+---
+
+## 二、第五点八问 · A/B 对照
+
+| # | 评估问题 | 方案 A | 方案 B |
+|---|----------|--------|--------|
+| 1 | 技术上能否实现 | 有条件可行（依赖 API） | 有条件可行（不依赖 API） |
+| 2 | 数据/接口怎么来 | API：订单/路线/门店等；回传 P1 | 无接口；导入/录入同套业务对象 |
+| 3 | 我方开发什么 | 对接层 + 待派派单小程序计费对账 | 导入改造 + 待派派单小程序计费对账 |
+| 4 | 多长时间 | 约 **18～25 周 / 5～6.5 月** | 约 **20～27 周 / 5.5～7 月** |
+| 5 | 投入人员 | 产1研2测1 + 对方接口人 | 产1研2测1 + **运营导单强依赖** |
+| 6 | 额外费用 | 联调+小程序等；专线视情况 | 现金更低；**导单隐性成本中** |
+| 7 | 前置与风险 | API/沙箱/映射；字段不一致、审核延误 | 导单责任/缺口表；导单延误、数据不一致 |
+| 8 | 分期 | 调研→V0→V1→V2→利润后置 | 同左（V1 多 2～4 周） |
+
+---
+
+## 三、周期对照（已压缩调研+V0）
+
+| 阶段 | 方案 A | 方案 B | 备注 |
+|------|--------|--------|------|
+| 业务调研 | 1～2 周 | 1～2 周 | 与 V0 可并行收口 |
+| V0 门禁 | 约 1 周 | 约 1 周 | |
+| **调研+V0** | **约 2～3 周** | **约 2～3 周** | 原 3～6 周减半 |
+| V1 | 12～16 周 | 14～18 周 | B 含导入改造 |
+| V2 | 4～6 周 | 4～6 周 | |
+| 利润（后置） | 另 2～4 周 | 另 2～4 周 | 不进首批退出 |
+| **首批合计** | **约 5～6.5 个月** | **约 5.5～7 个月** | 含调研 |
+
+---
+
+## 四、业务时序与已拍板规则（A/B 相同）
+
+| 步骤 | 规则 |
+|------|------|
+| 1 | 数据进入 OneOS（A=API / B=导入或录入） |
+| 2 | 自动生成待派任务 |
+| 3 | 人工选车、选司机并派单 |
+| 4 | **派单后**司机小程序才可见任务 |
+| 5 | 正常情况：**当前运单未完成，不可接下一单** |
+| 6 | 办结运单后 → **才触发正式计费/出账** |
+| 7 | V2：成本归集 + 流水 + 合作方只读确认 |
+| 8 | 利润抽点在流水与应收应付之后 |
+
+| 已拍板项 | 结论 |
+|----------|------|
+| 首批范围 | V0+V1+V2；V3（用友等）不计入 |
+| 计费 | 多模型引擎；每客户只绑一种 |
+| 对账深度 | 只读 + 确认（无驳回/补凭证） |
+| 司机端 | 微信小程序，V1 必达 |
+| 氢/ETC | 可先运费；V2 必须做完 |
+| 编制 | 产品1 + 研发2 + 测试1 |
+
+| 待确认项 | 说明 |
+|----------|------|
+| 走 A / B / 先 B 后 A | 调研结束书面选定 |
+| 车司机是否固定绑定 | 运营确认 |
+| 异常是否允许代办结 | 运营确认 |
+| 规则包书面试算样例 | 业务+财务 |
+| 利润具体参数 | 后置再锁 |
+
+---
+
+## 五、数据对象对照（业务要什么 × 怎么拿到）
+
+| 数据对象 | 用途 | 方案 A 获取 | 方案 B 获取 | 优先级 |
+|----------|------|-------------|-------------|--------|
+| 订单 | 生成待派 | 对方 API | 导入/手工建单 | P0 |
+| 路线/经停 | 派单与司机点序 | 对方 API | 导入/录入 | P0 |
+| 门店主数据 | 主数据与对账 | API 或首导+增量 | 批量导入+日常维护 | P0 |
+| 货物/物料 | 温层货量/计价 | API（汇总或明细） | 随单导入或汇总填 | P0/按需 |
+| 运费要素 | 办结后计费 | 订单内或规则侧 | 导入列或规则侧 | P0 |
+| 车/司机 | 人工派单 | 我方主数据为主 | 同左 | P0 |
+| 状态回传 | 告知对方 | OneOS→对方 API | 不做接口（可导出） | A:P1 / B:— |
+| 氢费/ETC | V2 成本 | 我方内部系统 | 同左 | V2 |
+
+---
+
+## 六、我方功能对照
+
+| 功能模块 | 方案 A | 方案 B | 阶段 |
+|----------|--------|--------|------|
+| 对接适配（鉴权/同步/映射/幂等/重试/差异日志） | ✅ | ❌（可不建） | V0～V1 |
+| 主数据/单据字段改造 | 按需 | ✅ 重点 | V0～V1 |
+| 导入中心（模板/校验/重导） | 仅兜底 | ✅ 重点 | V1 |
+| 手工建单/维护 | 辅 | ✅ | V1 |
+| 待派任务池 | ✅ | ✅ | V1 |
+| 人工调度台 | ✅ | ✅ | V1 |
+| 司机微信小程序 | ✅ | ✅ | V1 |
+| 办结后计费出账 | ✅ | ✅ | V1 |
+| 成本归集 | ✅ | ✅ | V2 |
+| 流水/应收应付/只读确认 | ✅ | ✅ | V2 |
+| 利润抽点 | 后置 | 后置 | V2 后 |
+| 用友 | 不计入 | 不计入 | V3 |
+
+---
+
+## 七、人员与费用对照
+
+| 角色/费用项 | 方案 A | 方案 B |
+|-------------|--------|--------|
+| 产品 | 1 | 1 |
+| 研发 | 2 | 2 |
+| 测试 | 1 | 1 |
+| 养馋记配合 | 接口人强 | 台账/导出样例弱 |
+| 运营配合 | 调研+双跑 | **导单责任人+日常导单（强）** |
+| 对方 API 联调费 | 可能有 | 无 |
+| 小程序认证 | 必需 | 必需 |
+| 短信 | 可选 | 可选 |
+| 氢/ETC 源 | V2 必需 | V2 必需 |
+| 独立服务器 | 通常否 | 通常否 |
+| 隐性成本 | 联调等待 | **持续导单与主数据质量** |
+
+---
+
+## 八、第六点确认事项 · A/B 对照
+
+| # | 原文件确认项 | 方案 A 状态 | 方案 B 状态 |
+|---|--------------|-------------|-------------|
+| 1 | 标准接口还是 Excel | 假定 **API**；Excel 兜底 | 假定 **无 API**；Excel/模板为主 |
+| 2 | 能提供哪些字段 | 待映射表收口 | 按业务 P0 定导入列 |
+| 3 | 状态能否实时回传 | 目标 P1；调研确认是否准实时 | **本期不做**系统回传 |
+| 4 | 氢费/ETC 从哪来 | 我方内部；V2 | 同左 |
+| 5 | 司机端形态 | **已定小程序** | **已定小程序** |
+| 6 | 车司机是否绑定 | 待运营确认 | 待运营确认 |
+| 7 | 利润怎么配 | 后置；按客户配 | 同左 |
+| 8 | 对账深度 | **已定只读+确认** | **已定只读+确认** |
+| 9 | 是否接用友 | **本期不做** | **本期不做** |
+
+---
+
+## 九、分期退出标准对照
+
+| 期次 | 方案 A 退出标准 | 方案 B 退出标准 |
+|------|-----------------|-----------------|
+| 调研 | 确认可对接；字段草案+原型范围 | 确认走 B（或先 B）；缺口表+导单责任+原型范围 |
+| V0 | 映射确认、规则样例、小程序账号、沙箱就绪 | 导入模板、字段缺口确认、规则样例、小程序账号就绪 |
+| V1 | 双跑运费可解释；小程序可用；办结出账；未完成不可接下一单 | 导入可生成待派；其余同 A |
+| V2 | 成本进项目；双方月确认一版 | 同左（对内或合作方账号） |
+| 利润 | 后置 | 后置 |
+
+| 名词 | 含义（白话） |
+|------|----------------|
+| 退出标准 | 本期做到什么才算结束、可进下一期 |
+| 双跑出账可解释（V1） | 运费应收侧能讲清；完整应付成本在 V2 |
+| 映射确认 | A=对方字段↔OneOS；B=导入列↔OneOS |
+
+---
+
+## 十、决策日志 · 养馋记台账相关（已拍板对照）
+
+| 日期 | 议题 | 结论 |
+|------|------|------|
+| 2026-08-10 | 首批范围 | 批准 V0+V1+V2；V3 不计入 |
+| 2026-08-10 | 计费模型 | 多模型引擎；每客户只绑一种 |
+| 2026-08-10 | 对账深度 | 只读+确认 |
+| 2026-08-10 | 司机端 | 微信小程序；V1 必达 |
+| 2026-08-10 | 氢/ETC | 可先运费；V2 必做完 |
+| 2026-08-10 | 利润 | 流水与应收应付之后 |
+| 2026-08-10 | 编制 | 产1研2测1 |
+| 2026-08-10 | 时序 | 派单后可见；办结后计费 |
+| 2026-08-10 | 接单约束 | 未完成不可接下一单 |
+| 2026-08-11 | 数据路径 | A API / B 导入改造 |
+| 2026-08-11 | 周期 | 调研+V0≈2～3周；A≈5～6.5月；B≈5.5～7月 |
+
+---
+
+## 十一、评估结果一览（并排）
+
+| 评估结果项 | 方案 A | 方案 B |
+|------------|--------|--------|
+| 可行性 | 有条件可行 | 有条件可行 |
+| 数据策略 | 对方 API 主路径 | OneOS 改造+导入/维护 |
+| 周期 | 约 5～6.5 个月 | 约 5.5～7 个月 |
+| 人员 | 产1研2测1 | 产1研2测1+运营强依赖 |
+| 费用感 | 低～中 | 现金低、运营成本中 |
+| 首批 | 调研→V0→V1→V2 | 同左 |
+| 利润/用友 | 后置 / 不计入 | 同左 |