G7-2 用户任务兑现 · 真机任务用例（WIP-338 · 扣子一号 · 2026-09-15）

依据：docs/plans/2026-09-15-G7用户价值门-v1草案.md §G7-2（责任席 一号/二号）

冈子映射复核追加要求：每任务 1 正向 + 1 异常路径（防只测 happy path）——本用例已逐条落实

覆盖：游客（C端 miniprogram）5 任务 + 主理人（B端商户工作台 / b-workbench）5 任务

一、任务清单总线

二、游客 5 任务（C端 miniprogram）

T1 找服务

• 正向
• 前置：游客进入首页 → category 分类（如 category-restaurant）
• 步骤：①首页点分类入口 ②加载分类商家列表 ③点击进入商家详情
• 预期：列表来自 GET /api/miniapp/merchants?category=restaurant，渲染 ≥1 商家卡（名称/评分/距离），点入详情带 merchant_id
• 证据位：network 面板 ?category= 请求 200 + 列表非空渲染截图
• 异常：?category=不存在值 → 预期返回空列表 data:[]（不 500、不闪退），页面显示「该分类暂无服务」诚实空态
• 证据位：前端 empty 插桩 + 接口 200 且 data 空

T2 下单

• 正向
• 前置：T1 找到目标服务，选规格（日期/数量）
• 步骤：①order-create 填必填项 ②提交下单 ③跳转支付
• 预期：POST /api/miniapp/orders（先 precheck）返回 order_no + order_id，300 系状态；订单出现在「我的订单」
• 证据位：响应 {code:0,data:{order_no,id}} + 列表可查
• 异常：必填项缺失/已下架服务 → 预期 422/400（前端红字提示，不落空单）
• 证据位：接口非 200 + 前端错误提示可见

T3 支付态

• 正向
• 前置：T2 下单成功、进入 pay-result
• 步骤：①触发支付（prepay/notify）②回跳页轮询状态 ③确认显示「已支付」
• 预期：GET /api/miniapp/pay/orders/{id}/status 返回 paid，order-detail 支付态正确
• 证据位：status 字段 = paid + 页面徽标
• 异常：支付取消/超时 → 预期 status=unpaid/failed，页面显示「待支付」+ 可再付，不得误判已支付
• 证据位：status 非 paid + 重试入口存在（与 D10 主权底线一致：零福钥用户同样可付）

T4 评价

• 正向
• 前置：服务已完成（T3 paid + 核销）
• 步骤：①进入订单评价 ②评分+文字 ③提交
• 预期：POST /api/miniapp/orders/{id}/review 成功，评价在详情可见
• 证据位：接口 200 + 评价列表含该条
• 异常（R1 红线）：未消费订单直接评价 → 预期 403/422（购买凭证校验，评价资格=订单关联）——防伪评价
• 证据位：接口拒绝 + 前端提示「仅支持已消费订单评价」

T5 福钥查看

• 正向
• 前置：用户已有福钥（key-task claim 或受赠）
• 步骤：①进入 key-tasks ②查看余额与流水 ③查看明细
• 预期：GET /api/miniapp/key-tasks/mine 与 /balance 返回明细+合计
• 证据位：balance 数值 + mine 列表渲染
• 异常：零福钥用户 → 预期返回零值（不报错），页面显示「暂无敌意福钥」引导，基础服务（浏览/天气/SOS）不受影响——D10 主权底部保护
• 证据位：balance=0 且首页/SOS 仍可用

三、主理人 5 任务（B端商户工作台）

T6 接单

• 正向
• 前置：主理人登录 + 有新订单
• 步骤：①查看待确认订单 ②确认接单
• 预期：GET /merchant-console/orders/pending-confirm 列出 → POST /orders/{id}/merchant-confirm 成功，订单转履约
• 证据位：pending-confirm 出现→confirm 200→订单状态变更
• 异常：重复确认/他人未接订单误操作 → 预期 409（幂等/归属校验），前端不裂
• 证据位：接口 4xx + 前端 toast

