scottpan/huangjingfen
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
huangjingfen/docs/frontend-new-pages-spec.md
panchengyong 9dd3dca21d docs: 新增前端开发规范文档 + Agent 执行任务清单 
- frontend-new-pages-spec.md: 7 章开发规范，按业务模块组织（DB/前端/后端/测试），含 Mock 数据机制、改造复用页面规格、完整 mockData.js 定义
- openclaw-frontend-tasks.md: 74 个全生命周期任务（Phase 0-5），每个任务含完整 Agent Prompt，CP-01 检查点控制前后端阶段切换

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 14:07:55 +08:00

54 KiB
Raw Permalink Blame History

黄精粉健康商城 · 前端开发规范文档

技术底座：CRMEB Pro v3.5 二次开发 文档版本：V2.0 · 2026年3月 配套文件：docs/openclaw-frontend-tasks.md（Agent 执行任务清单）

1. 文档说明

1.1 目的与读者

本文档为黄精粉健康商城微信小程序的前端开发规范，按业务模块组织，每个模块包含四部分：

  1. 数据库设计 — 建表 SQL、索引、字段修改
  2. 前端开发 — API 模块（含 Mock）、组件、页面、路由注册
  3. 后端开发 — Controller / Service / Dao / 路由 / API 契约
  4. 测试用例 — 前端渲染、后端接口、E2E 流程

读者：AI Agent（OpenClaw）、前端开发、后端开发、测试工程师

1.2 技术约定

1.2.1 UniApp（移动端）

维度 约定
框架 Vue 2 Options API (data / methods / computed / watch)
样式 <style scoped lang="scss">，使用 rpx 单位
主题色 CSS 变量 var(--view-theme) / var(--view-gradient)
组件前缀 Hjf（如 HjfQueueProgress、HjfAssetCard）
API 模块 放 api/ 目录，导入 import request from "@/utils/request.js"
请求方式 request.get(url, params) / request.post(url, data)
分页模式 page + limit，onReachBottom() 上拉加载
空状态 引入 emptyPage 组件
金额展示 保留两位小数，元为单位

1.2.2 Admin（管理后台）

维度 约定
UI 框架 iView Admin（Card / Form / Table / Page）
布局组件 BasicLayout（路由注册时使用）
API 模块 放 api/ 目录，导入 import request from '@/plugins/request'
请求方式 request({ url, method, params/data })
列表页模式 formValidate 对象 + columns 数组 + getList() / pageChange()
路由命名 前缀 const pre = 'hjf_'，如 ${pre}queueOrder
权限标识 meta: { auth: ['hjf-queue-order'] }

1.3 参考文件清单

文件路径 用途
docs/PRD_V2.md 业务需求 + 数据库 schema + API 契约
docs/黄精粉小程序_Figma_UI设计说明文档.md 页面编号 (P12-P23) + UI 规范
pro_v3.5.1/view/uniapp/api/user.js UniApp API 模块编写规范
pro_v3.5.1/view/uniapp/utils/request.js HTTP 请求封装（Mock 注入点）
pro_v3.5.1/view/uniapp/pages/users/user_bill/index.vue 列表页标准（分组 + 翻页）
pro_v3.5.1/view/uniapp/pages/users/user_money/index.vue 资产页渐变卡片模式
pro_v3.5.1/view/uniapp/pages/user/index.vue 个人中心 DIY 架构（改造目标）
pro_v3.5.1/view/uniapp/pages/users/user_cash/index.vue 提现页（改造目标）
pro_v3.5.1/view/admin/src/pages/finance/commission/index.vue Admin 列表页 (Card+Form+Table+Page)
pro_v3.5.1/view/admin/src/api/finance.js Admin API 模块规范
pro_v3.5.1/view/admin/src/router/modules/finance.js Admin 路由注册规范

1.4 Mock 数据机制说明

1.4.1 设计目标

前端开发阶段（Phase 1）不依赖后端 API，所有页面使用本地 Mock 数据渲染，保证：

  • 页面加载后立即可浏览和交互
  • Mock 数据具有真实感（合理的金额、时间、状态分布）
  • Phase 4 集成时仅需修改 USE_MOCK = false 即可切换到真实 API

1.4.2 UniApp Mock 模式

Mock 数据集中管理：pro_v3.5.1/view/uniapp/utils/hjfMockData.js

API 模块内 USE_MOCK 开关：

// pro_v3.5.1/view/uniapp/api/hjfQueue.js
import request from "@/utils/request.js";
import { MOCK_QUEUE_STATUS, MOCK_QUEUE_HISTORY } from '@/utils/hjfMockData.js';

const USE_MOCK = true; // Phase 4 时改为 false

/**
 * Mock 包装：返回与 request.get() 相同形状的 Promise
 * 300ms 延迟模拟网络，JSON 深拷贝防止数据突变
 */
function mockResponse(data, delay = 300) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

export function getQueueStatus() {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_STATUS);
  return request.get('hjf/queue/status');
}

export function getQueueHistory(params) {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_HISTORY);
  return request.get('hjf/queue/history', params);
}

1.4.3 Admin Mock 模式

Mock 数据集中管理：pro_v3.5.1/view/admin/src/utils/hjfMockData.js

// pro_v3.5.1/view/admin/src/api/hjfQueue.js
import request from '@/plugins/request';
import { MOCK_QUEUE_ORDER_LIST, MOCK_QUEUE_CONFIG } from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 200) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

export function queueOrderListApi(data) {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_ORDER_LIST);
  return request({ url: 'hjf/queue/order_list', method: 'get', params: data });
}

1.4.4 开关切换流程

阶段 USE_MOCK 说明
Phase 1（前端开发） true 使用本地 Mock 数据
Phase 4（前后端集成） false 切换到真实 API
生产环境 false 可删除 mock 导入（tree-shaking）

2. 公排模块

2.1 数据库设计

2.1.1 eb_queue_pool（公排池表）[NEW]

