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 - 确认结论文件已归档
230 lines
13 KiB
Markdown
230 lines
13 KiB
Markdown
# 运八网络货运平台 - 项目画像
|
||
|
||
> 用途：为本仓库内测试分析、测试点、测试用例提供"项目差异化约束"。
|
||
> 维护要求：当架构、业务模式、风控策略、履约策略、权限模型、计费规则等发生变更时，必须同步更新本文件。
|
||
> 数据来源：2026-07-10 通过 Playwright 对测试环境管理端在线页面实际浏览采集（352个菜单项、184个页面截图）。
|
||
|
||
## 1. 项目简介
|
||
|
||
- **项目名称**：运八网络货运平台（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/
|
||
- WebSocket：wss://ybxcx.ynyun8.com:8000/
|
||
- **测试账号**：
|
||
- 超级管理员：super_admin / 951260684NiAn..
|
||
- 车队长：13113113113 / 88888888
|
||
- 司机：15188888888 / 88888888
|
||
- **目标用户角色**：
|
||
- 平台运营人员（super_admin）：后台管理与审核
|
||
- 货主（托运人）：发布货源、管理运单、结算付款
|
||
- 车队长：接单并分派给名下司机
|
||
- 司机：实际运输执行，上传装卸货资料
|
||
- 财务人员：运单打款、资金管理
|
||
- 客服人员：订单咨询、异常协查
|
||
|
||
## 2. 核心业务域（基于实际在线系统菜单结构）
|
||
|
||
### 2.1 首页 Dashboard
|
||
- 平台车辆总计 / 平台运力统计
|
||
- 货源单（未接单/已接单/已结算/已撤销）
|
||
- 运输单（待运输/运输中/已卸货）
|
||
- 交易数据（充值总额/交易总额/运费总额/开票总额）
|
||
- 快捷入口：发布货源、订单管理、客服管理、大数据中心、中闽大数据
|
||
- 运输流程图展示
|
||
|
||
### 2.2 基础信息 = 平台管理 + 货主管理 + 承运管理 + 车辆服务 + 数据字典 + 审核管理 + 商户中心 + 账户管理 + 彩虹糖
|
||
|
||
**平台管理**：账号管理、角色管理(含权限分配)
|
||
**货主管理**：个体货主/企业货主列表+表单(含多Tab:发票资质/地址/承运服务/员工/合同/权限/快钱账户等)、分账记录
|
||
**承运管理**：车队管理(列表+表单含多Tab)、司机管理(列表+表单含多Tab)、平台车辆、车辆地图、运输停车报警
|
||
**车辆服务**：车辆保险、车辆维修、车辆违章、车辆事故
|
||
**数据字典**：商品档案、商品类型、单位档案、车型/车长/车宽/车高/轴数/吨位管理、增值类型、银行类型(含快钱)、银行编码/网点管理、能源卡类型
|
||
**审核管理**：司机审核(含开通高德/身份证上报)、换号审核、车辆审核(含车牌号上报)、货主审核、维修审核、开票审核、对账审核、车队司机/车辆审核、车队审核、核验审核
|
||
**商户中心**：商户管理(浦发)、快钱、光大会员列表、光大文件、光大监管商户号、会员资金明细、光大推送、光大监管商户
|
||
**账户管理**：余额统计(浦发/快钱/光大)、账户充值(含短信验证)、分账记录、变更记录、提现记录(浦发/光大)、平台公户、支付流水(含确认/还原)、支付明细(含流水号)、收款编码/记录、车队长收款记录
|
||
**彩虹糖**(风控)：司机审核、车辆审核、司机比对、车辆比对
|
||
|
||
### 2.3 整车运输 TMS（核心业务）
|
||
|
||
**货源管理**：发布货源(含OCR识别Tab/地图选点/指定车队司机/指定承运费率Tab)、货源大厅、项目货源(含创建项目/常跑路线/指定车队司机/指定承运费率Tab)、货源审核
|
||
|
||
**运输管理**：运单跟踪(含待装货/待运输/待卸货Tab)、运单管理(含批量删除/拆分/开票/导出)、运单轨迹
|
||
|
||
**预付管理**：预付运费、预付统计、预付记录
|
||
|
||
**运单认证核算**：运单证件异常、运单业务异常、运单时长异常、货物重量异常、运费金额异常、待处理异常运单、轨迹异常、风控异常运单、运费核算
|
||
|
||
**运单认证审核**：运单业务异常、运单认证审核、运单时长异常、货物重量异常、运费金额异常
|
||
|
||
**承运结算**：运费核算、货主打款、异常运单、回单签收、财务打款、财务分账、电子回单、货主支付、合并明细、合并付款、财务驳回、打款记录、合并打款、运单审核、**垫资-财务打款**、**垫资-货主打款**、清分列表
|
||
|
||
### 2.4 能源卡管理
|
||
能源卡余额、充值记录、消费记录
|
||
|
||
### 2.5 加油管理
|
||
油站管理、消费统计、油卡余额、加油记录、油费预付、油卡消费
|
||
|
||
### 2.6 货主结算
|
||
收款对账、对账列表、收款单据、收款列表
|
||
|
||
### 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/地图的功能需考虑坐标偏移和精度问题。
|