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

> 本文档基于 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条 |
