434aa8c69d
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
4.0 KiB
4.0 KiB
name, overview, todos, isProject
| name | overview | todos | isProject | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| fsgx PRD document | 根据《范氏国香小程序fsgx-V1.0》需求文档，对照当前代码库（基于黄精粉 HJF PRD V2.0），编写一份新的 PRD 文档 `docs/PRD_fsgx_V1.0.md`，标注所有与当前版本不一致或当前版本不满足的功能点。 |
|
false |
范氏国香小程序 PRD 文档编写计划
文档输出
在 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 文档将包含以下章节：
- 文档说明 -- 术语定义、版本信息
- 产品概述 -- 产品背景、定位、目标用户
- 核心业务逻辑 -- 推荐返现机制、会员等级、账户积分体系
- 用户端功能需求 -- 登录注册、首页、商品购买、推荐裂变、个人中心
- 管理后台功能需求 -- 仪表盘、用户管理、商品管理、订单管理、财务管理、活动管理、营销配置、内容管理、数据统计
- 与当前版本差异总结 -- 专门章节，表格列出所有差异项及影响评估
- 数据库改造方案
- 非功能性需求