黔城快配
城市配送管理系统
客户订单 · 外协运力 · 4.2米报价 · 贵阳线路 · 车辆维保 · 应收应付 · 单车经济账 · 回单签名 · GPS/ETA · AI决策 · 外部平台接入
黔城快配管理系统使用手册
版本: 2.3.2 交付日期: 2026-11-03 云端地址: <https://www.y2ksoft.cn/guiyang-logistics/> 适用业务: 以贵阳为中心,通过自有/外协资源向贵州省地州市及县份配送货物,4.2米高栏为主力车型。
---
一、登录、初始化与角色说明
系统采用服务端登录会话:
- 首次打开显示“初始化系统管理员”,由客户现场创建管理员账号。
- 密码必须至少10位并同时包含字母和数字。
- 密码使用 scrypt 加盐哈希保存,不在数据库保存明文。
- 登录状态使用 HttpOnly、SameSite=Strict Cookie。
- 连续登录失败10次会触发15分钟频率限制。
- 首次初始化完成后,所有业务 API 都必须登录。

- 品牌与业务范围:展示贵阳中心仓、8个市州、80条县区/同城参考线路、20个业务模块和AI决策能力。
- 管理员账号:首次初始化时自行设置用户名。
- 安全密码:至少10位,同时包含字母和数字。
- 登录或初始化:首次创建管理员并进入系统,后续使用同一表单登录。
登录后右上角提供“修改密码”。修改成功后其他设备的会话立即失效,当前设备自动续签。
系统主要角色:
| 角色 | 主要页面 | 工作内容 |
|---|---|---|
| 系统管理员 | 全部模块 | 账号、业务、AI决策、备份恢复和系统接入 |
| 调度员 | 驾驶舱、货源、车货匹配、订单、司机、跟踪、线路、车辆、维保、费用、单车经济账、报表 | 接客户订单、匹配外部资源、推进节点、处理异常 |
| 财务 | 驾驶舱、应收货款、司机应付、单车经济账、费用、利润、报表 | 收款核销、司机应付结算、成本归集和利润核对 |
| 外协司机 | 司机接单、在途跟踪 | 查看平台货源、接单、定位、提货、在途、送达、回单和异常上报 |
调度员每天怎么用
- 登录后先看驾驶舱:预警灯、待调度订单、可用车辆和未收货款。
- 进入“货源大厅”核对今天客户要发的货物。
- 对待调度订单做车辆匹配并指派。
- 在“司机接单/在途跟踪”检查提货、在途和送达情况。
- 对已送达的货到付款订单,在“应收货款”登记收款。
- 下班前检查逾期应收、维修车辆和AI高风险决策。

- 左侧导航:共20个业务模块,待调度、AI高风险和未完成维保会显示数量角标。
- 经营 KPI:应收、履约成本、预计毛利、待调度订单和可用车辆。
- 预警区:显示保养、保险、待调度订单及货拉拉授权状态。
- AI决策简报:显示当前最优先的4项AI建议,可进入AI决策中心处理。
1.1 图表怎么读
经营报表已统一采用与院陪诊师管理系统一致的本地 Chart.js 图表体系,取消重复饼图、矩形柱图和旧力导向/旭日图。
| 图表 | 怎么看 |
|---|---|
| 收入、成本与毛利趋势 | 金色为收入、粉色为成本、绿色为毛利,金额点位常驻显示 |
| 订单新增与完成趋势 | 青色为新增订单、绿色为完成订单,点位显示每日订单数 |
| 经营燃尽图 | 实际剩余订单与理想燃尽线对比,超线表示交付压力增加 |
| 核心线路收入趋势 | 收入前四线路逐日对比,不同颜色区分线路 |
| 费用项目走势 | 油费、过路费、维保、停车费等项目逐日金额趋势 |
| 资源能力雷达 | 准时率与综合评分双轨对照,评分按5分制折算到100分刻度 |
所有图表都显示具体数字;颜色和动效仅用于提示,不替代账务口径。

- 从左侧“财务管控”进入“经营报表”。
- 顶部四张KPI显示有效订单、业务收入、综合成本和预计毛利。
- 收入、成本与毛利趋势同时展示三条线,点位直接显示金额。
- 订单新增与完成趋势用于观察业务进入和结束节奏。
- 经营燃尽图比较实际剩余订单与理想燃尽线。
- 向下滚动可查看核心线路收入、费用项目走势和资源能力雷达。
- 图表下方仍保留线路经营汇总表,数字口径与图表一致。

