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
51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
# 黄精粉小程序 UniApp 运行说明
|
||
|
||
## 推荐方式：使用 HBuilderX 运行到浏览器（H5）
|
||
|
||
本 CRMEB 项目的小程序端按 HBuilderX + uni-app 标准目录设计，**推荐使用 HBuilderX 进行开发与预览**：
|
||
|
||
1. 安装 [HBuilderX](https://www.dcloud.io/hbuilderx.html)（正式版或 App 开发版）。
|
||
2. 用 HBuilderX 打开本目录：`pro_v3.5.1/view/uniapp`（即当前 package.json 所在目录）。
|
||
3. 在菜单栏选择 **运行 → 运行到浏览器 → 选择 Chrome（或其他浏览器）**。
|
||
4. 等待编译完成后，会自动打开浏览器，即可查看 Mock 演示效果。
|
||
|
||
在 H5 预览下可看到：
|
||
- 首页 / 个人中心右下角的 **演示控制面板**（紫色悬浮按钮）
|
||
- 切换场景 A/B/C、快捷跳转、退款弹窗等 Mock 演示功能
|
||
|
||
---
|
||
|
||
## 命令行方式（可选）
|
||
|
||
已在 `package.json` 中配置脚本与依赖，满足以下条件时可尝试命令行启动 H5：
|
||
|
||
- 需在 **本目录**（`view/uniapp`）下执行。
|
||
- 若使用 Vue CLI 5，可能与当前 uni-app 插件的 webpack 规则不兼容，出现 `No matching use for foo.js` 或 `reading 'use'` 等错误，此时请改用 HBuilderX。
|
||
|
||
### 启动 H5 开发服务
|
||
|
||
```bash
|
||
cd pro_v3.5.1/view/uniapp
|
||
|
||
# 设置环境变量并启动（Mac/Linux）
|
||
UNI_CLI_CONTEXT=$(pwd) UNI_PLATFORM=h5 UNI_INPUT_DIR=$(pwd) npx vue-cli-service uni-serve --platform h5
|
||
|
||
# 或使用 npm 脚本（需已安装 cross-env）
|
||
npm run dev:h5
|
||
```
|
||
|
||
默认端口：**8080**（在 `vue.config.js` 的 `devServer.port` 中配置）。
|
||
启动成功后，在浏览器访问：**http://localhost:8080**。
|
||
|
||
### 微信小程序开发
|
||
|
||
使用 HBuilderX 打开本目录后，选择 **运行 → 运行到小程序模拟器 → 微信开发者工具**，并先在本地打开微信开发者工具。
|
||
|
||
---
|
||
|
||
## Mock 演示说明
|
||
|
||
- 所有 HJF 相关接口当前使用 **Mock 数据**（`utils/hjfMockData.js`），无需后端即可演示。
|
||
- 右下角 **演示控制面板** 可切换场景 A（新用户）/ B（活跃用户）/ C（VIP），并支持快捷跳转、退款弹窗、重置引导等。
|
||
- 完整演示路线与验收点见：**docs/mock-demo-walkthrough.md**。
|