CREATE TABLE `eb_queue_pool` (
  `id` INT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
  `uid` INT UNSIGNED NOT NULL COMMENT '用户ID',
  `order_id` VARCHAR(64) NOT NULL COMMENT '原始订单号',
  `amount` DECIMAL(10,2) NOT NULL DEFAULT 3600.00 COMMENT '金额',
  `queue_no` BIGINT UNSIGNED NOT NULL COMMENT '全局排队序号',
  `status` TINYINT NOT NULL DEFAULT 0 COMMENT '0排队中 1已退款',
  `refund_time` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '退款时间戳',
  `trigger_batch` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '触发退款的批次号',
  `add_time` INT UNSIGNED NOT NULL COMMENT '入队时间戳',
  PRIMARY KEY (`id`),
  KEY `idx_uid` (`uid`),
  KEY `idx_status_queue_no` (`status`, `queue_no`),
  KEY `idx_trigger_batch` (`trigger_batch`),
  KEY `idx_add_time` (`add_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='公排池表';

2.2 前端开发

2.2.1 API 模块 — api/hjfQueue.js [NEW]

文件路径：pro_v3.5.1/view/uniapp/api/hjfQueue.js

import request from "@/utils/request.js";
import { MOCK_QUEUE_STATUS, MOCK_QUEUE_HISTORY } from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 300) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 获取公排状态（我的排队 + 全局进度） */
export function getQueueStatus() {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_STATUS);
  return request.get('hjf/queue/status');
}

/** 获取公排历史记录 */
export function getQueueHistory(params) {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_HISTORY);
  return request.get('hjf/queue/history', params);
}

2.2.2 组件 — HjfQueueProgress [NEW]

文件路径：pro_v3.5.1/view/uniapp/components/HjfQueueProgress.vue

功能：环形/条形进度条展示当前批次进度（如 2/4）

Props：

Prop 类型 说明
currentCount Number 当前批次已入队数
triggerMultiple Number 触发倍数（默认 4）
nextRefundNo Number 下一个退款的 queue_no

参考模式：参考 user_money/index.vue 的渐变卡片中嵌入统计数据的方式

2.2.3 组件 — HjfRefundNotice [NEW]

文件路径：pro_v3.5.1/view/uniapp/components/HjfRefundNotice.vue

功能：公排退款成功后的弹窗通知（退款金额、已入账到现金余额）

Props：

Prop 类型 说明
visible Boolean 是否显示
amount Number 退款金额
orderId String 订单号

2.2.4 P12 公排状态页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/queue/status.vue

页面结构：

  1. 顶部渐变卡片：公排池总单数 + 当前批次进度（引入 HjfQueueProgress）
  2. 我的排队列表：显示 myOrders 数组
    • 每条：排队序号 | 金额(¥3600.00) | 状态标签 | 预计等待
    • status=0 → 绿色"排队中"标签
    • status=1 → 灰色"已退款"标签
  3. 底部上拉加载更多

Mock 数据（来自 hjfMockData.js 的 MOCK_QUEUE_STATUS）：

{
  "totalOrders": 156,
  "myOrders": [
    {
      "id": 1,
      "order_id": "HJF202603100001",
      "amount": 3600.00,
      "queue_no": 142,
      "status": 0,
      "refund_time": 0,
      "trigger_batch": 0,
      "add_time": 1741593600,
      "position": 14,
      "estimated_wait": "约3天"
    },
    {
      "id": 2,
      "order_id": "HJF202603080002",
      "amount": 3600.00,
      "queue_no": 98,
      "status": 1,
      "refund_time": 1741507200,
      "trigger_batch": 24,
      "add_time": 1741420800,
      "position": 0,
      "estimated_wait": "已退款"
    }
  ],
  "progress": {
    "current_batch_count": 2,
    "trigger_multiple": 4,
    "next_refund_queue_no": 39
  }
}

参考文件：pages/users/user_money/index.vue（渐变卡片头部）+ pages/users/user_bill/index.vue（列表分页）

2.2.5 P13 公排历史记录页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/queue/history.vue

页面结构：

  1. Tab 筛选：全部 / 排队中 / 已退款
  2. 按日期分组的列表（参考 user_bill 模式）
  3. 每条记录：订单号 | 金额 | 退款时间 | 批次号

Mock 数据（来自 MOCK_QUEUE_HISTORY）：

{
  "list": [
    {
      "id": 1,
      "order_id": "HJF202603050001",
      "amount": 3600.00,
      "queue_no": 45,
      "status": 1,
      "refund_time": 1741334400,
      "trigger_batch": 11,
      "add_time": 1741161600,
      "time_key": "2026-03-07"
    },
    {
      "id": 2,
      "order_id": "HJF202603060002",
      "amount": 3600.00,
      "queue_no": 67,
      "status": 0,
      "refund_time": 0,
      "trigger_batch": 0,
      "add_time": 1741248000,
      "time_key": "2026-03-06"
    }
  ],
  "count": 25,
  "page": 1,
  "limit": 15
}

2.2.6 P14 公排规则说明页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/queue/rules.vue

页面结构：纯静态展示页面

  1. 公排机制图示（进四退一流程图）
  2. 规则条款列表
  3. 常见问题 FAQ 手风琴

无 Mock 数据依赖（静态页面）

2.2.7 pages.json 路由注册

在 subPackages 或 pages 中新增：

{
  "path": "pages/queue/status",
  "style": { "navigationBarTitleText": "公排状态" }
},
{
  "path": "pages/queue/history",
  "style": { "navigationBarTitleText": "公排记录" }
},
{
  "path": "pages/queue/rules",
  "style": { "navigationBarTitleText": "公排规则" }
}

2.3 后端开发

2.3.1 后端文件清单

文件 类型 说明
app/model/queue/QueuePool.php Model [NEW] eb_queue_pool 模型
app/dao/queue/QueuePoolDao.php Dao [NEW] 数据访问层
app/services/queue/QueuePoolService.php Service [NEW] 公排核心逻辑
app/services/queue/QueueRefundService.php Service [NEW] 退款处理
app/api/controller/v1/queue/QueuePoolController.php Controller [NEW] API 端控制器
route/api.php Route [MOD] 添加公排路由

2.3.2 API 契约

方法 路径 参数 返回
GET hjf/queue/status — { totalOrders, myOrders[], progress }
GET hjf/queue/history page, limit, status { list[], count, page, limit }

2.4 测试用例

测试类型 测试点 验收标准
前端渲染 P12 页面 Mock 数据渲染 卡片显示总单数、列表展示排队记录、进度条正确
前端渲染 P13 页面 Tab 筛选 切换 Tab 后列表正确过滤
后端接口 GET /hjf/queue/status 返回当前用户的排队记录和全局进度
E2E 购买报单商品 → 入队 → 查看状态 支付后公排状态页显示新记录
E2E 进四退一触发 第4单入队后最早1单退款到余额

3. 资产与积分模块

3.1 数据库设计

3.1.1 eb_user 新增字段 [MOD]

ALTER TABLE `eb_user`
  ADD COLUMN `member_level` TINYINT NOT NULL DEFAULT 0 COMMENT '会员等级: 0普通 1创客 2云店 3服务商 4分公司',
  ADD COLUMN `no_assess` TINYINT NOT NULL DEFAULT 0 COMMENT '不考核标记: 0正常 1不考核',
  ADD COLUMN `frozen_points` BIGINT NOT NULL DEFAULT 0 COMMENT '待释放积分',
  ADD COLUMN `available_points` BIGINT NOT NULL DEFAULT 0 COMMENT '已释放积分';

3.1.2 eb_points_release_log（积分释放日志表）[NEW]

CREATE TABLE `eb_points_release_log` (
  `id` INT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
  `uid` INT UNSIGNED NOT NULL COMMENT '用户ID',
  `frozen_before` BIGINT NOT NULL COMMENT '释放前待释放积分',
  `release_amount` BIGINT NOT NULL COMMENT '本次释放积分数',
  `frozen_after` BIGINT NOT NULL COMMENT '释放后待释放积分',
  `release_date` DATE NOT NULL COMMENT '释放日期',
  `add_time` INT UNSIGNED NOT NULL COMMENT '记录时间',
  PRIMARY KEY (`id`),
  KEY `idx_uid` (`uid`),
  KEY `idx_release_date` (`release_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='积分释放日志表';

3.2 前端开发

3.2.1 API 模块 — api/hjfAssets.js [NEW]

文件路径：pro_v3.5.1/view/uniapp/api/hjfAssets.js

import request from "@/utils/request.js";
import {
  MOCK_ASSETS_OVERVIEW, MOCK_POINTS_DETAIL,
  MOCK_CASH_DETAIL, MOCK_WITHDRAW_INFO
} from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 300) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 获取资产总览 */
export function getAssetsOverview() {
  if (USE_MOCK) return mockResponse(MOCK_ASSETS_OVERVIEW);
  return request.get('hjf/assets/overview');
}

/** 获取积分明细 */
export function getPointsDetail(params) {
  if (USE_MOCK) return mockResponse(MOCK_POINTS_DETAIL);
  return request.get('hjf/assets/points_detail', params);
}

/** 获取现金流水明细 */
export function getCashDetail(params) {
  if (USE_MOCK) return mockResponse(MOCK_CASH_DETAIL);
  return request.get('hjf/assets/cash_detail', params);
}

/** 获取提现信息（可提现余额、手续费率、最低金额） */
export function getWithdrawInfo() {
  if (USE_MOCK) return mockResponse(MOCK_WITHDRAW_INFO);
  return request.get('hjf/assets/withdraw_info');
}

3.2.2 API 模块 — api/hjfMember.js [NEW]

文件路径：pro_v3.5.1/view/uniapp/api/hjfMember.js

import request from "@/utils/request.js";
import { MOCK_MEMBER_INFO, MOCK_TEAM_DATA, MOCK_TEAM_INCOME } from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 300) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 获取会员信息（等级、团队统计） */
export function getMemberInfo() {
  if (USE_MOCK) return mockResponse(MOCK_MEMBER_INFO);
  return request.get('hjf/member/info');
}

