From 7cc5ab0f2113c55529e94e32ced249bd62d22074 Mon Sep 17 00:00:00 2001 From: panchengyong Date: Sun, 8 Mar 2026 11:42:26 +0800 Subject: [PATCH] change readme.md --- .DS_Store | Bin 6148 -> 6148 bytes .claude/worktrees/ecstatic-borg | 1 + .claude/worktrees/youthful-haslett | 1 + README.md | 128 +++++++++++++++++++++++------ api/README.md | 38 --------- mp/README.md | 31 ------- 6 files changed, 107 insertions(+), 92 deletions(-) create mode 160000 .claude/worktrees/ecstatic-borg create mode 160000 .claude/worktrees/youthful-haslett delete mode 100644 api/README.md delete mode 100644 mp/README.md diff --git a/.DS_Store b/.DS_Store index 6bf2c139bfb182b145e1aff8b3dee5f4cc7a09aa..38ee387c87c8c9ab9f4c03bdeeebc682c988cb49 100644 GIT binary patch delta 244 zcmZoMXfc=|#>B`mu~2NHo}wrV0|Nsi1A_nqLm7iHgC2t^5F1XsxV#=D!NpL(P{feW z5RWXGlWrKCoS$0&lxN_dz9}A;y4-vhm!zEhB%nOU^nmOx^>xP`ajQ*1Q>%$vaX|*c p0fHMEHeL*2+sw|v&jIw*#*5#XC-aLKasa)=&;Z1nJw)~}0|1wPG#dZ_ delta 141 zcmZoMXfc=|#>CJ*u~2NHo}wrd0|Nsi1A_nqgA+qMLjXe&Lq0?N#6tDS1|lrhd<@PE zK@7eOuE>%Mp$wj3|KcX6r4%P8<>%)Bbu+LqqyY6LGZe!GHy>nlW1D<|@%v_W4t@@x ZeL#Wl%#-;=3>g_F+we$ljuBbG3;@~1BT)bV diff --git a/.claude/worktrees/ecstatic-borg b/.claude/worktrees/ecstatic-borg new file mode 160000 index 00000000..7acbf45f --- /dev/null +++ b/.claude/worktrees/ecstatic-borg @@ -0,0 +1 @@ +Subproject commit 7acbf45ff719a9c60b708acc1c7c28e4cbd1bf21 diff --git a/.claude/worktrees/youthful-haslett b/.claude/worktrees/youthful-haslett new file mode 160000 index 00000000..7acbf45f --- /dev/null +++ b/.claude/worktrees/youthful-haslett @@ -0,0 +1 @@ +Subproject commit 7acbf45ff719a9c60b708acc1c7c28e4cbd1bf21 diff --git a/README.md b/README.md index 13aacd7b..7767fa06 100644 --- 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 配置体系设计 | ## 仓库地址 diff --git a/api/README.md b/api/README.md deleted file mode 100644 index 6bac0842..00000000 --- a/api/README.md +++ /dev/null @@ -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/` diff --git a/mp/README.md b/mp/README.md deleted file mode 100644 index 28efce2b..00000000 --- a/mp/README.md +++ /dev/null @@ -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/` 目录，按模块分文件