Start-Admin-BootStart-Admin-Boot
文档导航

快速开始

环境准备

  • 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

初始化基础设施

  1. 创建 PostgreSQL 数据库并导入基础 SQL 脚本;
  2. 启动 Redis 服务;
  3. 配置 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