Files

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

58 KiB

Raw Permalink Blame History

黄精粉健康商城 · 开发任务清单（Agent 执行版）

配套文件：docs/frontend-new-pages-spec.md（开发规范） 执行主体：OpenClaw AI Agent 任务总数：74 个（6 阶段）版本：V2.0 · 2026年3月

文档说明

任务状态

状态	标记	说明
pending	`[ ]`	待执行
in_progress	`[→]`	执行中
completed	`[✓]`	已完成
blocked	`[!]`	被阻塞

阶段概览

Phase	名称	任务数	前置依赖
0	基础设施	2	—
1	前端开发（Mock 驱动）	38	Phase 0
CP-01	前端评审检查点	1	Phase 1 全部完成
2	数据库迁移	5	CP-01
3	后端 API 开发	16	Phase 2
4	前后端集成	5	Phase 3
5	测试	8	Phase 4

并行策略

同一 Stage 内标注"可并行"的任务可同时执行
不同 Stage 之间有依赖关系，必须按序执行
Phase 1 完成后必须通过 CP-01 检查点才能进入 Phase 2

Phase 0: 基础设施（2 tasks）

P0-01: 创建 UniApp Mock 数据文件

属性	值
Phase	0
Status	`[ ]` pending
Dependencies	无
Output	`pro_v3.5.1/view/uniapp/utils/hjfMockData.js` [NEW]

Agent Prompt:

你正在为黄精粉健康商城项目创建 UniApp 端的 Mock 数据集中管理文件。

### 上下文
- 项目底座: CRMEB Pro v3.5，移动端使用 uni-app (Vue 2)
- 此文件为全新创建 [NEW]
- 所有 UniApp 前端页面的 Mock 数据统一在此文件中定义和导出

### 参考文件
- 开发规范: docs/frontend-new-pages-spec.md 第 7.1 节（完整的 Mock 数据定义）

### 开发规范
- 文件路径: pro_v3.5.1/view/uniapp/utils/hjfMockData.js
- 使用 ES6 命名导出 (export const)
- 按模块分区注释（公排/资产/会员/引导）
- 数据具有真实感：合理的金额(3600)、时间戳、状态分布

### 文件内容
按照 docs/frontend-new-pages-spec.md 第 7.1 节完整复制以下导出变量：
- MOCK_QUEUE_STATUS / MOCK_QUEUE_HISTORY
- MOCK_ASSETS_OVERVIEW / MOCK_POINTS_DETAIL / MOCK_CASH_DETAIL / MOCK_WITHDRAW_INFO
- MOCK_MEMBER_INFO / MOCK_TEAM_DATA / MOCK_TEAM_INCOME
- MOCK_GUIDE_DATA

### 验收标准
- [ ] 文件可被 import 正常引用
- [ ] 所有导出变量名与 spec 文档一致
- [ ] 数据字段完整、类型正确

P0-02: 创建 Admin Mock 数据文件

属性	值
Phase	0
Status	`[ ]` pending
Dependencies	无
Output	`pro_v3.5.1/view/admin/src/utils/hjfMockData.js` [NEW]

Agent Prompt:

你正在为黄精粉健康商城项目创建 Admin 端的 Mock 数据集中管理文件。

### 上下文
- 项目底座: CRMEB Pro v3.5，管理后台使用 iView Admin
- 此文件为全新创建 [NEW]

### 参考文件
- 开发规范: docs/frontend-new-pages-spec.md 第 7.2 节（完整的 Admin Mock 数据定义）

### 开发规范
- 文件路径: pro_v3.5.1/view/admin/src/utils/hjfMockData.js
- 使用 ES6 命名导出

### 文件内容
按照 docs/frontend-new-pages-spec.md 第 7.2 节完整复制以下导出变量：
- MOCK_QUEUE_ORDER_LIST / MOCK_QUEUE_CONFIG / MOCK_QUEUE_FINANCE
- MOCK_POINTS_RELEASE_LOG
- MOCK_MEMBER_LIST / MOCK_MEMBER_CONFIG

### 验收标准
- [ ] 文件可被 import 正常引用
- [ ] 所有导出变量名与 spec 文档一致

Phase 1: 前端开发（38 tasks）

Stage 1A: API 模块 + Mock 集成（6 tasks，可并行）

P1A-01: UniApp API — hjfQueue.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-01
Output	`pro_v3.5.1/view/uniapp/api/hjfQueue.js` [NEW]

Agent Prompt:

你正在为黄精粉健康商城创建公排模块的 UniApp API 文件。

### 上下文
- 项目底座: CRMEB Pro v3.5
- 技术栈: uni-app Vue 2
- 当前使用 Mock 数据 (USE_MOCK = true)

### 参考文件
- API 编写规范: pro_v3.5.1/view/uniapp/api/user.js（import request + export function 模式）
- Mock 数据源: pro_v3.5.1/view/uniapp/utils/hjfMockData.js
- 完整规范: docs/frontend-new-pages-spec.md 第 2.2.1 节

### 开发规范
- 文件路径: pro_v3.5.1/view/uniapp/api/hjfQueue.js
- 导入: import request from "@/utils/request.js"
- 导入 Mock: import { MOCK_QUEUE_STATUS, MOCK_QUEUE_HISTORY } from '@/utils/hjfMockData.js'
- 顶部声明: const USE_MOCK = true
- 包含 mockResponse() 辅助函数（返回 Promise + 300ms 延迟 + JSON 深拷贝）

### 导出函数
1. getQueueStatus() — 获取公排状态
2. getQueueHistory(params) — 获取公排历史记录

### 验收标准
- [ ] USE_MOCK = true 时返回 Mock 数据
- [ ] USE_MOCK = false 时调用 request.get()
- [ ] mockResponse 返回与 request 相同的 { status, data } 结构

P1A-02: UniApp API — hjfAssets.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-01
Output	`pro_v3.5.1/view/uniapp/api/hjfAssets.js` [NEW]

Agent Prompt:

你正在创建资产模块的 UniApp API 文件。

### 参考文件
- API 规范: pro_v3.5.1/view/uniapp/api/user.js
- 完整规范: docs/frontend-new-pages-spec.md 第 3.2.1 节

### 开发规范
- 文件路径: pro_v3.5.1/view/uniapp/api/hjfAssets.js
- USE_MOCK = true + mockResponse() 模式

### 导出函数
1. getAssetsOverview() — 资产总览
2. getPointsDetail(params) — 积分明细
3. getCashDetail(params) — 现金流水明细
4. getWithdrawInfo() — 提现信息

### Mock 导入
MOCK_ASSETS_OVERVIEW, MOCK_POINTS_DETAIL, MOCK_CASH_DETAIL, MOCK_WITHDRAW_INFO

### 验收标准
- [ ] 4 个函数均正常导出
- [ ] Mock 模式下返回正确数据

P1A-03: UniApp API — hjfMember.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-01
Output	`pro_v3.5.1/view/uniapp/api/hjfMember.js` [NEW]

Agent Prompt:

你正在创建会员模块的 UniApp API 文件。

### 参考文件
- API 规范: pro_v3.5.1/view/uniapp/api/user.js
- 完整规范: docs/frontend-new-pages-spec.md 第 3.2.2 节

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

### 导出函数
1. getMemberInfo() — 会员信息
2. getTeamData(params) — 团队成员列表
3. getTeamIncome(params) — 推荐收益明细

### Mock 导入
MOCK_MEMBER_INFO, MOCK_TEAM_DATA, MOCK_TEAM_INCOME

### 验收标准
- [ ] 3 个函数均正常导出
- [ ] Mock 模式下返回正确数据

P1A-04: Admin API — hjfQueue.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-02
Output	`pro_v3.5.1/view/admin/src/api/hjfQueue.js` [NEW]

Agent Prompt:

你正在创建公排模块的 Admin API 文件。

