change readme.md

2026-03-08 11:42:26 +08:00
parent 7acbf45ff7
commit 7cc5ab0f21
6 changed files with 107 additions and 92 deletions
--- a/.DS_Store
+++ b/.DS_Store
--- a/.claude/worktrees/ecstatic-borg
+++ b/.claude/worktrees/ecstatic-borg
--- a/.claude/worktrees/youthful-haslett
+++ b/.claude/worktrees/youthful-haslett
--- a/README.md
+++ b/README.md
@@ -1,45 +1,127 @@
-# 黄精粉微信小程序
+# 黄精粉健康商城小程序

-黄精粉社交电商小程序 - 多级分销+公排返利模式
+> 基于 **CRMEB Pro v3.5.1** 二次开发的社交电商微信小程序，支持多级分销 + 公排返利 + 会员积分体系。
+
+## 项目简介
+
+黄精粉健康商城是一款健康食品社交电商小程序，核心商品为 3600 元黄精粉套餐。通过「公排进四退一」机制降低用户购买心理门槛，配合 5 级会员积分体系激励用户裂变推广。
+
+### 核心业务特性
+
+- **公排机制**：全局排队队列，每进 N 单退 1 单，退款自动进入用户现金余额
+- **会员等级**：普通会员 → 创客 → 云店 → 服务商 → 分公司，5 级晋升体系
+- **积分体系**：直推/伞下奖励积分 → 待释放（冻结）→ 每日按千分之四释放 → 可购买普通商品
+- **分销裂变**：推荐绑定 + 团队业绩统计 + 级差规则
+
+## 技术栈
+
+| 层级 | 技术 | 说明 |
+|------|------|------|
+| 后端框架 | ThinkPHP 8.0 + PHP 8.0+ | CRMEB Pro 底座 |
+| 高性能服务 | Swoole 4.x | 协程 HTTP 服务器 |
+| 数据库 | MySQL 8.0 | InnoDB 引擎，`eb_` 前缀 |
+| 缓存/队列 | Redis 7.x | 缓存 + 分布式锁 + 队列驱动 |
+| 异步任务 | think-queue | Redis 驱动异步队列 |
+| 小程序前端 | UniApp + Vue 3 | 微信小程序 + H5 |
+| 管理后台 | Vue 2 + iView + Element UI | 后台管理界面 |
+| 容器部署 | Docker | 端口 20199 |

 ## 项目结构

 ```
 huangjingfen/
-├── mp/           # 小程序前端 (UniApp 3 + Vue 3)
-├── api/          # 后端 API (Spring Boot 3.2)
-├── docs/         # 项目文档、PRD、设计稿
-└── README.md     # 本文件
+├── pro_v3.5.1/                   # CRMEB Pro v3.5.1 主程序
+│   ├── app/                      # 后端应用代码
+│   │   ├── api/controller/       # 移动端 API 控制器
+│   │   ├── adminapi/controller/  # 后台管理 API 控制器
+│   │   ├── services/             # 业务逻辑层（含新增 queue/member/points）
+│   │   ├── dao/                  # 数据访问层
+│   │   ├── model/                # 数据模型
+│   │   ├── jobs/                 # 异步队列任务
+│   │   └── listener/            # 事件监听器
+│   ├── crmeb/                    # CRMEB 核心框架（不修改）
+│   ├── config/                   # 配置文件
+│   ├── view/
+│   │   ├── uniapp/               # 小程序前端（UniApp + Vue 3）
+│   │   │   ├── pages/            # 页面（含新增 queue/assets/guide）
+│   │   │   ├── api/              # API 模块（含新增 queue/points/member）
+│   │   │   └── components/       # 组件（含新增 Hjf* 系列）
+│   │   └── admin/                # 管理后台（Vue 2 + iView）
+│   │       └── src/
+│   │           ├── pages/        # 页面（含新增 queueOrder/queueFinance 等）
+│   │           ├── api/          # API 模块（含新增 hjfQueue/hjfMember/hjfPoints）
+│   │           └── router/       # 路由配置
+│   └── public/                   # Web 入口
+├── docs/                         # 项目文档
+│   ├── PRD_V2.md                 # 产品需求文档 V2.0
+│   ├── 黄精粉小程序_Figma_UI设计说明文档.md
+│   ├── OpenClaw_Agent_Config.md  # AI Agent 配置方案
+│   ├── frontend-new-pages-spec.md # 前端新页面开发说明
+│   └── openclaw-frontend-tasks.md # 前端 Agent 执行计划
+├── .openclaw/                    # OpenClaw AI Agent 配置
+│   ├── IDENTITY.md               # Agent 身份与心跳配置
+│   ├── SOUL.md                   # 技术栈、编码规范、行为准则
+│   ├── AGENTS.md                 # Sprint 计划、安全规则、协作规范
+│   ├── USER.md                   # 用户信息档案
+│   ├── TOOLS.md                  # 开发工具与命令
+│   └── PROJECT.md                # 项目路径与结构
+└── README.md                     # 本文件
 ```

