07-环境配置

一、依赖清单

层	依赖	版本	说明
运行时	JDK	17 或 21	Spring Boot 3 推荐
运行时	Node.js	≥ 18 LTS	Vite 5 / React 18 构建运行
运行时	MySQL Server	8.x	业务数据存储
运行时	Redis	最新稳定版	缓存、会话
运行时	Nginx	最新稳定版	前端静态托管 + 反向代理
构建	Maven	3.9.x	后端依赖管理与打包
构建	npm 或 pnpm	npm ≥ 9 / pnpm ≥ 8	前端包管理；项目统一二选一
构建	Flyway	10.x	数据库 migration（随 Spring Boot 启动 apply）
容器	Docker	最新稳定版	容器化部署
容器	Docker Compose	最新稳定版	本地多服务编排
CLI 工具	git	≥ 2.30	版本管理
CLI 工具	mysql-client	8.x	scripts/setup-test-db.sh 需要
CLI 工具	glab 或 gh	最新稳定版	创建 MR / PR

二、端口约定

服务	端口	说明
后端 HTTP	8080	Spring Boot 内嵌 Tomcat
后端管理端点	8081	Spring Boot Actuator（如启用，独立端口）
前端 dev 服务器	5173	Vite dev server
MySQL	3306	业务数据库
MySQL（测试库）	3307	隔离的测试库；可与主库同实例不同 schema
Redis	6379	缓存 / 会话
Nginx	80 / 443	生产反向代理（80 → 443 强跳）

三、环境变量

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

四、常用命令

命令	说明
cd backend && mvn spring-boot:run	本地启动后端（自动 apply Flyway migration）
cd frontend && npm run dev	本地启动前端 dev server（监听 5173）
cd backend && mvn clean package -DskipTests	打后端 jar
cd frontend && npm run build	打前端静态资源到 dist/
bash scripts/test.sh	一键跑全部测试（后端 build/lint/test + 前端 build/lint/test + e2e）
bash scripts/setup-test-db.sh	重置测试库（DROP + CREATE，不 apply migration；migration 由 Spring Boot 启动时 Flyway 自动 apply）
glab mr create 或 gh pr create	推送当前分支后创建 MR / PR