### 参考文件
- Admin API 规范: pro_v3.5.1/view/admin/src/api/finance.js（import request from '@/plugins/request' + request({url, method, params}) 模式）
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.1 节

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

### 导出函数
1. queueOrderListApi(data) — 公排订单列表
2. queueConfigGetApi() — 获取公排配置
3. queueConfigSaveApi(data) — 保存公排配置
4. queueFinanceListApi(data) — 公排财务流水

### 注意
- Admin 端使用 request({url, method, params/data}) 模式，不是 request.get()
- Mock 数据从 '@/utils/hjfMockData.js' 导入

### 验收标准
- [ ] 4 个函数均正常导出
- [ ] Admin request 格式正确

P1A-05: Admin API — hjfMember.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-02
Output	`pro_v3.5.1/view/admin/src/api/hjfMember.js` [NEW]

Agent Prompt:

你正在创建会员模块的 Admin API 文件。

### 参考文件
- Admin API 规范: pro_v3.5.1/view/admin/src/api/finance.js
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.2 节

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

### 导出函数
1. memberListApi(data) — 会员管理列表
2. memberLevelUpdateApi(uid, data) — 等级调整
3. memberConfigGetApi() — 获取会员配置
4. memberConfigSaveApi(data) — 保存会员配置

### 验收标准
- [ ] 4 个函数均正常导出

P1A-06: Admin API — hjfPoints.js

属性	值
Phase	1
Stage	1A
Status	`[ ]` pending
Dependencies	P0-02
Output	`pro_v3.5.1/view/admin/src/api/hjfPoints.js` [NEW]

Agent Prompt:

你正在创建积分模块的 Admin API 文件。

### 参考文件
- Admin API 规范: pro_v3.5.1/view/admin/src/api/finance.js
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.3 节

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

### 导出函数
1. pointsReleaseLogApi(data) — 积分释放日志列表

### 验收标准
- [ ] 函数正常导出

Stage 1B: 公共组件（4 tasks，依赖 1A，可并行）

P1B-01: HjfQueueProgress 组件

属性	值
Phase	1
Stage	1B
Status	`[ ]` pending
Dependencies	P1A-01
Output	`pro_v3.5.1/view/uniapp/components/HjfQueueProgress.vue` [NEW]

Agent Prompt:

你正在创建公排进度组件。

### 上下文
- 技术栈: uni-app Vue 2 Options API
- 此组件为全新创建 [NEW]

### 参考文件
- 组件规范: docs/frontend-new-pages-spec.md 第 2.2.2 节
- 样式参考: pro_v3.5.1/view/uniapp/pages/users/user_money/index.vue（渐变卡片内的统计数据展示）

### 组件功能
- 显示当前批次进度条或环形图（如 2/4）
- 显示下一个退款的排队序号

### Props
- currentCount: Number — 当前批次已入队数
- triggerMultiple: Number — 触发倍数（默认 4）
- nextRefundNo: Number — 下一个退款的 queue_no

### 开发规范
- <style scoped lang="scss">
- 使用 CSS 变量 var(--view-theme) 作为进度条颜色
- rpx 单位

### 验收标准
- [ ] 进度条正确显示 currentCount / triggerMultiple
- [ ] 样式与 CRMEB 一致

P1B-02: HjfAssetCard 组件

属性	值
Phase	1
Stage	1B
Status	`[ ]` pending
Dependencies	P1A-02
Output	`pro_v3.5.1/view/uniapp/components/HjfAssetCard.vue` [NEW]

Agent Prompt:

你正在创建三栏资产展示卡片组件。

### 参考文件
- 组件规范: docs/frontend-new-pages-spec.md 第 3.2.3 节
- 样式参考: pro_v3.5.1/view/uniapp/pages/users/user_money/index.vue（.account 渐变卡片）

### 组件功能
- 渐变背景卡片（linear-gradient 使用 CSS 变量）
- 三栏展示：现金余额(¥) / 待释放积分 / 已释放积分
- 今日预计释放数量

### Props
- nowMoney: String — 现金余额
- frozenPoints: Number — 待释放积分
- availablePoints: Number — 已释放积分
- todayRelease: Number — 今日预计释放

### 验收标准
- [ ] 渐变背景正确渲染
- [ ] 三栏数据正确展示
- [ ] 金额保留两位小数

P1B-03: HjfMemberBadge 组件

属性	值
Phase	1
Stage	1B
Status	`[ ]` pending
Dependencies	P1A-03
Output	`pro_v3.5.1/view/uniapp/components/HjfMemberBadge.vue` [NEW]

Agent Prompt:

你正在创建会员等级徽章组件。

### 参考文件
- 组件规范: docs/frontend-new-pages-spec.md 第 3.2.4 节

### 组件功能
- 显示会员等级图标 + 等级名称
- 支持三种尺寸

### Props
- level: Number — 等级数字 (0-4)
- levelName: String — 等级名称（普通会员/创客/云店/服务商/分公司）
- size: String — 'small' / 'normal' / 'large'

### 等级颜色映射
- 0(普通): 灰色 #999
- 1(创客): 铜色 #CD7F32
- 2(云店): 银色 #C0C0C0
- 3(服务商): 金色 #FFD700
- 4(分公司): 紫色 #8B5CF6

### 验收标准
- [ ] 不同等级显示不同颜色
- [ ] 三种尺寸正确渲染

P1B-04: HjfRefundNotice 组件

属性	值
Phase	1
Stage	1B
Status	`[ ]` pending
Dependencies	P1A-01
Output	`pro_v3.5.1/view/uniapp/components/HjfRefundNotice.vue` [NEW]

Agent Prompt:

你正在创建公排退款通知弹窗组件。

### 参考文件
- 组件规范: docs/frontend-new-pages-spec.md 第 2.2.3 节

### 组件功能
- 弹窗提示：恭喜！您的公排订单已退款
- 显示退款金额和订单号
- 确认按钮关闭弹窗

### Props
- visible: Boolean — 是否显示
- amount: Number — 退款金额
- orderId: String — 订单号

### Events
- @close — 关闭弹窗

### 验收标准
- [ ] 弹窗显示/隐藏正常
- [ ] 金额格式正确（¥3,600.00）

Stage 1C: 新 UniApp 页面（6 tasks，依赖 1A+1B，可并行）

P1C-01: P12 公排状态页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	P1A-01, P1B-01
Output	`pro_v3.5.1/view/uniapp/pages/queue/status.vue` [NEW]

Agent Prompt:

你正在为黄精粉健康商城创建公排状态页面。

### 上下文
- 项目底座: CRMEB Pro v3.5
- 技术栈: UniApp Vue2 Options API
- 此页面为全新创建 [NEW]
- 数据来源: api/hjfQueue.js 中的 getQueueStatus()
- 当前使用 Mock 数据 (USE_MOCK=true)

### 参考文件
- 页面布局参考: pro_v3.5.1/view/uniapp/pages/users/user_money/index.vue（渐变卡片头部 + 导航卡片结构）
- 列表翻页参考: pro_v3.5.1/view/uniapp/pages/users/user_bill/index.vue（page/limit/onReachBottom 模式）
- 组件引用: components/HjfQueueProgress.vue
- 完整规范: docs/frontend-new-pages-spec.md 第 2.2.4 节

### 开发规范
- 文件路径: pro_v3.5.1/view/uniapp/pages/queue/status.vue
- 样式: <style scoped lang="scss">
- 组件命名: Hjf 前缀
- 金额展示: 保留两位小数

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

### Mock 数据
从 api/hjfQueue.js 的 getQueueStatus() 获取，数据结构见 spec 文档 2.2.4 节

### 验收标准
- [ ] 页面渲染无报错
- [ ] Mock 数据正确展示（总单数、列表、进度条）
- [ ] 状态标签颜色正确
- [ ] 样式与 CRMEB 页面风格一致

