QaAutomationHub/knowledge_base/00_project/operation_manual.md

运八网络货运平台 - 操作手册

本文档基于 2026-07-10 对测试环境 https://ybxcx.ynyun8.com:8000/admin 的实际页面浏览编写。 共采集 352 个菜单项、184 个页面截图。

---

1. 平台端登录

地址：https://ybxcx.ynyun8.com:8000/admin

登录步骤：

1. 打开管理端地址，页面自动加载为 Element UI SPA
2. 确认机构自动选中"云南运八数据科技有限公司"（可从下拉切换其他分支机构）
3. 输入账号 super_admin，密码 951260684NiAn..
4. 完成滑块验证码（从左滑到右，成功后显示绿色"验证成功"）
5. 如触发图片验证码，输入右侧验证码计算结果（数学题如"3+5=?"）
6. 点击"登录"按钮（id=automaticLogon，登录前为 disabled 状态）

登录技术细节：

• 密码使用 RSA 公钥加密后通过 POST /ntocc-basic-api/authorize/encrypt 传输
• HTTP Header 需携带 secret: GouldAMap=d58bb5f7da1aa1d6b78741ded2450f2d
• 登录成功后端返回 Admin-Token Cookie
• 前端使用 Vuex 管理状态（stateKeys: user, permission, enterprise, settings, tagsView, app 等）

首页布局：

• 顶部导航栏（首页/基础信息/整车运输/管理服务/同城运输/增值服务/财务统计/系统管理/资源控制）
• 左侧菜单树（Element UI el-menu，el-submenu 可展开的多级菜单）
• 主内容区（Dashboard 面板 + 路由页面）
• 右侧用户信息（超级管理员，退出登录按钮）

首页 Dashboard 内容：

• 快捷入口卡片：发布货源、订单管理、客服管理、大数据中心、中闽大数据
• 运输流程图（货源发布 → 货源审核 → 货源管理 → 运输核算 → 运单管理 → 预付 → 财务打款）
• 平台车辆总计 / 平台运力(吨)
• 货源单统计（未接单/已接单/已结算/已撤销）
• 运输单统计（待运输/运输中/已卸货）
• 交易数据（充值总额/交易总额/运费总额/开票总额）
• 货源单类型分布（正常单/内容报价单）

---

2. 基础信息模块

2.1 平台管理

• 账号管理 (/basicInfo/platUser/partyManage/partyList)：平台用户列表，支持查询/新增/编辑
• 角色管理 (/basicInfo/platUser/roleManage/roleList)：角色列表，含角色名称/编码/描述/备注，支持权限分配

2.2 货主管理

• 个体货主 (/basicInfo/shipment/shipmentManage/shipmentList)：列表含税源号/交易状态，支持搜索/导出/默认配置
• 货主信息 (/basicInfo/shipment/selfShipmentForm)：个体货主表单录入（含Tab: 基本信息），支持提交/保存草稿
• 企业货主 (/basicInfo/shipment/shipmentCompanyManage/shipmentCompanyList)：企业货主列表
• 企业信息 (/basicInfo/shipment/selfCompanyShipmentForm)：企业货主表单，多Tab：企业信息、发票资质信息、发票信息维护、地址管理、承运服务、员工管理、多客户管理、合同管理、权限管理、快钱账户
• 分账记录 (/basicInfo/shipment/ledgerRecord)：分账流水查询/导出/确认

2.3 承运管理

• 车队管理 (/basicInfo/driver/driverTeamManage/driverTeamList)：车队列表，支持查询/新增/导入/导出/一键开启
• 车队信息 (/basicInfo/driver/selfDriverTeamForm)：车队表单，多Tab：基本信息、车队司机、车队车辆、常跑路线、绑卡/解绑记录
• 司机管理 (/basicInfo/driver/driverManage/driverList)：司机列表，支持查询/导入/导出/一键开账号/批量签署委托合同
• 司机信息 (/basicInfo/driver/selfDriverForm)：司机表单，多Tab：司机信息(含未认证状态)、我的车辆、运单记录
• 平台车辆：平台车辆列表
• 车辆地图：车辆位置实时地图
• 运输停车报警 (/basicInfo/driver/transportParkingAlarm)：停车异常列表

