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
- 确认结论文件已归档
This commit is contained in:
xst
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-menuel-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条 |
+208 -57
View File
@@ -1,78 +1,229 @@
# 项目画像(通用基线版,请按项目实际情况维护)
# 运八网络货运平台 - 项目画像
> 用途:为本仓库内测试分析、测试点、测试用例提供项目差异化约束
>
> 使用原则:本文件先提供测试行业常用的通用基线,后续项目落地时必须补充项目真实规则;若与正式需求、产品说明、接口文档冲突,以项目最新确认结论为准。
>
> 用途:为本仓库内测试分析、测试点、测试用例提供"项目差异化约束"
> 维护要求:当架构、业务模式、风控策略、履约策略、权限模型、计费规则等发生变更时,必须同步更新本文件。
> 数据来源:2026-07-10 通过 Playwright 对测试环境管理端在线页面实际浏览采集(352个菜单项、184个页面截图)。
## 1. 项目简介
- 项目名称:待补充
- 项目类型:默认按中后台系统、交易类系统、会员营销系统、内容平台或工具平台中的一种理解,未明确前不得擅自细化。
- 目标用户:默认至少包含终端用户、运营人员、客服/审核人员、系统管理员中的部分角色,具体以项目实际为准。
- 核心业务域:待补充,可从下单、履约、营销、会员、支付、退款、内容发布、审批流等域中选择。
- 当前版本范围:以本次 `requirements/` 下需求文档为准,未写入需求范围的能力默认不纳入本期。
- **项目名称**:运八网络货运平台(YunBa Network Freight Platform
- **所属公司**:云南运八数据科技有限公司(组织机构代码:YNCG)
- **软著版本**:TMS(运输管理系统)
- **项目类型**:网络货运平台(中后台管理系统 + 司机端APP + 货主端)
- **平台官网**www.ynyun8.com
- **客服电话**400-000-2888
- **支付方式**:arpa_2(云企付二期)+ 网商银行(浦发/快钱/光大)
- **网络货运上报**:云南省(reportProvince=28
- **测试环境**
- 管理端:https://ybxcx.ynyun8.com:8000/admin
- API基地址:https://ybxcx.ynyun8.com:8000/
- WebSocketwss://ybxcx.ynyun8.com:8000/
- **测试账号**
- 超级管理员:super_admin / 951260684NiAn..
- 车队长:13113113113 / 88888888
- 司机:15188888888 / 88888888
- **目标用户角色**
- 平台运营人员(super_admin):后台管理与审核
- 货主(托运人):发布货源、管理运单、结算付款
- 车队长:接单并分派给名下司机
- 司机:实际运输执行,上传装卸货资料
- 财务人员:运单打款、资金管理
- 客服人员:订单咨询、异常协查
## 2. 业务边界与禁用能力
## 2. 核心业务域(基于实际在线系统菜单结构)
- 本项目明确不支持的能力:凡需求文档、接口文档、项目说明中未声明支持的能力,默认按“不支持”处理,不得在测试分析和测试用例中臆造。
- 受监管或合规限制的流程:涉及支付、退款、发票、实名、隐私数据、权限审批、操作留痕等能力时,默认认为存在合规要求,测试中需覆盖鉴权、留痕、异常拦截和数据保护。
- 灰度/地域/渠道差异说明:若需求未明确,则默认检查 Web/H5/App/小程序、测试环境与生产配置、不同地域或租户下是否存在规则差异,并将其作为待确认项。
### 2.1 首页 Dashboard
- 平台车辆总计 / 平台运力统计
- 货源单(未接单/已接单/已结算/已撤销)
- 运输单(待运输/运输中/已卸货)
- 交易数据(充值总额/交易总额/运费总额/开票总额)
- 快捷入口:发布货源、订单管理、客服管理、大数据中心、中闽大数据
- 运输流程图展示
## 3. 核心业务规则(项目级)
### 2.2 基础信息 = 平台管理 + 货主管理 + 承运管理 + 车辆服务 + 数据字典 + 审核管理 + 商户中心 + 账户管理 + 彩虹糖
- 结算与支付规则:凡涉及金额、折扣、积分、优惠、手续费、税费、退款分摊时,默认要求金额计算可追溯、展示口径一致、前后端结果一致、重复提交不导致重复扣减。
- 营销与优惠规则:默认检查优惠互斥、叠加优先级、门槛命中、适用范围、失效时间、回滚恢复和异常场景;若项目无营销能力,应在项目化配置中显式写明。
- 风控与权限规则:默认要求关键操作具备角色限制、越权拦截、二次确认或风控校验;高风险动作失败时不得进入成功态。
- 状态流转规则:默认所有核心对象都应具备明确状态机约束,禁止跳状态、逆状态、重复终态处理;异常中断后状态应可解释、可恢复、可追踪。
**平台管理**:账号管理、角色管理(含权限分配)
**货主管理**:个体货主/企业货主列表+表单(含多Tab:发票资质/地址/承运服务/员工/合同/权限/快钱账户等)、分账记录
**承运管理**:车队管理(列表+表单含多Tab)、司机管理(列表+表单含多Tab)、平台车辆、车辆地图、运输停车报警
**车辆服务**:车辆保险、车辆维修、车辆违章、车辆事故
**数据字典**:商品档案、商品类型、单位档案、车型/车长/车宽/车高/轴数/吨位管理、增值类型、银行类型(含快钱)、银行编码/网点管理、能源卡类型
**审核管理**:司机审核(含开通高德/身份证上报)、换号审核、车辆审核(含车牌号上报)、货主审核、维修审核、开票审核、对账审核、车队司机/车辆审核、车队审核、核验审核
**商户中心**:商户管理(浦发)、快钱、光大会员列表、光大文件、光大监管商户号、会员资金明细、光大推送、光大监管商户
**账户管理**:余额统计(浦发/快钱/光大)、账户充值(含短信验证)、分账记录、变更记录、提现记录(浦发/光大)、平台公户、支付流水(含确认/还原)、支付明细(含流水号)、收款编码/记录、车队长收款记录
**彩虹糖**(风控):司机审核、车辆审核、司机比对、车辆比对
## 4. 技术与集成约束
### 2.3 整车运输 TMS(核心业务)
- 关键依赖系统:默认关注认证中心、用户中心、库存/资源中心、支付网关、消息系统、营销中心、风控系统、文件服务、第三方回调服务等;实际未接入的依赖请在项目化配置中删除。
- 外部接口约束:默认按存在超时、重试、幂等、限流、熔断、降级、重复回调、乱序回调、部分成功等风险设计测试。
- 数据一致性策略:若需求未明确,默认按“关键交易结果最终一致、关键扣减与状态更新需具备幂等保护”理解,并将强一致/最终一致边界列入待确认。
**货源管理**:发布货源(含OCR识别Tab/地图选点/指定车队司机/指定承运费率Tab)、货源大厅、项目货源(含创建项目/常跑路线/指定车队司机/指定承运费率Tab)、货源审核
## 5. 高风险场景与历史事故
**运输管理**:运单跟踪(含待装货/待运输/待卸货Tab)、运单管理(含批量删除/拆分/开票/导出)、运单轨迹
- 资损风险点:重复提交、重复支付、重复退款、优惠多减、金额少收/多收、库存超扣、积分或券未正确回滚、并发下重复创建资源。
- 可用性风险点:弱网超时、接口抖动、依赖不可用、消息延迟、回调丢失、页面重复点击、前后端缓存不一致、批量操作部分失败。
- 数据风险点:脏数据兼容、历史数据迁移、空值/默认值污染、精度丢失、跨租户串数据、删除后残留引用。
- 典型线上事故防御策略:默认对核心链路补充幂等、重试、回滚、补偿、审计日志、告警阈值和人工兜底场景。
**预付管理**:预付运费、预付统计、预付记录
## 6. 测试策略偏好(项目定制)
**运单认证核算**:运单证件异常、运单业务异常、运单时长异常、货物重量异常、运费金额异常、待处理异常运单、轨迹异常、风控异常运单、运费核算
- P0 优先覆盖链路:登录鉴权、核心主流程、金额/资源扣减、状态变更、提交确认、异常回滚、查询展示一致性。
- 必测异常场景:参数非法、前置条件不满足、重复点击、并发提交、超时重试、依赖失败、权限不足、状态已变化、数据部分缺失。
- 非功能重点:弱网、超时、高并发、权限隔离、接口幂等、审计日志、性能基线、兼容性、可观测性。
- 自动化优先级建议:稳定且高频回归的核心主流程、历史缺陷高发链路、金额与状态计算逻辑、关键接口鉴权与幂等校验优先自动化。
**运单认证审核**:运单业务异常、运单认证审核、运单时长异常、货物重量异常、运费金额异常
## 7. 需求冲突判定口径
**承运结算**:运费核算、货主打款、异常运单、回单签收、财务打款、财务分账、电子回单、货主支付、合并明细、合并付款、财务驳回、打款记录、合并打款、运单审核、**垫资-财务打款**、**垫资-货主打款**、清分列表
- 什么情况下判定为“冲突”:
- 同一对象在不同需求中出现相反规则。
- 同一阈值、时效、次数、金额口径不一致。
- 同一状态机的起点、终点、流转条件描述不一致。
- 同一角色权限、数据范围、可见性规则前后不一致。
- 新需求声明“沿用旧逻辑”,但实际描述已改变旧规则。
- 冲突处理优先级规则:
- 优先看当前版本正式需求是否显式声明“替换/废弃/继承”旧规则。
- 若无显式声明,优先要求补充版本边界、生效范围、影响模块。
- 若涉及金额、库存、权益、权限、安全、合规,默认按高风险冲突处理,必须在需求阶段确认。
- 需求文档修改建议模板:
- 建议类型:规则合并 / 版本边界补充 / 阈值统一 / 状态机修正 / 权限口径修正 / 异常处理补充
- 建议描述:明确指出当前需求条目、冲突来源条目、冲突点和推荐修订文本方向
- 影响范围:说明影响的角色、模块、接口、数据口径、历史兼容逻辑、回归范围
### 2.4 能源卡管理
能源卡余额、充值记录、消费记录
## 8. 通用输出约束(供测试任务直接使用)
### 2.5 加油管理
油站管理、消费统计、油卡余额、加油记录、油费预付、油卡消费
- 需求分析必须同时覆盖功能目标、边界、角色、前置条件、状态流转、关键规则、风险与待确认项。
- 测试点必须同时覆盖主流程、异常流程、边界条件、数据校验、状态流转、权限控制、并发幂等、弱网超时、历史缺陷防御。
- 测试用例预期结果必须同时覆盖 UI/接口反馈和数据状态变化,不能只写“成功”或“失败”。
- 若需求存在歧义、缺字段、缺状态、缺口径,必须显式输出:
### 2.6 货主结算
收款对账、对账列表、收款单据、收款列表
```md
> ⚠️ 待确认:问题、影响范围、建议确认方向
```
### 2.7 监管上报(网络货运监管平台对接)
司机上报、车辆上报、路单上报、资金上报、业务/时长/质量/金额异常路单
- 对于高风险业务规则,若项目未明确给出,不得基于经验直接写死为真实规则,只能作为风险假设或待确认项输出。
### 2.8 发票管理
- 发票索取、发票列表
- 浙样红、方众数据导出
- 轨迹导出2、轨迹导出
- **滇运通**:运单/资金流水/司机/车辆导出、添加浙样红订单、司机开票
- **三十六匠发票**:轨迹异常运单、司机/车辆/运单/资金上传、上传查询
- **满货达发票**:承运人/司机/车辆/运单上传、运单其他上传、开票结果查询
- **滇运通开票**:承运人/司机/车辆/货源/运单上传、运单其他上传
### 2.9 客服运维
偏离预警、疲劳预警、超速预警、运输异常、评价管理、投诉处理、投诉意见反馈、司机评价、货主评价、撤单统计、轨迹事件、异常运单证明、好运宝车辆状态/日志记录、异常运单申诉/审核
### 2.10 补单管理 + 小象开票
补单操作、车队派单、承运人管理、创建运单
### 2.11 管理服务
- **合同管理**:仓储合同、运输合同
- **运输合同**:货主合同、承运合同、货源合同、委托书合同、代收协议、委托协议书
- **三十六匠协议**:三十六匠协议/承运合同/代收协议
- **车犇协议**:车犇协议/批量导出协议
- **同城运输**:运单调度、指派订单
- **下单管理**:订单开单、批量导入、运单管理、回单确认、异常管理、投诉管理
- **费用管理**:清分结算、运单费用、提现管理、司机费用、月结结算、申请清分
### 2.12 财务统计(报表)
自定义表、承运报表、货主报表、业务客户报表、平台客户报表、货主费用、司机费用、上游费用、电子对账单、运单利润、月度利润、运单开票、首页统计、数据统计
### 2.13 增值服务
- 运输合同(全类型:货主/承运/货源/委托书/代收协议等)
- 保险服务:保单查询
- 万金油服务:账户余额、储值返点记录、消费记录
### 2.14 税务管理
平台信息、货主信息、司机信息、运单上报、授权委托、货主开票
### 2.15 ETC管理 + ETC开票管理
企业注册、实时开票、历史开票、运单上报、长途分单、ETC开票申请/记录、ETC红冲发票查询、ETC开票运单、已抵扣/未抵扣发票、运单开票申请、运单ETC抵扣、ETC抵扣管理
### 2.16 物流金融
放款管理
### 2.17 司机开票管理
开票公司管理、承运人管理、承运人临登查询、运单开票查询
### 2.18 系统管理
- **协议管理**:web协议、司机协议、货主协议、委托书
- **网站门户**:轮播图片、新闻管理、门户信息、门户配置、图片预览、客户案例
- **消息管理**:应用通知管理、短信发送管理、消息推送记录、验证码统计表、司机催款记录、超时异常运单、超时未派单
- **运维工具**:问题咨询、机构管理、自动更新、行为日志、扣费记录、合同模板、操作管理、用户登录/创建记录、光大手工调账、车队长运费任务运维、资源控制
- 其他:导航管理、数据工具、权限创建、修改密码、平台企业、机构充值、机构配置、开票信息、消费记录
## 3. 目标用户与端
| 端 | 平台 | 用户角色 | 主要功能 |
|---|------|---------|---------|
| 运八平台端 | Web管理后台(Element UI SPA) | 运营/财务/客服 | 全部管理功能(352个菜单项) |
| 运八司机端 | Android/iOS App | 司机/车队长 | 接单、运输、上传资料、提现 |
| 运八货主端 | Android/iOS/PC | 货主 | 发布货源、结算、付款 |
- **司机端包名**com.arpa.ynchenggangdriver
- **司机端主Activity**com.arpa.ntocc.MainActivity
## 4. 业务边界与禁用能力
- 营销活动/优惠券/积分体系:本项目不支持(marketing_rules.md标记)
- 司机同时接多单:默认不允许(allowMult=0
- 运输中车队长调单:默认不允许(allowCaptainDispatchInTransit=0
- 装卸货后台操作:默认关闭(loadOrUnloadInBackground=0
- 装货荷载吨数校验:默认关闭(loadTonnageVerification=0
- 重新装卸货:默认不允许(secondUploadDetail=0
- 司机授权协议:默认不需要(needDriverLicense=0
- 蚂蚁区块链/找油网服务:关闭
## 5. 核心业务规则
### 5.1 结算与支付规则
- 支付方式:云企付二期(arpa_2)
- 支持银行:浦发银行、快钱、光大银行、网商银行
- 金额计算必须可追溯,前后端一致,重复提交不重复扣减
- 保费支付人:默认货主支付(insuredPayer=1
### 5.2 运单核心规则
- 运单核心状态机:待运输 -> 运输中 -> 已卸货 -> 已结算 -> 已垫付(垫资)/已打款
- 禁止跳状态、逆状态、重复终态处理
- 异常中断后状态应可解释、可恢复、可追踪
### 5.3 垫资规则
- 垫资运单条件:货主标记垫资 AND 货源标记垫资
- 非垫资运单条件:货主或货源任一未标记垫资
- 垫资流程:平台先行垫付运费给司机 -> 货主后还款给平台
### 5.4 费用结构
- 货主合计付款 = 基础运费 + 服务费
- 能源费:货主配置比例金额,从运费转化为能源费
- 居间费:手动清分车队长收款部分
- 清分司机费用:手动清分司机收款部分
- 车队长收款 = 居间费 + 1%税费
## 6. 技术与集成约束
### 6.1 关键依赖系统
- 认证中心:ntocc-basic-api/authorize(滑块验证码 + 图片验证码 + RSA加密传输)
- 高德地图:定位、轨迹、电子围栏(Web/Android/iOS三端Key
- 银行通道:浦发银行、快钱、光大银行、网商银行
- 滇运通:司机代开发票系统
- 华为OBS:文件存储
- 短信平台
- 三十六匠/满货达/浙样红/车犇:第三方开票/协议平台
### 6.2 技术栈
- 前端:Vue.js + Element UI + 高德地图 JSAPI
- 后端:Spring Boot 微服务(ntocc-basic-api / ntocc-admin-api / ntocc-tps-api等)
- 网关:OpenResty
- 数据库:MySQL + Redis
- 文件存储:华为云 OBS
- 支付:云企付二期
## 7. 高风险场景
### 7.1 资损风险
重复打款/退款、运费/服务费/能源费/居间费/税费计算错误、垫资与非垫资混判、调账金额错误
### 7.2 可用性风险
支付回调丢失/延迟、银行接口不可用、高德地图服务不可用、装卸货图片上传失败
### 7.3 数据风险
装卸货地址与电子围栏偏差、GPS轨迹数据缺失、合同/回单文件丢失、多机构数据隔离
### 7.4 登录安全
管理端登录:滑块验证码 + 图片验证码(needImage) + RSA密码加密(authorize/encrypt) + 多机构选择登录
## 8. 测试策略偏好
### 8.1 P0优先覆盖
登录鉴权、运单核心主流程(接单->运输->卸货->结算->打款)、金额计算(运费/服务费/能源费/居间费/税费)、运单状态流转、支付流程(货主打款/财务打款/垫资打款)、权限隔离
### 8.2 必测异常场景
参数非法、重复提交(幂等)、并发提交、超时重试、依赖服务不可用、越权操作、状态已变化后操作、回单/凭证缺失
### 8.3 非功能重点
弱网/断网(APP端)、并发打款、机构间数据隔离、接口幂等、Excel大数据量导出(默认20000条)、装卸货图片上传(大文件/OSS)
## 9. 需求冲突判定口径
同一运单状态流转规则/同一费用计算口径/同一角色权限/垫资条件在不同需求中不一致均视为冲突;新需求声明"沿用旧逻辑"但实际描述已改变旧规则视为冲突。
## 10. 通用输出约束
需求分析必须覆盖功能目标/边界/角色/前置条件/状态流转/关键规则/风险;测试点必须覆盖主流程/异常流程/边界条件/数据校验/状态流转/权限控制/并发幂等;测试用例预期结果必须同时覆盖UI反馈和数据状态变化;金额相关用例必须验证计算精度;权限相关用例必须验证机构数据隔离;涉及GPS/地图的功能需考虑坐标偏移和精度问题。