OTWB 整体骨架（3PL 城配版）

基于前面的 yudao-cloud 架构语境，这份 OWTB + 3PL 城配 TMS 全功能清单 按"OTWB 四件套骨架 → TMS/OWTB 重点拆解 → 3PL 差异化模块 → P0/P1/P2 落地分级"铺，你可以直接拿来对标 yudao-module-tms的菜单和表结构设计。

一、OTWB 整体骨架（3PL 城配版）

OTWB = O MS + W MS + T MS + BMS，3PL 城配场景下四者的分工：

子系统	3PL 城配定位	与 yudao 模块映射
OMS 订单管理	多货主订单接入（API/EDI/Excel/小程序），清洗→归集→下发TMS	可复用 `erp`或新建 `yudao-module-oms`
WMS 仓储（可选）	多货主仓、波次拣货、越库直发、装车复核，输出"可靠出库时点+重量体积"给 TMS	复用 yudao `erp`仓储 or 独立 `yudao-module-wms`
TMS 运输（核心）	智能调度 OWTB + 派车 + 在途 + 回单 + 签收	新建 `yudao-module-tms`+ `tms-scheduler`
BMS 计费	3PL 价目表(Tariff)、应收(货主)/应付(司机/外协)、运费审计	扩展 yudao `pay`或独立 `yudao-module-bms`

💡 3PL 与普通车队 TMS 的最大差别：多货主数据隔离 + 合同 SLA 差异化 + 混合运力(自有+外协) + 计费规则复杂。下面清单里会用 🔑 标出 3PL 专属点。

二、TMS 全功能清单（按模块拆）

1️⃣ 基础档案（多货主 + 3PL 属性）

复制代码

├── 委托客户（= yudao tenant 扩展）
│   ├── 客户档案：名称/联系人/地址/结算方式/账期/授信额度 🔑
│   ├── 客户等级 + 专属合同运价（按重量/体积/里程/件数）🔑
│   └── SLA 模板：时效承诺/迟到罚款/冷藏溢价/拒收责任 🔑
├── 货物主数据
│   ├── 温层（常温/冷藏/冷冻/恒温）
│   ├── 堆叠系数/易碎/危险品标签
│   └── 包装类型（托盘/周转箱/散装）
├── 网点 & 仓库
│   ├── 装货点（仓库门号/月台/可装车时段）
│   └── 卸货点（门店/商圈/住宅/园区）
└── 计费规则库 🔑
    ├── 按趟 / 按方 / 按吨 / 按件 / 阶梯价
    ├── 峰值附加费 / 夜间费 / 等待费 / 搬运费
    └── 外协溢价倍率

2️⃣ 订单管理（OMS 下沉到 TMS 的部分）

多入口接入：API / EDI / Excel 批量 / 官微扫码 / 客户小程序
订单生命周期：待排 → 已排 → 装车 → 在途 → 签收 → 完结
订单操作：改单 / 补单 / 作废 / 拆分 / 合并
地址清洗 + 高德地理编码（lat/lng + POI 校正）
时间窗标记：硬时间窗 （商超）+ 软时间窗（电商）
🔑 3PL 专属：订单挂 tenant_id+ customer_id，货主数据完全隔离

3️⃣ OWTB 调度工作台（核心大脑）⭐

这是 3PL 城配 TMS 的"操作中枢"，建议按"左-中-右"三栏布局：

🎛️ 左侧：订单池看板

待排 / 已排 / 异常三状态 Tab
多维筛选：货主 / 温层 / 区域 / 时效等级 / 车型要求
批量勾选 → 一键「智能排线」
订单卡片悬浮：SKU/重量体积/时间窗/特殊要求

🗺️ 中间：线路可视化

高德 Map JS API 底图
线路色块区分（冷藏线/常温线/混合线）
车标实时 GPS 叠加
点击线路展开站点序列（装→卸1→卸2→...→回）

📋 右侧：派车单 + 人工微调

派车单头：线路编号 / 车牌 / 司机 / 总里程 / 装载率
站点明细表：序号 / 客户 / 预计到达 / 实际到达 / 联系电话
人工微调能力（算法≠万能）：
- 拖拽换序
- 两线路合并 / 拆单
- 手动换车 / 换司机
- 强制插入加急单
确认派车 → 司机 APP 推送

🚨 底部：异常告警流（参考零售 OTWB 控制塔 12 类异常）

配送超时 / 冷链断链 / 车辆偏航 / 装载率异常 / 拒收率突增 / 费用突增 ...
红(15min响应) / 橙(30min) / 黄(2h) 三级，超时自动升级

4️⃣ 智能调度引擎（背后服务）

订单聚类：K-means / DBSCAN 按"区域+温层+时效"聚合
VRP 求解：CVRPTW（载重/容积/时间窗/温层隔离/限行）
运力匹配：自有车优先 → 不足自动触发外协询价 🔑
重算策略：
- T-1 夜间静态排线（XXL-Job）
- 动态插单增量重算（2-5s）
- 异常触发 regional re-optimization

5️⃣ 运力管理

复制代码