T7 核销

• 正向
• 前置：T6 接单后服务已履约
• 步骤：①进入核销 ②扫码/确认 ③标记已消费
• 预期：POST /orders/{id}/confirm-consumed 成功，服务项转 completed
• 证据位：pending-services 从有→无 + 状态 completed
• 异常：非该订单核销 / 已核销重复验 → 预期 404/409，不重复记录
• 证据位：接口拒绝 + 核销流水单条

🔴 勘误（一号 2026-09-16 09:5x，WIP-359 机位协调前置核实）：T7 上面写的 POST /orders/{id}/confirm-consumed 经后端注释核实（miniapp_orders.py:9「游客确认已消费/异议（D2）」）是游客 D2 动作，不是主理人核销。主理人核销真实链路 = 小程序 pages/workbench-redeem 核销台 → POST /api/miniapp/workbench/redeem/confirm（配套 scan/batch/revoke/conflicts，商户/员工七校验，非员工 403、24h 误核销 revoke 一次、冲突进 conflicts 队列）。真机执行以 evidence/c1/353/主理人5任务真机执行核对.md（已修正）与 evidence/c1/353/机位20勾协调包.md 为准。另：T9 回复评价后端 reviews/{id}/reply 在但三端前端无 UI，正勾记 🚧 缺口。

T8 对账

• 正向
• 前置：存在多笔已结算支付
• 步骤：①打开对账 ②按时间/渠道汇总 ③核对待收与已确认
• 预期：GET /merchant-console/overview + /payments/pending 汇总一致，可确认收款
• 证据位：overview 金额与 pending 逐笔核对 + confirm 后变动
• 异常：对账期间金额变动（部分退）→ 预期金额实时重算不糊（display 诚实），无负余额/错配
• 证据位：退款后 overview/账单再取一致

T9 回复评价

• 正向
• 前置：有游客评价
• 步骤：①查看评价 ②回复 ③保存
• 预期：POST /miniapp/reviews/{review_id}/reply 成功，回复随评价展示
• 证据位：review 详情含 reply + 200
• 异常：回复他人非本商户评价 → 预期 403（归属校验，主理人只能回自己名下）
• 证据位：接口 4xx + 无权提示

T10 设置

• 正向
• 前置：主理人登录
• 步骤：①打开设置 ②改收款方式/参数 ③保存
• 预期：PUT /merchant-console/payment-mode 保存成功，重进仍生效
• 证据位：PUT 200 + GET 回读一致
• 异常：非法参数（格式错/超范围）→ 预期 422 拦截，不落脏数据
• 证据位：接口 4xx + 前端红字

四、销项分界与真机执行安排

• 用例落址：本文件即为 G7-2「真机任务用例」交付；执行由 一号/二号 共同在 staging 真机/工具代跑完成，逐任务截图挂证据位（GI）。
• 异常路径绑定判据：R1（T4 评价资格）、D10（T5 零福钥、T3 免费基础面）为本用例强制红线，FAIL=G7-4 联动。
• themePrimary 消费侧复核销项（WIP-338②）：
• 后端读源已修：miniapp_site.py L79 顶层 "themePrimary": brand.get("themePrimary","") ✓（代码复核）
• c端消费补丁（BrandAssets 扩字段 + home 根节点 CSS 变量）= 待小冈（C端=小冈）应用并复核，见交接包 themePrimary-消费补丁交接.md
• 销项分界：后端清=待 staging 实测（机位）；C端消费=待小冈应用后复核销

五、本轮验证记录

• [ ] 后端 themePrimary 顶层展平代码复核：✓ L79
• [ ] 游客 5 任务用例起草：✓ T1-T5（含异常路径）
• [ ] 主理人 5 任务用例起草：✓ T6-T10（含异常路径）
• [ ] staging 真机执行（GI）：待机位