- 核心线路收入图比较主要目的线路的逐日贡献。
- 费用项目走势按类别展示真实登记费用,不再使用扇区面积估算。
- 资源能力雷达同时显示准时率和服务评分。
---
二、AI决策中心
系统采用“规则风险模型+可选大模型总结”的混合架构。AI参与报价审查、订单风险、车辆保养、费用异常、外协匹配和利润保护,但任何报价调整、派车、维保生成都必须人工确认。

- AI扫描决策数量:显示全部决策、高风险决策和可执行建议。
- 决策原因和置信度:每项决策都说明触发原因、业务实体、风险等级和置信度。
- 人工确认后执行:点击后再次确认,系统会记录决策编号、执行人、时间和业务变化。
- AI操作审计:所有采纳动作进入审计链,便于追溯。
AI可参与的业务动作:
- 待调度订单匹配最优外协车辆。
- 低毛利或亏损订单建议调整报价。
- 车辆保养里程临近时生成维保工单。
- 保险临期和合规风险提醒。
- 油费异常、单车费用异常和路线消耗偏差。
- 亏损线路和资源结算风险预警。
AI决策怎么执行

- 阅读AI给出的标题、原因、置信度和建议摘要。
- 点击“采纳并执行”,系统弹出二次确认。
- 再次核对影响范围后点击确认。
- 系统自动写入业务数据和AI审计记录;如果不想执行,点击取消。
---
三、客户订单与货源管理
系统按“客户提供货物、外协资源实际承运”的模式设计。订单来源包括客户直单、外协资源、平台货源和人工导入。

- 状态筛选:查看待调度、已指派、在途、已送达、异常等货源。
- 新增客户订单:手工录入客户、货物、装卸地址、重量、体积、报价和外协结算价。
- 订单卡片:显示线路、载重、体积、提货时间和预计毛利。
- 去匹配:待调度订单进入车货匹配页面,选择可用外协车辆。
新增订单步骤
- 点击“新增客户订单”。
- 填写客户名称和货物名称。
- 选择目的城市,填写装货地址和卸货地址。
- 填写重量、体积、客户报价和外协结算价。
- 选择提货时间和预计送达时间。
- 选择付款方式、收款到期日和收款负责人。
- 点击“保存订单”,订单进入“待调度”。
新增订单表单说明

- 客户名称:填写实际货主或收货企业。
- 货物名称:填写便于司机识别的货物名称。
- 付款方式:货到付款、月结、现结、预付、回单结算或代收货款。
- 收款到期日:用于应收逾期判断;货到付款通常填送达当天。
- 客户报价:本单客户应付金额。
- 保存订单:保存后进入待调度,并记录应收和AI订单审查。
---
四、车货匹配与外协派单

车货匹配分数由以下因素组成:
- 车辆状态 30%
- 载重是否满足 20%
- 体积是否满足 15%
- 车辆当前位置与线路匹配 15%
- 资源评分、准时率、区域覆盖 20%
操作步骤:
- 在“货源大厅”选择待调度订单,点击“去匹配”。
- 或在“车货匹配”页面顶部选择待调度订单。
- 系统按匹配度从高到低显示可用车辆、司机和外协资源。
- 核对外协结算参考价后点击“确认指派”。
- 订单变为“已指派”,车辆和司机自动写入订单,司机可在“司机接单”工作台继续操作。
---
五、4.2 米高栏报价