/** 获取团队成员列表 */
export function getTeamData(params) {
  if (USE_MOCK) return mockResponse(MOCK_TEAM_DATA);
  return request.get('hjf/member/team', params);
}

/** 获取推荐收益明细 */
export function getTeamIncome(params) {
  if (USE_MOCK) return mockResponse(MOCK_TEAM_INCOME);
  return request.get('hjf/member/income', params);
}

3.2.3 组件 — HjfAssetCard [NEW]

文件路径：pro_v3.5.1/view/uniapp/components/HjfAssetCard.vue

功能：三栏资产展示卡片（现金余额 / 待释放积分 / 已释放积分），渐变背景

Props：

Prop 类型 说明
nowMoney String 现金余额
frozenPoints Number 待释放积分
availablePoints Number 已释放积分
todayRelease Number 今日预计释放

参考模式：pages/users/user_money/index.vue 中的 .account 渐变卡片区域

3.2.4 组件 — HjfMemberBadge [NEW]

文件路径：pro_v3.5.1/view/uniapp/components/HjfMemberBadge.vue

功能：会员等级徽章（图标 + 等级名称）

Props：

Prop 类型 说明
level Number 等级数字 (0-4)
levelName String 等级名称
size String 'small' / 'normal' / 'large'

3.2.5 P15 资产总览页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/assets/index.vue

页面结构：

  1. HjfAssetCard 三栏资产卡片（渐变背景）
  2. 快捷导航卡片：
    • 现金余额 → 提现页
    • 待释放积分 → 积分明细
    • 已释放积分 → 积分明细
    • 公排记录 → P12 公排状态页
  3. 今日释放提示：「今日预计释放 X 积分」

Mock 数据（来自 MOCK_ASSETS_OVERVIEW）：

{
  "now_money": "7200.00",
  "frozen_points": 15000,
  "available_points": 3200,
  "today_release": 6,
  "total_queue_refund": "14400.00",
  "total_points_earned": 18200,
  "member_level": 2,
  "member_level_name": "云店"
}

参考文件：pages/users/user_money/index.vue（整体布局 + 渐变卡片 + 导航卡片）

3.2.6 P18 积分明细页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/assets/points_detail.vue

页面结构：

  1. Tab 筛选：全部 / 直推奖励 / 伞下奖励 / 每日释放 / 消费
  2. 按日期分组的列表
  3. 每条：标题 | 积分数(±) | 状态(待释放/已释放) | 时间

Mock 数据（来自 MOCK_POINTS_DETAIL）：

{
  "list": [
    {
      "id": 1,
      "title": "直推奖励 - 用户张三购买报单商品",
      "type": "reward_direct",
      "points": 800,
      "pm": 1,
      "status": "frozen",
      "add_time": "2026-03-10 14:30",
      "order_id": "HJF202603100005"
    },
    {
      "id": 2,
      "title": "每日释放 - 待释放积分自动解冻",
      "type": "release",
      "points": 6,
      "pm": 1,
      "status": "released",
      "add_time": "2026-03-10 00:00"
    },
    {
      "id": 3,
      "title": "积分消费 - 购买普通商品",
      "type": "consume",
      "points": 200,
      "pm": 0,
      "status": "released",
      "add_time": "2026-03-09 16:22",
      "order_id": "HJF202603090012"
    }
  ],
  "count": 45,
  "page": 1,
  "limit": 15
}

参考文件：pages/users/user_bill/index.vue（Tab 筛选 + 分组列表 + 上拉加载）

3.2.7 pages.json 路由注册

{
  "path": "pages/assets/index",
  "style": { "navigationBarTitleText": "我的资产" }
},
{
  "path": "pages/assets/points_detail",
  "style": { "navigationBarTitleText": "积分明细" }
}

3.3 后端开发

3.3.1 后端文件清单

文件 类型 说明
app/model/points/PointsReleaseLog.php Model [NEW] 积分释放日志模型
app/dao/points/PointsReleaseLogDao.php Dao [NEW] 数据访问层
app/services/points/PointsReleaseService.php Service [NEW] 每日释放逻辑
app/services/points/PointsPayService.php Service [NEW] 积分支付逻辑
app/services/member/MemberLevelService.php Service [NEW] 等级升级逻辑
app/services/member/MemberRewardService.php Service [NEW] 积分奖励计算
app/services/member/MemberTeamService.php Service [NEW] 团队业绩统计
app/api/controller/v1/user/HjfAssetsController.php Controller [NEW] 资产 API
app/api/controller/v1/user/HjfMemberController.php Controller [NEW] 会员 API

3.3.2 API 契约

方法 路径 参数 返回
GET hjf/assets/overview — { now_money, frozen_points, available_points, today_release, member_level, member_level_name }
GET hjf/assets/points_detail page, limit, type { list[], count, page, limit }
GET hjf/assets/cash_detail page, limit { list[], count, page, limit }
GET hjf/assets/withdraw_info — { now_money, min_extract, fee_rate, extract_bank[] }
GET hjf/member/info — { member_level, member_level_name, direct_count, umbrella_count, umbrella_orders }
GET hjf/member/team page, limit, type { members[], count, page, limit }
GET hjf/member/income page, limit { list[], count, page, limit }

