快速开始
环境准备
- JDK:25+
- Maven:3.8+
- Node.js:20+(推荐 22+)、pnpm:9+
- PostgreSQL:14+、Redis:6.0+
获取代码与构建
git clone <仓库地址>
cd start-admin-boot
# 后端:编译并安装(含共享能力域 start-common 与业务模块)
cd start-admin-boot-backend
mvn clean install -DskipTests
初始化基础设施
- 创建 PostgreSQL 数据库并导入基础 SQL 脚本;
- 启动 Redis 服务;
- 配置
start-admin/src/main/resources/application-dev.yml(数据库、Redis 连接信息)。
Profile 强制要求:后端启动必须激活 Spring profile(
dev/test/pre/prod), 否则 datasource 无 URL 会启动失败。这是配置契约的安全边界。
启动服务
项目提供跨平台启动脚本三件套(.ps1 / .sh / .bat):
# 后端(默认 dev profile,端口 48080,上下文 /api)
./start-backend.sh start
# 前端(端口 9000)
./start-frontend.sh start
启动成功标志:
- 后端:日志输出
Started StartAdminApplication in ... seconds - 前端:访问 http://localhost:9000
热重启
后端集成 spring-boot-devtools,监听 target/classes 下 class 变化自动热重启(约 1~2 秒):
mvn -pl start-admin compile
