259 lines
12 KiB
Markdown
259 lines
12 KiB
Markdown
20250430
|
||
说明：本系统为django-vue-lyadmin专业版，专业版与基础版大体框架一样，只是功能有增加，因此文档可以参考基础版
|
||
|
||
注意：使用专业版开发时，请使用superadmin/123456超级管理员登录系统，方便测试和调试（避免菜单权限问题）
|
||
|
||
# Django-Vue-Lyadmin
|
||
|
||
[](https://python.org/) [](https://docs.djangoproject.com/zh-hans/4.0/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/lybbn/django-vue-lyadmin)
|
||
|
||
[QQ群聊](https://jq.qq.com/?_wv=1027&k=StAkGqk5) | [在线体验（admin/123456）](http://django-vue3-lyadmin.lybbn.cn) | [开发文档](https://gitee.com/lybbn/django-vue-lyadmin/wikis/pages?sort_id=5264002&doc_id=2214316) | [在线课程](https://gitee.com/lybbn/django-vue-lyadmin/wikis/pages?sort_id=5476409&doc_id=2214316) | [捐赠](https://gitee.com/lybbn/django-vue-lyadmin/wikis/pages?sort_id=5264497&doc_id=2214316)
|
||
|
||
## slogon
|
||
|
||
前端frontend：做一个专业前端能用的框架，后台人员也能面向配置的、能改得动的CRUD
|
||
后端backend ：强大的功能集合，让你开箱即用，成为初学者的领航员
|
||
|
||
## 平台简介
|
||
|
||
django-vue-lyadmin 是一套python django web前后端分离的管理后台快速开发平台（内置简易商城模块），去繁从简、还你一个干净的后台管理系统
|
||
|
||
* 前端采用Vue3（elementplus 2.3.14 支持暗黑主题）(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)
|
||
|
||
## 在线体验
|
||
|
||
演示地址：[http://django-vue3-lyadmin.lybbn.cn](http://django-vue3-lyadmin.lybbn.cn) 账号：admin 密码：123456
|
||
|
||
Eleunipy在线模板系统：[https://eleunipy.lybbn.cn/](https://eleunipy.lybbn.cn/) 账号/密码： 自行注册使用
|
||
|
||
eleunipy系统是结合
|
||
[django-vue-lyadmin](https://gitee.com/lybbn/django-vue-lyadmin)
|
||
[unielepy](https://gitee.com/lybbn/unielepy)
|
||
在全栈开发中，能让开发者挑选模板/组件/源码实现低代码、避免重复造轮子快速完成项目，模板持续更新中...
|
||
|
||
## 文档地址
|
||
|
||
文档地址：文档在本项目的wiki中会持续更新，也可以通过官网访问：[www.lybbn.cn](http://www.lybbn.cn)
|
||
|
||
说明：django-vue3-lyadmin 项目功能已合并至django-vue-lyadmin项目下，如果仅需要简约功能框架可访问： [django-vue3-lyadmin](https://gitee.com/lybbn/django-vue3-lyadmin)
|
||
|
||
补充：如果想找到1.x版本（vue2）标准模块（不带商城功能）的，可前往 [正式版v1.0.20](https://gitee.com/lybbn/django-vue-lyadmin/releases/v1.0.20) 版本进行下载
|
||
|
||
## 交流
|
||
|
||
- 开发者WX号：laoyanyj
|
||
- QQ群号：755277564 `<a target="_blank" href="https://jq.qq.com/?_wv=1027&k=oPz6bqmL"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="django-vue-lyadmin交流01群" title="django-vue-lyadmin交流01群">``</a>`
|
||
- 二维码：
|
||
|
||
<img src='https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/qq.jpg' width='200'>
|
||
|
||
## 源码地址
|
||
|
||
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项目启动视频讲解
|
||
|
||
[](https://v.kuaishouapp.com/s/VIJPdIx6)
|
||
|
||
## 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. 设置数据库不区分大小写：修改配置文件my.cnf 的[mysqld]中增加 lower_case_table_names = 1
|
||
|
||
5. 安装依赖环境
|
||
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
|
||
|
||
6. 数据初始化使用sql脚本直接导入
|
||
sql脚本位置：backend/lyadmin_pro.sql
|
||
|
||
7. 执行迁移命令：（防止代码有更新但未进行数据同步问题）
|
||
python manage.py makemigrations
|
||
python manage.py migrate
|
||
|
||
8. 启动项目（初始账号：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
|
||
|
||
9. 线上linux部署启动项目（需修改gunicorn_restart.sh中gunicorn命令安装目录）
|
||
sh gunicorn_restart.sh
|
||
```
|
||
|
||
#### 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.npmmirror.com
|
||
```
|
||
|
||
#### 使用说明
|
||
|
||
调试开发直接运行(development)：
|
||
|
||
```
|
||
npm start
|
||
```
|
||
|
||
#### 打包
|
||
|
||
线上部署(production)：
|
||
|
||
```
|
||
npm run build
|
||
```
|
||
|
||
打包后静态文件在 dist 目录中
|
||
|
||
## 线上部署注意事项
|
||
|
||
```bash
|
||
1、前端打包前修改frontend\src\api\url里面的线上服务器ip或域名
|
||
2、前端打包的dist里面的静态文件放到backend\frontend\目录
|
||
3、运行python manage.py collectstatic收集静态文件到django
|
||
```
|
||
|
||
## 演示图
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 捐赠该项目
|
||
|
||
开源不易，可使用支付宝、微信扫下面二维码打赏支持。您的支持是我不断创作的动力！！！
|
||
|
||
<table>
|
||
<tr>
|
||
<td><img src="https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/alipay.jpg" height="300" width="400"/></td>
|
||
<td><img src="https://gitee.com/lybbn/django-vue-lyadmin/raw/master/frontend/src/assets/img/wechat.jpg" height="300" width="400"/></td>
|
||
</tr>
|
||
</table>
|