# 07-环境配置

## 一、依赖清单

| 层 | 依赖 | 版本 | 说明 |
|---|---|---|---|
| 运行时 | Java JDK | 17 或 21 | Spring Boot 3.x 运行环境 |
| 运行时 | Node.js | 20.x LTS | Vite 5 / React 18 构建运行 |
| 运行时 | MySQL | 8.x | 关系型数据库 |
| 运行时 | Redis | 最新稳定 | 缓存 / 会话 |
| 运行时 | Nginx | 最新稳定 | 反向代理、前端静态托管（生产） |
| 构建 | Maven | 3.9.x | 后端依赖管理与构建 |
| 构建 | npm（或 pnpm） | 与 Node 配套 | 前端包管理器 |
| 构建 | Flyway core + mysql | 10.x | Spring Boot 启动时自动 apply migration |
| 构建 | Vite | 最新稳定 | 前端打包 |
| 容器 | Docker | 最新稳定 | 镜像构建与本地编排 |
| 容器 | docker-compose | 最新稳定 | 本地 mysql / redis 编排 |
| CLI 工具 | git | ≥ 2.40 | 版本控制 |
| CLI 工具 | mysql client | 8.x | `scripts/setup-test-db.sh` 调用 |
| CLI 工具 | curl / jq | 最新稳定 | API 调试、脚本辅助 |

## 二、端口约定

| 服务 | 端口 | 说明 |
|---|---|---|
| 后端 HTTP | 9090 | 项目锁定（避开常见 8080 冲突） |
| 前端 dev server | 5173 | Vite 默认 |
| MySQL | 3306 | 主库 |
| MySQL（测试） | 3307 | 本地独立测试库（避免与开发库冲突，可选） |
| Redis | 6379 | 默认 |
| Nginx | 80 / 443 | 生产反代 |

## 三、环境变量

运行时凭据（数据库连接、JWT 密钥、Redis 密码等）全部放在仓库根的 `.env.local`，**不入 git**（由 `.gitignore` 强制忽略）。

字段清单与占位符见 `.env.local`，真实值由开发者本地填写。CC 不读取 `.env.local` 的真实值；任何引用都用 `${VAR_NAME}` 形式。

## 四、常用命令

| 命令 | 说明 |
|---|---|
| `cd backend && ./mvnw spring-boot:run` | 启动后端服务（监听 8080） |
| `cd frontend && npm run dev` | 启动前端 dev server（监听 5173） |
| `cd backend && ./mvnw clean package` | 后端打包（生成 jar） |
| `cd frontend && npm run build` | 前端打包（生成 dist/） |
| `bash scripts/test.sh` | 跑后端 + 前端全部测试（test-gate 入口） |
| `bash scripts/setup-test-db.sh` | DROP+CREATE 测试库（Flyway V1 会在测试启动时 apply） |
| `glab mr create` 或 `gh pr create` | 创建 MR / PR（mr-create skill 调用） |