2.4 车辆服务

• 车辆保险 (/basicInfo/vehicleService/vehicleInsurance)：列表含车牌号/保险公司，支持查询/新增/编辑/删除
• 车辆维修 (/basicInfo/vehicleService/vehicleRepair)：列表含车牌号/维修地点/维修金额，支持查询/新增/编辑/删除
• 车辆违章 (/basicInfo/vehicleService/vehicleViolation)：列表含车牌号/违章地点/罚款金额，支持查询/详情
• 车辆事故 (/basicInfo/vehicleService/vehicleAccident)：列表含车牌号/事故地点，支持查询/新增/编辑/删除

2.5 数据字典

• 商品档案 (/basicInfo/dict/goods/goodsType)：货物类型管理
• 单位档案 (/basicInfo/dict/goods/unit)：计量单位，含维护人/更新时间
• 车型/车长/车宽/车高/轴数/吨位管理：车辆规格字典，均含排序号/名称/编辑
• 增值类型 (/basicInfo/dict/extraFeeType)：增值费用配置
• 银行类型 / 快钱银行类型 / 银行编码管理 / 银行网点管理：银行字典维护
• 能源卡类型 (/basicInfo/dict/energyCardType)：能源卡分类，支持新增

2.6 审核管理

• 司机审核 (/basicInfo/review/carrierReview)：司机注册审核，支持开通高德账号/司机身份证上报/查看详情
• 换号审核 (/basicInfo/review/MobilePhoneAudit)：手机号更换审核，含原手机号/新手机号对比
• 车辆审核 (/basicInfo/review/VehicleReview)：车辆注册审核，支持车牌号上报/查看详情
• 货主审核 (/basicInfo/review/shipperReview)：货主注册审核
• 维修审核 (/basicInfo/review/carRepairReview)：车辆维修申请审核
• 开票审核 (/basicInfo/review/financeReview)：发票开具审核，含发票抬头/税号
• 对账审核 (/basicInfo/review/duizhangReview)：运单对账审核，含运费/扣减金额
• 维修流程/开票流程/对账流程：流程可视化配置
• 车队司机 (/basicInfo/review/teamDriverReview)：车队司机审核，含同步运单/开通高德
• 车队车辆 (/basicInfo/review/teamVehicleReview)：车队车辆审核
• 车队审核 (/basicInfo/review/driverTeamReview)：车队长审核，含同步运单/编辑
• 核验审核 (/basicInfo/review/verificationReview)：运单核验，含确认/还原按钮

2.7 商户中心

• 商户管理 (/basicInfo/merchantCenter/merchantManagement)：浦发银行商户
• 快钱 (/basicInfo/merchantCenter/hat99BillManagement)：快钱商户，支持新增商户
• 光大会员列表 (/basicInfo/merchantCenter/everbrightBillMangement)：光大银行会员
• 光大文件 (/basicInfo/merchantCenter/cebFiles)：光大文件上传管理
• 光大监管商户号 (/basicInfo/merchantCenter/merchantAccount)：监管商户配置
• 会员资金明细 (/basicInfo/merchantCenter/memberFundDetails)：会员账户资金
• 光大推送 (/basicInfo/merchantCenter/everbrightPush)：推送记录(含取消选择)
• 光大监管商户 (/basicInfo/merchantCenter/superviseMerchants)：监管商户列表(含新增)

2.8 账户管理

• 余额统计 (/basicInfo/account/Balance)：浦发/快钱账户余额(含实时查询)
• 光大余额统计 (/basicInfo/account/everbrightBalanceStatistics)：光大账户余额
• 账户充值 (/basicInfo/account/recharge)：含短信验证码
• 分账记录/变更记录：账务变动查询
• 提现记录 (/basicInfo/account/WithdrawalsRecord)：含提现编码/金额/标记提现
• 平台公户 (/basicInfo/account/platformHousehold)：银行公户管理(含是否默认)
• 支付流水 (/basicInfo/account/payFlow)：含确认/还原操作
• 支付明细 (/basicInfo/account/remitDefiniteForPay)：含支付凭证/流水号
• 收款编码 (/basicInfo/account/CollectionCoding)：收款方信息管理
• 收款记录 (/basicInfo/account/CollectionRecord)：含同步收款记录
• 车队长收款记录 (/basicInfo/account/driverCaptain)：车队长收款项

