# 范氏国香商城 — 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 提现设置

路径：**财务 → 分销财务 → 提现设置（已存在）** 

- 提现手续费率：`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_points`、`available_points` 两列，并可操作"不考核"

---

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