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 钩子会预跑后端测试）