P1C-02: P13 公排历史页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	P1A-01
Output	`pro_v3.5.1/view/uniapp/pages/queue/history.vue` [NEW]

Agent Prompt:

你正在创建公排历史记录页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/uniapp/pages/users/user_bill/index.vue（Tab 筛选 + 按日期分组 + 上拉加载）
- 完整规范: docs/frontend-new-pages-spec.md 第 2.2.5 节

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

### 页面功能
1. Tab 筛选: 全部 / 排队中(status=0) / 已退款(status=1)
2. 按日期分组的列表（使用 time_key 字段分组）
3. 每条记录: 订单号 | 金额 | 退款时间 | 批次号
4. 上拉加载更多 (onReachBottom)

### Mock 数据
从 api/hjfQueue.js 的 getQueueHistory() 获取

### 验收标准
- [ ] Tab 切换正常过滤
- [ ] 按日期分组展示
- [ ] 上拉加载更多正常

P1C-03: P14 公排规则页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	无
Output	`pro_v3.5.1/view/uniapp/pages/queue/rules.vue` [NEW]

Agent Prompt:

你正在创建公排规则说明页面（纯静态页面）。

### 参考文件
- 完整规范: docs/frontend-new-pages-spec.md 第 2.2.6 节
- 业务规则: docs/PRD_V2.md 第 3.1 节（公排机制规则）

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

### 页面功能
1. 公排机制图示（进四退一流程图，可用 CSS 绘制简单流程）
2. 规则条款列表（有序列表）
3. 常见问题 FAQ 手风琴（点击展开/折叠）

### 内容要点
- 每笔报单商品订单 3600 元，付款后进入公排池
- 全局按付款时间排序，每进 4 单退 1 单
- 退款金额进入现金余额，可提现（7%手续费）
- 一次买多单拆分为独立订单

### 验收标准
- [ ] 规则内容完整准确
- [ ] FAQ 手风琴交互正常
- [ ] 无需后端 API

P1C-04: P15 资产总览页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	P1A-02, P1B-02
Output	`pro_v3.5.1/view/uniapp/pages/assets/index.vue` [NEW]

Agent Prompt:

你正在创建资产总览页面。

### 参考文件
- 页面布局: pro_v3.5.1/view/uniapp/pages/users/user_money/index.vue（渐变卡片 + 导航卡片 + 推荐区）
- 完整规范: docs/frontend-new-pages-spec.md 第 3.2.5 节

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

### 页面功能
1. HjfAssetCard 三栏资产卡片（渐变背景）
2. 快捷导航卡片:
   - 现金余额 → 提现页 (pages/users/user_cash/index)
   - 待释放积分 → 积分明细 (pages/assets/points_detail)
   - 已释放积分 → 积分明细
   - 公排记录 → 公排状态页 (pages/queue/status)
3. 今日释放提示

### Mock 数据
从 api/hjfAssets.js 的 getAssetsOverview() 获取

### 验收标准
- [ ] 三栏资产正确展示
- [ ] 导航卡片点击跳转正确
- [ ] 渐变背景与 CRMEB 风格一致

P1C-05: P18 积分明细页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	P1A-02
Output	`pro_v3.5.1/view/uniapp/pages/assets/points_detail.vue` [NEW]

Agent Prompt:

你正在创建积分明细页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/uniapp/pages/users/user_bill/index.vue（Tab 筛选 + 分组列表 + 翻页）
- 完整规范: docs/frontend-new-pages-spec.md 第 3.2.6 节

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

### 页面功能
1. Tab 筛选: 全部 / 直推奖励(reward_direct) / 伞下奖励(reward_umbrella) / 每日释放(release) / 消费(consume)
2. 每条: 标题 | 积分数(± 前缀) | 状态(待释放/已释放) | 时间
3. pm=1 显示绿色 +，pm=0 显示红色 -
4. 上拉加载更多

### Mock 数据
从 api/hjfAssets.js 的 getPointsDetail() 获取

### 验收标准
- [ ] Tab 筛选正确过滤
- [ ] 积分收支方向颜色正确
- [ ] 按日期分组展示

P1C-06: P23 新用户引导页

属性	值
Phase	1
Stage	1C
Status	`[ ]` pending
Dependencies	P0-01
Output	`pro_v3.5.1/view/uniapp/pages/guide/hjf_intro.vue` [NEW]

Agent Prompt:

你正在创建新用户引导页面。

### 参考文件
- 完整规范: docs/frontend-new-pages-spec.md 第 4.2.1 节

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

### 页面功能
1. 轮播引导（swiper 组件，3 屏）
   - 第1屏: 平台介绍
   - 第2屏: 公排规则图示
   - 第3屏: 会员积分说明 + "立即开始"按钮
2. 底部指示器
3. 右上角"跳过"按钮
4. navigationStyle: custom（自定义导航栏）

### Mock 数据
从 hjfMockData.js 的 MOCK_GUIDE_DATA 获取幻灯片配置

### 验收标准
- [ ] 轮播滑动正常
- [ ] 跳过/立即开始按钮跳转首页
- [ ] 自定义导航栏适配刘海屏

Stage 1D: 改造 UniApp 页面（7 tasks，依赖 1A+1B）

P1D-01: 首页改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-01
Output	`pro_v3.5.1/view/uniapp/pages/index/index.vue` [MOD]

Agent Prompt:

你正在改造首页，在商品卡片上增加报单商品角标。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.1 节
- 原始文件: pro_v3.5.1/view/uniapp/pages/index/index.vue

### 改动点
1. 在商品卡片 template 中根据 is_queue_goods 字段显示"参与公排"角标
2. 新增 .queue-badge 样式（绝对定位右上角，绿色/金色背景）

### 注意事项
- 首页使用 DIY 架构，商品卡片可能通过组件渲染
- 不要修改 DIY 核心逻辑，仅在商品卡片层增加角标判断
- 保持现有功能完整不变

### 验收标准
- [ ] 报单商品显示角标
- [ ] 普通商品不显示角标
- [ ] 原有功能不受影响

P1D-02: 商品详情改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-01
Output	商品详情页 [MOD]

Agent Prompt:

你正在改造商品详情页，增加支付方式选择功能。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.2 节

### 改动点
1. 购买弹窗中增加支付方式选择区域（单选按钮组）
2. data() 新增 payMethod: 'wechat'
3. 提交订单时传递 pay_type 参数
4. 报单商品显示"公排商品"标签
5. 报单商品不显示积分支付选项

### 验收标准
- [ ] 报单商品只显示微信/支付宝/余额
- [ ] 普通商品根据 allow_pay_types 显示
- [ ] 选择支付方式后正确传参

P1D-03: 购买流程改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-01
Output	订单确认页 + 支付成功页 [MOD]

Agent Prompt:

你正在改造购买流程，增加多单拆分提示和公排入队提示。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.3 节

### 改动点
1. 订单确认页: 报单商品数量>1 时显示"将拆分为 N 个独立公排订单"提示
2. 支付成功页: 报单商品支付成功后显示"已加入公排"提示 + 跳转公排状态按钮

### 验收标准
- [ ] 多单提示正确显示
- [ ] 支付成功后公排提示正确
- [ ] 普通商品不显示公排相关提示

P1D-04: 我的订单改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-01
Output	订单详情页 [MOD]

Agent Prompt:

你正在改造订单详情页，增加公排状态展示。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.4 节

### 改动点
1. 订单详情 template 新增公排状态区域（排队序号/状态/预计等待）
2. data() 新增 queueInfo 对象
3. 调用 getQueueStatus() 获取该订单的公排信息（Mock 阶段用固定数据）

### 验收标准
- [ ] 报单商品订单显示公排状态
- [ ] 普通商品订单不显示公排区域

P1D-05: 推荐页改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-03
Output	`pro_v3.5.1/view/uniapp/pages/users/user_spread_money/index.vue` [MOD]

