跳到主要内容

快速开始

本系统暂不提供可以直接部署的版本，需要自行打包部署。

安装环境​

后端

  • JDK 21 及以上版本
  • MySQL 8.x

前端

  • Angular 18.x
  • Node：18.9.1 及以上版本
  • TypeScript： 5.4.0以上，5.6.0以下
  • RxJS： 6.5.3 以上 7.4.0 以下

Angular 版本兼容说明

下载​

git clone https://gitee.com/d-blue/darkblue-parent.git
git clone https://gitee.com/d-blue/darkblue-web-ui-ng.git
shell

darkblue-parent 是后端项目，darkblue-web-ui-ng 是前端项目。

启动项目​

数据库初始化​

数据库脚本在 darkblue-parent/darkblue-application/src/main/resources/sql 目录下。

  • init_ddl.sql：数据库表结构初始化脚本
  • init_data.sql：数据库初始化数据
  • change.sql：数据库变更

执行顺序如下：init_ddl.sql →\to init_data.sql →\to change.sql

配置好之后需要在 application-dev.yaml 中设置数据库信息。

application-dev.yaml
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/darkblue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: 123456
yaml

Redis​

本项目依赖于Redis，使用 Redis 缓存了用户的登录信息（Session），和一部分基础信息。对 Redis 版本没有要求，建议使用 6.0 以上版本。

安装完 Redis 后需要修改 Redis 配置

application-dev.yaml
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: 123456
      database: 15
yaml

启动后端​

注意后端使用的 JDK 版本是 21，由于使用了 Spring 3.x 因此 JDK 版本需要使用 17 及以上版本。

在启动项目之前请先编译项目。

mvn compile
shell

或通过 IDEA 右侧的 Maven 工具栏编译。

编译项目

配置完成之后即可启动项目。

启动类：org.dblue.application.DarkblueApplication

启动前端​

建议使用最新的 Node 和 npm 已避免出现兼容性问题。

如果要使用阿里的 npm 源，请在根目录添加 .npmrc 文件。文件内容如下：

registry=https://registry.npmmirror.com

Node 和 npm 准备好之后，先安装 npm 包

npm install

安装完成之后通过下面的命令启动项目

npm run start

启动完之后，在浏览器输入：http://localhost:4200 即可打开项目。

登录页面

管理员账户默认用户名密码为：admin/123456