Files

T

xst acdb441507 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

13 KiB

Raw Blame History

运八网络货运平台 - 项目画像

用途：为本仓库内测试分析、测试点、测试用例提供"项目差异化约束"。维护要求：当架构、业务模式、风控策略、履约策略、权限模型、计费规则等发生变更时，必须同步更新本文件。数据来源：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/地图的功能需考虑坐标偏移和精度问题。

13 KiB Raw Blame History Unescape Escape