Snails 框架正式发布

众所周知，Ng-Zorro 是蚂蚁金服 Ant Design 前端设计语言的 Angular 实现，Ng-Alain 基于 Ng-Zorro 组件封装一个很棒的前端脚手架系统，提供大量实用功能，自然支持先后端分离；而 SpringBoot 做为目前最优秀的 Java Rest Api 架构，加上 Lombok、Jpa、Java8 等优秀设计思想，大大地减小了系统地代码量及复杂度。

而且，Ng-Alain 支持的前端控制语言 Angular 与 Java 高度一致，对后端人员高度友好，入门门槛也至关很低。

由于作过几个相关技术的项目，出于实现一个给实习生入门学习的先后端分离技术项目的想法，便有了 Snail 项目。

Snails 项目到现在，已经能够做为小项目的基础框架去扩展使用。

目前 Snails 系统框架已支持基本的后台功能，基于简单、实用设计，而且彻底支持 Docker 进行项目部署。

虽然没有正式的 1.0 版本出现，但仍是厚着脸皮发布先，后面看看实际实用的状况补上。

Snails 组成

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

系统功能

• 登录、登出
• 用户管理
• 组织管理
• 菜单管理，支持菜单动态配置
• 在线用户
• 登录日志，记录系统用户的登录登出行为
• http请求，将系统的全部请求进行拦截，并记录到数据库中
• 系统异常，全局拦截系统的异常，并记录到数据库中
• 支持系统数据初始化
• snails-api 后台 支持 Docker 部署
• snails-web 前端 支持 Docker 部署

启动系统前提 - Mysql

Mysql 配置文件地址：application.yml

IP	Port	Username	Password	Database
localhost	3306	root	123456	snails

启动系统

方法一 【docker】

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

# 二、打包 snails-api 镜像
git clone https://gitee.com/kuzan/snails-api.git
cd snails-api
mvn package docker:build

# 三、启动 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

# 四、浏览器访问 localhost:4200 便可

方法二

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

# 二、运行 snails-api
git clone https://gitee.com/kuzan/snails-api.git
cd snails-api
mvn package
java -jar target/snails-0.1.jar

# 三、浏览器访问 localhost:4200 便可

系统截图 localhost:4200

登录页面，帐号：kuzank，密码：123456

首页

项目地址

• GitHub 地址：https://gitee.com/kuzan/snails
• 码云 地址：https://github.com/danxiaogui/snails

新的开始

Snails 目前已支持后台管理系统的基本通用功能，将来会将

• 菜单权限
• 框架推广和技术分析

以上功能一一添加上去。

但愿 Snails 框架能够帮助到众多 Ng-Alain、SpringBoot 的使用者。