2026-03-23 22:32:19 +08:00
|
|
|
|
# 范氏国香商城 — Phase 7 后台配置与验收清单
|
|
|
|
|
|
|
|
|
|
|
|
> 本文档为运营人员在部署后，通过 CRMEB 管理后台完成配置的操作指南，同时提供全链路测试步骤。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 7.1 执行数据库迁移
|
|
|
|
|
|
|
|
|
|
|
|
在服务器上执行以下 SQL 迁移脚本（每次部署后执行一次，使用 `INSERT IGNORE` 和 `ADD COLUMN IF NOT EXISTS` 保证幂等性）：
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
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_points`、`available_points`、`no_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 周期佣金）
|
|
|
|
|
|
|
|
|
|
|
|
路径：**营销 → 分销 → 返佣设置 → 推荐佣金（fsgx）Tab**
|
|
|
|
|
|
|
|
|
|
|
|
| 配置项 | 推荐值 | 说明 |
|
|
|
|
|
|
|--------------|----------------|----------------------------------|
|
|
|
|
|
|
| 佣金周期人数 | `3` | 推荐3人为一个完整周期 |
|
|
|
|
|
|
| 各档佣金比例 | `[20,30,50]` | 第1人20%，第2人30%，第3人50%，JSON格式 |
|
|
|
|
|
|
| 返佣范围 | 仅报单商品 | 仅 `is_queue_goods=1` 的商品参与 |
|
|
|
|
|
|
| 佣金发放时机 | 支付即发放 | 用户付款后立即发放佣金 |
|
|
|
|
|
|
|
|
|
|
|
|
> 如果返佣设置页面没有"推荐佣金（fsgx）"Tab，请确认已运行 `fsgx_v1.sql` 迁移脚本。
|
|
|
|
|
|
|
|
|
|
|
|
### 7.3.3 提现设置
|
|
|
|
|
|
|
feat(fsgx): HJF queue merge, brokerage timing, cycle commission, points release
- Add HJF jobs, services, DAOs, models, admin/API controllers, release command
- Respect brokerage_timing (on_pay vs confirm); dispatch HjfOrderPayJob for queue goods
- Queue-only cycle commission and position index fix in StoreOrderCreateServices
- UserBill income types: frozen_points_brokerage, frozen_points_release
- Timer: fsgx_release_frozen_points -> PointsReleaseServices
- Agent tasks: no_assess filtering for direct/umbrella counts
- Migrations: queue_pool, points_release_log, fsgx_v1 checklist updates
- Admin/uniapp: crontab preset, membership level, user list, finance routes, docs
Made-with: Cursor
2026-03-24 11:59:09 +08:00
|
|
|
|
路径：**财务 → 分销财务 → 提现设置（已存在）**
|
2026-03-23 22:32:19 +08:00
|
|
|
|
|
|
|
|
|
|
- 提现手续费率：`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%**）
|
2026-03-24 19:05:53 +08:00
|
|
|
|
- [ ] 验证用户A 的 `frozen_points` 增加
|
2026-03-23 22:32:19 +08:00
|
|
|
|
- [ ] 小程序"推荐佣金"页：`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_points`、`available_points` 两列，并可操作"不考核"
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
*以上配置完成后，范氏国香商城 fsgx 改造即告完成，可正式上线运营。*
|
