# django-rest-admin

**Repository Path**: lianweiping/django-rest-admin

## Basic Information

- **Project Name**: django-rest-admin
- **Description**: 基于django restframework的前后分离后台管理框架
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-11-07
- **Last Updated**: 2023-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Django-Rest-Admin

[![img](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitee.com/liqianglog/django-rest-admin/blob/master/LICENSE)  [![img](https://img.shields.io/badge/python-%3E=3.7.x-green.svg)](https://python.org/)  [![PyPI - Django Version badge](https://img.shields.io/badge/django%20versions-3.2-blue)](https://docs.djangoproject.com/zh-hans/3.2/) [![img](https://img.shields.io/badge/node-%3E%3D%2012.0.0-brightgreen)](https://nodejs.org/zh-cn/) [![img](https://gitee.com/link234/django-rest-admin/badge/star.svg?theme=dark)](https://gitee.com/link234/django-rest-admin)

## 🐯 平台简介
💡 [django-rest-admin](https://gitee.com/link234/django-rest-admin) 是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。
* 🧑‍🤝‍🧑前端采用[芋道源码yudao-ui-admin-vue3](https://gitee.com/yudaocode/yudao-ui-admin-vue3) 、[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)，支持多终端认证系统。
* 👬支持加载动态权限菜单，多方式轻松权限控制。
* 采用 [vue-element-plus-admin](https://gitee.com/kailong110120130/vue-element-plus-admin) 实现
* 改换 saas，自动引入等功能
* 使用 Element Plus 免费开源的中后台模版，具备如下特性：

![首页](.images/home.png)
### 系统功能

|     | 功能   | 描述                              |
|-----|------|---------------------------------|
|     | 用户管理 | 用户是系统操作者，该功能主要完成系统用户配置          |
|     | 角色管理 | 角色菜单权限分配、设置角色按机构进行数据范围权限划分      |
|     | 菜单管理 | 配置系统菜单、操作权限、按钮权限标识等，本地缓存提供性能    |
|     | 部门管理 | 配置系统组织机构（公司、部门、小组），树结构展现支持数据权限  |
|     | 岗位管理 | 配置系统用户所属担任职务                    |
|     | 字典管理 | 对系统中经常使用的一些较为固定的数据进行维护          |
| 🚀  | 站内信  | 系统内的消息通知，提供站内信模版、站内信消息          |
| 🚀  | 操作日志 | 系统正常操作日志记录和查询，集成 Swagger 生成日志内容 |
| ⭐️  | 登录日志 | 系统登录日志记录查询，包含登录异常               |
|     | 通知公告 | 系统通知公告信息发布维护                    |
| 🚀  | 地区管理 | 展示省份、城市、区镇等城市信息，支持 IP 对应城市      |
| 🚀  | 定时任务 | 集成Celery，支持后台创建，启动，暂停任务，查看任务结果  |

### 视频搭建教程

【DjangoRestAdmin基础教程之开发环境搭建】 https://www.bilibili.com/video/BV1SN411W78F/?share_source=copy_web&vd_source=0c8ddcc919bdbeec2b287b7878b96160

## 准备工作

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

## 前端♝

```bash
# 克隆项目
git clone https://gitee.com/link234/django-rest-admin.git

# 进入项目目录
cd web

# 安装依赖
npm install -g pnpm  --registry=https://registry.npm.taobao.org
pnpm install --registry=https://registry.npm.taobao.org

# 启动服务
npm run dev
# .env.base 文件中可配置启动端口等参数
# 构建生产环境
# npm run build
```



## 后端💈

~~~bash
1. 进入项目目录 cd server
2. 在项目根目录中，复制 ./conf/env.example.py 文件为一份新的到 ./conf 文件夹下，并重命名为 env.py
3. 在 env.py 中配置数据库信息
	mysql数据库版本建议：8.0
	mysql数据库字符集：utf8mb4
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
~~~

## 🐷 演示图

### 系统功能

| 模块          | biu                        | biu                       | biu                      |
|-------------|----------------------------|---------------------------|--------------------------|
| 登录 & 首页     | ![登录](.images/登录.png)     | ![首页](.images/home.png)   | ![个人中心](.images/个人中心.png) |
| 用户 & 定时任务   | ![用户管理](.images/用户管理.png) | ![定时任务](.images/定时任务.png) | -                        |
| 部门 & 岗位     | ![部门管理](.images/部门管理.png) | ![岗位管理](.images/岗位管理.png) | -                        |
| 菜单 & 角色     | ![菜单管理](.images/菜单管理.png) | ![角色管理](.images/角色管理.png) | -                        |
| 操作日志 & 登录日志 | ![操作日志](.images/操作日志.png) | ![登录日志](.images/登录日志.png) | -                        |
| 配置管理 & 个人消息 | ![配置管理](.images/配置管理.png) | ![个人消息](.images/个人消息.png) | -                        |
| 字典 & 字典数据   | ![字典类型](.images/字典管理.png) | ![字典数据](.images/字典数据.png) | -                        |
| 通知 & 消息模板   | ![通知公告](.images/通知公告.png) | ![消息模板](.images/站内消息.png) | -                        |