# 黄精粉微信小程序 - 产品需求文档 (PRD)

**版本**: v1.0  
**日期**: 2026-03-06  
**状态**: 需求确认中

---

## 1. 项目概述

### 1.1 项目背景
黄精粉社交电商小程序，采用多级分销+公排返利模式，结合积分体系激励用户裂变推广。

### 1.2 核心模式
- **商品**: 黄精粉套餐（单价3600元）
- **机制**: 公排"进四退一"
- **推广**: 多级分销 + 积分奖励

---

## 2. 业务规则确认

### 待确认问题（请回复）

| 序号 | 问题 | 选项A | 选项B | 建议 |
|------|------|-------|-------|------|
| 1 | 公排池机制 | **全局统一队列**（所有订单进入一个队列） | 按推荐关系分队列 | 建议全局队列，逻辑简单 |
| 2 | 积分释放 | **按批次逐批释放**（每获得积分独立计算） | 汇总后统一释放 | 建议按批次，追溯清晰 |
| 3 | 提现手续费 | **固定7%** | 后台可配置 | 建议后台可配，灵活调整 |

**请回复数字选择（如：1A 2A 3B）**

---

## 3. 会员等级体系（已确定）

| 等级 | 升级条件 | 直推奖励 | 间推奖励（伞下）| 备注 |
|------|----------|----------|-----------------|------|
| 会员 | 注册即成为 | 公排池返利 | - | 购买进入公排池 |
| 创客 | 直推满3单 | 500积分/单 | - | 自动升级 |
| 云店 | 团队30单 | 800积分/单 | 300积分/单 | 伞下业绩分离 |
| 服务商 | 团队100单 | 1000积分/单 | 200积分/单 | - |
| 分公司 | 团队1000单 | 1300积分/单 | 300积分/单 | - |

> **云店分离规则**: 当伞下创客满30单成为云店时，该云店的业绩从原上级分离，独立计算

---

## 4. 积分体系

### 4.1 账户类型
| 账户 | 用途 | 来源 | 说明 |
|------|------|------|------|
| **现金账户** | 提现 | 公排返利 | 可提现，手续费7% |
| **待释放积分** | 等待释放 | 推荐奖励 | 不可直接使用 |
| **已释放积分** | 购物抵值 | 每日释放 | 不可提现，可购物 |

### 4.2 积分释放规则
- **释放比例**: 0.4%/天（后台可配置）
- **释放计算**: 待释放积分 × 0.4% → 已释放积分
- **释放时间**: 每日00:00统一计算

### 4.3 积分使用
- 可用于购买商品抵值
- 不可提现
- 与现金可组合支付

---

## 5. 公排"进四退一"机制

### 5.1 流程
```
用户购买套餐(3600元)
    ↓
进入公排池队列
    ↓
后续每进4单
    ↓
最早1单获得退款(3600元)到现金账户
```

### 5.2 关键规则（待确认）
- **队列类型**: [全局队列 / 分队列]
- **退款触发**: 每进4单触发1单退款
- **退款金额**: 等于购买金额（3600元）
- **可配置项**: 后期可能改为"进八退一"等

---

## 6. 推荐关系

### 6.1 绑定规则
- 用户A分享专属海报/链接给好友B
- B首次点击进入小程序即锁定上下级关系
- 绑定后不可更改

### 6.2 关系展示
- 个人中心显示"我的推荐"关系图
- 显示级别和团队人数
- 显示推荐收益明细

---

## 7. 商品系统

### 7.1 商品类型
| 类型 | 说明 | 参与公排 | 可用支付方式 |
|------|------|----------|--------------|
| 报单商品 | 黄精粉套餐等 | 是 | 微信/支付宝/余额/积分 |
| 普通商品 | 其他产品 | 否 | 微信/支付宝/余额/积分 |

### 7.2 支付方式配置
后台可设置每商品支持的支付方式：
- [ ] 微信支付
- [ ] 支付宝
- [ ] 余额支付
- [ ] 待释放积分
- [ ] 已释放积分

---

## 8. 页面结构

### 8.1 用户端（小程序）
| 页面 | 功能 |
|------|------|
| 首页 | Banner轮播、活动专区、商品推荐 |
| 商品详情 | 图文展示、购买、支付方式选择 |
| 购物车 | 商品管理、结算 |
| 订单中心 | 订单列表、详情、物流 |
| 个人中心 | 资产总览、等级展示 |
| 我的资产 | 余额、待释放积分、已释放积分 |
| 我的推荐 | 关系图、收益明细 |
| 提现 | 申请提现、记录 |

### 8.2 管理后台（PC）
| 模块 | 功能 |
|------|------|
| 仪表盘 | 数据统计、实时概况 |
| 订单管理 | 查看订单、发货、退款 |
| 商品管理 | 上架/下架、分类、支付方式配置 |
| 用户管理 | 用户列表、等级管理、关系树 |
| 营销中心 | 参数设置（公排比例、升级条件、积分释放率） |
| 活动管理 | 活动发布、报名管理、核销 |
| 财务管理 | 交易流水、提现审批、积分记录 |
| 内容管理 | Banner、文章发布 |

---

## 9. 技术架构

### 9.1 技术栈
| 层级 | 技术 |
|------|------|
| 小程序端 | UniApp 3 + Vue 3 |
| 后端API | Spring Boot 3.2 + JDK 17 |
| 数据库 | MySQL 8.0 |
| 缓存 | Redis |
| 定时任务 | XXL-Job |
| 支付 | 微信支付 SDK v3 |

### 9.2 项目仓库
- **单仓库 Monorepo**: `http://49.235.131.69:3000/scottpan/huangjingfen.git`
  - `mp/` - 小程序前端
  - `api/` - 后端API
  - `docs/` - 项目文档

---

## 10. 开发排期（预估）

| 阶段 | 工期 | 交付物 |
|------|------|--------|
| 需求确认 | 1天 | 确认业务规则 |
| 数据库设计 | 2天 | ER图、SQL脚本 |
| UI设计 | 3天 | 视觉稿、原型 |
| 后端开发 | 10天 | API接口 |
| 前端开发 | 10天 | 小程序页面 |
| 联调测试 | 5天 | 功能测试报告 |
| 上线部署 | 2天 | 生产环境 |

**总计约4周**

---

## 11. 下一步行动

请确认：
1. [ ] 上述待确认的三个业务规则
2. [ ] 是否还有其他补充需求
3. [ ] 期望的上线时间

确认后我立即开始数据库设计和UI原型。