# 快速上手

本项目采用前后端分离的框架,意味着您的本地需要同时启动前端、后端两个服务,才能正常运行。开始之前,请确保本机已安装如下所需的环境。

# 环境准备

为了方便新手入门,这里列出系统所需的环境,并给出相关的安装教程:

1、JDK:1.8+ 
安装教程:https://www.runoob.com/java/java-environment-setup.html
2、Redis 3.0+
安装教程:https://www.runoob.com/redis/redis-install.html
3、Maven 3.0+
安装教程:https://www.runoob.com/maven/maven-setup.html
4、MYSQL 5.5.0+
安装教程:https://www.runoob.com/mysql/mysql-install.html
5、Node v10+
安装教程:https://www.runoob.com/nodejs/nodejs-install-setup.html 
6、Git 2.27+
安装教程:https://www.runoob.com/git/git-install-setup.html
7、Elasticsearch 6.6+
官方教程:https://www.elastic.co/guide/index.html

安装完 Node 之后,我们最好设置一下国内的镜像源地址,防止下载相关依赖失败。

npm config set registry https://registry.npm.taobao.org
配置后可通过下面方式来验证是否成功
npm config get registry

# 开发准备

在正式使用该系统前,你还需要做如下准备,首先是作者推荐使用的开发工具:

当然你也可以用自己熟悉的开发工具比如 HBuilder (opens new window)Eclipse (opens new window) 替代。

在后端项目中,我们使用了 lombok (opens new window) 插件,是为了让代码更加简洁,所以请在您的 Idea 开发工具中安装此插件。

另外,假设您不是一个开发者新手,需要具备一定的开发知识,也可以通过相关文档来了解学习。

知识储备

好了,准备工作做完以后,下面来开始启动我们的项目吧。

# 启动项目

# 后端项目启动

第一步,首先请在 Git 上将项目的代码 clone 到本地。

git clone https://github.com/lizzie2008/Rapid-4-You.git

image-20201126114944515

第二步,用 Idea 导入我们的项目,Import Project -> Open ,选择刚才下载的本地 /rapid-api 目录,选择项目类型 Maven,点击 Finish 完成后端项目的导入,等待 Maven 安装相关依赖包。

image-20201126120313986

第三步,打开数据库,创建一个新库 db_rapid,导入sql文件夹中的初始化脚本库脚本 database-init.sql

image-20201126140439743

第四步,打开 rapid-api-web 模块下的配置文件 application.yml ,找到数据库源、缓存等相关配置,并修改成自己本地部署的地址。

image-20201126140654598

第五步,确认相关依赖已全部导入,右键 tech.lancelot.AppRun.AppRun 该程序入口,点击"Run AppRun",将启动后端项目。

image-20201126135417017

看控制台输出,确认服务已启动在正确的端口上。

image-20201126141813521

# 前端项目启动

首先,我们进入 /rapid-admin 目录 , 执行 npm 安装相关依赖命令:

> npm install

image-20201126144037832

然后,我们就可以启动前端项目了,运行命令:

> npm run dev

image-20201126144442381

我们可以看到,服务已经启动在9527端口,接下来打开这个网址,就进入登录界面,默认系统账户admin,密码123456。

image-20201126150412170