- 标准线路:选择贵阳至遵义、六盘水、安顺、毕节、铜仁、凯里、都匀或兴义。
- 目的县区/同城区域:可选择80条县区/同城参考线路,包含68个县区、8个市州中心及4个贵阳同城线路;参考里程约数±10%,大额订单必须导航复核。
- 货物重量:4.2米蓝牌高栏默认校验1.5吨,总质量4.495吨;最终以车辆行驶证核定载质量为准。
- 货物体积:4.2米高栏/平板约21m³,厢式约18m³;轻抛货重点看方量和装载率。
- 车型与道路:可选择高栏、厢式或平板,并选择高速或国道;国道按里程1.28倍和13.8L/100km估算。
- 平台/信息费:客户直单可填0;平台货源参考8%。报价结果同时显示货拉拉、运满满、专线、个体车、客户直报和成本保护六类锚点。
- 保存/复制报价:可保存报价并生成AI审查,也可复制客户报价话术直接发微信。
报价支持五种模式:
- 智能推荐
- 整车趟价
- 公里价
- 吨公里
- 方公里
系统计算逻辑:
客户报价 = max(成本保护价, 客户直报参考下限, 平台/专线行情, 当前计价模式结果)
成本 = 油费 + 过路桥隧费 + 司机工资 + 维保轮胎 + 保险折旧
+ 装卸费 + 等候费 + 返空补偿 + 平台服务费 + 风险准备金
系统同时展示高速和国道方案:
- 高速按里程、油费、过路桥隧和时效计算。
- 国道里程按约1.28倍估算,过路费为0,但油耗和司机时间增加。
- AI/成本模块给出推荐路线以及硬成本差、额外耗时。
金额全部按整数“分”计算,显示两位小数。客户报价生成后可点击“报价转订单”,直接进入客户订单录入页。
---
六、贵阳线路里程库

- 配送网络图:展示贵阳中心仓及 8 个地州市方向。
- 线路底表:显示推荐驾驶里程、预计时间、高速走廊、参考油费、参考路桥、市场参考趟价和返程参考。
- 用此线路报价:自动把该线路里程带入 4.2 米报价器。
标准里程如下:
| 目的地 | 里程 km | 预计时间 |
|---|---|---|
| 遵义市 | 150 | 2.9 小时 |
| 六盘水市 | 245 | 4.7 小时 |
| 安顺市 | 90 | 1.8 小时 |
| 毕节市 | 180 | 3.5 小时 |
| 铜仁市 | 325 | 6.1 小时 |
| 凯里市 | 185 | 3.6 小时 |
| 都匀市 | 145 | 2.8 小时 |
| 兴义市 | 305 | 5.7 小时 |
系统内置80条县区/同城参考线路,并显示高速参考里程、国道估算里程、可信度和四重价格锚。数据来自2026-10-26版《贵州4.2米货车报价系统_v3》《贵阳货运运价报价单》和2026-10-22运费查询报告,属于参考数据;单趟超过500元必须电话询价2~3家并用导航复核。
---
七、外协司机接单

- 选择车辆:切换当前司机/车辆身份。只有空闲车辆可以接单。
- 可抢货源:显示待调度订单和司机/外协结算金额。
- 立即接单:订单自动变为“已指派”,同时写入车辆、司机和外协资源。
- 推进运输节点:按“提货 → 在途 → 送达”推进;送达后可进入结算。
司机发现车辆故障、货损、延误或客户拒收时,点击“上报异常”。系统会把订单标记为异常并通知调度中心跟进。
7.1 司机GPS定位与ETA

- 司机进入“司机接单”,找到自己的运输任务。
- 点击“上报当前位置”;手机浏览器会申请定位权限,必须选择“允许”。
- 系统保存经纬度、定位时间和精度,并按当前位置到目的地城市中心点估算剩余里程。
- ETA按约55km/h行驶速度和30分钟缓冲估算;它只用于调度参考,实际到达以司机确认和签收为准。
- 定位上报成功后会显示在司机工作台、订单详情和“在途跟踪”页面。
- 司机只能在绑定车辆的本单上定位,不能给其他车辆或订单上报位置。
7.2 回单照片、货损照片与电子签名

- 在订单详情点击“上传回单/照片/签名”。
- 选择装货照片、卸货照片、签收单、货损照片、电子签名或其他。
- 普通照片直接调用手机相机或相册,支持JPEG、PNG、WebP,单张不超过5MB。
- 电子签名可在画板上用手指或鼠标手写;空白签名不能保存。
- 点击“保存附件”,系统记录上传人、上传时间、订单号和附件类型。
- 司机只能打开本人车辆订单的附件;管理员可在完整业务备份中保留附件文件和元数据。
系统可作为手机浏览器/PWA使用,支持添加到手机桌面。桌面端和手机端共享同一业务数据。
---
八、车辆管理

- 状态筛选:按空闲、在途、维修、保养、停用筛选车辆。
- 新增车辆:维护车牌、车型、归属、外协资源、司机、载重、容积、保险和年检信息。
- 车辆卡片:查看车辆、司机、当前位置、里程、累计登记成本和保养剩余里程。
- 登记费用:直接为车辆登记油费、过路费、停车费等。
系统在以下情况产生预警:
- 距下次保养不超过 3000km
- 保险或年检即将到期
- 车辆处于维修或保养状态
- 车辆停用
---
九、维修保养