Agent Prompt:

你正在改造推荐收益页面，将佣金替换为积分奖励。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.5 节
- 原始文件: pro_v3.5.1/view/uniapp/pages/users/user_spread_money/index.vue

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

### 验收标准
- [ ] 标题显示"推荐收益"
- [ ] 列表显示积分而非金额
- [ ] Mock 数据正确展示

P1D-06: 提现页改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-02
Output	`pro_v3.5.1/view/uniapp/pages/users/user_cash/index.vue` [MOD]

Agent Prompt:

你正在改造提现页面，增加7%手续费实时计算。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.6 节
- 原始文件: pro_v3.5.1/view/uniapp/pages/users/user_cash/index.vue

### 改动点
1. 提现金额输入区域下方新增: 「手续费：¥XX.XX（7%）| 实际到账：¥XX.XX」
2. computed 新增: feeAmount = 输入金额 × 0.07, actualAmount = 输入金额 × 0.93
3. 提交逻辑传递 fee_rate 参数

### 验收标准
- [ ] 输入 1000 → 显示手续费 ¥70.00 / 实际到账 ¥930.00
- [ ] 金额低于最低提现额时提示
- [ ] 手续费实时更新

P1D-07: 个人中心改造

属性	值
Phase	1
Stage	1D
Status	`[ ]` pending
Dependencies	P1A-03, P1B-03
Output	`pro_v3.5.1/view/uniapp/pages/user/index.vue` [MOD]

Agent Prompt:

你正在改造个人中心页面，增加会员等级徽章和资产入口。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.1.7 节
- 原始文件: pro_v3.5.1/view/uniapp/pages/user/index.vue（DIY 架构）

### 改动点
1. 用户信息区: 引入 HjfMemberBadge 显示会员等级
2. DIY 菜单数据: 增加"我的资产"、"公排查询"导航项
3. import: 导入 getMemberInfo() 和 HjfMemberBadge
4. onShow: 合并调用 getMemberInfo() 获取等级信息

### 注意事项
- 个人中心使用 DIY 架构（数据驱动），需理解 diyData 结构
- 使用 provide/inject 模式传递方法
- 不要破坏现有的 DIY 菜单结构

### 验收标准
- [ ] 会员等级徽章正确显示
- [ ] "我的资产"点击跳转 pages/assets/index
- [ ] "公排查询"点击跳转 pages/queue/status
- [ ] 原有 DIY 功能不受影响

Stage 1E: Admin 新页面（6 tasks，依赖 1A，可并行）

P1E-01: 公排订单管理页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-04
Output	`pro_v3.5.1/view/admin/src/pages/hjf/queueOrder/index.vue` [NEW]

Agent Prompt:

你正在创建公排订单管理页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/admin/src/pages/finance/commission/index.vue（Card + Form + Table + Page 模式）
- API: pro_v3.5.1/view/admin/src/api/hjfQueue.js
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.4 节

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

### 页面功能
1. 搜索区: 用户昵称/ID + 状态筛选(全部/排队中/已退款) + 日期范围
2. 数据表格: columns 见 spec 5.2.4 节
3. 分页组件
4. 导出功能（可选）

### formValidate 结构
{ nickname: '', status: '', start_time: '', end_time: '', page: 1, limit: 20 }

### 验收标准
- [ ] 表格正确展示 Mock 数据
- [ ] 搜索筛选正常工作
- [ ] 分页正常

P1E-02: 公排财务流水页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-04
Output	`pro_v3.5.1/view/admin/src/pages/hjf/queueFinance/index.vue` [NEW]

Agent Prompt:

你正在创建公排财务流水页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/admin/src/pages/finance/commission/index.vue
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.5 节

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

### 页面功能
1. 搜索区: 用户昵称/ID + 日期范围
2. 顶部统计: 退款总额
3. 数据表格: 用户 | 批次号 | 金额 | 排队序号 | 退款时间

### 验收标准
- [ ] 表格展示退款流水
- [ ] 统计数据正确

P1E-03: 积分释放日志页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-06
Output	`pro_v3.5.1/view/admin/src/pages/hjf/pointsLog/index.vue` [NEW]

Agent Prompt:

你正在创建积分释放日志页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/admin/src/pages/finance/commission/index.vue
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.6 节

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

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

### 验收标准
- [ ] 表格正确展示
- [ ] 顶部统计 statistics 字段正确显示

P1E-04: 公排参数配置页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-04
Output	`pro_v3.5.1/view/admin/src/pages/hjf/queueConfig/index.vue` [NEW]

Agent Prompt:

你正在创建公排参数配置页面（表单页，非列表页）。

### 参考文件
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.7 节

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

### 页面功能
1. 表单项:
   - 公排触发倍数 (InputNumber, 默认 4)
   - 积分日释放比例 (InputNumber, 千分之 X, 默认 4)
   - 提现手续费率 (InputNumber, 百分比, 默认 7)
2. 保存按钮 → 调用 queueConfigSaveApi()
3. 页面加载时调用 queueConfigGetApi() 填充表单

### 验收标准
- [ ] 表单正确加载 Mock 配置数据
- [ ] 保存按钮调用正确 API
- [ ] 数值输入合法性校验

P1E-05: 会员等级配置页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-05
Output	`pro_v3.5.1/view/admin/src/pages/hjf/memberConfig/index.vue` [NEW]

Agent Prompt:

你正在创建会员等级配置页面（表单页）。

### 参考文件
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.8 节

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

### 页面功能
1. 分区表单:
   - 升级门槛区: 创客/云店/服务商/分公司 各自的门槛值
   - 直推奖励区: 各等级直推积分奖励
   - 伞下奖励区: 各等级伞下积分奖励
2. 保存按钮 → 调用 memberConfigSaveApi()
3. 页面加载时调用 memberConfigGetApi()

### 验收标准
- [ ] 表单正确加载 Mock 配置
- [ ] 所有等级配置项可编辑

P1E-06: 会员管理页

属性	值
Phase	1
Stage	1E
Status	`[ ]` pending
Dependencies	P1A-05
Output	`pro_v3.5.1/view/admin/src/pages/hjf/memberLevel/index.vue` [NEW]

Agent Prompt:

你正在创建会员管理页面。

### 参考文件
- 列表页模式: pro_v3.5.1/view/admin/src/pages/finance/commission/index.vue
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.9 节

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

### 页面功能
1. 搜索区: 昵称/ID + 等级筛选(下拉) + 不考核筛选
2. 数据表格: 用户信息 | 等级 | 直推数 | 伞下业绩 | 待释放积分 | 已释放积分 | 余额 | 操作
3. 操作列: 调整等级(弹窗选择) / 设置不考核(确认弹窗)
4. 弹窗: 等级选择 Select + 确认按钮

### 验收标准
- [ ] 表格正确展示会员列表
- [ ] 等级筛选正常
- [ ] 等级调整弹窗可用

Stage 1F: 路由注册（7 tasks）

P1F-01: UniApp pages.json — 公排模块

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1C-01, P1C-02, P1C-03
Output	`pro_v3.5.1/view/uniapp/pages.json` [MOD]

Agent Prompt:

在 pages.json 中注册公排模块的 3 个页面路由。

### 新增路由
参考 docs/frontend-new-pages-spec.md 第 2.2.7 节:
- pages/queue/status (公排状态)
- pages/queue/history (公排记录)
- pages/queue/rules (公排规则)

### 注意
- 可以在 subPackages 中创建新的分包，或在 pages 数组中直接添加
- 保持与现有路由格式一致

### 验收标准
- [ ] 三个页面路由可正常访问

P1F-02: UniApp pages.json — 资产模块

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1C-04, P1C-05
Output	`pro_v3.5.1/view/uniapp/pages.json` [MOD]

Agent Prompt:

在 pages.json 中注册资产模块的 2 个页面路由。

### 新增路由
参考 docs/frontend-new-pages-spec.md 第 3.2.7 节:
- pages/assets/index (我的资产)
- pages/assets/points_detail (积分明细)

### 验收标准
- [ ] 两个页面路由可正常访问

P1F-03: UniApp pages.json — 引导页

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1C-06
Output	`pro_v3.5.1/view/uniapp/pages.json` [MOD]

Agent Prompt:

在 pages.json 中注册引导页路由。

### 新增路由
参考 docs/frontend-new-pages-spec.md 第 4.2.2 节:
- pages/guide/hjf_intro (新用户引导, navigationStyle: custom)

### 验收标准
- [ ] 引导页路由可正常访问
- [ ] 自定义导航栏生效

P1F-04: Admin 路由 — hjfQueue.js

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1E-01, P1E-02, P1E-04
Output	`pro_v3.5.1/view/admin/src/router/modules/hjfQueue.js` [NEW]

Agent Prompt:

创建 Admin 端 HJF 模块的路由文件。

### 参考文件
- 路由规范: pro_v3.5.1/view/admin/src/router/modules/finance.js（BasicLayout + pre 前缀 + auth 权限）
- 完整规范: docs/frontend-new-pages-spec.md 第 5.2.10 节

### 文件路径
pro_v3.5.1/view/admin/src/router/modules/hjfQueue.js

### 路由定义
按照 spec 5.2.10 节完整定义，包含 6 个子路由:
- hjf/queue/order (公排订单)
- hjf/queue/finance (公排财务)
- hjf/queue/config (公排配置)
- hjf/points/log (积分日志)
- hjf/member/config (会员配置)
- hjf/member/level (会员管理)

### 验收标准
- [ ] 路由格式与现有 finance.js 一致
- [ ] 使用 BasicLayout + 动态 import

P1F-05: Admin 路由模块注册

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1F-04
Output	`pro_v3.5.1/view/admin/src/router/modules/index.js` [MOD]

Agent Prompt:

在 Admin 路由入口文件中导入并注册 hjfQueue 路由模块。

### 参考文件
- 路由入口: pro_v3.5.1/view/admin/src/router/modules/index.js（查看现有路由模块如何注册）

### 改动点
1. 导入 hjfQueue 模块: import hjfQueue from './hjfQueue'
2. 在导出的路由数组中加入 hjfQueue

### 验收标准
- [ ] HJF 路由模块正常加载
- [ ] 菜单中可见 HJF 相关页面

P1F-06: Admin finance.js 路由追加（如需要）

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1E-03
Output	评估是否需要修改 `router/modules/finance.js` [评估]

Agent Prompt:

评估是否需要在现有 finance.js 路由中追加积分日志页路由。

### 判断依据
- 如果 P1F-04 已经将所有 HJF 页面（包括积分日志）放在统一的 hjfQueue.js 路由模块中，则此任务无需执行
- 如果积分日志更适合放在 finance 模块下，则在 finance.js 的 children 中追加子路由

### 验收标准
- [ ] 确认积分日志页路由可访问

P1F-07: Admin user.js 路由追加（如需要）

属性	值
Phase	1
Stage	1F
Status	`[ ]` pending
Dependencies	P1E-06
Output	评估是否需要修改 `router/modules/user.js` [评估]

Agent Prompt:

评估是否需要在现有 user.js 路由中追加会员管理页路由。

### 判断依据
- 如果 P1F-04 已经将会员管理放在 hjfQueue.js 路由模块中，则此任务无需执行
- 如果会员管理更适合放在 user 模块下，则追加

### 验收标准
- [ ] 确认会员管理页路由可访问

Stage 1G: Admin 改造页面（2 tasks）

P1G-01: 用户管理改造

属性	值
Phase	1
Stage	1G
Status	`[ ]` pending
Dependencies	P1A-05
Output	`pro_v3.5.1/view/admin/src/pages/user/list/index.vue` [MOD]

Agent Prompt:

你正在改造 Admin 用户管理页面，增加等级调整和不考核标记。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.2.1 节
- 原始文件: pro_v3.5.1/view/admin/src/pages/user/list/index.vue

### 改动点
1. columns 新增: "会员等级"列（slot 渲染等级名称）
2. columns 新增: "不考核"列（Tag 标记）
3. 操作列新增: "调整等级"按钮（弹窗 Select）
4. 操作列新增: "设置不考核"开关
5. import 新增: memberLevelUpdateApi
6. methods 新增: handleLevelChange / handleNoAssess

### 注意事项
- 不要删除现有的操作按钮
- 等级弹窗使用 iView Modal + Select 组件

### 验收标准
- [ ] 等级列正确显示
- [ ] 调整等级弹窗可用
- [ ] 原有功能不受影响

P1G-02: 商品管理改造

属性	值
Phase	1
Stage	1G
Status	`[ ]` pending
Dependencies	P1A-04
Output	商品编辑页面 [MOD]

Agent Prompt:

你正在改造 Admin 商品管理页面，增加报单商品标记和支付方式配置。

### 参考文件
- 改造规范: docs/frontend-new-pages-spec.md 第 6.2.2 节

### 改动点
1. 商品编辑表单新增: "报单商品"开关 (is_queue_goods, Switch 组件)
2. 商品编辑表单新增: "支付方式"多选框组 (allow_pay_types, CheckboxGroup)
3. 保存逻辑: 传递 is_queue_goods + allow_pay_types
4. 商品列表新增: "报单"标记列

### 规则
- 当 is_queue_goods=1 时，自动禁用积分支付选项

### 验收标准
- [ ] 报单商品开关可切换
- [ ] 支付方式多选框正确联动
- [ ] 商品列表显示报单标记

★ CHECKPOINT CP-01: 前端评审确认 ★

属性	值
Phase	CP
Status	`[ ]` pending
Dependencies	Phase 1 全部完成
Gate	用户确认后才能进入 Phase 2

检查清单：

UniApp 新页面：P12/P13/P14/P15/P18/P23 均可用 Mock 数据浏览
UniApp 改造页面：首页角标、商品详情支付方式、订单公排状态、推荐积分、提现手续费、个人中心徽章均正常显示
Admin 新页面：6 个管理页面均可用 Mock 数据浏览
Admin 改造页面：用户管理等级列、商品管理报单标记均正常
路由：所有新页面路由可正常访问
组件：HjfQueueProgress / HjfAssetCard / HjfMemberBadge / HjfRefundNotice 均正常渲染

确认后：用户在此处标记 [✓]，解锁 Phase 2。

Phase 2: 数据库迁移（5 tasks，依赖 CP-01）

P2-01: 创建 eb_queue_pool 表

属性	值
Phase	2
Status	`[ ]` pending
Dependencies	CP-01
Output	`database/migrations/20260307_create_eb_queue_pool.php` [NEW]

Agent Prompt:

创建公排池数据库表。

### SQL
参考 docs/frontend-new-pages-spec.md 第 2.1.1 节的建表 SQL。

### 索引
- idx_uid(uid)
- idx_status_queue_no(status, queue_no)
- idx_trigger_batch(trigger_batch)
- idx_add_time(add_time)

### 验收标准
- [ ] 迁移文件可正常执行
- [ ] 表结构与 spec 一致

P2-02: 创建 eb_points_release_log 表

属性	值
Phase	2
Status	`[ ]` pending
Dependencies	CP-01
Output	`database/migrations/20260307_create_eb_points_release_log.php` [NEW]

Agent Prompt:

创建积分释放日志表。

### SQL
参考 docs/frontend-new-pages-spec.md 第 3.1.2 节的建表 SQL。

### 验收标准
- [ ] 迁移文件可正常执行

P2-03: ALTER eb_user 添加 4 字段

