# fhs-framework
**Repository Path**: ChinaProgrammer_group/fhs-framework
## Basic Information
- **Project Name**: fhs-framework
- **Description**: Fhs-Framework是一个基于Springboot2.2.5 + Mybatis + Shiro + Beetl 的快速开发平台(低代码开发平台)，本框架永远免费，永久全开源
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: v2.x
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 211
- **Created**: 2021-02-18
- **Last Updated**: 2025-04-22
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
FHS-Framwork是一个集成了国内外诸多优秀开源项目的快速开发平台，除了在常规快速开发平台提供 用户，角色，权限，菜单，字典，审计日志，代码生成器 还拥有可以让您更少写SQL和前端代码的翻译服务以及PAGEX服务。
FHS-Framwork官方交流群：976278956
+
-----------------------------------------------------------------------------------------------
# 体验地址
http://114.116.21.147:8081/ admin 123456
# 预览图
# 1. 项目技术架构
# 2. 思维导图
# 3. 技术栈
- 前端:Easyui(美化过的Easyui),Layui(首页)，Validform，My 97(定制过主题)。
- 后端校验：hibernate vilidator。
- 后端：SpringBoot2.25 + Springcloud（可选）
- ORM：Mybatis JPA Mybatis Plus
- 模板引擎：beetl
- 无后端业务的快速开发引擎:PAGEX
- 分布式配置：Nacos
- 缓存：jetcache+spring data cache
- 分布式任务：shedlock
- 文档:swagger
# 4. 和其他框架差异化特性
## - 翻译服务
无需表关联,将id 翻译为其他表的title/name
## - 一款帮你写代码的引擎-PAGEX
只需要写一个js的配置文件即可实现CRUD+导出功能,引擎代码量很少,二次开发简单.预留了很多钩子函数,方便前端扩展.
下面是使用PAGEX引擎开发的学生管理的demo
```javascript
var modelConfig = {
title: '学生管理', pkey: 'id', type: 'uuid', orderBy: 'update_time Desc',
namespace: "demo_student_management", table: 't_demo_student_management',trans: true};
var listPage = {
listFieldSett: function () {
return [
// 前台显示的数据
{name: 'name', title: '姓名', width: '10%', align: 'center'},
{name: 'sex', title: '性别', width: '10%', align: 'center',trans:'book',key:'sex',showField:'transMap.sexName'},
{name: 'age', title: '年龄', width: '10%', align: 'center'},
{name: 'idcard', title: '身份证', width: '20%', align: 'center'},
{name: 'grade', title: '班级', width: '15%', align: 'center',trans:'book',key:'grade',showField:'transMap.gradeName'},
{name: 'hobby', title: '爱好', width: '15%', align: 'center'},
{name: 'email', title: '邮箱', width: '15%', align: 'center'},
{name: 'mobile', title: '手机号', width: '10%', align: 'center'},
{name: 'create_time', title: '创建时间', width: '14%', align: 'center'},
{name:'create_user',title:'创建人',width:'10%',align:'center',trans:'auto',showField:'transMap.create_userUserName'},
{name: 'update_time', title: '更新时间', width: '14%', align: 'center'},
{name:'update_user',title:'修改人',width:'10%',align:'center',trans:'auto',showField:'transMap.update_userUserName'},
]
},
isColumnButton: function () {
return false;
},
filters: function () {
return [
{name: 'name', type: 'input', title: '姓名', filterType: 'like'}
];
},
buttons: function () {
return [
{title:'批量导入学生',fun:'importExcel',permissionsCode:'demo_student_management:see'},
{title:'导出学生列表',fun:'exportStuExcel',permissionsCode:'demo_student_management:see'},
];
},
disableButtons: function () {
return ['export'];
},
otherFunctions: function () {
return {
importExcel:function(){
openDialog('${path.basePath}/b/page-ms-demo/demo_student_import_excel', '批量导入学生');
},
exportStuExcel: function () {
location.href = "${path.basePath}/ms/demoStudentManagement/exportExcel"
}
}
}
};
var add = {
formFields: function () {
// 添加的数据
return [
{name: 'name', title: '姓名', required: true, type: 'input'},
{name: 'sex', title: '性别', required: true, type: 'book',code:'sex'},
{name: 'age', title: '年龄', required: true, type: 'input',dataType:'n'},
{name: 'idcard', title: '身份证', required: true, type: 'input',dataType:'idNumber'},
{name: 'grade', title: '班级', required: true, type: 'book',code:'grade'},
{name: 'header', title: '图片', required: true, type: 'up',placeholder:'请上传图片'},
{name: 'hobby', title: '爱好', type: 'input'},
{name: 'email', title: '邮箱', required: true, type: 'input',dataType:'e'},
{name: 'mobile', title: '电话', required: true, type: 'input',dataType:'m'},
];
},
otherFunctions: function () {
return {
ready: function () {
},
loadSuccess: function (info) {
},
onSave: function () {
},
saveSucess: function () {
},
saveError: function () {
}
}
}
};
```
## - 更好用的校验框架
集成了validate-springboot-starter，在兼容hibernate Validator和javax validation的同时，支持了更多自定义玩法。
内置常用验证规则：比如手机号验证，正则验证，ip,邮箱，长度，范围，数字，小数，中国车牌号，身份证，长度， url, 图书ISBN编号,文件后缀,文件大小 等常用验证规则
## - 可能是首创的表单填充框架
在开发和测试阶段，测试表单或者做测试数据的时候都要频繁的给表单录入数据，有了表单填充框架，可以在测试和开发的时候一键填充测试数据，然后在根据情况修改下少数字段的值即可，可以节约很多时间来造无聊的数据(主要根据校验规则去造对应的数据，邮箱，姓名，身份证号，手机号通过字典+随机数生成数据，下拉默认选中第一个)。
## - 更容易看懂的审计日志
您只需要给对应的控制器和方法上加上注解，我们就能生成更容易看懂的审计日志（框架通过 swagger 属性注解和翻译服务实现此功能）。
# 使用说明
1 新出炉的文档 https://gitee.com/fhs-opensource/fhs-framework/wikis/pages?sort_id=2052774&doc_id=333929
2 word格式的文档 在sql&docs目录
3 quik start
A 准备好redis和mysql
B 创建数据库，导入sql&docs 下的fhs-demo.sql （如果遇到部分sql执行失败，请手动执行）
C 修改fhs_app/fhs_app_all_in_one/src/main/resources/application.yml redis(2处，jetcache和spring的redis)和mysql配置
C 启动fhs_app/fhs_app_all_in_one/src/main/java/com/fhs/app/SingleApplication.java
4 视频:
https://www.bilibili.com/video/BV1DK4y1s7AL/ 基础介绍和翻译服务使用
https://www.bilibili.com/video/BV1Hi4y1V7pW/ pagex的使用
https://www.bilibili.com/video/BV1eh411o7Td/ 新项目使用fhs
https://www.bilibili.com/video/BV115411Y7NR/ 代码生成器使用1
https://www.bilibili.com/video/BV1vK4y1s7hT/ 代码生成器使用2
https://www.bilibili.com/video/BV1sf4y1R7dH/ base类中的方法介绍以及activeRecord模式适用
# 写到最后
目前国内有很多快速开发平台，每个也有每个不同的特色，FHS不一定是最好的，但是我们愿意做百花齐放的快开平台的一朵鲜花，和很多脑子一热写个快开平台或者打算以此盈利不同，FHS 是长久维护的，也是全开源的，希望路过的同学给个Star 抱拳拉！