integral-shop/README.md

# 单商户积分商城

管理后台前端、用户端 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