属性	值
Phase	2
Status	`[ ]` pending
Dependencies	CP-01
Output	`database/migrations/20260307_alter_eb_user_add_hjf_fields.php` [NEW]

Agent Prompt:

为 eb_user 表添加 4 个新字段。

### SQL
参考 docs/frontend-new-pages-spec.md 第 3.1.1 节:
- member_level TINYINT DEFAULT 0
- no_assess TINYINT DEFAULT 0
- frozen_points BIGINT DEFAULT 0
- available_points BIGINT DEFAULT 0

### 验收标准
- [ ] ALTER 语句正常执行
- [ ] 现有数据不受影响

P2-04: INSERT eb_system_config 配置项

属性	值
Phase	2
Status	`[ ]` pending
Dependencies	CP-01
Output	`database/migrations/20260307_insert_eb_system_config_hjf.php` [NEW]

Agent Prompt:

向 eb_system_config 表插入 HJF 配置项。

### 配置项
参考 docs/PRD_V2.md 第 5.7 节:
- hjf_trigger_multiple = 4
- hjf_release_rate = 4
- hjf_withdraw_fee_rate = 7
- hjf_chuangke_threshold = 3
- hjf_yundian_threshold = 30
- hjf_fuwushang_threshold = 100
- hjf_fengongsi_threshold = 1000
- 各等级奖励积分配置

### 验收标准
- [ ] 配置项正确插入
- [ ] 不影响现有配置

P2-05: ALTER eb_store_product 添加 is_queue_goods

属性	值
Phase	2
Status	`[ ]` pending
Dependencies	CP-01
Output	`database/migrations/20260307_alter_eb_store_product.php` [NEW]

Agent Prompt:

为 eb_store_product 表添加报单商品标记字段。

### SQL
ALTER TABLE eb_store_product
  ADD COLUMN is_queue_goods TINYINT NOT NULL DEFAULT 0 COMMENT '报单商品标记: 0否 1是',
  ADD COLUMN allow_pay_types VARCHAR(255) NOT NULL DEFAULT 'wechat,alipay' COMMENT '允许的支付方式';

### 验收标准
- [ ] 字段正确添加
- [ ] 默认值合理

Phase 3: 后端 API 开发（16 tasks，依赖 Phase 2）

P3-01: QueuePool Model

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P2-01
Output	`app/model/queue/QueuePool.php` [NEW]

Agent Prompt:

创建 QueuePool 模型。参考 CRMEB 现有 Model 模式（继承 BaseModel，定义 $table, $fillable 等）。
表名: eb_queue_pool

P3-02: QueuePoolDao

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-01
Output	`app/dao/queue/QueuePoolDao.php` [NEW]

Agent Prompt:

创建 QueuePool 数据访问层。参考 CRMEB 现有 Dao 模式。
方法: getList / getByUid / getByStatus / getNextRefund / incrementQueueNo

P3-03: QueuePoolService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-02
Output	`app/services/queue/QueuePoolService.php` [NEW]

Agent Prompt:

创建公排核心业务服务。

### 方法
- addToQueue(uid, orderId, amount) — 入队
- checkAndTriggerRefund() — 检查并触发退款（进N退1逻辑）
- getQueueStatus(uid) — 获取用户排队状态
- getQueueHistory(uid, page, limit) — 获取历史记录

### 技术要点
- 使用 Redis 分布式锁 (hjf:queue:refund:lock)
- Redis 计数器 (hjf:queue:counter) 全局排队序号
- 退款通过 think-queue 异步处理
- 所有金额用 bcmath 计算

P3-04: QueueRefundService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-03
Output	`app/services/queue/QueueRefundService.php` [NEW]

Agent Prompt:

创建退款处理服务。
- processRefund(queuePoolId) — 执行退款（更新状态 + 增加 now_money）
- 使用数据库事务
- 退款后触发会员升级检查

P3-05: QueuePoolController (API 端)

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-03
Output	`app/api/controller/v1/queue/QueuePoolController.php` [NEW]

Agent Prompt:

创建公排 API 控制器。
- GET status — 调用 QueuePoolService::getQueueStatus()
- GET history — 调用 QueuePoolService::getQueueHistory()
路由路径: hjf/queue/status, hjf/queue/history

P3-06: MemberLevelService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P2-03
Output	`app/services/member/MemberLevelService.php` [NEW]

Agent Prompt:

创建会员等级服务。
- checkAndUpgrade(uid) — 检查升级条件并执行升级
- getLevelInfo(uid) — 获取等级信息
- updateLevel(uid, level) — 手动调整等级(Admin)
- setNoAssess(uid, flag) — 设置不考核标记
升级条件参考 PRD_V2.md 第 3.2.1 节

P3-07: MemberRewardService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-06
Output	`app/services/member/MemberRewardService.php` [NEW]

Agent Prompt:

创建积分奖励计算服务。
- calculateReward(orderId, buyerUid) — 计算并发放推荐奖励
- 逐级向上遍历推荐链，按等级发放固定积分
- 级差逻辑: 上级只获得与下级等级差额的积分
- 积分入账为 frozen_points（待释放）

P3-08: MemberTeamService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-06
Output	`app/services/member/MemberTeamService.php` [NEW]

Agent Prompt:

创建团队业绩统计服务。
- getDirectCount(uid) — 直推人数
- getUmbrellaCount(uid) — 伞下总人数
- getUmbrellaOrders(uid) — 伞下总单数（含级别隔离逻辑）
- getTeamMembers(uid, page, limit) — 团队成员列表

P3-09: PointsReleaseService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P2-02
Output	`app/services/points/PointsReleaseService.php` [NEW]

Agent Prompt:

创建积分每日释放服务。
- dailyRelease() — 定时任务入口，遍历所有 frozen_points > 0 的用户
- 释放量 = frozen_points × 0.4‰ (取整)
- 从 frozen_points 扣减，加到 available_points
- 写入 eb_points_release_log
- 使用 Redis 锁防止重复执行

P3-10: PointsPayService

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-09
Output	`app/services/points/PointsPayService.php` [NEW]

Agent Prompt:

创建积分支付服务。
- payWithFrozenPoints(uid, amount) — 待释放积分支付（仅普通商品）
- payWithAvailablePoints(uid, amount) — 已释放积分支付（仅普通商品）
- 检查余额是否充足
- 使用数据库事务

P3-11: Admin QueueOrderController

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-03
Output	`app/adminapi/controller/v1/hjf/QueueOrderController.php` [NEW]

Agent Prompt:

创建 Admin 公排订单控制器。
- GET order_list — 分页+筛选

P3-12: Admin QueueConfigController

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-03
Output	`app/adminapi/controller/v1/hjf/QueueConfigController.php` [NEW]

Agent Prompt:

创建 Admin 公排配置控制器。
- GET config — 读取 eb_system_config
- PUT config — 更新配置

P3-13: Admin QueueFinanceController

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-04
Output	`app/adminapi/controller/v1/hjf/QueueFinanceController.php` [NEW]

Agent Prompt:

创建 Admin 公排财务控制器。
- GET finance — 退款流水列表（分页+统计）

P3-14: Admin MemberLevelController

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-06
Output	`app/adminapi/controller/v1/hjf/MemberLevelController.php` [NEW]

Agent Prompt:

创建 Admin 会员管理控制器。
- GET list — 会员列表（分页+等级筛选）
- PUT level/{uid} — 调整等级
- GET/PUT config — 会员配置

P3-15: API 路由注册

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-05
Output	`route/api.php` [MOD]

Agent Prompt:

在 API 路由文件中注册公排和资产相关路由。

### 路由
- GET hjf/queue/status → QueuePoolController@status
- GET hjf/queue/history → QueuePoolController@history
- GET hjf/assets/overview → HjfAssetsController@overview
- GET hjf/assets/points_detail → HjfAssetsController@pointsDetail
- GET hjf/assets/cash_detail → HjfAssetsController@cashDetail
- GET hjf/assets/withdraw_info → HjfAssetsController@withdrawInfo
- GET hjf/member/info → HjfMemberController@info
- GET hjf/member/team → HjfMemberController@team
- GET hjf/member/income → HjfMemberController@income

