# django-vue-admin

**Repository Path**: allmyteacher/django-vue-admin

## Basic Information

- **Project Name**: django-vue-admin
- **Description**: 基于RBAC模型的权限控制的一整套基础开发平台，前后端分离，后端采用 django+django-rest-framework，前端采用 vue+ElementUI。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://django-vue-admin.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1757
- **Created**: 2023-11-20
- **Last Updated**: 2023-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Django-Vue-Admin

## 准备工作

~~~
Python >= 3.8.0 (推荐3.8+版本)
nodejs >= 14.0 (推荐最新)
Mysql >= 5.7.0 (可选，默认数据库sqlite3，推荐8.0版本)
Redis(可选，最新版)
~~~

## 前端♝

```bash
git clone https://gitee.com/liqianglog/django-vue-admin.git
cd web
npm install --registry=https://registry.npm.taobao.org
npm run dev
# 浏览器访问 http://localhost:8080
# .env.development 文件中可配置启动端口等参数
# 构建生产环境
# npm run build
```
## 后端💈

~~~bash
cd backend
复制 ./conf/env.example.py 文件为一份新的到 ./conf 文件夹下，并重命名为 env.py
在 env.py 中配置数据库信息
4. 安装依赖环境
	pip3 install -r requirements.txt
5. 执行迁移命令：
	python3 manage.py makemigrations
	python3 manage.py migrate
6. 初始化数据
	python3 manage.py init
7. 初始化省市县数据:
	python3 manage.py init_area
8. 启动项目
	最好不使用： python3 manage.py runserver 0.0.0.0:8000 > /dev/null 2>&1 &
我使用的 gunicorn : gunicorn -c gunicorn_conf.py application.asgi:application > /dev/null 2>&1 &
~~~

### 访问项目

- 访问前端：http://localhost:8080
- 访问后端：http://localhost:8000
- 账号：`superadmin` 密码：`admin123456`


## 技术栈
* 🧑‍🤝‍🧑前端
[D2Admin](https://github.com/d2-projects/d2-admin) 、
[Vue](https://cn.vuejs.org/)、
[ElementUI](https://element.eleme.cn/)。
* 👭后端采用 
Python 语言 
Django 框架以及强大的 
[Django REST Framework](https://pypi.org/project/djangorestframework)。
* 👫权限认证使用
[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt)，支持多终端认证系统。
* 👬支持加载动态权限菜单，多方式轻松权限控制。


## 默认账号

- 账号：superadmin 
- 密码：admin123456

👩‍👦‍👦文档地址：https://django-vue-admin.com


## 内置功能

1.  👨‍⚕️菜单管理：配置系统菜单，操作权限，按钮权限标识、后端接口权限等。
2.  🧑‍⚕️部门管理：配置系统组织机构（公司、部门、角色）。
3.  👩‍⚕️角色管理：角色菜单权限分配、数据权限分配、设置角色按部门进行数据范围权限划分。
4.  🧑‍🎓权限权限：授权角色的权限范围。
5.  👨‍🎓用户管理：用户是系统操作者，该功能主要完成系统用户配置。
6.  👬接口白名单：配置不需要进行权限校验的接口。
7.  🧑‍🔧字典管理：对系统中经常使用的一些较为固定的数据进行维护。
8.  🧑‍🔧地区管理：对省市县区域进行管理。
9.  📁附件管理：对平台上所有文件、图片等进行统一管理。
10.  🗓️操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
11.  🔌[插件市场 ](https://bbs.django-vue-admin.com/plugMarket.html)：基于Django-Vue-Admin框架开发的应用和插件。


| 项目                                                         | Star                                                         | 简介                                         |
| ------------------------------------------------------------ | ------------------------------------------------------------ | -------------------------------------------- |
| [django-vue-admin](https://gitee.com/liqianglog/django-vue-admin) | [![Gitee star](https://gitee.com/liqianglog/django-vue-admin/badge/star.svg?theme=white)](https://gitee.com/liqianglog/django-vue-admin) [![GitHub stars](https://img.shields.io/github/stars/liqianglog/django-vue-admin.svg?style=social&label=Stars)](https://github.com/liqianglog/django-vue-admin) | 基于 Vue2 + element + d2admin + django 实现的管理后台 |
| [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin) | [![Gitee star](https://gitee.com/huge-dream/django-vue3-admin/badge/star.svg?theme=white)](https://gitee.com/huge-dream/django-vue3-admin) [![GitHub stars](https://img.shields.io/github/stars/huge-dream/django-vue3-admin.svg?style=social&label=Stars)](https://github.com/huge-dream/django-vue3-admin) | 基于 Vue3 + vue-next-admin + fastcrud + django 实现的管理后台 |

##  插件市场 🔌

| 插件名称                                                  |           开发状态  | 简介                                                         |
| --------------------------------------------------------- | -------- | ------------------------------------------------------------ |
| [dvadmin3-celery 定时任务](https://bbs.django-vue-admin.com/plugMarket/129.html) | 已发布 | 适用dvadmin3可快速使用异步任务，包含在线添加任务、任务记录等 |
| [dvadmin-celery 定时任务](https://bbs.django-vue-admin.com/plugMarket/115.html) | 已发布   | 适用dvadmin3可快速使用异步任务，包含在线添加任务、任务记录等 |
| [dvadmin-sms 短信服务](https://bbs.django-vue-admin.com/plugMarket/128.html) | 已发布   | 整合各端的短信服务插件 |
| [dvadmin-vform 表单设计器](https://bbs.django-vue-admin.com/plugMarket/118.html) | 已发布   | 低代码表单设计器插件 |
| [dvadmin-tenants 多租户管理](https://bbs.django-vue-admin.com/plugMarket/124.html) | 已发布   | 多租户的saas模式 |
| [dvadmin-third 第三方用户管理](https://bbs.django-vue-admin.com/plugMarket/122.html) | 已发布   | 第三方用户管理插件 |
| [dvadmin-ak-sk 加密密钥管理](https://bbs.django-vue-admin.com/plugMarket/120.html) | 已发布   | 用于加密认证字符串来验证认证字符串的密钥 |
| [dvadmin-pay 支付插件](https://bbs.django-vue-admin.com/plugMarket/131.html) | 已发布 | 适用于dvadmin的支付插件，支持微信支持、支付宝支付 |
| [dvadmin-uniapp](https://bbs.django-vue-admin.com/plugMarket/130.html) | 已发布 | 适用于dvadmin的uniapp插件 |
| dvadmin-cloud-storage 云存储插件 | 开发中 | 适用各种云存储进行存储插件 |
| dvadmin-es 搜索插件 | 开发中 | 适用于es的搜索插件 |
| dvadmin-low-code-crud 低代码生成 | 开发中 | 低代码生成插件 |
| dvadmin-flow 工作流插件 | 开发中 | 工作流插件 |


### docker-compose 运行

~~~shell
# 先安装docker-compose (自行百度安装),执行此命令等待安装，如有使用celery插件请打开docker-compose.yml中celery 部分注释
docker-compose up -d
# 初始化后端数据(第一次执行即可)
docker exec -ti dvadmin-django bash
python manage.py makemigrations 
python manage.py migrate
python manage.py init_area
python manage.py init
exit

前端地址：http://127.0.0.1:8080
后端地址：http://127.0.0.1:8080/api
# 在服务器上请把127.0.0.1 换成自己公网ip
账号：superadmin 密码：admin123456

# docker-compose 停止
docker-compose down
#  docker-compose 重启
docker-compose restart
#  docker-compose 启动时重新进行 build
docker-compose up -d --build
~~~