目录

1.简介

2.快速开始

2.1.仓库

2.2.环境初始化

3.使用介绍

3.1.权限与组件

3.2.开发与测试

---

1.简介

管理系统是当前软件市场上最常见的软件，管理系统在功能和界面上都有大量通用的点。

功能上通用的点包括但不限于：

• 角色、权限管理
• 菜单管理
• 鉴权校验
• 登录，持久会话
• 定时任务
• 用户管理

界面上通用的包括但不限于：

界面现在一般都是窗口化的应用，点击菜单，转跳组件，所以对于前端来说能快速开发组件、方便配置路由是很重要的。除此之外还有就是UI样式能方便使用，避免复杂的编写CSS样式的工作。

针对功能上通用的点，后端有很多开源组件的实现：

Spring Boot、Spring Cloud、Apache Shiro、MyBatis、Quartz等

针对界面上通用的点，前端可以直接用VUE+ElementUI封装出一套能快速进行组件化开发的基础架子。

ruoyi框架就是完整的实现了上面的一整套的一个开箱即用的管理系统框架，后端基于Spring Boot、前端基于Vue，实现了全套管理系统的通用功能，提供了一套很方便开发的架子。

2.快速开始

2.1.仓库

仓库地址直接在github或者gitee上搜一下就是了，几万个star的项目，一搜就能搜出来：

演示地址和文档地址在项目下：

ruoyi有很多版本，一般单点版本就够用了，把代码拉下来。

2.2.环境初始化

拉起一个系统需要做什么？

数据库脚本、redis服务、前后端拉取依赖+编译、修改配置文件、最后启动。

接下来我们就进行这些步骤。

初始化数据库：

数据库用mysql，执行项目目录下的sql文件，会初始化出数据库：

配置文件：

可以看到主启动类在admin模块下，所以要修改的是admin模块的配置配置好数据库和redis。

3.使用介绍

3.1.权限与组件

使用介绍了用到的并不是原生下下来的，而是博主二开过的，因为要展示自定义组件和菜单。

登陆后我们可以看到ruoyi是个标注的窗口化的管理系统：

系统管理里面是基础的用户管理、角色管理、权限管理：

ruoyi的权限主要体现在菜单里面，每个菜单都有对应的权限码：

每个菜单对应的要转跳的组件也可以进行配置：

组件的路径就是位于前端项目view路径下的相对路径：

组件暴露出去的名称和菜单的路由地址对齐：

3.2.开发与测试

ruoyi集成了开发与测试功能：

表单构建可以通过拖动的方式生成一张张的表单以供前端使用：

代码生成，支持通过建表语句生成后端对象和前端组件：

系统接口，就是swagger，界面化的测试工具：

示例代码：

/**
     * 新增【请填写功能名称】
     */
    @Transactional
    @PreAuthorize("@ss.hasPermi('system:model:add')")
    @Log(title = "【请填写功能名称】", businessType = BusinessType.INSERT)
    @PostMapping
    @ApiOperation("新增用户")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "model", value = "模型实体", dataType = "com.ruoyi.web.controller.system.domain.Model", dataTypeClass = Model.class)
    })
    public AjaxResult add(@RequestBody Model model)
    {
        return toAjax(modelService.insertModel(model));
    }