dcy-fast

平台简介

一直想做一款后台管理系统，看了很多优秀的开源项目但是发现没有合适的。于是利用空闲休息时间开始自己写了一套后台系统。参考若依框架，自己编写dcy-fast框架。 她可以用于所有的Web应用程序，如网站管理后台，网站会员中心，CMS，CRM，OA。所有前端后台代码封装过后十分精简易上手，出错概率低。同时支持移动客户端访问。系统会陆续更新一些实用功能。

dcy-fast是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。

• 感谢若依，请移步RuoYi
• 感谢 vue-element-admin 后台主题 UI 框架。
• 接口访问地址：http://localhost:8999/doc.html
  • 用户名：admin；密码：123456

dcy-fast生态

• dcy-fast单体，请移步dcy-fast
• dcy-fast-vue前端，请移步dcy-fast-vue
• dubbo 2.7.18 微服务版本dcy-fast-cloud，请移步dcy-fast-cloud
• dubbo 2.7.18 微服务版本dcy-fast-cloud-vue前端，请移步dcy-fast-cloud-vue

技术介绍

TODO-LIST

1.优化代码（暂无任务了）

内置功能

1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3. 岗位管理：配置系统用户所属担任职务。
4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7. 参数管理：对系统动态配置常用参数。
8. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
9. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
10. 代码生成：前后端代码的生成（controller、service、mapper、xml、entity、dto、dtomapper、vue）支持CRUD下载 。
11. 系统接口：根据业务代码自动生成相关的api接口文档。
12. 连接池监视：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。
13. 文件管理：fastDFS和Minio已经都集成。

如何运行

1. 准备redis 修改 application-dev.yml 里面的配置项
2. 准备mysql 修改 application-dev.yml 里面的配置项
   • 注意：创建数据库，不需要导入表结果，空的数据库即可，因为flyway会自动创建
3. 如果需要文件上传请选择 fastdfs或者minio 安装教程网上找即可，如果需要后续我会出文档。
4. banner.txt 文件控制台有乱码，可以删除或换成自己喜欢的
5. 修改 application.yml 的 spring.flyway.enabled 变成 true
6. 直接运行 WebApplication 即可
7. 访问接口访问地址：http://localhost:8999/doc.html
   • 用户名：admin；密码：123456

数据权限使用

1. 定义mapper 和 sql

/**
 * 分页查询
 *
 * @param page    分页对象
 * @param wrapper 条件参数
 * @return
 */
@DataScopeColumn
IPage<UserInfo> selectPageList(IPage<UserInfo> page, @Param(Constants.WRAPPER) Wrapper wrapper);

<select id="selectPageList" resultType="com.dcy.system.model.UserInfo">
    select <include refid="Base_Column_List_Alias"/>,
            dept.name as dept_name
    from sys_user_info userInfo left join sys_dept dept on userInfo.dept_id = dept.id
    ${ew.customSqlSegment}
</select>

2. service调用

public IPage<UserInfo> pageList(UserInfo userInfo) {
    QueryWrapper<UserInfo> queryWrapper = Wrappers.<UserInfo>query();
    queryWrapper.eq("userInfo." + BaseModel.DEL_FLAG, BaseModelDelFlagEnum.NORMAL.code);
    queryWrapper.like(StrUtil.isNotBlank(userInfo.getUsername()), "userInfo." + UserInfo.USERNAME, userInfo.getUsername());
    if (StrUtil.isNotBlank(userInfo.getDeptId())) {
        queryWrapper.and(userInfoQueryWrapper -> {
                    userInfoQueryWrapper.eq("userInfo." + UserInfo.DEPT_ID, userInfo.getDeptId())
                            .or().inSql("userInfo." + UserInfo.DEPT_ID, "SELECT sys_dept.id FROM sys_dept WHERE FIND_IN_SET('" + userInfo.getDeptId() + "', ancestors)");
                }
        );
    }
    return baseMapper.selectPageList(getPagePlusInfo(userInfo), queryWrapper);
}

3. 关键性代码处理

com.dcy.common.base.interceptor#dataPermissionHandler()

4. 思路
   • 首先在需要的权限过滤的mapper上面加上@DataScopeColumn注解
   • 然后 com.dcy.common.base.interceptor#dataPermissionHandler() 会根据权限自动拼接sql 实现数据过滤

工作流使用方式（建议有点基础使用）

1. 先运行项目
2. 在web页面【模型管理】下面新增模型，把dcy-oa模块下的 resources/process-test下的请假流程.bpmn20.xml文件导入进去
3. 然后部署此流程实例
4. 在【流程管理】下 设置审批人，对应功能 设置审批，支持角色，人员，部门
5. 可以开始测试了，创建申请，然后查询代办任务，已办任务，追踪流程等待。其他的自己发掘。。。

基础功能演示图

工作流演示图

联系作者

鸣谢

感谢 JetBrains 对开源项目的支持