# 打包与部署说明

本文档说明项目的 **4 个子项目** 如何单独或组合打包部署。**2 个 jar 包** 分别对应 **2 个前端**，可独立执行编译、打包、部署。

---

## 一、架构概览

### 2 个 jar 包 ↔ 2 个前端

| jar 包 | 对应前端 | 说明 |
|--------|----------|------|
| **miao-admin-2.2.jar** | `backend-adminend`（admin 后台 Vue） | 管理后台 API + 后台静态站点 |
| **miao-front-2.2.jar** | `single_uniapp22miao`（用户端 H5/uni-app） | 积分商城、用户端 API |

### 4 个子项目（可单独打包部署）

| 子项目 | 产出 | 打包命令 | 说明 |
|--------|------|----------|------|
| **crmeb-admin** | `miao-admin-2.2.jar` | `mvn clean package -pl crmeb-admin -am -DskipTests` | 管理后台后端 |
| **crmeb-front** | `miao-front-2.2.jar` | `mvn clean package -pl crmeb-front -am -DskipTests` | 用户端 API |
| **backend-adminend** | `backend-adminend/dist` | `npm run build:prod` | 管理后台前端静态 |
| **single_uniapp22miao** | `single_uniapp22miao/unpackage/dist/build/h5` | `npm run build:h5` | 用户端 H5 静态 |

---

## 二、部署配置（deploy.conf）

配置位于 **backend/deploy.conf**，按段落区分环境（by80、miao50、shjjy153 等）。

### 通用变量

| 变量 | 说明 | 示例 |
|------|------|------|
| `SERVER_HOST` | 服务器 IP | 123.56.214.80 |
| `SERVER_USER` | SSH 用户 | root |
| `SERVER_PORT` | SSH 端口 | 22 |
| `REMOTE_DIR_JAR` | jar 上传目录（两个 jar 可同目录） | /www/wwwroot/crmeb |
| `REMOTE_DIR_ADMIN` | admin 后台静态站点目录 | /www/wwwroot/jfadmin.bosenyuan.com |
| `REMOTE_DIR_FRONT` | 用户端 H5 静态站点目录（部分环境有） | /www/wwwroot/jjy-jf.fwxgpt.com |
| `FRONT_JAR_NAME` | 用户端 jar 文件名 | miao-front-2.2.jar |
| `ADMIN_JAR_NAME` | 管理后台 jar 文件名 | miao-admin-2.2.jar |
| `FRONT_LOCAL_PORT` | 用户端 API 端口 | 30031 |
| `ADMIN_LOCAL_PORT` | 管理后台 API 端口 | 30032 |

### 环境示例（deploy.conf）

- **by80**：`REMOTE_DIR_JAR`、`REMOTE_DIR_ADMIN`，profile=miao80
- **miao50**：`REMOTE_DIR`（jar 目录），profile=miao50
- **shjjy153**：`REMOTE_DIR_JAR`、`REMOTE_DIR_ADMIN`、`REMOTE_DIR_FRONT`，profile=shjjy153

---

## 三、单独打包（4 个子项目）

### 1. 仅打包 crmeb-admin（miao-admin-2.2.jar）

```bash
cd backend
mvn clean package -pl crmeb-admin -am -DskipTests
# 产出：backend/crmeb-admin/target/miao-admin-2.2.jar
```

### 2. 仅打包 crmeb-front（miao-front-2.2.jar）

```bash
cd backend
mvn clean package -pl crmeb-front -am -DskipTests
# 产出：backend/crmeb-front/target/miao-front-2.2.jar
```

### 3. 仅打包 admin 后台前端（backend-adminend）

```bash
cd backend-adminend
export NODE_OPTIONS="${NODE_OPTIONS:-} --openssl-legacy-provider"   # Node 17+ 需要
npm run build:prod
# backend-adminend/dist
```

### 4. 仅打包用户端 H5 前端（single_uniapp22miao）

```bash
cd single_uniapp22miao
npm run build:h5
# 产出：single_uniapp22miao/unpackage/dist/build/h5
```

---

## 四、单独启动（本机）

### 启动 miao-admin（管理后台 API）

```bash
cd backend
nohup java -jar crmeb-admin/target/miao-admin-2.2.jar \
  --spring.profiles.active=miao80 \
  --server.port=30032 > admin.log 2>&1 &
```

### 启动 miao-front（用户端 API）

```bash
cd backend
./shell/start-front-miao33.sh   # 使用 miao33 配置，端口 30031
# 或指定 profile：
nohup java -jar crmeb-front/target/miao-front-2.2.jar \
  --spring.profiles.active=miao33 > front-miao33.log 2>&1 &
```

