# 07-环境配置

## 一、依赖清单

| 层 | 依赖 | 版本 | 说明 |
|---|---|---|---|
| 运行时 | Java (JDK) | 17 / 21 | Spring Boot 3 推荐版本 |
| 运行时 | MySQL | 8.x | 关系数据库 |
| 运行时 | Redis | 最新稳定版 | 缓存 / 会话 |
| 运行时 | Node.js | 20.x LTS | 前端构建 + 本地 dev server |
| 构建（后端） | Maven | 3.9.x | Java 依赖与构建工具 |
| 构建（前端） | pnpm | 8.x（或 npm 10.x） | 前端依赖管理 |
| 构建（前端） | Vite | 最新稳定版 | 前端开发与打包 |
| 容器 | Docker | 最新稳定版 | 容器化部署 |
| 容器 | Docker Compose | 最新稳定版 | 本地一键启依赖（MySQL + Redis） |
| 反向代理 | Nginx | 最新稳定版 | 前端静态托管 / 反向代理 |
| CLI 工具 | git | 2.30+ | 代码版本控制 |
| CLI 工具 | mysql client | 8.x | 本地执行 SQL / 验证 migration |
| CLI 工具 | glab（可选） | 最新稳定版 | GitLab MR 创建（亦可直接走 Web） |

## 二、端口约定

| 服务 | 端口 | 说明 |
|---|---|---|
| 后端 HTTP | 8080 | Spring Boot 默认端口（`server.port`） |
| 前端 dev server | 5173 | Vite 默认端口（`vite --port`） |
| MySQL | 3306 | 默认端口，本地开发可用 Docker Compose 暴露 |
| Redis | 6379 | 默认端口 |
| Nginx | 80 / 443 | 生产部署反向代理入口 |

## 三、环境变量

运行时凭据（数据库连接、JWT 密钥等）全部放在仓库根的 `.env.local`，不入 git。
字段清单与占位符见该文件，真实值由开发者本地填写。

## 四、常用命令

| 命令 | 说明 |
|---|---|
| `./mvnw spring-boot:run` | 本地启动后端（含 Flyway 自动 apply migration） |
| `pnpm dev` | 本地启动前端 dev server（默认 5173） |
| `./mvnw clean package -DskipTests` | 后端打包生成 jar |
| `pnpm build` | 前端打包到 `dist/` |
| `bash scripts/test.sh` | 执行后端 + 前端测试组合（lint / unit / e2e） |
| `bash scripts/setup-test-db.sh` | 重置本地测试数据库（DROP + CREATE + apply V1） |
| `glab mr create` | 推送当前分支并创建 GitLab MR（亦可走 Web 端） |