Files
huangjingfen/docs/fsgx-phase7-config-checklist.md
apple c2420e7393 feat(fsgx): 更新用户列表直推/伞下统计并同步测试文档
补充用户列表中的直推人数与伞下订单数统计逻辑,便于验证分销链路数据;同时更新验收与问题文档,记录当前手测结论和检查项。

Made-with: Cursor
2026-03-24 19:05:53 +08:00

5.4 KiB
Raw Blame History

范氏国香商城 — Phase 7 后台配置与验收清单

本文档为运营人员在部署后,通过 CRMEB 管理后台完成配置的操作指南,同时提供全链路测试步骤。


7.1 执行数据库迁移

在服务器上执行以下 SQL 迁移脚本(每次部署后执行一次,使用 INSERT IGNOREADD COLUMN IF NOT EXISTS 保证幂等性):

mysql -u root -p fsgx-shop < pro_v3.5.1/help/migrations/fsgx_v1.sql

迁移内容:

  • eb_store_product 新增 is_queue_goods 字段
  • eb_store_order 新增 is_queue_goods 字段(冗余,加速佣金计数)
  • eb_user 新增 frozen_pointsavailable_pointsno_assess 字段
  • eb_system_config 插入 4 个返佣配置键
  • eb_system_timer 插入每日积分释放定时任务

7.2 后台分销等级配置

路径:营销 → 分销 → 分销等级

创建以下 4 个等级按顺序level 值 1~4

等级 名称 直推人数条件 伞下有效订单数 佣金上浮比例
1 创客 直推 ≥ 1 人 - +0%
2 云店 直推 ≥ 3 人 - +5%
3 服务商 直推 ≥ 10 人 伞下 ≥ 30 单 +10%
4 分公司 直推 ≥ 30 人 伞下 ≥ 100 单 +15%

注意:等级升级任务条件可根据业务调整,以上为推荐默认值。


7.3 后台运营配置

7.3.1 开启人人分销

路径:营销 → 分销 → 分销设置

  • 分销功能:开启
  • 分销类型:人人分销(所有用户均可参与)

7.3.2 返佣设置fsgx 周期佣金)

路径:营销 → 分销 → 返佣设置 → 推荐佣金fsgxTab

配置项 推荐值 说明
佣金周期人数 3 推荐3人为一个完整周期
各档佣金比例 [20,30,50] 第1人20%第2人30%第3人50%JSON格式
返佣范围 仅报单商品 is_queue_goods=1 的商品参与
佣金发放时机 支付即发放 用户付款后立即发放佣金

如果返佣设置页面没有"推荐佣金fsgx"Tab请确认已运行 fsgx_v1.sql 迁移脚本。

7.3.3 提现设置

路径:财务 → 分销财务 → 提现设置(已存在)

  • 提现手续费率:7%
  • 最低提现金额:100 元
  • 支持提现方式:微信零钱、支付宝、银行卡

7.3.4 报单商品配置

路径:商品 → 商品列表 → 编辑目标商品 → 其他设置

  • 将参与周期佣金的商品标记为"报单商品"is_queue_goods = 1
  • 建议在商品名称/描述中注明"报单商品"

7.4 全链路验收测试

测试环境准备

  1. 准备 3 个测试账号:用户A(推荐人)、用户B/C/D(被推荐人)
  2. 确保用户B/C/D 通过用户A 的邀请链接注册(绑定 spread_uid = A.uid
  3. 准备至少 1 个标记了 is_queue_goods=1 的报单商品

测试步骤

Step 1注册与推荐关系绑定

  • 用户B 通过用户A 邀请链接打开小程序并注册
  • 后台验证:eb_user.spread_uid = A.uid

Step 2购买报单商品第1人

  • 用户B 购买报单商品并支付成功
  • 验证用户A 获得第1周期佣金应为商品价格的 20%
  • 验证用户A 的 frozen_points 增加
  • 小程序"推荐佣金"页:cycle_current = 1/3

Step 3购买报单商品第2人

  • 用户C 通过用户A 邀请链接注册并购买报单商品
  • 验证用户A 获得第2周期佣金应为商品价格的 30%
  • 小程序"推荐佣金"页:cycle_current = 2/3

Step 4购买报单商品第3人完成一个周期

  • 用户D 通过用户A 邀请链接注册并购买报单商品
  • 验证用户A 获得第3周期佣金应为商品价格的 50%
  • 验证:一个周期累计佣金 = 商品价格的 100%
  • 小程序"推荐佣金"页:cycle_current = 0/3(新周期开始)

Step 5分销等级自动升级验证

  • 用户A 直推了3人B/C/D满足"云店"升级条件直推≥3人
  • 后台验证:eb_user.agent_level = 2(云店)
  • 小程序个人中心:等级标签显示"云店"

Step 6积分释放验证

  • 等待次日 2:00 AM 定时任务执行(或手动触发测试)
  • 验证用户A 的 frozen_points 减少 0.4‰,available_points 对应增加
  • 后台积分日志页(/admin/hjf/points/log可查看释放记录

Step 7提现流程验证

  • 用户A 在小程序申请提现(输入金额)
  • 验证手续费率 7% 正确扣除
  • 后台审核通过后,brokerage_price 对应减少

7.5 异常场景验收

  • 非报单商品(is_queue_goods=0)下单:验证不触发周期佣金计算(brokerage_scope=queue_only 时)
  • 报单商品订单确认页:验证"积分抵扣"入口不显示
  • 不考核用户购买报单商品:佣金仍正常发放给推荐人
  • 管理后台用户列表:可见 frozen_pointsavailable_points 两列,并可操作"不考核"

以上配置完成后,范氏国香商城 fsgx 改造即告完成,可正式上线运营。