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 技能定义
This commit is contained in:
xst
2026-09-29 10:03:43 +08:00
parent 8c61209dd4
commit 5e4e978cd5
14 changed files with 2463 additions and 9 deletions
@@ -0,0 +1,76 @@
# 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` 标记,无承运管控流程;"信用"仅统一社会信用代码字段。)