3.4 测试用例

测试类型 测试点 验收标准
前端渲染 P15 资产总览 Mock 渲染 三栏卡片显示正确金额和积分
前端渲染 P18 积分明细 Tab 筛选 切换 Tab 后列表过滤正确
后端接口 积分每日释放定时任务 frozen_points × 0.4‰ 正确转入 available_points
后端接口 会员等级升级 直推满3单自动升为创客
E2E 推荐购买 → 积分到账 → 每日释放 → 积分消费 全流程积分流转正确

4. 新用户引导模块

4.1 数据库设计

无新表。引导状态可通过 eb_user 的首次登录时间判断。

4.2 前端开发

4.2.1 P23 新用户引导页 [NEW]

文件路径：pro_v3.5.1/view/uniapp/pages/guide/hjf_intro.vue

页面结构：

  1. 轮播引导（3-4 屏）
    • 第1屏：平台介绍（健康商城概览）
    • 第2屏：公排规则图示（进四退一）
    • 第3屏：会员等级与积分说明
    • 第4屏：「立即开始」按钮 → 跳转首页
  2. 底部指示器 + 跳过按钮

Mock 数据（来自 MOCK_GUIDE_DATA）：

{
  "slides": [
    {
      "title": "欢迎来到黄精粉健康商城",
      "desc": "健康好物，品质生活",
      "image": "/static/images/guide/slide1.png"
    },
    {
      "title": "公排返利机制",
      "desc": "购买报单商品自动进入公排，每进4单退1单全额返还",
      "image": "/static/images/guide/slide2.png"
    },
    {
      "title": "会员积分体系",
      "desc": "推荐好友即获积分奖励，积分每日自动释放",
      "image": "/static/images/guide/slide3.png"
    }
  ]
}

4.2.2 pages.json 路由注册

{
  "path": "pages/guide/hjf_intro",
  "style": { "navigationBarTitleText": "", "navigationStyle": "custom" }
}

4.3 后端开发

无后端接口需求。

4.4 测试用例

测试类型 测试点 验收标准
前端渲染 P23 轮播引导 3 屏正常滑动，指示器同步
前端交互 跳过/立即开始 正确跳转至首页

5. 管理后台新增页面

5.1 数据库设计

共享模块 2-3 的表（eb_queue_pool、eb_points_release_log、eb_user 字段）。

5.2 前端开发

5.2.1 Admin API — api/hjfQueue.js [NEW]

文件路径：pro_v3.5.1/view/admin/src/api/hjfQueue.js

import request from '@/plugins/request';
import {
  MOCK_QUEUE_ORDER_LIST, MOCK_QUEUE_CONFIG,
  MOCK_QUEUE_FINANCE
} from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 200) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 公排订单列表 */
export function queueOrderListApi(data) {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_ORDER_LIST);
  return request({ url: 'hjf/queue/order_list', method: 'get', params: data });
}

/** 公排参数配置-获取 */
export function queueConfigGetApi() {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_CONFIG);
  return request({ url: 'hjf/queue/config', method: 'get' });
}

/** 公排参数配置-保存 */
export function queueConfigSaveApi(data) {
  if (USE_MOCK) return mockResponse({ success: true });
  return request({ url: 'hjf/queue/config', method: 'put', data });
}

/** 公排财务流水 */
export function queueFinanceListApi(data) {
  if (USE_MOCK) return mockResponse(MOCK_QUEUE_FINANCE);
  return request({ url: 'hjf/queue/finance', method: 'get', params: data });
}

5.2.2 Admin API — api/hjfMember.js [NEW]

文件路径：pro_v3.5.1/view/admin/src/api/hjfMember.js

import request from '@/plugins/request';
import { MOCK_MEMBER_LIST, MOCK_MEMBER_CONFIG } from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 200) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 会员管理列表 */
export function memberListApi(data) {
  if (USE_MOCK) return mockResponse(MOCK_MEMBER_LIST);
  return request({ url: 'hjf/member/list', method: 'get', params: data });
}

/** 会员等级调整 */
export function memberLevelUpdateApi(uid, data) {
  if (USE_MOCK) return mockResponse({ success: true });
  return request({ url: `hjf/member/level/${uid}`, method: 'put', data });
}

/** 会员配置-获取 */
export function memberConfigGetApi() {
  if (USE_MOCK) return mockResponse(MOCK_MEMBER_CONFIG);
  return request({ url: 'hjf/member/config', method: 'get' });
}

/** 会员配置-保存 */
export function memberConfigSaveApi(data) {
  if (USE_MOCK) return mockResponse({ success: true });
  return request({ url: 'hjf/member/config', method: 'put', data });
}

5.2.3 Admin API — api/hjfPoints.js [NEW]

文件路径：pro_v3.5.1/view/admin/src/api/hjfPoints.js

import request from '@/plugins/request';
import { MOCK_POINTS_RELEASE_LOG } from '@/utils/hjfMockData.js';

const USE_MOCK = true;

function mockResponse(data, delay = 200) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({ status: 200, data: JSON.parse(JSON.stringify(data)) });
    }, delay);
  });
}

/** 积分释放日志列表 */
export function pointsReleaseLogApi(data) {
  if (USE_MOCK) return mockResponse(MOCK_POINTS_RELEASE_LOG);
  return request({ url: 'hjf/points/release_log', method: 'get', params: data });
}

5.2.4 公排订单管理页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/queueOrder/index.vue

页面结构（参考 finance/commission/index.vue）：

  1. 搜索区：用户昵称/ID + 状态筛选 + 日期范围
  2. 数据表格：用户信息 | 订单号 | 金额 | 排队序号 | 状态 | 退款时间 | 入队时间

Mock 数据（来自 MOCK_QUEUE_ORDER_LIST）：

{
  "list": [
    {
      "id": 1,
      "uid": 10086,
      "nickname": "王五",
      "phone": "138****8888",
      "order_id": "HJF202603100001",
      "amount": 3600.00,
      "queue_no": 142,
      "status": 0,
      "status_text": "排队中",
      "refund_time": "",
      "trigger_batch": 0,
      "add_time": "2026-03-10 10:00:00"
    },
    {
      "id": 2,
      "uid": 10087,
      "nickname": "张三",
      "phone": "139****9999",
      "order_id": "HJF202603080002",
      "amount": 3600.00,
      "queue_no": 98,
      "status": 1,
      "status_text": "已退款",
      "refund_time": "2026-03-09 12:00:00",
      "trigger_batch": 24,
      "add_time": "2026-03-08 09:30:00"
    }
  ],
  "count": 156,
  "page": 1,
  "limit": 20
}

Table Columns：

columns: [
  { title: '用户', slot: 'user', minWidth: 200 },
  { title: '订单号', key: 'order_id', minWidth: 180 },
  { title: '金额', key: 'amount', minWidth: 100 },
  { title: '排队序号', key: 'queue_no', minWidth: 100 },
  { title: '状态', slot: 'status', minWidth: 100 },
  { title: '退款时间', key: 'refund_time', minWidth: 160 },
  { title: '入队时间', key: 'add_time', minWidth: 160 }
]