---

## 五、by80 环境一键部署（admin 后台）

部署目标：**miao-admin-2.2.jar** + **admin 后台静态**，上传到 by80 配置的服务器。

### 1. 配置 SSH 免密（一次性）

```bash
ssh-copy-id -i ~/.ssh/id_ed25519_crmeb_deploy.pub root@123.56.214.80
```

### 2. 执行部署脚本

```bash
cd backend
./shell/deploy-admin-by80.sh
```

使用其他密钥：`SSH_IDENTITY=~/.ssh/你的私钥 ./shell/deploy-admin-by80.sh`

### 3. 脚本执行步骤

| 步骤 | 说明 |
|------|------|
| 1 | 编译 crmeb-admin，生成 miao-admin-2.2.jar |
| 2 | 编译 backend-adminend，生成 dist |
| 3 | 远程备份原有 jar 与后台静态 |
| 4 | 上传 miao-admin-2.2.jar 到 REMOTE_DIR_JAR |
| 5 | 上传 backend-adminend/dist 到 REMOTE_DIR_ADMIN |
| 6 | 远程重启 admin 服务（profile=miao80, port=30032） |

---

## 六、部署 miao-front（用户端 API）

### shccd159 环境

```bash
cd backend
./shell/deploy-front-shccd159.sh
```

脚本步骤：编译 crmeb-front → **云服务器备份原有 jar** → 上传 jar → 远程重启。

使用其他密钥：`SSH_IDENTITY=~/.ssh/你的私钥 ./shell/deploy-front-shccd159.sh`

**前置条件**：配置 SSH 免密，例如：
```bash
ssh-copy-id -i ~/.ssh/id_ed25519_crmeb_deploy.pub root@182.92.78.159
```

---

## 七、shjjy153 环境 admin 部署（可拆分）

shjjy153 支持 admin 全量部署，也可**单独部署 API 或 Vue 前端**。

### 1. 全量部署（API + Vue）

```bash
cd backend
./shell/deploy-admin-shjjy153.sh
```

依次执行 `deploy-admin-api-shjjy153.sh` 和 `deploy-admin-vue-shjjy153.sh`。

### 2. 仅部署 miao-admin API（miao-admin-2.2.jar）

```bash
cd backend
./shell/deploy-admin-api-shjjy153.sh
```

步骤：编译 crmeb-admin → 云服务器备份 jar → 上传 jar → 远程重启 admin 服务。

### 3. 仅部署 backend-adminend（Vue 前端）

```bash
cd backend
./shell/deploy-admin-vue-shjjy153.sh
```

步骤：编译 backend-adminend → 云服务器备份静态 → 上传 dist 到 REMOTE_DIR_ADMIN。

使用其他密钥：`SSH_IDENTITY=~/.ssh/你的私钥 ./shell/deploy-admin-api-shjjy153.sh`

---

## 八、其他环境

- **miao50**：使用 `./shell/deploy-admin-miao50.sh`，逻辑类似，配置来自 deploy.conf 中 miao50 段。
- **shjjy153**：deploy.conf 中配置了 `REMOTE_DIR_FRONT`，可扩展脚本上传 single_uniapp22miao 的 H5 构建产物到该目录。

---

## 九、远程服务器手动重启

### 重启 admin（miao-admin-2.2.jar）

```bash
ssh root@<SERVER_HOST>
cd /www/wwwroot/crmeb   # 或 REMOTE_DIR_JAR
pkill -f miao-admin-2.2.jar || true
sleep 2
nohup java -Xms128m -Xmx200m -jar miao-admin-2.2.jar --spring.profiles.active=miao80 --server.port=30032 > admin.log 2>&1 &
pgrep -f miao-admin-2.2.jar && echo "Admin 已启动"
```

### 重启 front（miao-front-2.2.jar）

```bash
ssh root@<SERVER_HOST>
cd /www/wwwroot/crmeb   # 或 REMOTE_DIR_JAR
pkill -f miao-front-2.2.jar || true
sleep 2
nohup java -Xms128m -Xmx200m -jar miao-front-2.2.jar --spring.profiles.active=miao33 --server.port=30031 > front.log 2>&1 &
pgrep -f miao-front-2.2.jar && echo "Front 已启动"
```

---

## 十、故障排查

- **SSH Permission denied**：检查 `ssh-copy-id` 是否成功，或指定正确 `SSH_IDENTITY`。
- **前端构建 OpenSSL 报错**：设置 `export NODE_OPTIONS="--openssl-legacy-provider"`。
- **jar 未启动**：SSH 登录查看对应 log 文件及 `pgrep -f <jar名>`。