后端运行

本机开发环境

So-fast基于Springboot构建，数据库基于MySql（后续会丰富数据源），并使用Maven管理工程。开发环境所需软件清单如下：

代码获取

GIT地址：https://gitee.com/ntt_yangyq/so-fast.git

如有问题请联系国内开发技术委员会。

工程导入

打开IDE，选择导入或者打开选项（STS选择打开MAVEN工程，IDEA选择工程目录打开），工程导入后MAVEN会执行工程的构建，所需时间较长，请耐心等待。

推荐在IDE里面把MAVEN配置为本地安装的MAVEN工具。

针对property等文件的中文乱码请自行配置IDE。

数据导入

由于基础框架内置了UPMS、字典、CMS等基础功能，请将基础工程中的基础数据，导入项目数据库。详见XXXXXXX.sql.

配置文件修改

基础环境和数据准备好之后，请修改配置文件。在工程中共有四个yml配置文件，其主要目的是为了便捷的进行环境切换。本篇主要描述开发环境，因此只讲解dev环境的配置修改。

application.yml

本文件内配置了服务端口、日期格式、mybatis-plus等基础配置，请慎重修改。

application-dev.yml

本文件内配置了各种项目控制信息，如数据库、redis、日志级别、安全相关、文件存储、日志、swagger等。

一定要修改的是数据库以及redis的相关配置，其中URL、PORT、DataBase、PassWord等为必须修改项。其余性能相关参数不建议修改，如需修改请慎重。

数据库配置

druid:
  # 主库数据源
  master:
    url: jdbc:mysql://${your_database_host}:${your_database_port}/${your_database_name}?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: ${your_database_user}
    password: ${your_database_password}

Reis配置

redis:
  # 地址
  host:  ${your_redis_host}
  port:  ${your_redis_port}
  # 密码
  password:  ${your_redis_password}

工程启动

以上环节均准备完毕后，通过IDE的run功能，启动工程。启动过程中如出现问题请联系国内开发技术委员会。

也可以基于MAVEN自行打包，java - jar的方式启动。

确认

工程正常启动后，其通过以下方式确认其正常启动。（默认使用8081端口）

一、访问Swagger页面，能够正常看到Swagger页面。

​ URL：http://localhost:8081/swagger-ui.html

二、通过API接口调试工具，访问login接口，能够正常获取token。

​ URL：http://localhost:8081/login

​ 参数：jsonbody

{
    "username": "admin",
    "password": "000000"
}

​ 返回

{
    "data": {
        "accessToken": "Bearer XXXXXXXXXXXXXXXXXXX",
        "userId": X
    },
    "status": 0
}