5.2.5 公排财务流水页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/queueFinance/index.vue

页面结构：与公排订单类似，展示退款流水记录（批次号、退款金额、用户信息、时间）

Mock 数据（来自 MOCK_QUEUE_FINANCE）：

{
  "list": [
    {
      "id": 1,
      "uid": 10085,
      "nickname": "赵六",
      "trigger_batch": 24,
      "amount": 3600.00,
      "queue_no": 39,
      "refund_time": "2026-03-09 12:00:00"
    }
  ],
  "count": 39,
  "total_refund": "140400.00",
  "page": 1,
  "limit": 20
}

5.2.6 积分释放日志页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/pointsLog/index.vue

页面结构：

  1. 搜索区：用户昵称/ID + 日期范围
  2. 顶部统计：今日释放总量 / 今日释放用户数
  3. 数据表格：用户 | 释放前 | 释放量 | 释放后 | 日期

Mock 数据（来自 MOCK_POINTS_RELEASE_LOG）：

{
  "list": [
    {
      "id": 1,
      "uid": 10086,
      "nickname": "王五",
      "frozen_before": 15000,
      "release_amount": 6,
      "frozen_after": 14994,
      "release_date": "2026-03-10",
      "add_time": "2026-03-10 00:01:23"
    }
  ],
  "count": 500,
  "page": 1,
  "limit": 20,
  "statistics": {
    "total_released_today": 2450,
    "total_users_released": 320
  }
}

5.2.7 公排参数配置页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/queueConfig/index.vue

页面结构：表单页面（非列表页）

  • 公排触发倍数（InputNumber，默认 4）
  • 积分日释放比例（InputNumber，千分之 X，默认 4）
  • 提现手续费率（InputNumber，百分比，默认 7）
  • 保存按钮

Mock 数据（来自 MOCK_QUEUE_CONFIG）：

{
  "trigger_multiple": 4,
  "release_rate": 4,
  "withdraw_fee_rate": 7
}

5.2.8 会员等级配置页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/memberConfig/index.vue

页面结构：表单页面

  • 各等级升级门槛（创客/云店/服务商/分公司）
  • 各等级直推奖励积分
  • 各等级伞下奖励积分
  • 保存按钮

Mock 数据（来自 MOCK_MEMBER_CONFIG）：

{
  "chuangke_threshold": 3,
  "yundian_threshold": 30,
  "fuwushang_threshold": 100,
  "fengongsi_threshold": 1000,
  "chuangke_direct_reward": 500,
  "yundian_direct_reward": 800,
  "yundian_umbrella_reward": 300,
  "fuwushang_direct_reward": 1000,
  "fuwushang_umbrella_reward": 200,
  "fengongsi_direct_reward": 1300,
  "fengongsi_umbrella_reward": 300
}

5.2.9 会员管理页 [NEW]

文件路径：pro_v3.5.1/view/admin/src/pages/hjf/memberLevel/index.vue

页面结构：

  1. 搜索区：昵称/ID + 等级筛选 + 不考核筛选
  2. 数据表格：用户信息 | 等级 | 直推数 | 伞下业绩 | 待释放积分 | 已释放积分 | 余额 | 操作
  3. 操作列：调整等级 / 设置不考核

Mock 数据（来自 MOCK_MEMBER_LIST）：

{
  "list": [
    {
      "uid": 10086,
      "nickname": "王五",
      "phone": "138****8888",
      "avatar": "",
      "member_level": 2,
      "member_level_name": "云店",
      "no_assess": 0,
      "direct_count": 8,
      "umbrella_orders": 42,
      "frozen_points": 15000,
      "available_points": 3200,
      "now_money": "7200.00",
      "spread_uid": 10001,
      "spread_nickname": "推荐人A"
    }
  ],
  "count": 1200,
  "page": 1,
  "limit": 20
}

5.2.10 Admin 路由注册

新建文件：pro_v3.5.1/view/admin/src/router/modules/hjfQueue.js

import BasicLayout from '@/layouts/basic-layout';

const pre = 'hjf_';
export default {
  path: '/admin/hjf',
  name: 'hjf',
  header: 'hjf',
  meta: {
    auth: ['admin-hjf']
  },
  component: BasicLayout,
  children: [
    {
      path: 'queue/order',
      name: `${pre}queueOrder`,
      meta: { auth: ['hjf-queue-order'], title: '公排订单' },
      component: () => import('@/pages/hjf/queueOrder/index')
    },
    {
      path: 'queue/finance',
      name: `${pre}queueFinance`,
      meta: { auth: ['hjf-queue-finance'], title: '公排财务' },
      component: () => import('@/pages/hjf/queueFinance/index')
    },
    {
      path: 'queue/config',
      name: `${pre}queueConfig`,
      meta: { auth: ['hjf-queue-config'], title: '公排配置' },
      component: () => import('@/pages/hjf/queueConfig/index')
    },
    {
      path: 'points/log',
      name: `${pre}pointsLog`,
      meta: { auth: ['hjf-points-log'], title: '积分日志' },
      component: () => import('@/pages/hjf/pointsLog/index')
    },
    {
      path: 'member/config',
      name: `${pre}memberConfig`,
      meta: { auth: ['hjf-member-config'], title: '会员配置' },
      component: () => import('@/pages/hjf/memberConfig/index')
    },
    {
      path: 'member/level',
      name: `${pre}memberLevel`,
      meta: { auth: ['hjf-member-level'], title: '会员管理' },
      component: () => import('@/pages/hjf/memberLevel/index')
    }
  ]
};

路由注册入口：需在 router/modules/index.js 中导入此模块。

5.3 后端开发

5.3.1 后端文件清单

文件 类型 说明
app/adminapi/controller/v1/hjf/QueueOrderController.php Controller [NEW] 公排订单管理
app/adminapi/controller/v1/hjf/QueueConfigController.php Controller [NEW] 公排配置
app/adminapi/controller/v1/hjf/QueueFinanceController.php Controller [NEW] 公排财务
app/adminapi/controller/v1/hjf/PointsLogController.php Controller [NEW] 积分日志
app/adminapi/controller/v1/hjf/MemberLevelController.php Controller [NEW] 会员管理
app/adminapi/controller/v1/hjf/MemberConfigController.php Controller [NEW] 会员配置
route/adminapi.php Route [MOD] 添加管理后台路由

5.3.2 Admin API 契约

方法 路径 说明
GET hjf/queue/order_list 公排订单列表（分页 + 筛选）
GET hjf/queue/config 获取公排配置
PUT hjf/queue/config 保存公排配置
GET hjf/queue/finance 公排财务流水（分页）
GET hjf/points/release_log 积分释放日志（分页 + 统计）
GET hjf/member/list 会员列表（分页 + 等级筛选）
PUT hjf/member/level/{uid} 调整会员等级
GET hjf/member/config 获取会员配置
PUT hjf/member/config 保存会员配置

5.4 测试用例

测试类型 测试点 验收标准
前端渲染 6 个管理页面 Mock 渲染 表格/表单正常显示
后端接口 配置保存/读取 配置项正确持久化到 eb_system_config
后端接口 等级调整 手动调整后 member_level 正确更新
权限测试 无权限用户访问 返回 403

