# django-vue-lyadmin **Repository Path**: zpflog/django-vue-lyadmin ## Basic Information - **Project Name**: django-vue-lyadmin - **Description**: django-vue-lyadmin前端采用vue3+elementplus,后端采用Python Django DRF的一套前后端分离的低代码快速后台开发平台(专业版带有代码生成和表单构建器)、支持简易商城模块、定时任务、webssh运维、系统监控、内置常用功能api接口如:登陆、短信、支付宝微信支付,RABC权限控制。登录使用simplejwt,webpack\vite自由选择 - **Primary Language**: Python - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://gitee.com/lybbn - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 409 - **Created**: 2025-02-19 - **Last Updated**: 2025-02-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 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 点击链接加入群聊 - 二维码: ## 源码地址 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) ## 捐赠该项目 开源不易,可使用支付宝、微信扫下面二维码打赏支持。您的支持是我不断创作的动力!!!