- 筛选状态:查看待保养、保养中、维修中、已完成。
- 新建维保工单:选择车辆、维保类型、状态、到期日期/里程、维修厂和预估费用。
- 查看工单:核对预估费用、实际费用、到期里程和问题描述。
- 完成并释放车辆:完成工单后车辆恢复空闲,实际维修费用自动写入费用中心。
新建维保工单

- 选择车辆。
- 选择保养、轮胎、制动、发动机或事故维修类型。
- 选择待保养、保养中或维修中。
- 填写到期里程、维修厂、预估费用和问题描述。
- 保存后车辆状态自动联动,AI同步检查到期里程和高额维修风险。
维修保养与车辆状态联动:
- 新建“维修中”工单后,车辆自动变为“维修”。
- 新建“保养中”工单后,车辆自动变为“保养”。
- 完成工单后,车辆自动恢复“空闲”。
---
十、费用中心:油费、过路费等

- 费用构成图:按油费、过路费、维修保养、停车费等分类统计。
- 按车辆筛选:查看单车费用。
- 登记费用:填写车辆、费用类型、金额、日期、关联订单、油量和当前里程。
- 费用明细:所有费用进入订单成本和车辆成本,不再另设重复台账。
费用中心支持:
- 油费
- 过路费
- 停车费
- 维修保养
- 装卸费
- 洗车费
- 保险
- 罚款
- 其他
登记费用表单

- 选择车辆。
- 选择油费、过路费、停车费等费用类型。
- 输入实际金额。
- 关联订单,便于计算订单利润。
- 输入当前里程,系统同步车辆保养提醒。
- 保存后费用进入车辆成本和订单成本。
---
十一、应收货款与货到付款

- 未收余额:显示客户尚未支付的货款和货到付款待收金额。
- 登记收款:按订单填写本次到账金额、收款方式、凭证号和备注。
- 订单收款核销:支持部分收款、全额收款、逾期、争议和已核销。
- 应收与已收明细:每单明确应收、已收、未收、到期日和收款负责人。
支持的付款方式:
- 货到付款
- 月结
- 现结
- 预付
- 回单结算
- 代收货款
核销规则:
未收金额 = 客户应收 - 已收金额
本次收款不得超过未收金额
累计收款达到应收金额后自动变为“已收”
所有收款进入“最近收款记录”,并保留凭证号、收款人、时间和备注。AI会自动识别已送达但未收款的货到付款订单、逾期订单和争议订单。
登记收款操作

- 选择待收订单,系统自动显示未收金额。
- 输入本次实际到账金额,可以只收部分。
- 选择收款方式。
- 填写银行流水、现金收据或回单编号。
- 点击“确认收款并核销”。
- 部分收款显示“部分收款”;累计达到应收金额后自动变为“已收”。
---
十二、司机与外协应付

司机应付与客户应收分开管理:客户报价属于应收,外协司机/车队结算价属于应付。系统不会用客户未收款直接冲减司机应付款,也不会重复计算同一订单的履约成本。
- 应付总额:按订单外协结算价汇总。
- 登记结算:选择订单,填写本次付款金额、方式、凭证号和备注。
- 按订单付款:每笔付款绑定订单,自动累计已付和未付。
- 结算记录:保留付款时间、司机/资源、金额、方式和凭证,便于财务追溯。
司机结算表单

- 选择待结算订单,核对司机和外协资源。
- 输入本次结算金额,可部分付款。
- 选择银行转账、微信、支付宝、现金或预支抵扣。
- 填写银行流水或收据编号。
- 确认后订单状态变为“部分结算”或“已结算”,并禁止超过未付金额付款。
---
十三、利润核算

- 毛利与毛利率:汇总客户应收、履约成本和毛利。
- 线路毛利图:按目的城市比较盈利水平。
- 订单成本利润明细:逐单显示客户报价、履约成本、毛利、毛利率和承运资源。
计算公式:
订单毛利 = 客户报价 - 履约成本
订单毛利率 = 订单毛利 ÷ 客户报价 × 100%
发现亏损订单时,应优先检查:
- 外协结算价是否过高。
- 实际重量/体积是否超限。
- 是否产生额外等候、装卸或返空费用。
- 线路里程是否与实际地址不符。
订单详情如何看

