行用惠 · 联调测试流程

商家后台 + 用户小程序 全链路测试
📋 8 步完整流程 🔄 跨端数据流转 💰 收益闭环 🛡 含订单状态机
8
测试步骤
2
端/角色
6
订单状态
3
数据载体

🗺 整体流程

商家
1
添加门店
2
创建活动
7
订单审核
用户
3
报名活动
4-6
收货/截图
8
收益到账
📌 角色与文件
🏪 商家端 商家后台
主模块:门店管理、活动管理、订单审核
📱 用户端 用户小程序
主模块:用户首页 / 活动详情 / 订单详情 / 收益中心 / 我的
📋 测试步骤详解
1
添加门店
商家端
🏪 商家后台 → 门店管理
操作流程
  • 打开 商家后台
  • 左侧菜单 → "门店管理""添加门店"
  • 填写:门店名称所属平台(美团/饿了么/JD 至少 1 个)、店铺链接店铺 ID店铺主图后台管理截图(必填,JPG/PNG/WebP,≤ 5MB)
  • 点击 "保存" → 门店列表新增一条记录
📐 业务逻辑
① 至少需授权 1 个平台才能创建活动(硬约束)
② "后台管理截图"为必填项,缺失保存按钮 disabled
③ 门店保存后写入 localStorage['yh_stores'],供活动创建时关联
2
创建活动
商家端
🏪 商家后台 → 活动管理
操作流程(对应 5 个表单分段)
  • 左侧菜单 → "活动管理""+ 创建活动"(先选门店进入表单)
  • 基本信息:活动名称 / 店铺名称 / 试吃归类
  • 平台活动配置:3 张平台卡(美团/饿了么/京东),可分别展开配置实付金额、返现金额、活动名额、每日限量
  • 时间配置:开始时间 / 结束时间 / 每日开始 / 每日结束
  • 评鉴方案:5 选 1(必填)
  • 其他要求:12 选 1(标签仅作提醒)
  • 勾选 《行用惠平台商家服务协议》 → 点 "创建活动"
  • 扣活动金(99 元起)→ 创建成功 → 返回活动管理页
📐 业务逻辑(严格对应表单字段)
📍 进入表单前的拦截(硬约束)
  · 选门店时若 s.platforms.length === 0(未授权任何平台)→ Toast "该门店未授权任何平台,无法创建活动,请先完成平台授权" → 禁止进入创建活动表单
① 基本信息
  · 活动名称:必填,maxlength="30",trim 后非空且 ≤ 30 字(超长 Toast "活动名称不能超过30个字")
  · 店铺名称:从 shopList 下拉选,只列已有门店
  · 试吃归类:5 选 1 下拉(不限 / 美食 / 饮品 / 甜点 / 正餐)
② 平台活动配置(3 张卡:meituan / eleme / jd)
  · 是否开启活动:每张卡独立开关,至少开启 1 张卡
  · 用户实付金额:元,v.payAmount > 0 必填
  · 返现金额:元,v.cashback > 0 必填;< 5 元时该字段下方自动显示橙色警告"低于 5 元,无法同步霸王餐"
  · 活动名额:个,v.quota > 0 必填
  · 每日限量:个/天,可空(0 = 不限
  · 4 个数值字段都带"−/+"按钮,> 0 时才能 −(防负数),可手动输入
  · 平台卡头部可点击"展开 ⌄/收起 ⌃"切换显示
  · 编辑已创建活动时,平台被锁定actLockedPlat 非空时只显示对应平台卡,其他 v-show 隐藏,且该卡右上角显示"本活动已锁定XX平台,不支持修改")
③ 时间配置
  · 开始时间type="date",必填
  · 结束时间type="date",必填
  · 每日开始时间type="time",必填,默认 "08:00"
  · 每日结束时间type="time",必填,默认 "20:00"
④ 评鉴方案(必填)
  · 5 个等级(下拉单选):
    ① 无需评价 ② 用餐反馈(无需图文) ③ 用餐反馈(需含文) ④ 用餐反馈(需含图) ⑤ 用餐反馈(需含图含文)
