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:
apple
2026-03-23 22:32:19 +08:00
parent 788ee0c0c0
commit 434aa8c69d
13098 changed files with 2008990 additions and 961 deletions

View File

@@ -12,8 +12,8 @@ import {
getMockWithdrawInfo
} from '@/utils/hjfMockData.js';
/** @type {boolean} 是否使用 Mock 数据(Phase 1 开发为 truePhase 4 集成改为 false */
const USE_MOCK = true;
/** @type {boolean} 是否使用 Mock 数据(已切换到真实接口 */
const USE_MOCK = false;
/**
* Mock 包装:返回与 request 相同形状的 Promisestatus + data带延迟模拟网络

View File

@@ -1,63 +1,27 @@
/**
* 黄精粉健康商城 - 会员模块 API
* 会员信息、团队数据、团队收益
* @module api/hjfMember
* fsgx: 会员/团队 API已改用 CRMEB 原生分销接口)
* 旧公排会员 API 已废弃getTeamData/getTeamIncome 重定向到 CRMEB spread 接口
*/
import request from '@/utils/request.js';
import {
getMockMemberInfo,
getMockTeamData,
getMockTeamIncome
} from '@/utils/hjfMockData.js';
/** @type {boolean} Phase 1 前端开发为 truePhase 4 集成时改为 false */
const USE_MOCK = true;
/**
* Mock 包装:返回与 request.get() 相同形状的 Promise
* @param {Object} data - 要返回的响应体数据
* @param {number} [delay=300] - 模拟网络延迟(毫秒)
* @returns {Promise<{ status: number, data: Object }>}
*/
function mockResponse(data, delay = 300) {
return new Promise(resolve => {
setTimeout(() => {
resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
}, delay);
});
}
/**
* 获取会员信息(等级、直推/伞下人数、升级进度等)
* @returns {Promise<{ status: number, data: Object }>} 会员信息
* 获取会员信息(改用资产总览接口)
*/
export function getMemberInfo() {
if (USE_MOCK) return mockResponse(getMockMemberInfo());
return request.get('hjf/member/info');
return request.get('hjf/assets/overview');
}
/**
* 获取团队成员列表(直推/伞下成员、分页
* @param {Object} [params] - 查询参数
* @param {number} [params.page] - 页码
* @param {number} [params.limit] - 每页条数
* @param {string} [params.type] - 筛选类型(如 direct/umbrella
* @returns {Promise<{ status: number, data: Object }>} 团队数据
* 获取团队成员列表(复用 CRMEB 推广用户列表接口
*/
export function getTeamData(params) {
if (USE_MOCK) return mockResponse(getMockTeamData());
return request.get('hjf/member/team', params);
return request.get('spread/people', params);
}
/**
* 获取团队收益明细(直推奖励、伞下奖励等
* @param {Object} [params] - 查询参数
* @param {number} [params.page] - 页码
* @param {number} [params.limit] - 每页条数
* @returns {Promise<{ status: number, data: Object }>} 团队收益列表
* 获取团队收益明细(复用 CRMEB 推广佣金明细接口
*/
export function getTeamIncome(params) {
if (USE_MOCK) return mockResponse(getMockTeamIncome());
return request.get('hjf/member/income', params);
return request.get('spread/commission/1', params);
}

View File

@@ -1,45 +1,17 @@
/**
* 黄精粉健康商城 - 公排相关 API
* 公排状态、公排历史记录
* @see docs/frontend-new-pages-spec.md 2.2.1
* fsgx: 推荐佣金相关 API已替换公排模块
* 公排 API 已废弃,仅保留佣金周期进度聚合接口
*/
import request from '@/utils/request.js';
import { getMockQueueStatus, getMockQueueHistory } from '@/utils/hjfMockData.js';
/** @type {boolean} 是否使用 Mock 数据Phase 4 集成时改为 false */
const USE_MOCK = true;
/**
* Mock 包装:返回与 request.get() 相同形状的 Promise
* 300ms 延迟模拟网络JSON 深拷贝防止数据突变
* @param {*} data - 要返回的数据
* @param {number} [delay=300] - 延迟毫秒数
* @returns {Promise<{ status: number, data: * }>}
* 获取推荐佣金周期进度(聚合接口)
* @returns {Promise<{ cycle_total, cycle_current, cycle_rates, total_brokerage, total_completed }>}
*/
function mockResponse(data, delay = 300) {
return new Promise(resolve => {
setTimeout(() => {
resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
}, delay);
});
export function getBrokerageProgress() {
return request.get('hjf/brokerage/progress');
}
/**
* 获取公排状态(我的排队 + 全局进度)
* @returns {Promise<{ status: number, data: { totalOrders: number, myOrders: Array, progress: Object } }>}
*/
export function getQueueStatus() {
if (USE_MOCK) return mockResponse(getMockQueueStatus());
return request.get('hjf/queue/status');
}
/**
* 获取公排历史记录(分页)
* @param {Object} [params] - 查询参数,如 page、limit
* @returns {Promise<{ status: number, data: { list: Array, count: number, page: number, limit: number } }>}
*/
export function getQueueHistory(params) {
if (USE_MOCK) return mockResponse(getMockQueueHistory());
return request.get('hjf/queue/history', params);
}
// 兼容旧名 - 迁移期保留
export const getQueueStatus = getBrokerageProgress;