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
This commit is contained in:
94
pro_v3.5.1/.cursor/plans/fsgx_prd_document_dc5247ea.plan.md
Normal file
94
pro_v3.5.1/.cursor/plans/fsgx_prd_document_dc5247ea.plan.md
Normal file
@@ -0,0 +1,94 @@
|
||||
---
|
||||
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. **非功能性需求**
|
||||
|
||||
Reference in New Issue
Block a user