# 全栈生产包生成实施记录

## 基本信息

- 实施日期：2026-05-27
- 实施内容：生成前端 `dist.zip` 与后端可运行 Jar 的生产发布压缩包
- 最终产物：`/Users/wkc/Downloads/20260527-150234.zip`

## 执行内容

1. 核对项目构建配置：
   - 前端目录：`ruoyi-ui`
   - 前端 Node 版本：通过 `.nvmrc` 使用 `v14.21.3`
   - 前端生产构建命令：`npm run build:prod`
   - 后端构建命令：`mvn clean package -DskipTests`
   - 后端运行 Jar：`ruoyi-admin/target/ruoyi-admin.jar`

2. 执行后端生产构建：
   - 在仓库根目录执行 `mvn clean package -DskipTests`
   - Maven Reactor 全模块构建成功
   - 生成后端运行包 `ruoyi-admin.jar`

3. 执行前端生产构建与发布包生成：
   - 通过 `nvm use` 切换至 Node `v14.21.3`
   - 执行 `npm run build:prod`
   - 生成 `ruoyi-ui/dist`
   - 将 `dist` 压缩为 `dist.zip`
   - 将 `dist.zip` 与 `ruoyi-admin.jar` 合并为最终发布包

## 影响范围

- 更新构建产物目录：
  - `ruoyi-ui/dist`
  - 各后端模块 `target`
- 新增本地发布产物：
  - `/Users/wkc/Downloads/20260527-150234.zip`

## 验证结果

- Node 版本已确认：`v14.21.3`
- Java 版本已确认：`21.0.9`
- Maven 版本已确认：`3.9.14`
- 后端构建结果：成功
- 前端构建结果：成功，存在前端资源体积 warning，不影响构建完成
- `ruoyi-ui/dist` 文件数：377
- 后端 Jar：`ruoyi-admin.jar`，约 100 MB
- 最终压缩包：`20260527-150234.zip`，约 94 MB
- 最终压缩包内容已通过 `unzip -l` 验证，仅包含：
  - `dist.zip`
  - `ruoyi-admin.jar`
