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:
@@ -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条 |
|
||||
@@ -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/
|
||||
- WebSocket:wss://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/地图的功能需考虑坐标偏移和精度问题。
|
||||
|
||||
Reference in New Issue
Block a user