# 07-环境配置

## 一、依赖清单

| 层 | 依赖 | 版本 | 说明 |
|---|---|---|---|
| 运行时 | JDK | Java 17 / 21 | Spring Boot 3 推荐版本 |
| 运行时 | MySQL | 8.x | 关系型数据库 |
| 运行时 | Redis | 最新稳定版 | 缓存 / 会话 |
| 运行时 | Node.js | 20 LTS | 前端构建运行时 |
| 运行时 | Nginx | 最新稳定版 | 前端托管 / 反向代理 |
| 构建 | Maven | 3.9.x | 后端依赖与构建 |
| 构建 | Vite | 最新稳定版 | 前端开发与打包 |
| 构建 | npm / pnpm | 最新稳定版 | 前端依赖管理 |
| 容器 | Docker | 最新稳定版 | 容器化部署 |
| 容器 | Docker Compose | 最新稳定版 | 本地多服务编排 |
| CLI | git | 最新稳定版 | 源码管理 |
| CLI | mysql-client | 8.x | 命令行连接数据库 |
| CLI | redis-cli | 最新稳定版 | 命令行操作 Redis |
| CLI | glab | 最新稳定版 | 创建 / 管理 GitLab MR |

## 二、端口约定

| 服务 | 端口 | 说明 |
|---|---|---|
| 后端 HTTP | 8080 | Spring Boot 默认端口 |
| 前端 dev | 5173 | Vite 默认端口 |
| MySQL | 3306 | 数据库 |
| Redis | 6379 | 缓存 |
| Nginx | 80 / 443 | 反向代理 / HTTPS |

## 三、环境变量

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

## 四、常用命令

| 命令 | 说明 |
|---|---|
| `cd backend && mvn spring-boot:run` | 启动后端服务 |
| `cd frontend && npm run dev` | 启动前端 dev 服务 |
| `cd backend && mvn clean package -DskipTests` | 后端打包 |
| `cd frontend && npm run build` | 前端打包 |
| `bash scripts/test.sh` | 全量测试（后端 + 前端 + E2E） |
| `bash scripts/setup-test-db.sh` | 重置测试数据库（DROP + CREATE） |
| `glab mr create` | 创建 GitLab MR |
| `git push` | 推送（pre-push 钩子会预跑后端测试） |