- 顶部查看客户、货物、装卸地址和载重体积。
- 中间查看履约节点、付款状态、已收和未收金额。
- 点击“登记收款”直接完成回款核销。
- 点击“推进到下一状态”完成提货、在途、送达和结算。
13.2 单车经济账

- 进入“单车经济账”,可选择“自购电车·城配5趟”“自购电车·城配6趟”“自购柴油·专线”和“帮人开车基准”。
- 修改工作天数、日均趟数、单趟收费、车贷、保险、油耗/电耗、维保、装卸费、平台费、自己的工资和对比工资。
- 系统计算月流水、现金结余、扣自己工资后的利润、与帮人开车的差额。
- 同时计算单趟贡献、现金保本趟次/天、挣到自己工资所需趟次/天和首付回收周期。
- 点击“保存当前测算”后参数写入服务端,进入备份和审计,不会只留在某台手机浏览器里。
- 模型未计入事故、违章、货损赔付、淡季空档和车辆大修,实际决策应额外预留10%–15%安全垫。
---
十四、货拉拉及外部平台接入

- 货拉拉企业版 API:支持城市、车型、询价、下单、订单轨迹、账单和发票能力。
- 检查授权:读取服务端配置状态,不在浏览器保存密钥。
- 接入边界说明:明确凭证、官方授权和非公开接口限制。
已开发的服务端接口
GET /api/connectors/huolala/statusPOST /api/connectors/huolala/testPOST /api/connectors/huolala/citiesPOST /api/connectors/huolala/city-infoPOST /api/connectors/huolala/quotePOST /api/connectors/huolala/ordersPOST /api/connectors/huolala/order-detailPOST /api/connectors/huolala/driver-location
凭证配置
货拉拉正式联调前,需要设置服务端环境变量:
$env:HUOLALA_APP_KEY="商务提供的app_key"
$env:HUOLALA_APP_SECRET="商务提供的app_secret"
$env:HUOLALA_ACCESS_TOKEN="用户授权得到的access_token"
npm start
或由部署系统注入同名环境变量。密钥不能写入 app.js、JSON 数据或浏览器 LocalStorage。
重要边界
- 货拉拉官方 API 是企业系统“向货拉拉询价/下单/查轨迹”的接口。
- 把货拉拉司机端订单池直接导入本系统供司机抢单,需要货拉拉专项平台合作授权。
- 未取得授权前,只能使用自有客户订单、外协资源和人工导入货源。
- 满帮、运满满、快狗打车等平台需逐个完成商务确认,系统已预留适配器位置。
- 不允许通过抓包、爬虫或非公开接口获取外部订单。
---
十五、系统设置

- 导出完整备份:下载包含订单、车辆、外协资源、维保、费用、报价、收款、AI审计和回单附件的JSON文件。
- 导入备份恢复:选择系统导出的JSON备份。导入前服务端会自动保存当前完整数据副本,包含附件文件。
- 一键重置系统:恢复初始订单、车辆、收款、费用和维保数据;执行前强制自动备份,登录账号不会删除。
- 运行和经营参数:查看当前账号、车辆规模、AI引擎、柴油价格、高速费率、司机成本和目标毛利。
系统可从当前一台自有车逐步扩展:新增车辆、外协资源和司机后,车货匹配和成本核算会自动按更多运力计算。
15.1 用户与权限管理

- 新增用户:管理员在“系统设置 → 用户与权限”中创建调度员、财务或司机账号。
- 角色:系统管理员拥有全部权限;调度员不能进入系统设置和用户管理;财务只能访问应收、应付、费用、利润和报表;司机只能查看绑定车辆的订单。
- 车辆绑定:司机账号必须绑定车辆,且同一车辆不能同时绑定两个启用中的司机账号。
- 启用/停用:停用后该账号现有会话失效,不能继续登录或调用业务接口。
- 最后管理员保护:系统不允许停用或降级最后一个启用中的管理员账号。

- 输入司机登录名和司机姓名。
- 角色选择“司机”。
- 必须选择该司机实际驾驶的车辆。
- 设置至少10位且包含字母和数字的初始密码。
- 点击“保存用户”后把用户名和初始密码当面交给司机,并提醒首次登录后修改密码。
15.2 一键重置:先备份,再重置