6. 改造复用页面

6.1 UniApp 改造（7 项）

6.1.1 首页改造 [MOD]

原始文件：pro_v3.5.1/view/uniapp/pages/index/index.vue

改造目的：在商品推荐区的报单商品卡片上增加「参与公排」角标

改动点清单：

# 改动位置 类型 说明
1 商品卡片 template 新增 根据 is_queue_goods 字段显示绿色/金色角标
2 style 新增 .queue-badge 角标样式（绝对定位右上角）

Mock 数据：在商品列表数据中增加 is_queue_goods: 1 字段标记

{ "id": 101, "store_name": "黄精粉套餐", "price": "3600.00", "is_queue_goods": 1 }

测试用例：商品列表中报单商品显示角标，普通商品不显示

6.1.2 商品详情改造 [MOD]

原始文件：pro_v3.5.1/view/uniapp/pages/goods_details/index.vue（或 subPackage 路径）

改造目的：支持多种支付方式选择（现金余额/待释放积分/已释放积分），报单商品不显示积分支付选项

改动点清单：

# 改动位置 类型 说明
1 购买弹窗 template 新增 支付方式选择区域（单选按钮组）
2 data() 新增 payMethod: 'wechat' 选中的支付方式
3 提交订单方法 修改 传递 pay_type 参数（wechat/balance/frozen_points/available_points）
4 商品信息区域 新增 报单商品显示「公排商品」标签

Mock 数据：商品详情增加 is_queue_goods 和 allow_pay_types 字段

{
  "is_queue_goods": 1,
  "allow_pay_types": ["wechat", "alipay", "balance"],
  "store_name": "黄精粉套餐",
  "price": "3600.00"
}

测试用例：

  • 报单商品：只显示微信/支付宝/余额支付，不显示积分支付
  • 普通商品：根据 allow_pay_types 显示对应支付方式

6.1.3 购买流程改造 [MOD]

涉及文件：订单确认页 + 支付回调处理

改造目的：多单拆分 + 公排入队逻辑（主要在后端，前端仅需传参）

改动点清单：

# 改动位置 类型 说明
1 订单确认页 修改 购买报单商品时数量>1 提示"将拆分为 N 个独立公排订单"
2 支付成功页 新增 报单商品支付成功后显示"已加入公排"提示 + 跳转公排状态

测试用例：购买 2 单报单商品 → 生成 2 笔独立订单 → 各自进入公排

6.1.4 我的订单改造 [MOD]

原始文件：订单列表/订单详情页

改造目的：在订单详情中增加公排状态展示

改动点清单：

# 改动位置 类型 说明
1 订单详情 template 新增 公排状态区域：排队序号 / 状态 / 预计等待
2 订单详情 data 新增 queueInfo 对象
3 API 调用 新增 调用 getQueueStatus() 获取该订单的公排信息

Mock 数据：

{
  "queueInfo": {
    "queue_no": 142,
    "status": 0,
    "position": 14,
    "estimated_wait": "约3天"
  }
}

测试用例：报单商品订单详情显示公排状态，普通商品订单不显示

6.1.5 推荐页改造 [MOD]

原始文件：pro_v3.5.1/view/uniapp/pages/users/user_spread_money/index.vue（或对应推荐收益页）

改造目的：将"佣金"概念替换为"积分奖励"，展示积分而非金额

改动点清单：

# 改动位置 类型 说明
1 页面标题 修改 "推广佣金" → "推荐收益"
2 金额展示 修改 佣金金额 → 积分数量（不带 ¥ 符号）
3 API 调用 修改 替换为 getTeamIncome()
4 列表项 修改 显示积分来源（直推/伞下）+ 积分类型（待释放）

Mock 数据：使用 MOCK_TEAM_INCOME（见第 7 章）

测试用例：收益列表显示积分数量而非佣金金额

6.1.6 提现页改造 [MOD]

原始文件：pro_v3.5.1/view/uniapp/pages/users/user_cash/index.vue

改造目的：手续费率改为 7%，实时计算并展示

改动点清单：

# 改动位置 类型 说明
1 提现金额输入区域 新增 实时显示「手续费：¥XX.XX（7%）
2 computed 新增 feeAmount 和 actualAmount 计算属性
3 提交逻辑 修改 传递 fee_rate 参数确认手续费

Mock 数据：使用 MOCK_WITHDRAW_INFO

{
  "now_money": "7200.00",
  "min_extract": 100,
  "fee_rate": 7,
  "extract_bank": ["微信零钱", "支付宝", "银行卡"]
}

测试用例：

  • 输入提现金额 1000 → 显示「手续费：¥70.00 | 实际到账：¥930.00」
  • 金额低于最低提现额 → 提示错误

6.1.7 个人中心改造 [MOD]

原始文件：pro_v3.5.1/view/uniapp/pages/user/index.vue

改造目的：增加会员等级徽章展示 + 资产入口导航

改动点清单：

# 改动位置 类型 说明
1 用户信息区 新增 引入 HjfMemberBadge 显示会员等级
2 DIY 菜单数据 新增 增加"我的资产"、"公排查询"导航项
3 import 新增 导入 getMemberInfo() 和 HjfMemberBadge 组件
4 onShow/methods 修改 合并调用 getMemberInfo() 获取等级信息

Mock 数据：使用 MOCK_MEMBER_INFO

{
  "member_level": 2,
  "member_level_name": "云店",
  "direct_count": 8,
  "umbrella_count": 35,
  "umbrella_orders": 42
}

测试用例：

  • 个人中心显示会员等级徽章
  • 点击"我的资产"跳转到 P15 资产总览页
  • 点击"公排查询"跳转到 P12 公排状态页

6.2 Admin 改造（2 项）

6.2.1 用户管理改造 [MOD]

原始文件：pro_v3.5.1/view/admin/src/pages/user/list/index.vue

改造目的：增加会员等级调整和不考核标记功能

改动点清单：

# 改动位置 类型 说明
1 columns 新增 增加"会员等级"列（slot 渲染等级名称 + 徽章）
2 columns 新增 增加"不考核"列（Tag 标记）
3 操作列 新增 增加"调整等级"按钮（弹窗选择等级）
4 操作列 新增 增加"设置不考核"开关
5 import 新增 导入 memberLevelUpdateApi
6 methods 新增 handleLevelChange(uid, level) / handleNoAssess(uid, flag)

Mock 数据：用户列表数据中增加 member_level、member_level_name、no_assess 字段

测试用例：

  • 用户列表显示等级和不考核标记
  • 点击调整等级后 member_level 更新
  • 设置不考核后 no_assess 标记变更

6.2.2 商品管理改造 [MOD]

原始文件：商品编辑页面（CRMEB 商品管理模块）

改造目的：增加报单商品标记和支付方式配置

改动点清单：

# 改动位置 类型 说明
1 商品编辑表单 新增 「报单商品」开关 (is_queue_goods)
2 商品编辑表单 新增 「支付方式」多选框组 (allow_pay_types)
3 保存逻辑 修改 传递 is_queue_goods + allow_pay_types 字段
4 商品列表 新增 「报单」标记列