P3-16: Admin 路由注册

属性	值
Phase	3
Status	`[ ]` pending
Dependencies	P3-11, P3-12, P3-13, P3-14
Output	`route/adminapi.php` [MOD]

Agent Prompt:

在 Admin 路由文件中注册 HJF 管理路由。

### 路由
参考 docs/frontend-new-pages-spec.md 第 5.3.2 节的 Admin API 契约表。

Phase 4: 前后端集成（5 tasks，依赖 Phase 3）

P4-01: UniApp 关闭 USE_MOCK

属性	值
Phase	4
Status	`[ ]` pending
Dependencies	P3-15
Output	`api/hjfQueue.js`, `api/hjfAssets.js`, `api/hjfMember.js` [MOD]

Agent Prompt:

将所有 UniApp HJF API 文件中的 USE_MOCK 改为 false。
文件: hjfQueue.js, hjfAssets.js, hjfMember.js
将 const USE_MOCK = true 改为 const USE_MOCK = false

P4-02: Admin 关闭 USE_MOCK

属性	值
Phase	4
Status	`[ ]` pending
Dependencies	P3-16
Output	`api/hjfQueue.js`, `api/hjfMember.js`, `api/hjfPoints.js` [MOD]

Agent Prompt:

将所有 Admin HJF API 文件中的 USE_MOCK 改为 false。
文件: hjfQueue.js, hjfMember.js, hjfPoints.js
将 const USE_MOCK = true 改为 const USE_MOCK = false

P4-03: UniApp 联调冒烟测试

属性	值
Phase	4
Status	`[ ]` pending
Dependencies	P4-01
Output	测试报告

Agent Prompt:

对 UniApp 端所有 HJF 页面进行联调冒烟测试。

### 测试清单
- [ ] P12 公排状态页: 调用真实 API 返回数据正确
- [ ] P13 公排历史页: 分页和筛选正常
- [ ] P15 资产总览页: 三栏数据正确
- [ ] P18 积分明细页: 列表和筛选正常
- [ ] 改造页面: 首页角标、商品详情支付方式、个人中心徽章正常

P4-04: Admin 联调冒烟测试

属性	值
Phase	4
Status	`[ ]` pending
Dependencies	P4-02
Output	测试报告

Agent Prompt:

对 Admin 端所有 HJF 页面进行联调冒烟测试。

### 测试清单
- [ ] 公排订单列表: 分页和搜索正常
- [ ] 公排配置: 读取和保存正常
- [ ] 积分日志: 列表和统计正常
- [ ] 会员管理: 等级调整正常

P4-05: 端到端流程验证

属性	值
Phase	4
Status	`[ ]` pending
Dependencies	P4-03, P4-04
Output	测试报告

Agent Prompt:

执行完整的端到端流程验证。

### 测试流程
1. 用户注册 → 绑定推荐关系
2. 购买报单商品(3600元) → 订单生成 → 公排入队
3. 查看公排状态 → 排队序号正确
4. 模拟第4单 → 触发退款 → 余额增加
5. 推荐人获得积分奖励 → frozen_points 增加
6. 次日释放 → available_points 增加
7. 使用积分购买普通商品 → available_points 扣减
8. 提现 → 扣除7%手续费

Phase 5: 测试（8 tasks，依赖 Phase 4）

P5-01: QueuePool 单元测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P4-05
Output	`tests/Unit/QueuePoolServiceTest.php` [NEW]

Agent Prompt:

编写公排核心逻辑单元测试。
- 测试入队: 队列序号递增
- 测试进4退1: 第4单触发退款
- 测试退款金额: 正确入账 now_money
- 测试并发: Redis 锁防重复

P5-02: MemberReward 单元测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P4-05
Output	`tests/Unit/MemberRewardServiceTest.php` [NEW]

Agent Prompt:

编写会员积分奖励单元测试。
- 测试直推奖励: 按等级发放正确积分
- 测试级差逻辑: 上级不获得同等级下级的团队奖励
- 测试积分入账: 正确写入 frozen_points

P5-03: PointsRelease 单元测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P4-05
Output	`tests/Unit/PointsReleaseServiceTest.php` [NEW]

Agent Prompt:

编写积分释放定时任务单元测试。
- 测试释放计算: 15000 × 0.4‰ = 6
- 测试余额变化: frozen_points 减少, available_points 增加
- 测试日志: eb_points_release_log 正确写入
- 测试幂等: 同一天不重复释放

P5-04: 公排并发测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P5-01
Output	`tests/Feature/QueuePoolFlowTest.php` [NEW]

Agent Prompt:

编写公排并发场景测试。
- 模拟 10 个用户同时下单
- 验证队列序号不重复
- 验证退款不重复触发
- 验证 Redis 锁正确工作

P5-05: 完整购买流程 E2E

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P5-01, P5-02, P5-03
Output	`tests/Feature/OrderPayWithQueueTest.php` [NEW]

Agent Prompt:

编写完整购买流程 E2E 测试。
1. 创建报单商品 (is_queue_goods=1)
2. 用户A购买1单 → 入队(queue_no=1)
3. 用户B购买1单 → 入队(queue_no=2), 用户A的推荐人获得积分
4. 用户C购买2单 → 入队(queue_no=3,4), 触发退款(queue_no=1)
5. 验证用户A的 now_money += 3600
6. 验证各级推荐人积分正确

P5-06: Admin CRUD 冒烟测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P4-04
Output	测试报告

Agent Prompt:

Admin 后台管理功能冒烟测试。
- 公排订单列表: 搜索/分页
- 公排配置: 读取/修改/保存
- 会员管理: 列表/等级调整/不考核设置
- 积分日志: 列表/日期筛选

P5-07: 积分释放定时任务测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P5-03
Output	测试报告

Agent Prompt:

积分释放定时任务集成测试。
- 创建 100 个用户，各有不同 frozen_points
- 执行 dailyRelease()
- 验证: 每个用户 frozen_points 正确减少, available_points 正确增加
- 验证: eb_points_release_log 记录数 = 有积分的用户数
- 验证: 执行时间 < 5 秒

P5-08: 提现流程测试

属性	值
Phase	5
Status	`[ ]` pending
Dependencies	P4-05
Output	测试报告

Agent Prompt:

提现流程集成测试。
- 用户余额 7200, 提现 1000
- 验证: 手续费 = 1000 × 7% = 70
- 验证: 实际到账 = 930
- 验证: now_money = 7200 - 1000 = 6200
- 边界测试: 低于最低提现额拒绝, 超过余额拒绝

依赖关系图

Phase 0
  P0-01 ──┐
  P0-02 ──┤
          │
Phase 1   ▼
  1A (6) ←── P0-01/P0-02
    │
  1B (4) ←── 1A
    │
  1C (6) ←── 1A + 1B
  1D (7) ←── 1A + 1B
  1E (6) ←── 1A
    │
  1F (7) ←── 1C + 1E
  1G (2) ←── 1A
    │
  CP-01 ←── ALL Phase 1
    │
Phase 2 (5) ←── CP-01
    │
Phase 3 (16) ←── Phase 2
    │
Phase 4 (5) ←── Phase 3
    │
Phase 5 (8) ←── Phase 4

附录：任务索引

