Snails 1.0正式发布

Snails 项目源于给实习生做的一个 Ng-Alain + SpringBoot 入门学习项目，随着项目逐步完善，便将其开源并正式发布 Snails 1.0 版本。

基于简单、实用性等考虑，项目中使用了 Lombok、Jpa、Java8 等技术，加上 Ng-Alain 优秀的前端脚手架系统、Ng-Zorro 丰富前端组件、SpringBoot 作为后台 Java Rest Api 服务；并且，项目中支持的前端控制语言 Angular 与 Java 思想高度一致，对后端开发人员极度友好，学习门槛也比较低。

以上这些优秀的框架技术，都大大地减少了系统地代码量和复杂度，并且项目完全支持 Docker 进行部署。

如今，Snails 项目可以作为Ng-Alain + SpringBoot 入门学习项目，或者作为小项目的基础框架去扩展使用。

Snails 组成

Snails 框架：编程入门，新手礼赞
snails-web 前端：Angular + Ng-Zorro + Ng-Alain
snails-api 后台：SpringBoot + JPA + lombok + Java8 + Mysql

基于国内访问速度考虑，建议使用码云进行访问 https://gitee.com/kuzank/snails

`框架源码`	Gitee	GitHub
Snails 框架	https://gitee.com/kuzank/snails	https://github.com/kuzank/snails
Snails-web 前端	https://gitee.com/kuzank/snails-web	https://github.com/kuzank/snails-web
Snails-api 后台	https://gitee.com/kuzank/snails-api	https://github.com/kuzank/snails-api

欢迎到 Gitee 或者 GitHub 上提 issue

`issue 渠道`	访问地址
Gitee	https://gitee.com/kuzank/snails/issues
GitHub	https://github.com/kuzank/snails/issues

1、系统功能

[x] 登陆、登出
[x] 用户管理
[x] 组织管理
[x] 菜单管理，支持菜单配置、菜单权限配置、用户菜单权限预览功能
[x] 在线用户
[x] 登陆日志，记录系统用户的登陆登出行为
[x] http请求，将系统的所有请求进行拦截，并记录到数据库中
[x] 系统异常，全局拦截系统的异常，并记录到数据库中
[x] 支持系统数据初始化
[x] 支持 Docker 部署

2、启动系统前提 `Mysql`

Mysql 配置文件地址：/snails-api/src/main/resources/application.yml

IP	Port	Username	Password	Database
localhost	3306	root	123456	snails

3、启动系统

3.1、方法一 `Docker`

前提：系统已安装和配置 Java8、Git、Maven、Docker

# 1、打包 snails-web 镜像
git clone https://gitee.com/kuzank/snails-web.git
cd snails-web
docker build -t snails-web .

# 2、打包 snails-api 镜像
git clone https://gitee.com/kuzank/snails-api.git
cd snails-api
# 根据步骤 2 所示，修改代码中的 Mysql 配置 /snails-api/src/main/resources/application.yml
# 使用部署系统中 Docker 的 Mysql 作为数据库连接可能导致启动报错
mvn package docker:build

# 3、启动 docker 镜像
# 查看 docker 镜像
docker images | grep snails
# 运行 snails-web
docker run -d --name snails-web -p 4200:4200 snails-web
# 运行 snails-api
docker run -d --name snails-api -p 8081:8081 -t snails-api
# 查看运行中的 docker 实例
docker ps -a | grep snails

# 4、浏览器访问 localhost:4200 即可

3.2、方法二

前提：系统已安装和配置 Java8、Git、Maven、Node

# 1、运行 snails-web
git clone https://gitee.com/kuzank/snails-web.git
cd snails-web
yarn
npm run start

# 2、运行 snails-api
git clone https://gitee.com/kuzank/snails-api.git
cd snails-api
# 根据步骤 2 所示，修改代码中的 Mysql 配置 /snails-api/src/main/resources/application.yml
mvn package
java -jar target/snails-0.1.jar

# 3、浏览器访问 localhost:4200 即可