多功能、高效率、低代码的前后端一体化、智能化的开发工具
👉 https://maimengcloud.com/#/openCommunity 👈
## 📢 简介 **mdp-sys-backend**旨在为企业开发管理类的业务系统提供一个模板工程，该模板工程具有高效率、低代码、功能丰富等特点。企业可以在该工程之上，加入更多其它业务功能；也可以以该工程作为模板，创建新的工程，用于开发其它业务。使用该工程构建应用，您不用考虑登录、权限、菜单管理、系统管理、公共组件、公共api、代码冗余、数据字典、图片库、微服务互相调用、全局跟踪定位bug、多主键crud,复杂sql查询等各种问题，这些都内置其中了，轻松搞定。 **mdp-sys-backend**作为独立的spring boot项目，企业可以单独使用该工程，另外单独开发后端系统；也可以直接使用**唛盟团队** 配套开源的前端工程[mdp-sys-ui-web](https://gitee.com/maimengcloud/mdp-sys-ui-web)作为前端页面工程。 唛盟mdp更多内容，请点击👉[mdp-core](https://gitee.com/maimengcloud/mdp-core) 👈 ## 💪 内置功能 ``` 角色权限 ├── 角色管理 => 角色crud、分配菜单、分配权限 ├── 权限定义 => 权限crud ├── 菜单管理 => 菜单(按钮)crud、分配菜单(按钮)给角色、 ├── 模块管理 => 模块crud ├── 已开模块 => 查看企业(个人)已开通的模块 组织管理 ├── 机构管理 => 企业信息维护、管理员维护、账户信息维护、企业产品维护、 ├── 用户管理 => 用户的crud、分配岗位、分配部门、重置密码、邀请 ├── 部门管理 => 部门curd、分配岗位到部门、查看部门用户 ├── 公司管理 => 公司curd（超级管理员使用） ├── 岗位管理 => 岗位curd、分配角色到岗位、岗位人员查看 ├── 注销审核 => 审核用户的注销申请 平台管理 ├── 平台配置 => 配置平台的信息 ├── 个人认证审核 => 审核个人的实名认证请求 ├── 企业认证审核 => 审核企业的实名认证请求 元数据管理 ├── 字典管理 => 数据字典的crud ├── 列表维护 => 下拉列表数据项的crud ├── 参数定义 => 公共系统参数的crud ``` ## ⌨ 技术栈 spring boot + spring security + mybatis plus(改造后支持多主键、复杂查询) + spring oauth2(可选) + druid + redis + mysql(可选其它数据库) + flowable(工作流,可选) ## 💻 样例项目 - [系统管理] (https://maimengcloud.com/sys/m1/) - [协同办公] (https://maimengcloud.com/oa/m1/) - [项目管理] (https://maimengcloud.com/xm/m1/) - [流程管理] (https://maimengcloud.com/workflow/m1/) ## ⚙ 快速开始 ### 前序准备 - 该项目属于java应用项目，其页面由 [mdp-sys-ui-web](https://gitee.com/maimengcloud/mdp-sys-ui-web)提供，如需开发页面请下载页面工程 - 代码生成器下载 [mdp-code-generator](https://gitee.com/maimengcloud/mdp-code-generator) ### 开发 #### 初始化开发环境 ```bash # 克隆底层框架 git clone https://gitee.com/maimengcloud/mdp-core.git # 编译构建基础库 进入mdp-core根目录 mvn install # 克隆项目 git clone https://gitee.com/maimengcloud/mdp-sys-backend.git # 安装数据库 在数据库创建adm用户，找到 mdp-sys-backend/mdp-sys/database/adm_*.sql 将 adm.*.sql导入到数据库中,并到mdp-sys/src/main/resources/application-dev.yml修改数据源相关用户名,密码,连接地址等 ``` #### 开发 ```bash # 运行spring boot项目 找到mdp-sys-backend/mdp-sys/src/test/java/com/mdp/SysApplication.java 运行 SysApplication ``` #### 构建 ```bash # 编译构建基础库(如果有修改) 进入mdp-core根目录 mvn install # 构建发布包 切换到 mdp-sys-backend/下，执行下面命令，成功后在 mdp-sys-bootstrap及mdp-sys-cloud-bootstrap下都会有jar输出 mvn install ``` #### 发布 >⚠️注意：[bootstrap-mdp-sys.sh](mdp-sys-bootstrap/bin/start-service/bootstrap-mdp-sys.sh) 一般在mdp-sys-backend/mdp-sys-bootstrap/bin/start-service/下 ```bash # 将jar包发布到maven服务器 切换到 mdp-core/下 mvn deploy # 将jar包发布到maven服务器 切换到 mdp-sys-backend/下 mvn deploy # 如果是单体运用，将mdp-sys-backend/mdp-sys-bootstrap/mdp-sys-bootstrap-2.0.0-RELEASE.jar拷贝到目标服务器 sh bootstrap-mdp-sys.sh # 如果是微服务环境，将mdp-sys-backend/mdp-sys-cloud-bootstrap/mdp-sys-bootstrap-2.0.0-RELEASE.jar拷贝到目标服务器 sh bootstrap-mdp-sys.sh ``` ### 🔔️ 特别提醒 mdp 3.0 版本已经开始规划更新了，尽请期待新版本的诞生吧 ### 🗒️ 版本更新日志 升级前必看：[CHANGELOG.md](/docs/CHANGELOG.md) ## 🚀 基于mdp框架拓展的开源项目 >⚠️ 注意：以下拓展的框架或者子系统，由mdp开源团队基于项目经验进行总结抽取，可用可不用，可以以jar包方式合并到现有工程进行发布，也可单独发布成单体应用、微服务应用 - 第三方支付框架,整合了微信支付、支付宝支付、paypal支付 1. [mdp-tpa-backend](https://gitee.com/maimengcloud/mdp-tpa-backend) 后端 - 即时通讯框架 1. [mdp-im-uniapp](https://gitee.com/maimengcloud/mdp-im-uniapp) 前端app 2. [mdp-im-web](https://gitee.com/maimengcloud/mdp-im-web) 前端浏览器 3. [mdp-im-backend](https://gitee.com/maimengcloud/mdp-im-backend) 后端 - 统一认证中心框架 1. [mdp-sys-ui-web](https://gitee.com/maimengcloud/mdp-sys-ui-web) 前端 2. [mdp-oauth2-backend](https://gitee.com/maimengcloud/mdp-oauth2-backend) 后端 3. [mdp-sys-backend](https://gitee.com/maimengcloud/mdp-sys-backend) 后端 - 微服务框架 1. [mdp-cloud-backend](https://gitee.com/maimengcloud/mdp-cloud-backend) 后端 - 工作流管理子系统 1. [mdp-workflow-ui-web](https://gitee.com/maimengcloud/mdp-workflow-ui-web) 前端 2. [mdp-workflow-backend](https://gitee.com/maimengcloud/mdp-workflow-backend) 后端 - 智能表单子系统 1. [mdp-form-ui-web](https://gitee.com/maimengcloud/mdp-form-ui-web) 前端 2. [mdp-form-backend](https://gitee.com/maimengcloud/mdp-form-backend) 后端 - 内容管理子系统 1. [mdp-arc-ui-web](https://gitee.com/maimengcloud/mdp-arc-ui-web) 前端 2. [mdp-arc-backend](https://gitee.com/maimengcloud/mdp-arc-backend) 后端 - 短信子系统 1. [mdp-sms-ui-web](https://gitee.com/maimengcloud/mdp-sms-ui-web) 前端 2. [mdp-sms-backend](https://gitee.com/maimengcloud/mdp-sms-backend) 后端 - 项目管理子系统 1. [xm-crowd-ui-web](https://gitee.com/maimengcloud/xm-crowd-ui-web) 前端众包 2. [xm-ui-web](https://gitee.com/maimengcloud/xm-ui-web) 前端管理端 3. [xm-backend](https://gitee.com/maimengcloud/xm-backend) 后端 - 财务管理子系统 1. [ac-core-ui-web](https://gitee.com/maimengcloud/ac-core-ui-web) 前端管理端 2. [ac-backend](https://gitee.com/maimengcloud/ac-backend) 后端 ## 📝 常见问题、操作说明 - [前端基础组件](https://gitee.com/maimengcloud/mdp-modules/blob/master/docs/COMPONENTS.md) - [前端扩展组件](https://gitee.com/maimengcloud/mdp-modules/blob/master/docs/COMPONENTS.md) - [前端公共api](https://gitee.com/maimengcloud/mdp-modules/blob/master/docs/COMPONENTS.md) - [后端公共api](https://gitee.com/maimengcloud/mdp-modules/blob/master/docs/COMPONENTS.md) - [文档主页](https://maimengcloud.com/#/openCommunity/mdp) - [FQA](https://maimengcloud.com/#/openCommunity/fqa) ## 💯 实践案例 1. [系统管理](https://maimengcloud.com/sys/m1/) 2. [协同办公](https://maimengcloud.com/oa/m1/) 3. [唛盟众包-网页](https://maimengcloud.com) 3. [项目管理-网页](https://maimengcloud.com/xm/m1/) 4. 项目管理-小程序
5. [流程管理](https://maimengcloud.com/workflow/m1/)
## 🔨贡献指南
### 贡献须知
mdp 作为开源项目，离不开社区的支持，欢迎任何人修改和提出建议。贡献无论大小，你的贡献会帮助背后成千上万的使用者以及开发者，你做出的贡献也会永远的保留在项目的贡献者名单中，这也是开源项目的意义所在！
为了保证项目代码的质量与规范，以及帮助你更快的了解项目的结构，请在贡献之前阅读：
- [mdp 贡献说明](https://gitee.com/maimengcloud/mdp-core/blob/master/docs/CONTRIBUTE.md)
### 贡献步骤
1. Fork 本仓库。
2. Fork 后会在你的帐号下多了一个和本仓库一模一样的仓库，把你帐号的仓库 clone 到本地。
注意替换掉链接中的`分支名`和`用户名`。
如果是贡献代码，分支名填 `dev`；如果是贡献文档，分支名填 `docs`
```bash
git clone -b 分支名 https://gitee.com/用户名/mdp-sys-ui-web.git
```
3. 修改代码/文档，修改后提交上来。
```bash
# 把修改的文件添加到暂存区
git add .
# 提交到本地仓库，说明你具体做了什么修改
git commit -m '填写你做了什么修改'
# 推送到远程仓库，分支名替换成 dev 或者 docs
git push origin 分支名
```
4. 登录你的仓库，然后会看到一条 PR 请求，点击请求合并，等待管理员把你的代码合并进来。
### 项目分支说明
| 分支 | 说明 |
|--------|-----------------------------------------------|
| master | 主分支，受保护分支，此分支不接受 PR。在 dev 分支后经过测试没问题后会合并到此分支。 |
| dev | 开发分支，接受 PR，PR 请提交到 dev 分支。 |
## 🐞 交流讨论 、反馈 BUG、提出建议等
1. 快扫描下方左侧微信二维码和我们一起交流讨论吧！（备注 唛盟-mdp 进群）
2. 唛盟微信公众号查看一些基础教程
3. 反馈 BUG、提出建议，欢迎新建：[issues](https://gitee.com/maimengcloud/mdp-sys-ui-web/issues)，开发人员会不定时查看回复。
4. 参与贡献，请查看[贡献指南](#🔨贡献指南)。
## 💲 打赏
**感谢所有赞赏以及参与贡献的小伙伴，你们的支持是我们不断更新前进的动力！微信扫一扫，赏杯咖啡呗！**
## 🔔 精品项目推荐
| 项目名称 | 项目地址 | 项目介绍 |
|----------------------|---------------------------------------------------------------------------------------------|--------------------------------------------------|
| SpringBoot_v2 | [https://gitee.com/bdj/SpringBoot_v2](https://gitee.com/bdj/SpringBoot_v2) - | 基于springboot的一款纯净脚手架 |