feat: /qe-fleet run 安徽运八需求 + 系统坑修复

系统修复: - 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 - 确认结论文件已归档
2026-07-13 09:49:54 +08:00
parent b958b75899
commit acdb441507
77 changed files with 4134 additions and 1597 deletions
@@ -0,0 +1,206 @@
+# 运八网络货运平台 - 操作手册
+
+> 本文档基于 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条 |