Yb-QaAutomationHub/原型评估_滇中好运物流云_20260917/01_原型盘点.md

# 01 原型盘点 — 滇中好运智慧物流协同平台 0.2.0

> 来源：demo.kmshuangmiao.com 前端产物逆向（主应用 `main-BZrhSiwe.js` + `waybill-center` 子应用），抓取日期 2026-09-17。
> 原型状态：纯前端 Mock（`__DZH_HTTP_MOCK__ = true`），状态依据飞书《业务表清单》《业务节点对比》《菜单对比》revision 213，产品名《滇中好运物流云》。大量字段标注"待确认"，属于**客户讲解/评审演示原型**，非可实施产品。

## 1. 总体架构

**双系统（同一账号体系内切换视角）**

| 系统 | systemKey | 定位 | 角色（8/7 个） |
|---|---|---|---|
| 物流云 | `logisticsCloud` | 统一调度平台（唯一数据枢纽），承接呈钢 ERP 业务与三方业务 | 系统管理员、供货商（呈钢）/呈钢业务员、货主/货主业务员/货主财务、调度主管、调度员、平台调度-客服/安全、平台调度-核算专员、平台调度-财务管理 |
| 中闽 | `zhongmin` | 特殊物流公司（自营车队 + 资产 + 内部成本财务），接受物流云委托 | 系统管理员、运营、计划员/调度员、核算专员、财务、车队长、资产管理员 |

- 物流云视角范围声明：*只展示呈钢 ERP 来源业务及物流云本组织资料；中闽自有业务、车队、资产、成本和内部财务明细不下发*。
- 其他承运商（好运、**运八**、云岭、博成、安达、顺达等）只作为**运力池准入租户**出现，不拥有独立工作系统（角色体系中仅有"运输公司调度"泛称）。
- 另有司机端概念：司机 App（提交资质申请、装/卸货打卡、回单、在途费用上报），无独立原型界面（waybill-center 内嵌手机样机演示）。

**子应用**：运单中心 `waybill-center`（独立页面，`embedded=1` 嵌入主应用），承载运单管理/监控/异常三个一级入口，含费用录入、改派、退换货、轨迹详情、发运生命周期等十余个特性脚本。

## 2. 菜单结构（17 组 / 49 模块，双系统按权限投影）

- **经营分析**：经营分析与报表（reportSnapshots，金额无确认规则时显示"待确认"）
- **经营工作台**（role-workbench/dashboard）：货主、调度、财务、物流公司四类工作台
- **计划调度**：发货计划（sourceOrders，货主/ERP 代录/客户自提）、调度计划（materialPlans，拆分/合并/铁路）、配载与派车（loading）、装车计划（dispatches）、分派承运（carrier）
- **运单中心**：运单（driverTasks）、履约监控（fulfillmentMonitoring）、异常管理（exceptionCases）、接收通知（dispatchNotifications）
- **运力中心**：运力池（capacityPool）、资质管理（qualificationReview）、车辆资质校验结果（qualificationResult）
- **配载中心**：装车计划资质门禁
- **履约协同**：凭证中心（voucherChains，回单/凭证链）
- **客户合同**：货主管理（businessSubjects）、项目台账（projects）、合同台账（contracts）
- **价格管理**：价格台账（priceBases，片区运价/项目一口价/调价待审核版本）
- **基础资料**：货物/货物分类、站点与地址、路线档案、铁路站点、铁路运价、倒短费
- **核算结算中心**：核算管理、结算申请、结算管理、结算对账、收付准备、收付款记录、付款批次、发票管理、在途费用、罚款台账、财务关单、财务管理
- **财务协同/结算核算**：铁路运费对账（车皮级，次日导入铁路局 PDF 回填）
- **报表中心**：运营/资产/成本/司机工资/财务报表、利润分析
- **接口中心**：接口配置（interfaceDefinitions，本期仅呈钢 ERP）、接口任务（externalExchangeTasks，交换/回执/重试）
- **安全审计**：审计事件（auditEvents）、操作日志（operationLogs）
- **系统管理**：租户管理、组织架构、用户账号、角色管理、导出历史
- **中闽独有资产模块**：车头/车挂/司机管理、维保、保险到期、罚款、油卡管理、新能源资产（车电分离）、停运、成本归集等

