# mldong-python

**Repository Path**: mldong666/mldong-python

## Basic Information

- **Project Name**: mldong-python
- **Description**: Flask快速开发框架、RBAC权限管理、自研工作流引擎
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.mldong.com/
- **GVP Project**: No

## Statistics

- **Stars**: 329
- **Forks**: 12
- **Created**: 2024-07-21
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Flask, Python, 快速开发框架, 工作流引擎, RBAC权限管理

## README

## [⭐提问前，先看看这里⭐](https://gitee.com/mldong666/mldong-python/issues)
## mldong-python介绍
mldong-python 是一个 Flask 企业级快速开发平台，基于经典技术组合（Flask、Vue3、Vben Admin、Ant Design Of Vue），内置模块如：用户管理、在线用户、角色管理、菜单管理、前端路由同步、部门管理、岗位管理、数据字典、参数配置、登录日志地等。自研工作流引擎并配套工作流管理模块：流程设计、流程定义、发起申请、我发起的、我的待办、我的已办、我的抄送等。在线开发：支持元数据管理、代码生成。
## 视频教程
- [本地运行后端项目](https://www.bilibili.com/video/BV1CnrDYdEea)
- [本地运行前端项目](https://www.bilibili.com/video/BV11jrDYbEWU)

## 相关项目 
- [前端工程](https://gitee.com/mldong/mldong-vue)
- [演示地址](https://www.mldong.com/?nav=onlinedemo-1) 
- [演示地址-pro版](https://www.mldong.com/?nav=onlinedemo-10) 
- [文档地址](https://doc-py.mldong.com/)
- [Java版](https://gitee.com/mldong/mldong)


演示环境账号密码：admin/123456

本地环境账号密码：superAdmin/123456

## 技术栈
- Python3.8.5
- Flask==2.0.2
- SQLAlchemy==1.4.26
- Flask-SQLAlchemy==2.5.1
- pymysql==1.0.2
- Flask-Migrate==3.1.0
- WTForms==3.0.0
- flask-redis==0.4.0
- pytest==6.2.5
## 环境安装
- Python3安装（略）
- NodeJS 16 （略）
- Mysql （略）
- Redis（略）
- NodeJS版本管理工具nvm（略），如果安装了nvm，可不用单独安装nodejs
- IDEA/PyCharm（略）
- Git Bash (略)
- VSCode（略）
- ApiFox或Postman 接口测试及管理工具（略）
## 快速开始
### 创建虚拟环境
```shell
python -m venv ./venv
```
### 激活虚拟环境
```shell
source venv/Scripts/activate
```
### 安装依赖
```shell
pip3 install -r requirements.txt -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
```
### 设置环境变量
```shell
export FLASK_APP=app.py
export FLASK_ENV=development
export FLASK_DEBUG=1
export FLASK_RUN_PORT=18080
```
### 运行
```shell
flask run
```
### 其他命令
#### 代码生成
```shell
flask code gen -t sys_role -ignore_prefix=sys_
```
#### 生成依赖文件
```shell
pip3 freeze > requirements.txt
```
## 功能清单

- [ ] 系统设置
	- [x] 用户管理
        - [x] 扮演用户
        - [x] 重置密码
        - [x] 授权角色
    - [x] 在线用户
        - [x] 详情
        - [x] 踢下线
        - [x] 强制注销
	- [x] 角色管理
        - [x] 授权菜单
        - [x] 成员管理
	- [x] 菜单管理
	- [x] 前端路由
        - [x] 同步路由清单
	- [x] 部门管理
	- [x] 岗位管理
    - [x] 数据字典
    - [x] 参数配置
    - [x] 登录日志
    - [ ] 系统日志
	- [ ] 系统通知
- [x] 工作流程
	- [x] 流程设计
        - [x] 流程设计
        - [x] 表单设计
        - [x] 部署流程
        - [x] 导出流程
        - [x] 导入流程
    - [x] 流程定义
	- [x] 发起申请
	- [x] 我发起的
	- [x] 我的待办
      - [x] 同意
      - [x] 拒绝
      - [x] 退回上一步
      - [x] 退回发起人
      - [x] 跳转
      - [x] 转办
      - [x] 委托
      - [x] 抄送
      - [ ] 转发
      - [x] 加签
      - [x] 减签
	- [x] 我的已办
	- [x] 我的抄送
- [ ] 在线开发
    - [ ] 模型分组
    - [ ] 数据模型
        - [ ] 导入数据库表
        - [ ] 查看元数据
        - [ ] 模型字段管理
        - [ ] 在线预览
## 目录结构
```lua
├── controller 控制层
├── decorators  装饰器
├── doc  文档
├── enums  枚举字典
├── generator 代码生成
├── mauth  权限认证
├── mexception  异常处理
├── mlogging  日志处理
├── models  模型层
├── services  业务逻辑层
├── tests  单元测试
├── tools  工具类
├── validators  表单校验
├── config.py  配置文件
└── requirements.txt  依赖包清单
```