- 重置清除范围:确认即将恢复的业务对象,重置不是普通“刷新数据”。
- 影响数量:核对当前订单、收款、费用和回单附件数量,避免误操作。
- 自动安全备份:服务端会先保存完整业务快照,包含订单、费用、收款、回单附件和审计记录;登录账号单独保存,不受重置影响。
- 勾选确认:必须手动勾选“我已知晓”,确认按钮才会启用。
- 备份并重置:点击后先备份,再将业务库恢复为出厂演示基线;登录账号、密码和角色权限保留。
重置完成后系统会显示结果回执,不会静默结束:

- 重置结果:明确显示业务数据已恢复初始状态,当前账号仍然有效。
- 数据回执:显示重置前订单、收款、费用和附件数量,便于核对。
- 备份文件名:格式为
backup-before-reset-时间戳.json。 - 立即下载:点击“下载重置前备份”,把文件保存到电脑、移动硬盘或企业网盘,再关闭窗口。
15.3 重置后要找回旧数据怎么办
优先使用重置完成窗口中的“下载重置前备份”。如果已经关闭窗口,备份仍保存在服务端数据目录:
本地:F:\Y2Ksoft系统\11_交通物流\物流TMS干线运输管理系统\data\backup-before-reset-*.json
云端:/var/lib/y2k-guiyang-logistics/backup-before-reset-*.json
找回步骤:进入“系统设置 → 备份恢复导入”,选择该JSON文件。导入前系统还会再生成一份当前数据备份,因此恢复操作同样可回退。
---
十六、手机移动端使用
手机端与电脑使用同一套业务数据,不需要单独录入。推荐司机和外勤人员把系统添加到手机桌面,作为PWA使用。
16.1 手机驾驶舱

- 顶部显示当前页面和快捷报价。
- 页面中间显示应收、成本、毛利、待调度等指标。
- 底部固定5个主入口:驾驶舱、货源、订单、应收和AI。
- 点击底部“更多”可进入车辆、维保、费用、设置等全部模块。
16.2 手机更多菜单

- 以两列大按钮显示全部20个模块。
- 点击系统设置可进入备份和恢复。
- 点击任一模组后自动关闭菜单并进入对应页面。
16.3 手机系统设置

- 下载完整备份。
- 选择备份文件导入恢复。
- 一键重置系统。
16.4 手机司机接单

- 选择当前驾驶车辆。
- 查看货物、线路、提货时间和结算金额。
- 点击“立即接单”。
- 按“提货 → 在途 → 送达”推进。
- 发生故障、延误或货损时点击“上报异常”。
16.5 手机应收货款

- 查看应收、已收、未收和逾期金额。
- 点击“登记收款”进行现金或转账核销。
- 点击订单“收款”可只收当前订单的未收余额。
16.6 司机角色手机界面

