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 端）