Files
huangjingfen/pro_v3.5.1/.cursor/plans/fsgx_prd_document_dc5247ea.plan.md

95 lines
4.0 KiB
Markdown
Raw Normal View History

feat(fsgx): 完成全部24项开发任务 Phase1-7 Phase1 后端核心: - 新增 fsgx_v1.sql 迁移脚本(is_queue_goods/frozen_points/available_points/no_assess) - SystemConfigServices 返佣设置扩展(周期人数/分档比例/范围/时机) - StoreOrderCreateServices 周期循环佣金计算 - StoreOrderTakeServices 佣金发放后同步冻结积分 - StoreProductServices/StoreProduct 保存 is_queue_goods Phase2 后端接口: - GET /api/hjf/brokerage/progress 佣金周期进度 - GET /api/hjf/assets/overview 资产总览 - HjfPointsServices 每日 frozen_points 0.4‰ 释放定时任务 - PUT /adminapi/hjf/member/{uid}/no_assess 不考核接口 - GET /adminapi/hjf/points/release_log 积分日志接口 Phase3 前端清理: - hjfCustom.js 路由精简(仅保留 points/log) - hjfQueue.js/hjfMember.js API 清理/重定向至 CRMEB 原生接口 - pages.json 公排→推荐佣金/佣金记录/佣金规则 Phase4-5 前端改造: - queue/status.vue 推荐佣金进度页整体重写 - 商品详情/订单确认/支付结果页文案与逻辑改造 - 个人中心/资产页/引导页/规则页文案改造 - HjfQueueProgress/HjfRefundNotice/HjfAssetCard 组件改造 - 推广中心嵌入佣金进度摘要 - hjfMockData.js 全量更新(公排字段→佣金字段) Phase6 Admin 增强: - 用户列表新增 frozen_points/available_points 列及不考核操作按钮 - hjfPoints.js USE_MOCK=false 对接真实积分日志接口 Phase7 配置文档: - docs/fsgx-phase7-config-checklist.md 后台配置与全链路验收清单 Made-with: Cursor
2026-03-23 22:32:19 +08:00
---
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. **非功能性需求**