Mock 数据：商品数据增加 is_queue_goods 和 allow_pay_types 字段

测试用例：

  • 商品编辑页可勾选报单商品
  • 报单商品自动禁用积分支付选项
  • 商品列表显示报单标记

7. Mock 数据总文件

7.1 UniApp Mock 数据文件

文件路径：pro_v3.5.1/view/uniapp/utils/hjfMockData.js

/**
 * 黄精粉健康商城 - UniApp Mock 数据集中管理
 * Phase 1 前端开发使用，Phase 4 集成后可移除
 */

// ========== 公排模块 ==========

export const MOCK_QUEUE_STATUS = {
  totalOrders: 156,
  myOrders: [
    {
      id: 1,
      order_id: 'HJF202603100001',
      amount: 3600.00,
      queue_no: 142,
      status: 0,
      refund_time: 0,
      trigger_batch: 0,
      add_time: 1741593600,
      position: 14,
      estimated_wait: '约3天'
    },
    {
      id: 2,
      order_id: 'HJF202603080002',
      amount: 3600.00,
      queue_no: 98,
      status: 1,
      refund_time: 1741507200,
      trigger_batch: 24,
      add_time: 1741420800,
      position: 0,
      estimated_wait: '已退款'
    },
    {
      id: 3,
      order_id: 'HJF202603070003',
      amount: 3600.00,
      queue_no: 85,
      status: 0,
      refund_time: 0,
      trigger_batch: 0,
      add_time: 1741334400,
      position: 46,
      estimated_wait: '约12天'
    }
  ],
  progress: {
    current_batch_count: 2,
    trigger_multiple: 4,
    next_refund_queue_no: 39
  }
};

export const MOCK_QUEUE_HISTORY = {
  list: [
    {
      id: 1,
      order_id: 'HJF202603050001',
      amount: 3600.00,
      queue_no: 45,
      status: 1,
      refund_time: 1741334400,
      trigger_batch: 11,
      add_time: 1741161600,
      time_key: '2026-03-07'
    },
    {
      id: 2,
      order_id: 'HJF202603060002',
      amount: 3600.00,
      queue_no: 67,
      status: 0,
      refund_time: 0,
      trigger_batch: 0,
      add_time: 1741248000,
      time_key: '2026-03-06'
    },
    {
      id: 3,
      order_id: 'HJF202603040003',
      amount: 3600.00,
      queue_no: 33,
      status: 1,
      refund_time: 1741248000,
      trigger_batch: 8,
      add_time: 1741075200,
      time_key: '2026-03-04'
    }
  ],
  count: 25,
  page: 1,
  limit: 15
};

// ========== 资产模块 ==========

export const MOCK_ASSETS_OVERVIEW = {
  now_money: '7200.00',
  frozen_points: 15000,
  available_points: 3200,
  today_release: 6,
  total_queue_refund: '14400.00',
  total_points_earned: 18200,
  member_level: 2,
  member_level_name: '云店'
};

export const MOCK_POINTS_DETAIL = {
  list: [
    {
      id: 1,
      title: '直推奖励 - 用户张三购买报单商品',
      type: 'reward_direct',
      points: 800,
      pm: 1,
      status: 'frozen',
      add_time: '2026-03-10 14:30',
      order_id: 'HJF202603100005'
    },
    {
      id: 2,
      title: '每日释放 - 待释放积分自动解冻',
      type: 'release',
      points: 6,
      pm: 1,
      status: 'released',
      add_time: '2026-03-10 00:00',
      release_date: '2026-03-10'
    },
    {
      id: 3,
      title: '积分消费 - 购买普通商品',
      type: 'consume',
      points: 200,
      pm: 0,
      status: 'released',
      add_time: '2026-03-09 16:22',
      order_id: 'HJF202603090012'
    },
    {
      id: 4,
      title: '伞下奖励 - 用户李四购买报单商品',
      type: 'reward_umbrella',
      points: 300,
      pm: 1,
      status: 'frozen',
      add_time: '2026-03-09 10:15',
      order_id: 'HJF202603090003'
    },
    {
      id: 5,
      title: '每日释放 - 待释放积分自动解冻',
      type: 'release',
      points: 6,
      pm: 1,
      status: 'released',
      add_time: '2026-03-09 00:00',
      release_date: '2026-03-09'
    }
  ],
  count: 45,
  page: 1,
  limit: 15
};

export const MOCK_CASH_DETAIL = {
  list: [
    {
      id: 1,
      title: '公排退款 - 订单HJF202603050001',
      amount: '3600.00',
      pm: 1,
      add_time: '2026-03-07 12:00',
      order_id: 'HJF202603050001'
    },
    {
      id: 2,
      title: '提现 - 微信零钱',
      amount: '930.00',
      pm: 0,
      add_time: '2026-03-06 15:30',
      remark: '手续费¥70.00'
    },
    {
      id: 3,
      title: '购物消费',
      amount: '299.00',
      pm: 0,
      add_time: '2026-03-05 09:20',
      order_id: 'HJF202603050010'
    }
  ],
  count: 12,
  page: 1,
  limit: 15
};

export const MOCK_WITHDRAW_INFO = {
  now_money: '7200.00',
  min_extract: 100,
  fee_rate: 7,
  extract_bank: ['微信零钱', '支付宝', '银行卡'],
  bank_list: [
    { bank_name: '中国工商银行', bank_code: '1234****5678' }
  ]
};

// ========== 会员模块 ==========

export const MOCK_MEMBER_INFO = {
  member_level: 2,
  member_level_name: '云店',
  direct_count: 8,
  umbrella_count: 35,
  umbrella_orders: 42,
  next_level_name: '服务商',
  next_level_require: 100,
  progress_percent: 42
};

export const MOCK_TEAM_DATA = {
  direct_count: 8,
  umbrella_count: 35,
  umbrella_orders: 42,
  members: [
    {
      uid: 10087,
      nickname: '张三',
      avatar: '/static/images/default_avatar.png',
      member_level: 1,
      member_level_name: '创客',
      join_time: '2026-02-15',
      direct_orders: 5,
      is_direct: true
    },
    {
      uid: 10088,
      nickname: '李四',
      avatar: '/static/images/default_avatar.png',
      member_level: 0,
      member_level_name: '普通会员',
      join_time: '2026-03-01',
      direct_orders: 1,
      is_direct: false,
      parent_nickname: '张三'
    },
    {
      uid: 10089,
      nickname: '王五',
      avatar: '/static/images/default_avatar.png',
      member_level: 2,
      member_level_name: '云店',
      join_time: '2026-01-20',
      direct_orders: 12,
      is_direct: true
    }
  ],
  page: 1,
  count: 35
};