-## 技术栈
-
-| 层级 | 技术 |
-|------|------|
-| 小程序 | UniApp 3 + Vue 3 |
-| 后端 | Spring Boot 3.2 + JDK 17 |
-| 数据库 | MySQL 8.0 |
-| 缓存 | Redis |
-| 定时任务 | XXL-Job |
-
 ## 快速开始

-### 前端
+### 环境要求
+
+- PHP 8.0+（需安装 swoole, redis, bcmath 扩展）
+- MySQL 8.0+
+- Redis 7.0+
+- Node.js 18+
+- Composer 2.x
+
+### 后端启动
+
 ```bash
-cd mp
+cd pro_v3.5.1
+composer install
+php think swoole start
+```
+
+### 小程序前端
+
+```bash
+cd pro_v3.5.1/view/uniapp
 npm install
 npm run dev:mp-weixin
+# 用微信开发者工具打开 dist/dev/mp-weixin 目录
 ```

-### 后端
+### 管理后台
+
 ```bash
-cd api
-./mvnw spring-boot:run
+cd pro_v3.5.1/view/admin
+npm install
+npm run build
 ```

-## 文档
+## 二次开发模块

- [PRD v1.0](./docs/PRD-v1.0.md) - 产品需求文档
+| 模块 | 说明 | Sprint |
+|------|------|--------|
+| 公排引擎 | 全局排队 + 自动退款 + 并发安全 | Sprint 1 |
+| 会员体系 | 5 级会员 + 团队业绩 + 自动晋升 | Sprint 2 |
+| 积分体系 | 奖励计算 + 冻结释放 + 积分支付 | Sprint 2 |
+| 裂变推荐 | 推荐绑定 + 收益明细 + 提现(7%) | Sprint 3 |
+| 后台管理 | 公排管理 + 会员管理 + 财务流水 | Sprint 4 |
+
+## 文档索引
+
+| 文档 | 说明 |
+|------|------|
+| [PRD v2.0](./docs/PRD_V2.md) | 完整产品需求文档 |
+| [Figma UI 设计说明](./docs/黄精粉小程序_Figma_UI设计说明文档.md) | 27 页 UI/交互规范 |
+| [前端页面开发说明](./docs/frontend-new-pages-spec.md) | 新开发页面完整规格（6 页面 + 4 组件 + 3 API） |
+| [前端 Agent 执行计划](./docs/openclaw-frontend-tasks.md) | 25 个原子化 AI Agent 任务 |
+| [OpenClaw 配置方案](./docs/OpenClaw_Agent_Config.md) | Agent 配置体系设计 |

 ## 仓库地址

--- a/api/README.md
+++ b/api/README.md
@@ -1,38 +0,0 @@
-# 后端 API
-
-黄精粉小程序后端服务
-
-## 技术栈
- Spring Boot 3.2
- JDK 17
- MyBatis-Plus
- MySQL 8.0
- Redis
- XXL-Job
-
-## 目录结构
-
-```
-api/
-├── src/
-│   ├── main/
-│   │   ├── java/
-│   │   │   └── com/huangjingfen/
-│   │   │       ├── config/       # 配置类
-│   │   │       ├── controller/   # 控制器
-│   │   │       ├── service/      # 服务层
-│   │   │       ├── mapper/       # 数据访问层
-│   │   │       ├── entity/       # 实体类
-│   │   │       └── job/          # 定时任务
-│   │   └── resources/
-│   │       ├── mapper/           # XML映射文件
-│   │       └── application.yml
-│   └── test/
-└── pom.xml
-```
-
-## 开发规范
-
- 包名：`com.huangjingfen`
- 数据库表名：`hjf_` 前缀（如 `hjf_user`）
- API 前缀：`/api/v1/`
--- a/mp/README.md
+++ b/mp/README.md
@@ -1,31 +0,0 @@
-# 小程序前端
-
-黄精粉微信小程序前端代码
-
-## 技术栈
- UniApp 3
- Vue 3
- Pinia 状态管理
- uni-ui 组件库
-
-## 目录结构
-
-```
-mp/
-├── src/
-│   ├── pages/          # 页面
-│   ├── components/     # 组件
-│   ├── static/         # 静态资源
-│   ├── utils/          # 工具函数
-│   ├── api/            # API 接口
-│   └── store/          # Pinia store
-├── manifest.json       # 应用配置
-├── pages.json          # 页面配置
-└── package.json
-```
-
-## 开发规范
-
- 页面命名：kebab-case（如 `my-order.vue`）
- 组件命名：PascalCase（如 `ProductCard.vue`）
- API 封装：`src/api/` 目录，按模块分文件