编号	名称	Phase	Stage	类型
P0-01	UniApp Mock 数据文件	0	—	NEW
P0-02	Admin Mock 数据文件	0	—	NEW
P1A-01	UniApp api/hjfQueue.js	1	1A	NEW
P1A-02	UniApp api/hjfAssets.js	1	1A	NEW
P1A-03	UniApp api/hjfMember.js	1	1A	NEW
P1A-04	Admin api/hjfQueue.js	1	1A	NEW
P1A-05	Admin api/hjfMember.js	1	1A	NEW
P1A-06	Admin api/hjfPoints.js	1	1A	NEW
P1B-01	HjfQueueProgress	1	1B	NEW
P1B-02	HjfAssetCard	1	1B	NEW
P1B-03	HjfMemberBadge	1	1B	NEW
P1B-04	HjfRefundNotice	1	1B	NEW
P1C-01	P12 公排状态页	1	1C	NEW
P1C-02	P13 公排历史页	1	1C	NEW
P1C-03	P14 公排规则页	1	1C	NEW
P1C-04	P15 资产总览页	1	1C	NEW
P1C-05	P18 积分明细页	1	1C	NEW
P1C-06	P23 新用户引导页	1	1C	NEW
P1D-01	首页改造	1	1D	MOD
P1D-02	商品详情改造	1	1D	MOD
P1D-03	购买流程改造	1	1D	MOD
P1D-04	我的订单改造	1	1D	MOD
P1D-05	推荐页改造	1	1D	MOD
P1D-06	提现页改造	1	1D	MOD
P1D-07	个人中心改造	1	1D	MOD
P1E-01	公排订单管理页	1	1E	NEW
P1E-02	公排财务流水页	1	1E	NEW
P1E-03	积分释放日志页	1	1E	NEW
P1E-04	公排参数配置页	1	1E	NEW
P1E-05	会员等级配置页	1	1E	NEW
P1E-06	会员管理页	1	1E	NEW
P1F-01	pages.json 公排路由	1	1F	MOD
P1F-02	pages.json 资产路由	1	1F	MOD
P1F-03	pages.json 引导路由	1	1F	MOD
P1F-04	Admin hjfQueue 路由	1	1F	NEW
P1F-05	Admin 路由模块注册	1	1F	MOD
P1F-06	Admin finance 路由评估	1	1F	评估
P1F-07	Admin user 路由评估	1	1F	评估
P1G-01	用户管理改造	1	1G	MOD
P1G-02	商品管理改造	1	1G	MOD
CP-01	前端评审检查点	CP	—	GATE
P2-01	eb_queue_pool 建表	2	—	DDL
P2-02	eb_points_release_log 建表	2	—	DDL
P2-03	eb_user 加字段	2	—	DDL
P2-04	eb_system_config 配置	2	—	DML
P2-05	eb_store_product 加字段	2	—	DDL
P3-01	QueuePool Model	3	—	NEW
P3-02	QueuePoolDao	3	—	NEW
P3-03	QueuePoolService	3	—	NEW
P3-04	QueueRefundService	3	—	NEW
P3-05	QueuePoolController	3	—	NEW
P3-06	MemberLevelService	3	—	NEW
P3-07	MemberRewardService	3	—	NEW
P3-08	MemberTeamService	3	—	NEW
P3-09	PointsReleaseService	3	—	NEW
P3-10	PointsPayService	3	—	NEW
P3-11	Admin QueueOrderController	3	—	NEW
P3-12	Admin QueueConfigController	3	—	NEW
P3-13	Admin QueueFinanceController	3	—	NEW
P3-14	Admin MemberLevelController	3	—	NEW
P3-15	API 路由注册	3	—	MOD
P3-16	Admin 路由注册	3	—	MOD
P4-01	UniApp 关闭 USE_MOCK	4	—	MOD
P4-02	Admin 关闭 USE_MOCK	4	—	MOD
P4-03	UniApp 联调冒烟	4	—	TEST
P4-04	Admin 联调冒烟	4	—	TEST
P4-05	端到端验证	4	—	TEST
P5-01	QueuePool 单元测试	5	—	TEST
P5-02	MemberReward 单元测试	5	—	TEST
P5-03	PointsRelease 单元测试	5	—	TEST
P5-04	公排并发测试	5	—	TEST
P5-05	完整购买流程 E2E	5	—	TEST
P5-06	Admin CRUD 冒烟	5	—	TEST
P5-07	积分释放定时任务测试	5	—	TEST
P5-08	提现流程测试	5	—	TEST

58 KiB Raw Permalink Blame History Unescape Escape

黄精粉健康商城 · 开发任务清单（Agent 执行版）

文档说明

任务状态

阶段概览

并行策略

Phase 0: 基础设施（2 tasks）

P0-01: 创建 UniApp Mock 数据文件

P0-02: 创建 Admin Mock 数据文件

Phase 1: 前端开发（38 tasks）

Stage 1A: API 模块 + Mock 集成（6 tasks，可并行）

P1A-01: UniApp API — hjfQueue.js

P1A-02: UniApp API — hjfAssets.js

P1A-03: UniApp API — hjfMember.js

P1A-04: Admin API — hjfQueue.js

P1A-05: Admin API — hjfMember.js

P1A-06: Admin API — hjfPoints.js

Stage 1B: 公共组件（4 tasks，依赖 1A，可并行）

P1B-01: HjfQueueProgress 组件

P1B-02: HjfAssetCard 组件

P1B-03: HjfMemberBadge 组件

P1B-04: HjfRefundNotice 组件

Stage 1C: 新 UniApp 页面（6 tasks，依赖 1A+1B，可并行）

P1C-01: P12 公排状态页

P1C-02: P13 公排历史页

P1C-03: P14 公排规则页

P1C-04: P15 资产总览页

P1C-05: P18 积分明细页

P1C-06: P23 新用户引导页

Stage 1D: 改造 UniApp 页面（7 tasks，依赖 1A+1B）

P1D-01: 首页改造

P1D-02: 商品详情改造

P1D-03: 购买流程改造

P1D-04: 我的订单改造

P1D-05: 推荐页改造

P1D-06: 提现页改造

P1D-07: 个人中心改造

Stage 1E: Admin 新页面（6 tasks，依赖 1A，可并行）

P1E-01: 公排订单管理页

P1E-02: 公排财务流水页

P1E-03: 积分释放日志页

P1E-04: 公排参数配置页

P1E-05: 会员等级配置页

P1E-06: 会员管理页

Stage 1F: 路由注册（7 tasks）

P1F-01: UniApp pages.json — 公排模块

P1F-02: UniApp pages.json — 资产模块

P1F-03: UniApp pages.json — 引导页

P1F-04: Admin 路由 — hjfQueue.js

P1F-05: Admin 路由模块注册

P1F-06: Admin finance.js 路由追加（如需要）

P1F-07: Admin user.js 路由追加（如需要）

Stage 1G: Admin 改造页面（2 tasks）

P1G-01: 用户管理改造

P1G-02: 商品管理改造

★ CHECKPOINT CP-01: 前端评审确认 ★

Phase 2: 数据库迁移（5 tasks，依赖 CP-01）

P2-01: 创建 eb_queue_pool 表

P2-02: 创建 eb_points_release_log 表

P2-03: ALTER eb_user 添加 4 字段

P2-04: INSERT eb_system_config 配置项

P2-05: ALTER eb_store_product 添加 is_queue_goods

Phase 3: 后端 API 开发（16 tasks，依赖 Phase 2）

P3-01: QueuePool Model

P3-02: QueuePoolDao

P3-03: QueuePoolService

P3-04: QueueRefundService

P3-05: QueuePoolController (API 端)

P3-06: MemberLevelService

P3-07: MemberRewardService

P3-08: MemberTeamService

P3-09: PointsReleaseService

P3-10: PointsPayService

P3-11: Admin QueueOrderController

P3-12: Admin QueueConfigController

P3-13: Admin QueueFinanceController

P3-14: Admin MemberLevelController

P3-15: API 路由注册

P3-16: Admin 路由注册

Phase 4: 前后端集成（5 tasks，依赖 Phase 3）

58 KiB

Raw Permalink Blame History