export const MOCK_TEAM_INCOME = {
  list: [
    {
      id: 1,
      title: '直推奖励',
      from_uid: 10087,
      from_nickname: '张三',
      order_id: 'HJF202603100005',
      points: 800,
      type: 'direct',
      add_time: '2026-03-10 14:30'
    },
    {
      id: 2,
      title: '伞下奖励(级差)',
      from_uid: 10088,
      from_nickname: '李四',
      order_id: 'HJF202603090003',
      points: 300,
      type: 'umbrella',
      add_time: '2026-03-09 10:15'
    },
    {
      id: 3,
      title: '直推奖励',
      from_uid: 10089,
      from_nickname: '王五',
      order_id: 'HJF202603080010',
      points: 800,
      type: 'direct',
      add_time: '2026-03-08 16:45'
    }
  ],
  count: 22,
  page: 1,
  limit: 15
};

// ========== 引导模块 ==========

export const MOCK_GUIDE_DATA = {
  slides: [
    {
      title: '欢迎来到黄精粉健康商城',
      desc: '健康好物，品质生活',
      image: '/static/images/guide/slide1.png'
    },
    {
      title: '公排返利机制',
      desc: '购买报单商品自动进入公排，每进4单退1单全额返还',
      image: '/static/images/guide/slide2.png'
    },
    {
      title: '会员积分体系',
      desc: '推荐好友即获积分奖励，积分每日自动释放',
      image: '/static/images/guide/slide3.png'
    }
  ]
};

7.2 Admin Mock 数据文件

文件路径：pro_v3.5.1/view/admin/src/utils/hjfMockData.js

/**
 * 黄精粉健康商城 - Admin Mock 数据集中管理
 * Phase 1 前端开发使用，Phase 4 集成后可移除
 */

// ========== 公排管理 ==========

export const MOCK_QUEUE_ORDER_LIST = {
  list: [
    {
      id: 1,
      uid: 10086,
      nickname: '王五',
      phone: '138****8888',
      order_id: 'HJF202603100001',
      amount: 3600.00,
      queue_no: 142,
      status: 0,
      status_text: '排队中',
      refund_time: '',
      trigger_batch: 0,
      add_time: '2026-03-10 10:00:00'
    },
    {
      id: 2,
      uid: 10087,
      nickname: '张三',
      phone: '139****9999',
      order_id: 'HJF202603080002',
      amount: 3600.00,
      queue_no: 98,
      status: 1,
      status_text: '已退款',
      refund_time: '2026-03-09 12:00:00',
      trigger_batch: 24,
      add_time: '2026-03-08 09:30:00'
    },
    {
      id: 3,
      uid: 10088,
      nickname: '李四',
      phone: '137****7777',
      order_id: 'HJF202603090003',
      amount: 3600.00,
      queue_no: 120,
      status: 0,
      status_text: '排队中',
      refund_time: '',
      trigger_batch: 0,
      add_time: '2026-03-09 14:20:00'
    }
  ],
  count: 156,
  page: 1,
  limit: 20
};

export const MOCK_QUEUE_CONFIG = {
  trigger_multiple: 4,
  release_rate: 4,
  withdraw_fee_rate: 7
};

export const MOCK_QUEUE_FINANCE = {
  list: [
    {
      id: 1,
      uid: 10085,
      nickname: '赵六',
      phone: '136****6666',
      trigger_batch: 24,
      amount: 3600.00,
      queue_no: 39,
      refund_time: '2026-03-09 12:00:00'
    },
    {
      id: 2,
      uid: 10082,
      nickname: '孙七',
      phone: '135****5555',
      trigger_batch: 23,
      amount: 3600.00,
      queue_no: 35,
      refund_time: '2026-03-08 16:30:00'
    }
  ],
  count: 39,
  total_refund: '140400.00',
  page: 1,
  limit: 20
};

// ========== 积分管理 ==========

export const MOCK_POINTS_RELEASE_LOG = {
  list: [
    {
      id: 1,
      uid: 10086,
      nickname: '王五',
      phone: '138****8888',
      frozen_before: 15000,
      release_amount: 6,
      frozen_after: 14994,
      release_date: '2026-03-10',
      add_time: '2026-03-10 00:01:23'
    },
    {
      id: 2,
      uid: 10087,
      nickname: '张三',
      phone: '139****9999',
      frozen_before: 8500,
      release_amount: 3,
      frozen_after: 8497,
      release_date: '2026-03-10',
      add_time: '2026-03-10 00:01:24'
    }
  ],
  count: 500,
  page: 1,
  limit: 20,
  statistics: {
    total_released_today: 2450,
    total_users_released: 320
  }
};

// ========== 会员管理 ==========

export const MOCK_MEMBER_LIST = {
  list: [
    {
      uid: 10086,
      nickname: '王五',
      phone: '138****8888',
      avatar: '',
      member_level: 2,
      member_level_name: '云店',
      no_assess: 0,
      direct_count: 8,
      umbrella_orders: 42,
      frozen_points: 15000,
      available_points: 3200,
      now_money: '7200.00',
      spread_uid: 10001,
      spread_nickname: '推荐人A'
    },
    {
      uid: 10087,
      nickname: '张三',
      phone: '139****9999',
      avatar: '',
      member_level: 1,
      member_level_name: '创客',
      no_assess: 0,
      direct_count: 5,
      umbrella_orders: 8,
      frozen_points: 8500,
      available_points: 1200,
      now_money: '3600.00',
      spread_uid: 10086,
      spread_nickname: '王五'
    },
    {
      uid: 10090,
      nickname: '钱八',
      phone: '134****4444',
      avatar: '',
      member_level: 0,
      member_level_name: '普通会员',
      no_assess: 1,
      direct_count: 0,
      umbrella_orders: 0,
      frozen_points: 0,
      available_points: 0,
      now_money: '0.00',
      spread_uid: 10087,
      spread_nickname: '张三'
    }
  ],
  count: 1200,
  page: 1,
  limit: 20
};

export const MOCK_MEMBER_CONFIG = {
  chuangke_threshold: 3,
  yundian_threshold: 30,
  fuwushang_threshold: 100,
  fengongsi_threshold: 1000,
  chuangke_direct_reward: 500,
  yundian_direct_reward: 800,
  yundian_umbrella_reward: 300,
  fuwushang_direct_reward: 1000,
  fuwushang_umbrella_reward: 200,
  fengongsi_direct_reward: 1300,
  fengongsi_umbrella_reward: 300
};

附录：页面编号映射

页面编号 页面名称 类型 文件路径
P12 公排状态页 NEW pages/queue/status.vue
P13 公排历史记录 NEW pages/queue/history.vue
P14 公排规则说明 NEW pages/queue/rules.vue
P15 资产总览 NEW pages/assets/index.vue
P18 积分明细 NEW pages/assets/points_detail.vue
P23 新用户引导 NEW pages/guide/hjf_intro.vue
P01 首页 MOD pages/index/index.vue
P06 商品详情 MOD pages/goods_details/index.vue
P08 确认订单 MOD 订单确认页
P10 订单列表 MOD 订单列表页
P11 订单详情 MOD 订单详情页
P04 个人中心 MOD pages/user/index.vue
P16 提现页 MOD pages/users/user_cash/index.vue
P19 推荐收益 MOD pages/users/user_spread_money/index.vue
Reference in New Issue View Git Blame Copy Permalink