xst
acdb441507
系统修复: - fleet_runner.py: Windows UTF-8 编码兼容（reconfigure stdout/stderr） - fleet_runner.py: run 命令自动生成合并清单供导出使用 - fleet_manifest.py: 新增 save_merged_manifest() 保存统一清单 - fleet_config.yml: 修复 YAML keywords 格式（block sequence → flow sequence） - 恢复被误删的知识库文件(payment_flow_cases, marketing_activity_cases) QE Fleet 产物 (安徽运八需求): - 153个测试点 + 53条可执行测试用例 - 需求分析/风险评估/测试策略/质量裁决（PASS） - Excel 导出 + 版本快照 v2 - 确认结论文件已归档
207 lines
12 KiB
Markdown
207 lines
12 KiB
Markdown
# 运八网络货运平台 - 操作手册
|
||
|
||
> 本文档基于 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条 |
|