⑤ 其他要求
  · 12 选 1(下拉单选,可空):
    需满实付 / 多图多字 / 仅限一瓶饮品 / 宝子们要3图15字哈 / 禁止预订单 / 宝子们要收藏店铺哈 / 宝子们要五公里内下单哦 / 文字反馈即可 / 餐品真实图片哦 / 反馈图片要该订单餐品哦 / 自定义
  · 标签仅作提醒,不是强制要求
⑥ 服务协议(必勾选)
  · 复选框 actAgree 必须为 true,否则 Toast "请先同意行用惠平台商家服务协议"
  · UI 上"创建活动"按钮未做 disabled 联动,靠 saveAct 提示兜底
📋 saveAct() 校验顺序(任一失败 return)
  a. 活动名称:trim 后非空、长度 ≤ 30 字
  b. 开始时间 / 结束时间:不能为空
  c. 评鉴方案:不能为空(未选)
  d. 平台开关:至少开启 1 个平台(Object.entries().filter(v => v.enabled)
  e. 每个开启平台:实付金额 > 0、返现金额 > 0、活动名额 > 0;返现金额 ≥ 实付金额 × 0.5(下限 Math.floor(payAmount*0.5*100)/100,2 位小数)
  f. 协议同意:actAgree 必须为 true
💰 活动金(创建后扣款)
  · 99 元起,先检查钱包余额
  · 余额不足 → 弹充值弹窗(与 电子签约 / 制作合同 共用 #topupMask
  · 余额充足 → 扣款并创建 → 写 localStorage['yh_act_fee']
🗂 创建后的数据写入
  · activities 数组 unshift 新活动(newId = Math.max(...ids) + 1
  · 初始字段:status="待审核"exposure=0, visits=0, grab=0, used=0, completeOrders=0, salesRate=0, actFee=false, feePaid=false, collected=0
  · target = quota × (payAmount - cashback)(目标完成金额)
  · Toast "已创建",关闭弹窗,closeSub() 返回上一页
🔄 活动状态机迁移(系统每分钟自动检查)
  ① 创建活动 → 未启动 + 待缴费
  ② 缴纳活动金 → 未启动 + 已缴费(状态不变,只改缴费标志)
  ③ 到 startTime + 已缴费 + 仍在 endTime 内 → 自动 进行中(用户可报名)
  ④ 到 endTime → 自动 已结束
  ⑤ 手动结束 → 已结束
  ⑥ 手动取消(未启动) → 已取消 + 已缴费用退回待缴费
  · 已结束已取消仅可删除
3
报名活动
用户端
用户首页 → 活动详情
操作流程
  • 打开 用户首页(用户小程序首页)
  • 在活动列表中找到刚才商家创建的活动,点击进入 活动详情
  • 浏览活动详情(奖励、规则、门店信息、图册)
  • 点击底部 "立即报名" 按钮
  • Toast 提示"报名成功",自动跳转到 订单详情(订单号 A1001)
📐 业务逻辑
① 报名成功后,订单数据写入 sessionStorage['orders'](订单号自动生成 A1001/A1002...)
② 订单初始状态:"已下单待反馈"(在 订单列表 的"待上传"tab 可见)
③ 提示用户"15 分钟内提交订单号"
💡 提示
报名是整个流程的起点。完成此步后,用户端会有一条"待上传"状态的订单等待后续操作。
4
去美团下单(活动要求)
用户端
订单详情
操作流程
  • 订单详情 订单详情页,点击"领取红包"和"前往美团店铺"按钮(演示版弹 Toast 模拟跳转)
  • 切到真实美团 App 下单,实付金额需满足活动要求(如满 30 减 30 活动需要实付 ≥ 30)
  • 下单完成后,复制美团订单号返回行用惠
📐 业务逻辑
① 演示版没有真实跳转,用户需手动复制美团订单号
② 订单号需要是已完成的真实订单(审核会校验)
③ 返利金额 = 商家活动返利 - 平台手续费;若实付小于要求实付,会扣减返利金额
5
确认收货(上传订单号)
用户端
订单详情
操作流程
  • 在订单详情页,找到"图二:收到外卖"区域
  • 系统自动带入美团订单号(如 2202186622489257107
  • 点击 "外卖已确认收货,继续提交" 按钮
  • 页面切换到"图三:上传订单完成截图"区
📐 业务逻辑
① 订单号可手动"修改"
② 收货确认 = 订单状态从 "已下单待反馈" 推进到 "待上传截图"
③ 进入下一步前,订单号必须有效(演示版仅做格式校验)
6
上传反馈截图 → 提交审核
用户端
订单详情
操作流程
  • 在订单详情页"图三"区,订单完成截图:必填 1-3 张(必须能看到订单号、金额)
  • 如果活动有图文反馈要求,还需上传 反馈凭证截图 2-3 张
  • 点击 "提交审核" 按钮
  • 页面切换到"step3 返利到账"区,显示 "平台审核中" 状态
📐 业务逻辑
① 截图少于最少张数 → 提交按钮 disabled
② 提交后订单状态从 "待上传截图""审核中"订单列表 的"审核中"tab 可见)
③ 状态变更是商家端订单审核的输入信号,下一步需要切到 商家后台 处理
💡 演示版注意事项
演示版的"提交审核"会弹窗提示并自动跳到 订单列表。真实审核需要在 商家后台 商家端做。
7
订单审核(商家端)
商家端
🏪 商家后台 → 订单审核
操作流程
  • 打开 商家后台
  • 左侧菜单 → "订单审核"
  • 列表展示所有"审核中"订单,按时间倒序
  • 点击某条订单 → 进入 审核详情:可看到订单号、金额、用户上传的反馈截图、关联活动
  • 点击 "通过" → 弹窗(订单号、订单金额、返利金额、备注均可编辑)→ 确认后状态变为 "已完成"
  • 或点击 "驳回" → 弹窗(订单号必填、备注必填且可编辑)→ 确认后状态变为 "已驳回"
📐 业务逻辑
① 审核通过 → 订单状态从"审核中"→"已完成" + 触发返利到账,资金进入用户钱包
② 审核驳回 → 订单状态从"审核中"→"已驳回",用户可"重新上传"再次进入审核
③ 返利金额 = 返现金额计算举例,活动A满20返13:消费金额大于等于20时,实际返现金额=应返金额13元。 消费金额小于20时,实际消费金额16元,实际返现金额=应返金额13-差额(应实付金额满20-实际消费金额16) =9元 。若返现金额小于等于0,则返现金额=0元。,审核时可调整(实际打款以审核为准)
④ 审核结果通过 sessionStorage 写回,用户端 订单列表/订单详情 重新进入即可看到新状态
8
收益到账 + 订单详情
用户端
收益中心 + 订单详情
操作流程(收益到账)
  • 打开 收益中心(从 我的 → "我的收益" 进入)
  • 顶部"可提现收益"金额 = 累计返利合计
  • "全部"tab 列表显示刚才的 "我的订单返利" +X.XX 元 记录
  • 点击"立即提现"可发起提现申请
操作流程(订单详情)
  • 回到 订单列表 → "已完成" tab 找到刚审核的订单
  • 点击进入 订单详情
  • 页面显示"step3 返利到账"区:"审核通过,返利已同步到您的余额"
  • 时间线显示:报名 → 反馈凭证已上传 → 平台审核通过
📐 业务逻辑
① 返利到账时间 = 审核通过那一刻
② 收益数据写入 localStorage['yh_earnings'] + 订单列表/订单详情 同步显示
收益中心的"累计收益"= 所有 type='in' 合计;"可提现收益"= 已完成收入 - 已完成支出
④ 整个测试闭环完成
🔄 订单状态机
订单从用户报名到收益到账,经历 6 个状态。每个状态包含 4 要素:入口 / 用户可操作 / 出口 / 特殊规则
① 已下单待反馈 (pending_upload)
入口:用户点击"立即报名"成功,订单创建
可操作:去美团下单 / 取消报名
出口:① 点"确认收货"上传订单号 → ② 待上传截图;② 主动点"取消报名" → ⑥ 已取消;③ 15 分钟未上传订单号 → ⑥ 已取消(超时作废)
特殊规则:订单号有 15 分钟有效期,超时自动作废并释放活动名额
② 待上传截图 (waiting_proof)
入口:已确认收货并提交订单号(订单号校验通过)
可操作:上传订单完成截图(必填 1-3 张)/ 反馈凭证截图(图文反馈活动 2-3 张)
出口:点"提交审核"且截图张数达标 → ③ 审核中
特殊规则:无时间限制,但活动结束前必须提交;订单号在此阶段可"修改"
③ 审核中 (review)
入口:用户提交了完整凭证
可操作(用户端):查看进度(只读)
可操作(商家端):查看凭证 → 通过 / 驳回
出口:商家点"通过" → ⑤ 已完成(触发返利到账);商家点"驳回" → ④ 已驳回
特殊规则:用户端倒计时展示"预计 1-3 个工作日内完成";驳回时商家必须填驳回原因(影响用户的 ④ 状态显示)
④ 已驳回 (reject)
入口:商家审核未通过
可操作:查看驳回原因 / 重新上传凭证
出口:点"重新上传"修改截图 → ③ 审核中(再次进入审核)
特殊规则:驳回原因会用红色框突出显示;重新提交次数无限制,但每次驳回都会记入订单时间线
⑤ 已完成 (done)
入口:商家审核通过
可操作:查看返利记录 / 去收益页提现(资金已到账)
出口:终态(不再流转)
特殊规则:返利金额 = 商家返利 - 平台手续费;若实付 < 要求实付,返利 = 商家返利 - 差额;同步写入 localStorage['yh_earnings'] 一条 type='in' 记录
⑥ 已取消 (cancel)
入口:① 用户主动点"取消报名";② 15 分钟内未提交订单号(系统超时);③ 商家手动取消
可操作:查看取消原因(仅自己/系统取消时显示)
出口:终态(不再流转)
特殊规则:释放活动名额(+1);返利不发放;不计入收益统计;订单时间线记录取消原因
📊 状态流转图示:
① 已下单待反馈 ─收货确认→ ② 待上传截图 ─提交审核→ ③ 审核中
  │ │ │
  │ │ └─驳回→ ④ 已驳回 ─重新上传→ 回到 ③ 审核中
  │ └─超时 15min→ ⑥ 已取消
  └─取消报名→ ⑥ 已取消
  ③ 审核中 ─通过→ ⑤ 已完成(触发返利到账)
  ⑤ 已完成 / ⑥ 已取消:终态,不再流转
🗂 数据流转(localStorage 视角)
数据 Key写入方读取方用途
yh_stores 商家后台(门店管理) 商家后台(创建活动) 门店列表
yh_activities 商家后台(活动管理) 用户首页/活动详情 活动列表
sessionStorage['orders'] 订单详情(报名) 商家后台(订单审核) 订单数据
yh_sign_quota 电子签约(购买) 制作合同(盖章) 电子签约套餐额度
yh_seals 印章管理 制作合同(盖章) 印章数据
yh_wallet 电子签约/制作合同(充值) 电子签约/制作合同(购买) 钱包余额
yh_earnings 审核通过自动写入 收益中心 收益记录
✅ 联调测试 Checklist
步骤验证点状态
1 添加门店门店列表新增 / 必填校验 / 平台授权
2 创建活动活动列表新增 / 关联门店 / 返利规则显示
3 报名活动跳转 订单详情 / 订单状态=待反馈
4 美团下单真实下单 / 满足金额门槛
5 确认收货订单号带入 / 状态推进到"待上传"
6 上传截图1-3 张订单截图 / 提交后状态=审核中
7 商家审核通过 / 驳回 两种流程都跑通
8 收益到账收益中心 出现记录 / 订单详情 状态=已完成

🎉 联调完成

8 步全跑通 = 行用惠核心业务流程验证通过