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
@@ -9,7 +9,7 @@
- 主流程:核心业务 Happy Path 必须覆盖。
- 异常流程:参数非法、前置条件不满足、状态不允许、库存不足、余额不足、权限不足、重复操作、超限操作等必须覆盖。
- 边界条件:最小值、最大值、临界值、空值、默认值、长度边界、数量边界、时间边界、金额边界必须按需求实际场景覆盖。
- 状态流转:创建、提交、生效、失效、取消、关闭、退款、撤回、恢复等关键状态变化必须覆盖。
- 状态流转:创建、提交、生效、失效、取消、关闭、撤回、恢复等关键状态变化必须覆盖。
- 规则组合:多条件叠加、互斥、优先级、覆盖关系、兜底规则必须覆盖。
- 数据校验:展示数据、落库数据、统计口径、列表汇总、详情字段、外部回传字段必须覆盖。
- 中后台页面:如果需求包含列表、新建、编辑、查看、失效、删除、筛选、选择弹窗等管理能力,除失败态外,正向成功链路和交互细项也必须覆盖。
@@ -22,8 +22,8 @@
对于高风险模块,测试用例必须体现风险导向,而不是平均用力。
- P0/P1 业务规则必须覆盖正向、逆向、边界、互斥、并发或幂等中的关键场景。
- 资金、库存、优惠、权益、单状态等资损类风险,必须覆盖结果一致性校验。
- 涉及角色隔离、数据隔离、门店隔离、组织隔离的需求,必须覆盖权限与越权场景。
- 资金、库存、优惠、权益、单状态等资损类风险,必须覆盖结果一致性校验。
- 涉及角色隔离、数据隔离、组织隔离的需求,必须覆盖权限与越权场景。
- 涉及外部系统、回调、异步任务、延迟生效、重试补偿的需求,必须覆盖时序异常与重复触发场景。
## 3. 用例设计质量达标
+44 -84
View File
@@ -1,6 +1,6 @@
# 业务术语表
> 本文件定义了项目中长期稳定、跨商城场景高频出现的核心业务术语。AI 在生成分析、测试点和测试用例时必须优先使用这些词汇,禁止混用口语化同义词。
> 本文件定义了项目中长期稳定、运输场景高频出现的核心业务术语。AI 在生成分析、测试点和测试用例时必须优先使用这些词汇,禁止混用口语化同义词。
>
> 使用原则:
> 1. 先使用本术语表中的标准词。
@@ -10,92 +10,56 @@
## 1. 角色与业务主体
- **平台端**: 平台总部或品牌总部使用的管理后台,用于统一管理店铺、商品、营销、订单、会员、数据等能力。
- **商家端**: 商家、门店、代理商或直营网点使用的经营后台,用于管理本商家可见范围内的商品、订单、营销和资产
- **用户端**: C 端消费者使用的台,包括 App、H5、小程序、PC 商城等购买入口
- **店铺**: 面向用户提供商品或服务经营能力的业务主体,可理解为商家经营单元
- **门店**: 线下经营或履约单元,可能具备独立库存、独立配送范围、独立核销能力
- **供应商**: 提供商品、履约或货源支持的上游主体,可能影响供货价、库存和发货链路
- **运营人员**: 负责配置商品、活动、价格、运费、会员权益等后台能力的业务角色
- **客服**: 负责处理订单咨询、退款、售后、补单、异常协查等问题的后台角色。
- **运八平台端**: 平台总部或托运人使用的管理后台,用于统一管理货源、审核、司机、车辆、货主、打款、数据等能力。
- **运八司机端**: 司机、车队长使用的移动端,包括 Android/iOS/小程序,用于司机、车队长接单、派单、运输、提现等能力
- **运八货主端**: 托运人使用的台,包括 Android/iOS/PC端等,用于货主发布货源、结算、付款等能力
- **货主**: 有运输需求的托运人,可以使用运八平台端、运八货主端进行货源、资金等管理
- **车队长**: 可以理解为一个运输企业,本身该角色不能进行实际运输,仅执行接单后,将运输的单子指派给名下的司机
- **司机**: 进行实际货物运输,需要上传装卸货的资料以及图片
- **运营人员**: 负责审核工作包含司机、车辆、货主等所有角色注册和运输的审核,也可代货主发布货源、结算运单
- **客服**: 负责处理订单咨询、异常协查等问题的后台角色。
- **财务**:负责处理运单实际打款的角色。
- **滇运通**:负责帮司机代开发票的系统。
## 2. 商品与库存
## 2. 货源
- **SPU**: 标准产品单位,表示一类商品的抽象定义,如“iPhone 15”
- **SKU**: 库存量单位,表示商品的最小可售规格,如“iPhone 15 黑色 256G”
- **商品规格**: 用于区分 SKU 的销售属性组合,如颜色、尺码、套餐版本
- **可售库存**: 当前可用于下单扣减的库存数量,不等于物理库存
- **锁定库存**: 用户下单后暂时占用、待支付或待确认释放的库存
- **回滚库存**: 订单取消、支付失败或超时关闭后,系统释放此前锁定库存的动作。
- **超卖**: 实际成功售卖数量超过可售库存的异常情况。
- **手动清分**: 该货源下所有运单结算方式名称
- **车队长全额收款**: 该货源下所有运单结算方式名称
- **自动清分**: 该货源下所有运单结算方式名称
- **垫资**: 货源下运单能否进行进行垫资打款的标识
- **电子围栏**: 当前货源下所有运单装卸货位置是否进行限制
## 3. 购物与订
## 3.
- **购物车**: 用户临时存放待购买商品的列表,不代表价格、库存、优惠结果最终已锁定
- **结算页**: 用户提交订单前的确认页面,用于展示最新商品、价格、库存、运费、优惠和实付信息
- **提交订单**: 用户确认购买并生成订单的动作,通常意味着进入待支付或待确认状态
- **订单**: 用户购买商品或服务形成的业务单据,是支付、履约、退款、售后的核心载体
- **子订单**: 拆单后形成的订单明细单元,常见于多商家、多仓、多履约场景
- **单状态**: 单在生命周期中的阶段标识,如待支付、待发货、待收货、已完成、已取消
- **单关闭**: 因超时未支付、风控失败、系统取消等原因终止单继续流转。
- **逆向流程**: 单创建后的反向处理链路,如取消、退款、退货退款、换货、补偿
- **车队长运单**: 由车队长接单分派给司机的运单
- **司机运单**: 由司机自行接单的运单
- **垫资运单**:货主、货源都标记为垫资时对应货源下的所有运单
- **非垫资运单**:货主、货源下只要有一个没有标记为垫资时对应货源下的所有运单
- **单**: 用户对货源接单后形成的数据,是支付、履约的核心载体
- **单状态**: 单在生命周期中的阶段标识,如待运输、运输中、已卸货、已结算、已垫付、已打款等
- **单关闭**: 因司机取消运单终止单继续流转。
- **逆向流程**: 单创建后的反向处理链路,如取消、每个节点的审核驳回
## 4. 支付与资金
- **待支付订单**: 已成功创建但尚未完成付款的订单状态
- **支付单**: 订单在支付环节生成的资金请求单据,用于对接三方支付或内部资金系统
- **支付流水**: 记录支付请求、支付结果、渠道单号、金额等信息的资金明细
- **支付方式**: 用户完成付款所使用的资金渠道,如微信支付、支付宝、余额、积分抵现
- **实付金额**: 用户最终实际支付的金额,通常等于应付金额减去各类可抵扣权益后的结果
- **原路退回**: 退款时按原支付方式、原资金路径退还用户资产的处理方式
- **挂账**: 订单生成但尚未完成付款,系统已形成应收记录但未完成资金入账的状态
- **资损**: 因金额计算错误、优惠错误、重复退款、库存超卖等问题导致平台或商家资产损失
- **调账**: 运单在打款后,用户未提现进行的资金调整
- **电子回单**: 运单产生支付记录后银行推送的回单
- **支付方式**: 用户完成付款所使用的资金渠道,如光大银行、浦发银行
- **货主合计付款**:货主实际需要支付给平台的费用,基础运费+服务费
- **合并打款**:货主-平台-司机一次性打款的操作
- **货主打款**:货主给平台支付费用
- **财务打款**:平台给司机、车队长支付费用
- **垫资-财务打款**:垫资运单由平台先行垫付运费给司机
- **垫资-货主打款**:垫资运单平台垫付运费后货主偿还费用。
- **能源费**: 货主配置里的比例金额,对应货主名下所有货源司机接单后自动将部分运费转化为能源费。
- **居间费**: 手动清分运单车队长收款的金额。
- **清分司机费用**: 手动清分运单司机收款的金额。
- **车队长收款**:车队长实收费用,需要根据居间费给车队长多打1%的税费。
- **资损**: 因金额计算错误、重复打款等问题导致平台或货主资产损失。
## 5. 营销与优惠
## 5. 风控、权限与系统能力
- **优惠券**: 可在满足条件时抵扣订单金额或给予折扣的营销权益
- **平台券**: 由平台统一发放和承担成本的优惠券,通常作用于平台范围内指定商品、店铺或活动。
- **商家券**: 由商家或店铺发放和承担成本的优惠券,通常只在指定商家范围内可用。
- **品类券**: 只对指定商品类目或商品范围生效的优惠券。
- **满减券**: 订单或商品金额达到门槛后才可生效的优惠券。
- **折扣券**: 以打折方式生效的优惠券,而非固定金额抵扣。
- **优惠门槛**: 优惠生效所需满足的条件,如满 100 可减 20。
- **适用范围**: 某个优惠可生效的商品、类目、店铺、用户、渠道或时间范围。
- **优惠叠加**: 多种优惠是否允许同时生效的规则。
- **优惠互斥**: 多种优惠不能同时生效,只能按优先级或选择规则命中其一。
- **试算**: 在正式提交前,根据当前商品、用户、活动、券、积分等条件预估优惠和实付结果的过程。
- **优惠分摊**: 将订单级优惠按规则分配到商品、子单、退款项上的计算过程。
- **一口价**: 以固定成交价覆盖常规价格和营销计算链路的促销方式。
- **满减送**: 满足金额或件数条件后,给予减价、赠品或附加权益的活动方式。
- **限时折扣**: 在指定时间内生效的临时价格优惠活动。
- **秒杀**: 在短时间窗口内以强时效、强库存约束进行的促销活动。
- **拼团**: 通过多人组团满足条件后生效的营销活动。
## 6. 会员与权益
- **会员**: 具备等级、成长值、标签、专属价格或专属权益的用户身份。
- **会员等级**: 用于区分会员权益范围的层级,如普通会员、VIP、SVIP。
- **会员价**: 针对会员身份生效的专属销售价格或折扣规则。
- **会员权益**: 会员可享受的专属能力,如会员价、包邮、积分加速、专属券等。
- **积分**: 可用于兑换、抵现、成长或运营激励的虚拟权益资产。
- **积分抵现**: 将积分按兑换比例折算为订单可抵扣金额的能力。
- **余额**: 用户在平台或商家体系内预存或结余的可消费资金。
## 7. 履约、售后与核销
- **履约**: 订单支付后到商品或服务完成交付之间的执行链路,如发货、配送、自提、到店消费。
- **发货**: 商家或仓库将商品交给物流或配送体系的动作。
- **签收**: 用户确认收到商品或系统确认妥投的状态。
- **售后**: 支付后围绕退款、退货、换货、补寄、补偿等问题展开的处理流程。
- **整单退款**: 针对订单全部商品和全部已支付金额发起的退款。
- **部分退款**: 针对订单中的部分商品、部分数量或部分金额发起的退款。
- **退款分摊**: 在部分退款场景下,将优惠、运费、积分等按规则分配到退款项的过程。
- **核销**: 对券码、提货码、预约码、订单码等进行校验并确认已消费/已使用的动作,常见于到店自提、到店服务、卡券消费场景。
- **核销码**: 用于完成核销动作的识别码、二维码、条形码或数字口令。
## 8. 风控、权限与系统能力
- **风控拦截**: 系统判定交易、账号或操作存在风险后自动阻断继续执行的行为。
- **风控拦截**: 系统判定运单存在风险后自动阻断继续执行的行为
- **权限控制**: 根据角色、数据范围、组织关系等限制用户可见、可操作范围的机制。
- **越权**: 用户访问或操作了其本不应拥有权限的数据或功能。
- **幂等性**: 同一业务请求被重复提交时,系统结果保持一致,且不会重复扣款、重复创建、重复退款或重复扣减资源。
@@ -105,10 +69,6 @@
- **回调**: 外部系统处理完成后主动通知本系统结果的机制,常见于支付、退款、物流等链路。
- **审计日志**: 用于记录关键操作人、操作时间、操作对象和变更结果的可追溯日志。
## 9. 术语使用约束
## 6. 术语使用约束
- **订单关闭** 与 **退款成功** 不是同义词,关闭订单不代表资金已经退回。
- **优惠券使用** 与 **核销** 不是同义词;商城下单抵扣通常描述为“使用优惠券”或“优惠券抵扣”,到店消费确认才更常用“核销”。
- **挂账** 只在涉及应收记录或账务状态时使用;普通商城待支付场景优先写“待支付订单”。
- **平台券**、**商家券**、**店铺券** 不应混写;若项目内三者含义不同,必须以项目需求或项目画像中的定义为准。
- **退款**、**退货退款**、**换货**、**售后关闭** 不应混写,生成用例时要按实际逆向类型写全称。
暂无
@@ -1,4 +1,4 @@
# 可选业务术语表(SaaS 扩展域)
# 可选业务术语表(SaaS 扩展域)--暂不需要
> 本文件只在需求文档、项目画像或关联需求明确涉及对应领域时才应纳入上下文。不要将这些术语默认用于所有商城项目。