Files

T

xst 5e4e978cd5 chore: 入库 9 月积压成果（滇中好运原型评估、小象开票需求与原型、工具配置）

- 原型评估_滇中好运物流云_20260917/：物流云原型评估产物（含核对表与字段对比表）
- requirements/小象开票收款方创建需求.md + prototypes/小象开票原型.html：小象开票建司机/车辆/收款信息需求
- requirements.txt：Execute 战区依赖调整（移除 pytest/allure-pytest/requests，改用 pytest-html，Appium 默认注释）
- .claude/launch.json：新增物流公司管理原型预览服务（wuliu-proto:8138）
- .agents/skills：agent 技能定义

2026-09-29 10:03:43 +08:00

7.7 KiB

Raw Permalink Blame History

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 标记，无承运管控流程；"信用"仅统一社会信用代码字段。）

7.7 KiB Raw Permalink Blame History Unescape Escape