---
name: fsgx PRD document
overview: 根据《范氏国香小程序fsgx-V1.0》需求文档，对照当前代码库（基于黄精粉 HJF PRD V2.0），编写一份新的 PRD 文档 `docs/PRD_fsgx_V1.0.md`，标注所有与当前版本不一致或当前版本不满足的功能点。
todos:
  - id: write-prd
    content: 在 docs/PRD_fsgx_V1.0.md 编写完整的 PRD 文档，包含所有章节
    status: completed
isProject: false
---

# 范氏国香小程序 PRD 文档编写计划

## 文档输出

在 [docs/PRD_fsgx_V1.0.md](docs/PRD_fsgx_V1.0.md) 创建新的 PRD 文档。

## 关键差异分析结果

通过对比 fsgx V1.0 需求文档与当前代码库（HJF PRD V2.0 + 实际实现），识别出以下核心差异：

### 1. 品牌与商品变更

- 产品名称：黄精粉健康商城 → **范氏国香商城**
- 核心商品：黄精粉套餐 3600 元/单 → **艾制品三条套餐 4333 元/单**
- 产品定位：黄精粉（健康食品） → **艾制品（健康艾灸产品）**

### 2. 核心业务逻辑 -- 奖励机制（重大变更）

**当前版本（HJF）**："公排进四退一"全局排队池机制，每进 4 单退 1 单全额返还。

**fsgx V1.0 要求**："邀请三人自己免单"直推返现机制：

- 推荐第 1 人购买 → 推荐人获 **20%** 现金返还
- 推荐第 2 人购买 → 推荐人获 **30%** 现金返还
- 推荐第 3 人购买 → 推荐人获 **50%** 现金返还（合计 100% 免单）
- 第 4 人起循环上述比例 + 额外积分奖励
- 推荐人数和返现比例后台**可自由设置**

**影响范围**：

- 后端：需重写奖励计算引擎，从全局队列退款改为直推层级返现
- 前端 uniapp：`pages/queue/` 下的公排页面需改造为推荐返现展示
- 前端 admin：`pages/hjf/queueOrder/`、`queueConfig/`、`queueFinance/` 需改造
- Mock 数据：`hjfMockData.js` 中的公排相关数据需替换为返现数据

### 3. 现金余额来源变更

- **当前版本**：公排退款 + 后台手动充值
- **fsgx V1.0**：**推荐返现** + 后台手动充值（无公排退款概念）

### 4. 普通会员即可获得推荐奖励（变更）

- **当前版本**：普通会员无奖励，升级创客后才有直推积分
- **fsgx V1.0**：普通会员升级为分销会员后直推即可获得 20%+30%+50% **现金**奖励；创客及以上额外获得**积分**奖励

### 5. 批量购买升级规则（新增）

- fsgx V1.0 新增："一次购买多单时，如果符合升级条件，先升级，然后 N-1 单可额外获得积分奖励"
- 当前版本无此逻辑

### 6. 订单取消方式（变更）

- **当前版本**：已付款订单不可取消，退款仅通过公排
- **fsgx V1.0**：**可通过后台取消订单，实现全额返还**

### 7. 返佣配置参数（变更）

- **当前版本**：公排触发倍数（N=4）
- **fsgx V1.0**：推荐奖励比例 = 3 人循环（20%+30%+50%），人数和比例均可配置

### 8. 一致保留的功能

以下功能 fsgx V1.0 与当前版本**一致**，无需变更：

- 四级分销等级体系（创客/云店/服务商/分公司）及升级门槛
- 积分体系（待释放积分 → 按日 0.4% 释放 → 已释放积分）
- 积分支付（仅普通商品）
- 提现手续费 7%
- 报单商品标记 `is_queue_goods`
- 登录注册、首页、商品管理、订单管理、活动管理、内容管理等基础模块

## 文档结构

PRD 文档将包含以下章节：

1. **文档说明** -- 术语定义、版本信息
2. **产品概述** -- 产品背景、定位、目标用户
3. **核心业务逻辑** -- 推荐返现机制、会员等级、账户积分体系
4. **用户端功能需求** -- 登录注册、首页、商品购买、推荐裂变、个人中心
5. **管理后台功能需求** -- 仪表盘、用户管理、商品管理、订单管理、财务管理、活动管理、营销配置、内容管理、数据统计
6. **与当前版本差异总结** -- 专门章节，表格列出所有差异项及影响评估
7. **数据库改造方案**
8. **非功能性需求**