Skip to content

Django-Vue-Lyadmin

img PyPI - Django Version badge img img

QQ群聊 | 在线体验(admin/123456) | 开发文档 | 在线课程 | 捐赠

slogon

TIP

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

平台简介

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

  • 代码生成: 前端配置即可生成前后台所需的crud文件,并同步到项目目录中(专业版功能优化中
  • 表单构建: 可视化低代码表单设计器,后期规划自动生成前后台,并提供模板方便导入所需表单(专业版功能优化中
  • 前端采用Vue3(elementplus 2.3.1 支持暗黑主题)(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

在线体验

演示地址:http://django-vue3-lyadmin.lybbn.cn 账号:admin 密码:123456

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

  • 移动端 演示地址:H5端 账号:test2 密码:123456

  • 后台 演示地址:后台 账号:admin 密码:123456

文档地址

文档地址:文档在本项目的wiki中会持续更新,也可以通过官网访问:www.lybbn.cn

补充:如果想找到1.x版本(vue2)标准模块(不带商城功能)的,可前往 正式版v1.0.20 版本进行下载

交流

  • 开发者WX号:laoyanyj

  • QQ群号:755277564 django-vue-lyadmin交流01群

  • 二维码:

源码地址

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

内置功能

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

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

点击跳转观看

lyadmin后端

bash

1. 进入项目目录(python >= 3.9.x)

2. config.py 中配置数据库信息
	mysql数据库版本建议:8.0
	mysql数据库字符集:utf8mb4
    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 -ti django-vue-lyadmin_django bash
python manage.py makemigrations 
python manage.py migrate
python manage.py init
exit
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、pinia
4、富文本编辑器采用tinymce

安装教程

cd frontend
npm install --registry=https://registry.npm.taobao.org

使用说明

调试开发直接运行:

npm start

打包

npm run build

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

线上部署注意事项

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

捐赠该项目

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

Released under the Apache License 2.0