README.md · lightwindy01/django-vue-lyadmin

# Django-Vue-Lyadmin

[![img](https://img.shields.io/badge/python-%3E=3.9.x-green.svg)](https://python.org/)  [![PyPI - Django Version badge](https://img.shields.io/badge/django%20versions-4.x-blue)](https://docs.djangoproject.com/zh-hans/4.0/) [![img](https://img.shields.io/badge/node-%3E%3D%2014.0.0-brightgreen)](https://nodejs.org/zh-cn/) [![img](https://gitee.com/lybbn/django-vue-lyadmin/badge/star.svg?theme=dark)](https://gitee.com/lybbn/django-vue-lyadmin)

[ 官方文档 ](https://doc.lybbn.cn/) | 演示（[基础版](http://django-vue3-lyadmin.lybbn.cn) [专业版](http://django-vue-lyadmin-pro.lybbn.cn)）| [Go语言版](https://gitee.com/lybbn/golyadmin) | [ 在线课程 ](https://doc.lybbn.cn/videos/PythonWeb/%E8%AF%BE%E7%A8%8B%E4%BB%8B%E7%BB%8D.html) | [捐赠](https://gitee.com/lybbn/django-vue-lyadmin/wikis/pages?sort_id=5264497&doc_id=2214316)

## slogon

一个开箱即用的低代码中后台管理系统

前端frontend：做一个专业前端能用的框架，后台人员也能面向配置的、能改得动的CRUD
后端backend ：强大的功能集合，让你开箱即用，成为初学者的领航员

## 在线体验

* 基础版 演示地址：[http://django-vue3-lyadmin.lybbn.cn](http://django-vue3-lyadmin.lybbn.cn) 账号：admin 密码：123456

* 专业版 演示地址：[http://django-vue-lyadmin-pro.lybbn.cn](http://django-vue-lyadmin-pro.lybbn.cn) 账号：admin 密码：123456

说明：

专业版【代码生成】【表单构建】稳定版已出，可适用大部分简单crud场景

unielepy为移动端开发模板：[unielepy](https://gitee.com/lybbn/unielepy)

## 在线体验(商城论坛系统)

* 移动端 演示地址：[H5端](https://pingbang.lybbn.cn/#/) 账号：test2 密码：123456

* 后台 演示地址：[后台](https://pbadmin.lybbn.cn/) 账号：admin 密码：123456

## 平台简介

django-vue-lyadmin 是一套python django web前后端分离的管理后台快速开发平台（内置简易商城模块），去繁从简、还你一个干净的后台管理系统

说明：前端vue环境开发支持vite和webpack两种形式，可自由选择

* 代码生成： 前端配置即可生成前后台所需的crud文件，并同步到项目目录中
* 表单构建： 可视化低代码表单设计器，后期规划自动生成前后台，并提供模板方便导入所需表单
* 前端采用Vue3（elementplus 2.3.6 支持暗黑主题）(vue2版本请访问分支django-vue2-lyadmin)
* 前端支持面向配置的CRUD和自定义页面的CRUD双开发模式
* DashBoard： 数据分析查看
* 计划任务（定时任务，运维能力），django-celery-beat 定时任务
* 服务器监控面板（运维能力），支持windows和linux服务器的实时服务器资源状态监控
* 终端服务webssh（运维能力），支持基于channels的websocket与xterm的webssh（实现websocket的simple-jwt认证，并实现请求方法和接口地址的权限控制）
* 后端采用Python语言Django框架
* 权限认证使用JWT（djangorestframework-simplejwt），支持多终端认证系统
* 接口采用（drf）djangorestframework，支持后台一键关闭前端API访问功能
* 支持加载动态权限菜单，内置常用模块，多方式轻松权限控制，支持单用户登录（踢掉上一个）
* 支持支付宝、微信支付、微信登录、阿里云短信、腾讯云短信等
* 新增商城模块：商品管理、订单管理、财务统计、支付接口（微信支付（app端、小程序端）、支付宝（app端）供参考）....
* 适合刚入门或苦于寻找django web快速开发框架的小伙伴们

特别鸣谢：本平台后端权限设计模式，部分逻辑参考[django-vue-admin-pro](https://gitee.com/dvadmin/django-vue-admin-pro)

## 文档地址

文档地址：文档在本项目的wiki中会持续更新，也可以通过官网访问：[www.lybbn.cn](http://www.lybbn.cn)

补充：如果想找到1.x版本（vue2）标准模块（不带商城功能）的，可前往 [正式版v1.0.20](https://gitee.com/lybbn/django-vue-lyadmin/releases/v1.0.20) 版本进行下载

## 交流
- 开发者WX号：laoyanyj

- QQ群号：

1. django-vue-lyadmin交流01群(已满)：755277564
1. django-vue-lyadmin交流02群：877020250 <a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=bQteR0foj1tZuZE0kdVF3XV9xozOmr9p&jump_from=webapi&authKey=8GRzb/ATMG1hXE7G1n2oCHyoHrP0+mg7xBzskR6mnw8eqb9LTv6FuAhHtoqs2F3y"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="点击链接加入群聊" title="django-vue-lyadmin交流02群"></a>
- 二维码：

## 源码地址

gitee地址(主推)：https://gitee.com/lybbn/django-vue-lyadmin

## 内置功能

01.  DashBoard： 数据分析查看
02.  CRUD： 面向配置的crud功能
03.  计划任务（定时任务，运维能力），django-celery-beat 定时任务
04.  服务器监控面板（运维能力），支持windows和linux服务器的实时服务器资源状态监控
05.  终端服务webssh（运维能力），支持基于channels的websocket与xterm的webssh（实现websocket的simple-jwt认证，并实现请求方法和接口地址的权限控制）
06.  部门管理：配置系统组织机构（公司、部门、角色），树结构展现支持数据权限。
07.  菜单管理：配置系统菜单，操作权限，按钮权限标识、后端接口权限等。
08.  角色管理：角色菜单权限、数据权限、设置角色按部门进行数据范围权限划分。
09.  权限管理：授权角色的权限范围。
10.  地区管理：国内省市区管理。
11.  管理员管理：主要管理系统管理员账号。
12.  用户管理：主要管理前端用户。
13.  个人中心：主要设置登录系统的个人昵称、密码等账号信息。
14.  操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
15.  平台设置：系统设置如字典参数、轮播图
16.  意见反馈：配合前端接口收集用户的反馈信息
17.  商品管理：支持多规格、单规格添加商品、提供对应的支付接口和前端商品详情接口供参考
18.  订单管理：主要为商品订单的管理有发货、统计......
19.  财务统计：平台订单等财务统计
20.  其他功能：内置微信登录、小程序登录、短信登录、密码登录、微信企业到零钱、微信支付、支付宝支付、极光推送等API。

## django-vue-lyadmin项目启动视频讲解

1. 如何启动项目
- 1.1 [django-vue-lyadmin项目介绍（一）(视频)](https://www.bilibili.com/video/BV1Tk4y1j7pq/?share_source=copy_web&vd_source=be722122bb4156c932e29dbdfe89c90c)

2. 项目功能点介绍
- 2.1 [django-vue-lyadmin项目介绍（二）(视频)](https://www.bilibili.com/video/BV1RV4y1671v/?share_source=copy_web&vd_source=be722122bb4156c932e29dbdfe89c90c)

3. 项目低代码开发介绍
- 3.1 [django-vue-lyadmin低代码开发介绍(视频)](https://www.bilibili.com/video/BV1Yh411F7iM/?share_source=copy_web&vd_source=be722122bb4156c932e29dbdfe89c90c)

## lyadmin后端

~~~bash
1. 进入项目目录

2. 在 config.py 中配置数据库信息
	mysql数据库版本建议：8.0（django4.2版本要求mysql8.x以上）
	mysql数据库字符集：utf8mb4（mysql8.x排序规则选择：utf8mb4_0900_ai_ci、mysql5.7.x选择utf8mb4_general_ci）
    mysql数据库对应的表关于事务处理的确保是：innodb引擎（能回滚）

3. 设置数据库隔离级别（悲观锁、乐观锁）
    全局设置mysql数据库隔离级别为READ-COMMITTED（临时生效，重启就没了）：SET GLOBAL tx_isolation='READ-COMMITTED';
    全局设置mysql数据库隔离级别为READ-COMMITTED（永久有效）：修改配置文件my.cnf 的[mysqld]中增加 transaction-isolation=Read-Committed 
    当数据库当前会话的隔离级别：set tx_isolation='READ-COMMITTED';
    查询当前会话的数据库隔离级别：select @@tx_isolation;
    查询数据库mysql的隔离级别：select @@global.tx_isolation;
    
4. 安装依赖环境
	pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

5. 执行迁移命令（数据初始化）：（此步骤可省略，直接导入sql脚本即可）
	python manage.py makemigrations
	python manage.py migrate

6. 初始化数据（数据初始化）：（此步骤可省略，直接导入sql脚本即可）
	python manage.py init

7. 启动项目（初始账号：superadmin 密码：123456）
	python manage.py runserver 127.0.0.1:8000
    或使用 daphne (使用【终端服务】的需要使用此asgi方式部署来支持websocket):
    daphne -b 0.0.0.0 -p 8000 --proxy-headers application.asgi:application
    
    使用celery【计划任务】需要额外启动celery 和 beat（调度器）
    mac/linux:
    celery -A application worker -B -l info
    windows:(需要安装: pip install eventlet)
    celery -A application worker -P eventlet -l info
    celery -A application beat -l info

~~~

#### docker-compose 部署

~~~bash
1、先安装docker环境
2、pip install docker-compose 安装docker-compose
3、切换到项目根目录运行 docker-compose build 创建环境
4、docker-compose up -d 后台的方式启动docker环境
5、初始化django后端数据（第一次执行即可）
docker exec -it django-vue-lyadmin_django /bin/bash
python manage.py makemigrations 
python manage.py migrate
python manage.py init
exit
或者直接导入lyadmin_db.sql文件到数据库也可
6、其他docker-compose命令
# docker-compose 停止
docker-compose down
#  docker-compose 重启
docker-compose restart
#  docker-compose 启动时重新进行 build
docker-compose up -d --build
7、说明：默认docker端口mysql:3306\redis:6379\前端:8080\后台:8000 
如果端口冲突会造成启动docker失败情况
~~~

## 其他说明

1、使用本项目记得要更改application-->settings-->SECRET_KEY
~~~bash
可以运行python manage.py shell
from django.core.management import utils
utils.get_random_secret_key()
获取生成的新SECRET_KEY替换原来的老KEY
~~~

## lyadmin前端

#### 介绍

django-vue-lyadmin 是一套前后端分离的前端后台管理框架，是适配 django-vue-lyadmin 的 python django 后台管理项目的专属框架，基于原生 vue 开发，灵活自定义，可发挥空间大

#### 软件架构

```
1、VUE3
2、elementplus
3、富文本编辑器采用 vue-quill-editor 和 tinymce 两种 可以自行选择
```

#### 安装教程

```
cd frontend
npm install --registry=https://registry.npmmirror.com
```
说明：node版本尽量选择低版本，目前开发使用的为node：v16.17.0

#### 使用说明

调试开发直接运行：

```
npm start
```

#### 打包

```
npm run build
```

打包后静态文件在 dist 目录中

## 线上部署注意事项

~~~bash
1、前端打包前修改frontend\src\api\url里面的线上服务器ip或域名
2、前端打包的dist里面的静态文件放到backend\frontend\目录
3、运行python manage.py collectstatic收集静态文件到django
~~~

## 演示图

![image-task02](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/task02.png)

![image-task01](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/task01.png)

![image-188](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/188.png)

![image-100](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/100.png)

![image-099](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/099.png)

![image-098](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/098.png)

![image-088](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/088.png)

![image-04](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/04.png)

![image-02](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/02.png)

![image-03](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/03.png)

![image-06](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/06.png)

![image-05](https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/05.png)

## 捐赠该项目

开源不易，可使用支付宝、微信扫下面二维码打赏支持。您的支持是我不断创作的动力！！！

lightwindy01/django-vue-lyadmin

简介

发行版

贡献者

近期动态

lightwindy01/django-vue-lyadmin .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

lightwindy01/django-vue-lyadmin