127 lines
3.7 KiB
Markdown
127 lines
3.7 KiB
Markdown
# 单商户积分商城
|
||
|
||
管理后台前端、用户端 H5（uni-app）与 CRMEB Java 后端合并仓库。项目由 **4 个子项目** 组成，对应 **2 个 jar 包** 与 **2 个前端**。
|
||
|
||
---
|
||
|
||
## 项目架构概览
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
subgraph frontends [前端]
|
||
AdminVue[backend-adminend / frontend]
|
||
UserH5[single_uniapp22miao]
|
||
end
|
||
|
||
subgraph backends [后端 JAR]
|
||
AdminJar[miao-admin-2.2.jar]
|
||
FrontJar[miao-front-2.2.jar]
|
||
end
|
||
|
||
subgraph sources [源码子项目]
|
||
crmebAdmin[crmeb-admin]
|
||
crmebFront[crmeb-front]
|
||
end
|
||
|
||
AdminVue --> AdminJar
|
||
UserH5 --> FrontJar
|
||
crmebAdmin --> AdminJar
|
||
crmebFront --> FrontJar
|
||
```
|
||
|
||
### 2 个 jar 包 ↔ 2 个前端
|
||
|
||
| jar 包 | 对应前端 | 说明 |
|
||
|--------|----------|------|
|
||
| **miao-admin-2.2.jar** | `backend-adminend`（部分分支为 `frontend`） | 管理后台 API + 后台静态站点 |
|
||
| **miao-front-2.2.jar** | `single_uniapp22miao` | 积分商城、用户端 H5 / uni-app |
|
||
|
||
### 4 个子项目（可单独打包部署）
|
||
|
||
| 子项目 | 产出 | 说明 |
|
||
|--------|------|------|
|
||
| **crmeb-admin** | `miao-admin-2.2.jar` | 管理后台后端 |
|
||
| **crmeb-front** | `miao-front-2.2.jar` | 用户端 API |
|
||
| **backend-adminend**（或 `frontend`） | `dist/` | 管理后台 Vue 静态 |
|
||
| **single_uniapp22miao** | `unpackage/dist/build/h5` | 用户端 H5 静态 |
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
### 根目录
|
||
|
||
| 目录/文件 | 说明 |
|
||
|-----------|------|
|
||
| **backend/** | Java 后端（Maven 多模块） |
|
||
| **backend-adminend/** | 管理后台 Vue 前端（部分分支为 `frontend`） |
|
||
| **single_uniapp22miao/** | 用户端 uni-app 前端（积分商城 H5） |
|
||
| **backend/deploy.conf** | 多环境部署配置 |
|
||
| **backend/DEPLOY.md** | 打包与部署详细说明 |
|
||
|
||
### backend 子模块
|
||
|
||
| 子模块 | 产出 | 说明 |
|
||
|--------|------|------|
|
||
| **crmeb-admin** | `miao-admin-2.2.jar` | 管理后台后端 |
|
||
| **crmeb-front** | `miao-front-2.2.jar` | 用户端 API |
|
||
| **crmeb-service** | 依赖库 | 业务逻辑、Mapper |
|
||
| **crmeb-common** | 依赖库 | 公共组件 |
|
||
|
||
### single_uniapp22miao 主要目录
|
||
|
||
| 目录 | 说明 |
|
||
|------|------|
|
||
| **api/** | 后台 API 调用 |
|
||
| **components/** | 公共组件 |
|
||
| **config/** | 请求地址等配置 |
|
||
| **pages/** | 页面（含 integral 积分模块等） |
|
||
| **static/** | 静态资源 |
|
||
|
||
### backend-adminend 主要目录
|
||
|
||
| 目录 | 说明 |
|
||
|------|------|
|
||
| **src/** | Vue 源码 |
|
||
| **public/** | 静态资源 |
|
||
| **build/** | 构建脚本 |
|
||
|
||
---
|
||
|
||
## 开发与构建
|
||
|
||
### 管理后台前端
|
||
|
||
- 技术栈：Vue + Vue CLI
|
||
- 开发：`cd backend-adminend && npm install && npm run serve`（若仓库中为 `frontend` 目录则替换）
|
||
- 构建：`npm run build:prod`（Node 17+ 可设 `export NODE_OPTIONS="--openssl-legacy-provider"`）
|
||
- 产出：`backend-adminend/dist/`（或 `frontend/dist/`）
|
||
|
||
### 用户端 H5 前端
|
||
|
||
- 技术栈：uni-app、Vue 2
|
||
- 开发：`cd single_uniapp22miao && npm install && npm run dev:h5`
|
||
- 构建：`npm run build:h5`
|
||
- 产出：`single_uniapp22miao/unpackage/dist/build/h5/`
|
||
|
||
### 后端
|
||
|
||
- 技术栈：Spring Boot 2.2.6、Maven、MyBatis Plus
|
||
- 管理后台 API：`cd backend && mvn spring-boot:run -pl crmeb-admin`
|
||
- 用户端 API：`cd backend && mvn spring-boot:run -pl crmeb-front`
|
||
- 打包、多模块命令与环境说明见 **[backend/DEPLOY.md](backend/DEPLOY.md)**
|
||
|
||
---
|
||
|
||
## 多环境与部署（简要）
|
||
|
||
- 环境配置：**[backend/deploy.conf](backend/deploy.conf)**（by80、miao33、miao50、shjjy153、shccd159 等）
|
||
- 部署脚本：`backend/shell/deploy-admin-*.sh`、`deploy-front-*.sh`
|
||
- 详细步骤与变量说明：**[backend/DEPLOY.md](backend/DEPLOY.md)**
|
||
|
||
---
|
||
|
||
## Gitea
|
||
|
||
- 仓库：http://49.235.131.69:3000/scottpan/integral-shop
|