# 07-环境配置

## 一、依赖清单

| 层 | 依赖 | 版本 | 说明 |
|---|---|---|---|
| 运行时 | Java (JDK) | 17 / 21 | Spring Boot 3.x 推荐版本 |
| 运行时 | MySQL | 8.x | 核心业务数据库 |
| 运行时 | Redis | 最新稳定版 | 缓存/会话/分布式锁 |
| 运行时 | Node.js | 18.x+ | 前端开发环境 |
| 构建 | Maven | 3.9.x | Java 后端构建工具 |
| 构建 | npm | 随 Node.js | 前端包管理器 |
| 构建 | Vite | 最新稳定版 | 前端打包构建 |
| 容器 | Docker | 最新稳定版 | 容器化部署 |
| 容器 | Docker Compose | v2+ | 本地多服务编排 |
| CLI 工具 | Flyway CLI（可选） | 10.x | 手动执行数据库迁移 |
| Web 服务器 | Nginx | 最新稳定版 | 前端托管 + 反向代理 |

## 二、端口约定

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

## 三、环境变量

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

## 四、常用命令

| 命令 | 说明 |
|---|---|
| `cd backend && mvn spring-boot:run` | 启动后端开发服务 |
| `cd frontend && npm run dev` | 启动前端开发服务器 |
| `cd backend && mvn clean package -DskipTests` | 打包后端（跳过测试） |
| `cd frontend && npm run build` | 打包前端静态资源 |
| `bash scripts/test.sh` | 运行全量测试（build + lint + unit + e2e） |
| `bash scripts/setup-test-db.sh` | 重置测试数据库 |
| `git push origin <branch>` | 推送分支（触发 pre-push 钩子） |