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 钩子）