---

3. 整车运输（TMS核心）

3.1 货源管理

• 发布货源 (/tms/order/order_publish)：多Tab: 发布货源(含OCR识别)、项目货源、常跑路线、指定车队和司机、指定承运费率。表单含货主搜索/地图选点/货物信息
• 货源管理 (/tms/order/order_hall)：货源大厅列表，含接单方式设置
• 项目货源 (/tms/order/order_project)：多Tab: 常跑路线、指定车队和司机、指定承运费率
• 货源审核 (/tms/order/cargoaudit)：货源审核列表

3.2 运输管理

• 运单跟踪 (/tms/transportManage/waybillManage)：多Tab: 待装货、待运输、待卸货。含批量删除/批量全删
• 运单管理 (/tms/transportManage/Transport)：运单列表，含查询/导出/拆分/开票
• 运单轨迹 (/tms/transportManage)：GPS轨迹查看

3.3 承运结算

流程：运费核算 → 货主打款 → 财务打款 → 回单签收

• 电子回单 / 货主支付
• 合并明细 / 合并付款 / 合并打款
• 财务驳回 / 打款记录 / 运单审核
• 垫资-财务打款：平台先行垫付
• 垫资-货主打款：货主后还款
• 清分列表：结算汇总

3.4 运单异常处理

运单证件异常/业务异常/时长异常/货物重量异常/运费金额异常/轨迹异常/风控异常运单

---

4. 其他业务模块速查

模块	主要页面	说明
能源卡	余额/充值记录/消费记录	能源卡账户管理
加油管理	油站管理/油卡余额/加油记录/油卡消费	油气站服务
货主结算	收款对账/对账列表/收款单据/收款列表	货主端结算
监管上报	司机/车辆/路单/资金上报+异常路单	网络货运监管对接
发票管理	发票索取/列表+滇运通/三十六匠/满货达/浙样红	多渠道开票
客服运维	预警/投诉/评价/轨迹/运单证明	客服工作台
合同管理	货主/承运/货源/委托书/代收协议+三十六匠/车犇	合同全生命周期
同城运输	运单调度/指派订单	短途运输
费用管理	清分结算/运单费用/提现管理/司机费用/月结结算	费用结算
财务统计	自定义表/承运/货主/业务客户/平台客户报表+费用利润	数据报表
增值服务	保险服务(保单查询)+万金油服务(账户/储值/消费)	增值业务
税务管理	平台信息/货主/司机信息/运单上报/授权委托/货主开票	税务对接
ETC管理	企业注册/实时&历史开票/长途分单	ETC全流程
ETC开票	开票申请/记录/红冲/运单ETC抵扣	ETC发票管理
物流金融	放款管理	供应链金融
系统管理	协议/web/司机/货主/委托书+网站门户+消息管理+运维工具	系统配置

---

5. 支付与资金流

货主 →(货主打款)→ 平台账户 →(财务打款)→ 司机/车队长
                                ↓(垫资)
                         平台先行垫付 → 司机
                                ↓(垫资-货主打款)
                         货主还款 → 平台

银行通道：浦发银行 / 快钱 / 光大银行 / 网商银行

---

6. 司机端 APP 核心流程

1. 登录 → 货源大厅浏览 → 接单
2. 车队长派单给司机（或司机自行接单）
3. 到达装货地 → 装货确认（上传装货图片/填写吨数）
4. 开始运输 → 到达卸货地 → 卸货确认（上传卸货图片）
5. 等待结算 → 财务打款 → 提现

---

7. 测试环境信息汇总

项目	信息
管理端地址	https://ybxcx.ynyun8.com:8000/admin
API基地址	https://ybxcx.ynyun8.com:8000/
管理员	super_admin / 951260684NiAn..
车队长	13113113113 / 88888888
司机	15188888888 / 88888888
司机端包名	com.arpa.ynchenggangdriver
机构编码	49adb23841asw3118yunnanchenggang
高德地图Key	Web: d58bb5f7da1aa1d6b78741ded2450f2d
支付方式	arpa_2 (浦发/快钱/光大/网商)
上报省份	28 (云南)
Excel导出上限	20000条