├── 自有车队
│   ├── 车辆档案：车牌/车型/载重/容积/温层/限行标签/保险/年检
│   ├── 司机档案：资质/熟悉线路/历史评分/可作业时段的
│   └── 状态看板：空闲/在途/装卸/维修
├── 外协运力 🔑
│   ├── 外协车队 / 临时司机 / 众包
│   ├── 报价评级 / 可用时段
│   └── 竞价记录（自动比价选最低）
└── 车辆维护
    ├── 保养提醒 / 年检提醒 / 保险到期
    └── 维修记录

6️⃣ 派车 & 执行

派车单生成（关联线路 + 订单明细）
司机 APP 推送：任务 / 导航 / 装货要求
节点打卡：到达装货点 → 装完 → 发车 → 到达卸货点 → 签收
电子围栏：进出仓库/客户园区自动触发状态变更
回单管理：纸质回单拍照存档 + 电子回单在线确认 + 回单超时预警

7️⃣ 在途监控

GPS/北斗实时轨迹 + 电子围栏 + 偏离路线预警
冷链温度 IoT 对接（0-4℃ 断链即告警）🔑
停留超时 / 异常停车自动预警
轨迹回放 + ETA 动态修正
货主小程序自助查单 + 到达/签收自动推送

8️⃣ 签收 & 异常

扫码签收 / 短信签收 / 客户电子确认 / 拒收登记
异常一键上报：晚点 / 货损 / 少货 / 堵车 / 改址
异常流程：上报 → 责任判定 → 改派 → 赔付 → 闭环
异常归因：司机 / 货主 / 仓库 / 不可抗力

9️⃣ BMS 计费（3PL 利润核心）🔑

3PL 的 TMS 没有 BMS 就等于"只干活不算账"。

应收（向货主）：
- 按合同 Tariff 自动算：基价 + 附加费 + 超时罚款 + 拒收扣款
- 分货主月度账单
应付（向司机/外协）：
- 自有车：底薪 + 趟次 + 油补 + 绩效
- 外协：竞价成交价 + 异常扣款
运费审计：比对合同价 vs 实际费用，识别重复计费/附加费错误
自动稽核：每天跑批，异常标红 → 争议管理流程

🔟 报表 & BI（控制塔）

参考零售 OTWB 控制塔指标，3PL 城配建议盯这些：

维度	核心 KPI
调度效率	排线耗时、人工微调率、算法采纳率
运力利用	车辆周转率、装载率(目标≥85%)、外协占比
服务质量	SLA 达成率(分货主)、准时率、拒收率、投诉率
成本	单均运费、空驶率、外协溢价率、油费/公里
财务	应收账期、应付账期、费用异常率、业财自动对接率

三、多端协同（OWTB 不止 Web）

端口	核心功能
调度 Web 端（OWTB 主工作台）	订单池 / 智能排线 / 派车单 / 大屏
货主小程序/门户 🔑	自主下单 / 查单 / 改单 / 对账 / 申请售后
司机 APP	接单 / 导航 / 提货拍照 / 送货拍照 / 电子回单 / 异常上报 / 运费对账
仓库 PDA	装车复核 / 扫码验货（若 WMS 独立则由 WMS 管）
大屏（控制塔）	全国/区域全景：订单/车辆/异常红黄灯

四、P0 / P1 / P2 落地分级（对照 yudao 节奏）

✅ P0 地基（Sprint 1-2，没它跑不起来）

委托客户(tenant扩展) + 合同 SLA 框架 🔑
订单接入(Excel/API) + 地址 geocoding
运力档案(自有车+司机) + 外协基础表
派车单 CRUD + 司机 APP 最小集(接单/回单拍照)
复用 yudao system多租户 + infra文件/定时

✅ P1 核心竞争力（Sprint 3-5，3PL 差异化就在这）

OWTB 调度工作台三栏布局（订单池+地图+派车单）
tms-scheduler算法服务（OR-Tools Python + 高德距阵）
静态排线 T-1 Job + 动态插单增量重算
BMS 计费规则引擎 + 应收应付自动算 🔑
在途 GPS + 异常三级告警

✅ P2 进阶（Sprint 6+，拉开差距）

外协运力竞价 + 众包接入
冷链 IoT 温度对接 + 断链预警 🔑
客户门户自助对账 / 账单下载
运费审计自动化（合同价 vs 实际）
多仓多货主 WMS 联调（若 3PL 同时管仓）
强化学习动态调度 / what-if 仿真

五、对照 yudao-cloud 的 module 划分建议

复制代码

yudao-module-oms   (可选，若 WMS 也自建则必建)
yudao-module-wms   (可选，3PL 多货主仓)
yudao-module-tms   (必建：订单/运力/派车/回单/异常)
yudao-module-bms   (必建：3PL 计费，扩展 pay)
tms-scheduler      (独立服务：OR-Tools + 高德距阵)

OWTB 工作台本身只是 yudao-module-tms的一个前端 menu + 一组 controller ，但它调用的"排线接口"在 tms-scheduler，"计费回写"走 bms，"多租户隔离"吃 system------这就是为啥前面坚持让你把算法独立成服务。