## 3. 业务主线（原型闭环）

```
呈钢ERP/货主/运八代录 → 发货计划(sourceOrders)
  → 调度计划(materialPlans, S1呈钢/S2昆铁倒短/S4三方直委中闽; 拆分/合并)
  → 装车计划(dispatches, 承运模式: 中闽自营车队/指定合作承运商/待调度分派)
      ↳ 资质门禁(qualificationResult): 单人+单车组合 OCR 机审通过才可生成运单
  → 运单(driverTasks): 待核价→已开单→装货中→待发货→运输中→已卸货→核算中→结算中→已付款→财务关单
      ↳ 司机App: 装货打卡/卸货打卡/回单上传/在途费用上报(电费/装卸/过磅/ETC/路桥/其他)
  → 履约监控: 车辆位置+路线轨迹(高德地图Mock)+异常处置+运输台账
  → 凭证中心: 回单审核(退回/补传/复核, 不覆盖历史)
  → 核算(上游/下游独立, 磅单+回单+最终审核值齐全才放行, 调价留痕)
  → 结算申请→结算管理→结算对账→付款批次(线下全额付款登记)→收付款记录(冲正机制)
  → 发票管理(进项/销项登记, OCR, "线下结果的线上登记候选, 不连接真实税务")
  → 财务关单(月度勾稽+人工关账)
```

## 4. 关键机制细节（与运八对比相关）

- **资质管理**：以"司机+单车"组合为审核主体；司机 App/物流公司提交 → 资料冻结 → OCR 机审（道路运输证影像过期会阻断装车计划且不生成发货单）→ 物流云运营抽检 → 组合可运输门禁。*原型自注：正式 OCR 字段、车型匹配规则、抽检比例及运营角色映射待确认。*
- **轨迹**：履约监控用高德地图展示车辆位置与路线轨迹（Mock 数据）；"轨迹数据来源""定位不可用处理"仅为待确认的口径配置项；**无北斗/车载终端接入**；运单时效靠司机 App 装卸打卡。
- **发票**：进项/销项两条线，字段含发票类型（电子增值税专用/普通）、税率、价税合计、OCR 识别（有 OCR-FAILED 演示数据）、一票多批次分摊；**明确声明不连接真实税务，无代开、无红冲链路、无个税**。
- **资金**：付款批次"登记线下全额付款结果、付款凭证和发票进度……不支持部分付款，**不执行真实资金操作**"；收付款记录同。无支付通道、无银行存管、无分账。
- **合同**：合同台账登记原始合同及增补，附件 OCR 预填，"不采集结算依据"；**无电子签约**。
- **异常**：司机主动上报或系统识别，责任岗位+处理时限+复核闭环；缺货通知仅调度内部可见。
- **接口**：接口配置目前仅呈钢 ERP（发货计划/项目/价格等）；接口任务管理发送/回执/失败/重试。**网络货运平台明确排除在本期接入范围外。**
- **运八在原型中的存在方式**：
  1. 运力池承运商租户 `carrier-yunba` = 云南运八物流科技有限公司；
  2. 发货计划来源类型："运八调度"角色录入 → 标记为"运八授权代录"；
  3. 核算管理范围声明："参考 Demo 的运八样例数据未迁入；当前仅复用其已评审核算规则，并适配呈钢、昆铁和中闽现有业务对象"；
  4. 工作台数据过滤把 YUNBA/-YB-/运八 命中的数据标为 OUT_OF_SCOPE。

## 5. 原型空白清单（关键词全文检索为 0）

监管/省级监测、北斗、投诉、评价体系、电子签、个税、代开、货源大厅/竞价/招标、多式联运、甩挂、超载/超限管控。
（"危险货物"仅货物档案上的一个 `dangerousGoodsFlag` 标记，无承运管控流程；"信用"仅统一社会信用代码字段。）