- 司机使用管理员创建的个人账号登录,不使用管理员账号。
- 顶部只显示司机业务指标:可接货源、我的任务、已完成和车辆状态。
- 货源大厅显示平台待接订单和司机结算金额,不显示客户报价、利润或其他车辆。
- 我的运输任务显示定位、剩余里程、ETA、推进节点和异常上报。
- 底部只保留“司机接单”和“在途跟踪”两个角色入口。
16.7 手机安装方法
- Android/Chrome:打开系统后选择“添加到主屏幕”。
- iPhone/Safari:点击分享按钮,选择“添加到主屏幕”。
- 手机屏宽下使用底部导航,不显示桌面侧边栏。
- 网络中断时仅能打开已缓存的页面,收款和保存操作仍需联网。
- 定位功能需要HTTPS和手机定位权限;首次使用时必须允许浏览器定位。
---
十七、启动、停止与重置
启动
cd "F:\Y2Ksoft系统\11_交通物流\物流TMS干线运输管理系统"
npm start
浏览器打开本地:
http://127.0.0.1:8765
云端:
https://www.y2ksoft.cn/guiyang-logistics/
首次打开需要创建管理员;系统不预置默认密码。
测试
npm test
npm run test:e2e
重置演示数据
调用:
POST /api/reset-demo
/api/reset-demo 只用于本地演示数据回归;客户界面使用 POST /api/settings/reset,执行前会自动生成 backup-before-reset-时间戳.json,并在响应中返回 backupName 与重置前数据摘要。
备份
修改源码前已保留 .bak 文件。业务数据位于:
F:\Y2Ksoft系统\11_交通物流\物流TMS干线运输管理系统\data\store.json
系统设置中的“下载完整备份”会同时导出业务数据和回单附件文件。手工备份服务器时,建议每天备份以下内容,重大上线前同时备份整个系统目录:
data/store.json
data/auth.json
data/uploads/
其中 auth.json 包含加盐密码哈希,uploads/ 包含回单、照片和电子签名,二者都不得公开下载。
---
十八、常见问题
1. 页面能打开但提示“系统启动失败”
确认 Node 服务已经启动,并检查 http://127.0.0.1:8765/api/health 是否返回 ok: true。
2. 图表空白
系统使用本地 ECharts,不再依赖外部 CDN。若仍空白,刷新页面并清理浏览器缓存;检查 assets/vendor/echarts.min.js 是否存在。
3. 货拉拉显示“待授权”
这是正常状态。需要先完成企业商务合作、开发者应用申请和用户授权,再配置三个服务端环境变量。
4. 司机看不到接单按钮
检查司机工作台选择的车辆是否为“空闲”。维修、保养、停用或在途车辆不能接单。
5. 订单报价明显偏低
检查目标毛利率、外协结算价、返空补偿、等候费和实际里程。客户报价不能低于成本保护价。
6. 货物超重或超方怎么办
4.2米蓝牌高栏默认按1.5吨、21m³校验,总质量按4.495吨提示。实际合规载重以行驶证为准。超限应改派更大车型或分趟,系统不会把超载订单视为正常可派单。
7. 外协车辆发生维修后为什么不能派单
维修或保养工单会把车辆从可用池移除。工单完成后才会恢复“空闲”。
8. 为什么利润看板和外协司机结算金额不同
客户毛利按“客户报价 - 外协结算价”计算;司机看到的是外协结算金额。油费、过路费、维保和司机工资属于外协资源的经营成本,不应在公司经营利润中重复扣减。
9. 手机看不到全部菜单怎么办
手机底部只保留5个高频入口,点击最右侧“更多”查看全部20个模块。
10. 怎样备份和恢复
进入“系统设置”,点击“下载完整备份”保存JSON文件;需要恢复时选择该文件导入。导入和客户界面的一键重置都会先自动备份当前完整数据。
11. 重置系统会删除账号吗
不会。一键重置只恢复业务种子数据并清空当前附件,登录账号和密码保留;执行前系统会强制生成可下载的完整安全备份。
12. 司机为什么看不到其他车辆或其他订单
这是服务端权限隔离,不是页面异常。司机账号只返回绑定车辆的订单、附件和司机结算金额。请检查司机账号是否绑定了正确车辆。
13. 点击“上报当前位置”失败怎么办
先确认手机定位已开启、浏览器允许定位、页面使用HTTPS地址。走到开阔区域后重试;系统会把定位精度超过5000米的记录视为无效。
14. 回单照片为什么上传失败
检查图片是否为JPEG、PNG或WebP,单张是否小于5MB。系统还会校验文件内容与图片格式是否一致,扩展名伪装的文件会被拒绝。
15. 导入备份会恢复哪些数据
会恢复订单、车辆、外协资源、维保、费用、报价、客户收款、司机结算、AI审计和附件文件。导入前服务端会自动写一份包含附件的当前业务数据备份。
---
十九、交付清单
| 交付项 | 路径 |
|---|---|
| 系统入口 | index.html |
| 服务端 | server.js |
| 业务数据 | data/store.json |
| 计价内核 | assets/js/pricing.js |
| 货拉拉客户端 | integrations/huolala.js |
| 使用手册 | docs/使用手册.md |
| 使用手册 PDF | docs/使用手册.pdf |
| 系统设置 | server.js / assets/js/app.js |
| 应收货款与货到付款 | assets/js/app.js / server.js |
| 司机/外协应付台账 | assets/js/app.js / server.js |
| 用户权限与司机数据隔离 | assets/js/app.js / server.js |
| 回单附件与电子签名 | assets/js/app.js / server.js |
| 单车经济账 | assets/js/app.js / server.js / assets/js/data.js |
| GPS定位与ETA | assets/js/app.js / server.js |
| 使用手册截图 | docs/images/ |
| 数据与计价说明 | docs/数据来源与计价口径.md |
| 部署与平台接入说明 | docs/部署与平台接入说明.md |