Merge remote-tracking branch 'origin/develop' into develop
This commit is contained in:
猿小天
175
README.en.md
175
README.en.md
@@ -1,175 +0,0 @@
|
|||||||
# Django-Vue3-Admin
|
|
||||||
|
|
||||||
[](https://gitee.com/huge-dream/django-vue3-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/huge-dream/django-vue3-admin)
|
|
||||||
|
|
||||||
[preview](https://demo.dvadmin.com) | [Official website document](https://www.django-vue-admin.com) | [qq group](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [community](https://bbs.django-vue-admin.com) | [plugins market](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin)
|
|
||||||
|
|
||||||
💡 **「About」**
|
|
||||||
|
|
||||||
It is a completely open-source rapid development platform, provided free for personal use and authorized for group use.
|
|
||||||
Django-Vue3-Admin is a comprehensive basic development platform based on the RBAC (Role-Based Access Control) model for permission control, with column-level granularity. It follows a frontend-backend separation architecture, with Django and Django Rest Framework used for the backend, and Vue3, Composition API, TypeScript, Vite, and Element Plus used for the frontend.
|
|
||||||
|
|
||||||
|
|
||||||
## framework introduction
|
|
||||||
|
|
||||||
💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) Is a set of all open source rapid development platform, no reservation for individuals and enterprises free use.
|
|
||||||
|
|
||||||
* 🧑🤝🧑Front-end adoption Vue3+TS+pinia+fastcrud。
|
|
||||||
* 👭The backend uses the Python language Django framework as well as the powerful[Django REST Framework](https://pypi.org/project/djangorestframework)。
|
|
||||||
* 👫Permission authentication use[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt)，Supports the multi-terminal authentication system.
|
|
||||||
* 👬Support loading dynamic permission menu, multi - way easy permission control.
|
|
||||||
* 👬Enhanced Column Permission Control, with granularity down to each column.
|
|
||||||
* 💏Special thanks: [vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/).
|
|
||||||
* 💡Special thanks:[jetbrains](https://www.jetbrains.com/) To provide a free IntelliJ IDEA license for this open source project.
|
|
||||||
|
|
||||||
## Online experience
|
|
||||||
|
|
||||||
👩👧👦👩👧👦 demo address:[https://demo.dvadmin.com](https://demo.dvadmin.com)
|
|
||||||
|
|
||||||
* demo account：superadmin
|
|
||||||
|
|
||||||
* demo password：admin123456
|
|
||||||
|
|
||||||
👩👦👦docs:[https://django-vue-admin.com](https://django-vue-admin.com)
|
|
||||||
|
|
||||||
## communication
|
|
||||||
|
|
||||||
* Communication community:[click here](https://bbs.django-vue-admin.com)👩👦👦
|
|
||||||
|
|
||||||
* plugins market:[click here](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦
|
|
||||||
|
|
||||||
## source code url:
|
|
||||||
|
|
||||||
gitee(Main push)：[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦
|
|
||||||
|
|
||||||
github：[https://github.com/huge-dream/django-vue3-admin](https://github.com/huge-dream/django-vue3-admin)👩👦👦
|
|
||||||
|
|
||||||
## core function
|
|
||||||
|
|
||||||
1. 👨⚕️Menu Management: Configure system menus, operation permissions, button permission flags, backend interface permissions, etc.
|
|
||||||
2. 🧑⚕️Department Management: Configure system organizational structure (company, department, role).
|
|
||||||
3. 👩⚕️Role Management: Role menu permission assignment, data permission assignment, set role-based data scope permissions by department.
|
|
||||||
4. 🧑🎓Button Permission Control: Authorize role-specific button permissions and interface permissions, enabling authorization of data scope for each interface.
|
|
||||||
5. 🧑🎓Field Column Permission Control: Authorize page field display permissions, specifically for the display permissions of a certain column.
|
|
||||||
6. 👨🎓User Management: Users are system operators, and this function is mainly used for system user configuration.
|
|
||||||
7. 👬API Whitelist: Configure interfaces that do not require permission verification.
|
|
||||||
8. 🧑🔧Dictionary Management: Maintain frequently used and relatively fixed data in the system.
|
|
||||||
9. 🧑🔧Region Management: Manage provinces, cities, counties, and districts.
|
|
||||||
10. 📁File Management: Unified management of all files, images, etc., on the platform.
|
|
||||||
11. 🗓️Operation Logs: Record and query logs for normal system operations and exceptional system information.
|
|
||||||
12. 🔌[Plugin Market](https://bbs.django-vue-admin.com/plugMarket.html): Applications and plugins developed based on the Django-Vue-Admin framework.
|
|
||||||
|
|
||||||
## plugins market 🔌
|
|
||||||
|
|
||||||
Updating...
|
|
||||||
|
|
||||||
## Repository Branch Explanation 💈
|
|
||||||
Main Branch: master (stable version)
|
|
||||||
Development Branch: develop
|
|
||||||
|
|
||||||
## before start project you need:
|
|
||||||
|
|
||||||
~~~
|
|
||||||
Python >= 3.11.0 (Minimum version 3.9+)
|
|
||||||
Node.js >= 16.0
|
|
||||||
Mysql >= 8.0 (Optional, default database: SQLite3, supports 5.7+, recommended version: 8.0)
|
|
||||||
Redis (Optional, latest version)
|
|
||||||
~~~
|
|
||||||
|
|
||||||
## frontend♝
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# clone code
|
|
||||||
git clone https://gitee.com/huge-dream/django-vue3-admin.git
|
|
||||||
|
|
||||||
# enter code dir
|
|
||||||
cd web
|
|
||||||
|
|
||||||
# install dependence
|
|
||||||
npm install yarn
|
|
||||||
yarn install --registry=https://registry.npm.taobao.org
|
|
||||||
|
|
||||||
# Start service
|
|
||||||
yarn run dev
|
|
||||||
# Visit http://localhost:8080 in your browser
|
|
||||||
# Parameters such as boot port can be configured in the #.env.development file
|
|
||||||
# Build the production environment
|
|
||||||
# yarn run build
|
|
||||||
```
|
|
||||||
|
|
||||||
## backend💈
|
|
||||||
|
|
||||||
~~~bash
|
|
||||||
1. enter code dir cd backend
|
|
||||||
2. copy ./conf/env.example.py to ./conf dir，rename as env.py
|
|
||||||
3. in env.py configure database information
|
|
||||||
mysql database recommended version: 8.0
|
|
||||||
mysql database character set: utf8mb4
|
|
||||||
4. install pip dependence
|
|
||||||
pip3 install -r requirements.txt
|
|
||||||
5. Execute the migration command:
|
|
||||||
python3 manage.py makemigrations
|
|
||||||
python3 manage.py migrate
|
|
||||||
6. Initialization data
|
|
||||||
python3 manage.py init
|
|
||||||
7. Initialize provincial, municipal and county data:
|
|
||||||
python3 manage.py init_area
|
|
||||||
8. start backend
|
|
||||||
python3 manage.py runserver 0.0.0.0:8000
|
|
||||||
or uvicorn :
|
|
||||||
uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
|
|
||||||
~~~
|
|
||||||
|
|
||||||
### visit backend swagger
|
|
||||||
|
|
||||||
* visit url：[http://localhost:8080](http://localhost:8080) (The default address is this one. If you want to change it, follow the configuration file)
|
|
||||||
* account：`superadmin` password：`admin123456`
|
|
||||||
|
|
||||||
### docker-compose
|
|
||||||
|
|
||||||
~~~shell
|
|
||||||
docker-compose up -d
|
|
||||||
# Initialize backend data (first execution only)
|
|
||||||
docker exec -ti dvadmin3-django bash
|
|
||||||
python manage.py makemigrations
|
|
||||||
python manage.py migrate
|
|
||||||
python manage.py init_area
|
|
||||||
python manage.py init
|
|
||||||
exit
|
|
||||||
|
|
||||||
frontend url：http://127.0.0.1:8080
|
|
||||||
backend url：http://127.0.0.1:8080/api
|
|
||||||
# Change 127.0.0.1 to your own public ip address on the server
|
|
||||||
account：`superadmin` password：`admin123456`
|
|
||||||
|
|
||||||
# docker-compose stop
|
|
||||||
docker-compose down
|
|
||||||
# docker-compose restart
|
|
||||||
docker-compose restart
|
|
||||||
# docker-compose on start build
|
|
||||||
docker-compose up -d --build
|
|
||||||
~~~
|
|
||||||
|
|
||||||
## Demo screenshot✅
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
219
README.md
219
README.md
@@ -1,171 +1,135 @@
|
|||||||
# Django-Vue3-Admin
|
# Django-Vue3-Admin
|
||||||
|
|
||||||
[](https://gitee.com/liqianglog/django-vue-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/liqianglog/django-vue-admin)
|
[](https://gitee.com/huge-dream/django-vue3-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/huge-dream/django-vue3-admin)
|
||||||
|
|
||||||
[预 览](https://demo.dvadmin.com) | [官网文档](https://www.django-vue-admin.com) | [群聊](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [社区](https://bbs.django-vue-admin.com) | [插件市场](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin)
|
[preview](https://demo.dvadmin.com) | [Official website document](https://www.django-vue-admin.com) | [qq group](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [community](https://bbs.django-vue-admin.com) | [plugins market](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin)
|
||||||
|
|
||||||
|
💡 **「About」**
|
||||||
|
|
||||||
|
It is a completely open-source rapid development platform, provided free for personal use and authorized for group use.
|
||||||
|
Django-Vue3-Admin is a comprehensive basic development platform based on the RBAC (Role-Based Access Control) model for permission control, with column-level granularity. It follows a frontend-backend separation architecture, with Django and Django Rest Framework used for the backend, and Vue3, Composition API, TypeScript, Vite, and Element Plus used for the frontend.
|
||||||
|
|
||||||
|
|
||||||
|
## framework introduction
|
||||||
|
|
||||||
💡 **「关于」**
|
💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) Is a set of all open source rapid development platform, no reservation for individuals and enterprises free use.
|
||||||
|
|
||||||
我们是一群热爱代码的青年，在这个炙热的时代下，我们希望静下心来通过Code带来一点我们的色彩和颜色。
|
* 🧑🤝🧑Front-end adoption Vue3+TS+pinia+fastcrud。
|
||||||
|
* 👭The backend uses the Python language Django framework as well as the powerful[Django REST Framework](https://pypi.org/project/djangorestframework)。
|
||||||
|
* 👫Permission authentication use[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt)，Supports the multi-terminal authentication system.
|
||||||
|
* 👬Support loading dynamic permission menu, multi - way easy permission control.
|
||||||
|
* 👬Enhanced Column Permission Control, with granularity down to each column.
|
||||||
|
* 💏Special thanks: [vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/).
|
||||||
|
* 💡Special thanks:[jetbrains](https://www.jetbrains.com/) To provide a free IntelliJ IDEA license for this open source project.
|
||||||
|
|
||||||
因为热爱，所以拥抱未来!
|
## Online experience
|
||||||
|
|
||||||
|
👩👧👦👩👧👦 demo address:[https://demo.dvadmin.com](https://demo.dvadmin.com)
|
||||||
|
|
||||||
## 平台简介
|
* demo account：superadmin
|
||||||
|
|
||||||
💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) 是一套全部开源的快速开发平台，毫无保留给个人免费使用、团体授权使用。
|
* demo password：admin123456
|
||||||
django-vue3-admin 基于RBAC模型的权限控制的一整套基础开发平台，权限粒度达到列级别，前后端分离，后端采用django + django-rest-framework，前端采用基于 vue3 + CompositionAPI + typescript + vite + element plus
|
|
||||||
|
|
||||||
|
👩👦👦docs:[https://django-vue-admin.com](https://django-vue-admin.com)
|
||||||
|
|
||||||
|
## communication
|
||||||
|
|
||||||
|
* Communication community:[click here](https://bbs.django-vue-admin.com)👩👦👦
|
||||||
|
|
||||||
* 🧑🤝🧑前端采用 Vue3+TS+pinia+fastcrud(感谢[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/))
|
* plugins market:[click here](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦
|
||||||
* 👭后端采用 Python 语言 Django 框架以及强大的 [Django REST Framework](https://pypi.org/project/djangorestframework)。
|
|
||||||
* 👫权限认证使用[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt)，支持多终端认证系统。
|
|
||||||
* 👬支持加载动态权限菜单，多方式轻松权限控制。
|
|
||||||
* 👬全新的列权限管控，粒度细化到每一列。
|
|
||||||
* 💏特别鸣谢：[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/)。
|
|
||||||
* 💡特别感谢[jetbrains](https://www.jetbrains.com/) 为本开源项目提供免费的 IntelliJ IDEA 授权。
|
|
||||||
|
|
||||||
#### 🏭 环境支持
|
## source code url:
|
||||||
|
|
||||||
| Edge | Firefox | Chrome | Safari |
|
gitee(Main push)：[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦
|
||||||
| --------- | ------------ | ----------- | ----------- |
|
|
||||||
| Edge ≥ 79 | Firefox ≥ 78 | Chrome ≥ 64 | Safari ≥ 12 |
|
|
||||||
|
|
||||||
> 由于 Vue3 不再支持 IE11，故而 ElementPlus 也不支持 IE11 及之前版本。
|
github：[https://github.com/huge-dream/django-vue3-admin](https://github.com/huge-dream/django-vue3-admin)👩👦👦
|
||||||
|
|
||||||
|
## core function
|
||||||
|
|
||||||
|
1. 👨⚕️Menu Management: Configure system menus, operation permissions, button permission flags, backend interface permissions, etc.
|
||||||
|
2. 🧑⚕️Department Management: Configure system organizational structure (company, department, role).
|
||||||
|
3. 👩⚕️Role Management: Role menu permission assignment, data permission assignment, set role-based data scope permissions by department.
|
||||||
|
4. 🧑🎓Button Permission Control: Authorize role-specific button permissions and interface permissions, enabling authorization of data scope for each interface.
|
||||||
|
5. 🧑🎓Field Column Permission Control: Authorize page field display permissions, specifically for the display permissions of a certain column.
|
||||||
|
6. 👨🎓User Management: Users are system operators, and this function is mainly used for system user configuration.
|
||||||
|
7. 👬API Whitelist: Configure interfaces that do not require permission verification.
|
||||||
|
8. 🧑🔧Dictionary Management: Maintain frequently used and relatively fixed data in the system.
|
||||||
|
9. 🧑🔧Region Management: Manage provinces, cities, counties, and districts.
|
||||||
|
10. 📁File Management: Unified management of all files, images, etc., on the platform.
|
||||||
|
11. 🗓️Operation Logs: Record and query logs for normal system operations and exceptional system information.
|
||||||
|
12. 🔌[Plugin Market](https://bbs.django-vue-admin.com/plugMarket.html): Applications and plugins developed based on the Django-Vue-Admin framework.
|
||||||
|
|
||||||
## 在线体验
|
## plugins market 🔌
|
||||||
|
|
||||||
👩👧👦演示地址：[https://demo.dvadmin.com](https://demo.dvadmin.com)
|
Updating...
|
||||||
|
|
||||||
- 账号：superadmin
|
## Repository Branch Explanation 💈
|
||||||
|
Main Branch: master (stable version)
|
||||||
|
Development Branch: develop
|
||||||
|
|
||||||
- 密码：admin123456
|
## before start project you need:
|
||||||
|
|
||||||
👩👦👦文档地址：[coding](https://dvadmin-private.coding.net/share/km/cec69f3d-30fe-47d5-bd97-e9e851f0b776/K-2)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 交流
|
|
||||||
|
|
||||||
- 交流社区：[戳我](https://bbs.django-vue-admin.com)👩👦👦
|
|
||||||
|
|
||||||
- 插件市场：[戳我](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦
|
|
||||||
|
|
||||||
- django-vue-admin交流01群(已满)：812482043 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=aJVwjDvH-Es4MPJQuoO32N0SucK22TE5&jump_from=webapi)
|
|
||||||
- django-vue-admin交流02群(已满)：687252418 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=4jJN4IjWGfxJ8YJXbb_gTsuWjR34WLdc&jump_from=webapi)
|
|
||||||
- django-vue-admin交流03群：442108213 [点击链接加入群聊](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=wsm5oSz3K8dElBYUDtLTcQSEPhINFkl8&authKey=M6sbER0z59ZakgBr5erFeZyFZU15CI52bErNZa%2FxSvvGIuVAbY0N5866v89hm%2FK4&noverify=0&group_code=442108213)
|
|
||||||
|
|
||||||
- 二维码
|
|
||||||
|
|
||||||
<img src='https://images.gitee.com/uploads/images/2022/0530/233203_5fb11883_5074988.jpeg' width='200'>
|
|
||||||
|
|
||||||
## 源码地址
|
|
||||||
|
|
||||||
gitee地址(主推)：[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦
|
|
||||||
|
|
||||||
github地址：[https://github.com/huge-dream/django-vue3-admin](https://github.com/huge-dream/django-vue3-admin)👩👦👦
|
|
||||||
|
|
||||||
|
|
||||||
## 内置功能
|
|
||||||
|
|
||||||
1. 👨⚕️菜单管理：配置系统菜单，操作权限，按钮权限标识、后端接口权限等。
|
|
||||||
2. 🧑⚕️部门管理：配置系统组织机构（公司、部门、角色）。
|
|
||||||
3. 👩⚕️角色管理：角色菜单权限分配、数据权限分配、设置角色按部门进行数据范围权限划分。
|
|
||||||
4. 🧑🎓按钮权限控制：授权角色的按钮权限和接口权限,可做到每一个接口都能授权数据范围。
|
|
||||||
5. 🧑🎓字段列权限控制：授权页面的字段显示权限，具体到某一列的显示权限。
|
|
||||||
7. 👨🎓用户管理：用户是系统操作者，该功能主要完成系统用户配置。
|
|
||||||
8. 👬接口白名单：配置不需要进行权限校验的接口。
|
|
||||||
9. 🧑🔧字典管理：对系统中经常使用的一些较为固定的数据进行维护。
|
|
||||||
10. 🧑🔧地区管理：对省市县区域进行管理。
|
|
||||||
11. 📁附件管理：对平台上所有文件、图片等进行统一管理。
|
|
||||||
12. 🗓️操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
|
|
||||||
13. 🔌[插件市场 ](https://bbs.django-vue-admin.com/plugMarket.html)：基于Django-Vue-Admin框架开发的应用和插件。
|
|
||||||
|
|
||||||
## 插件市场 🔌
|
|
||||||
更新中...
|
|
||||||
|
|
||||||
## 仓库分支说明 💈
|
|
||||||
主分支：master（稳定版本）
|
|
||||||
开发分支：develop
|
|
||||||
|
|
||||||
|
|
||||||
## 准备工作
|
|
||||||
~~~
|
~~~
|
||||||
Python >= 3.11.0 (最低3.9+版本)
|
Python >= 3.11.0 (Minimum version 3.9+)
|
||||||
nodejs >= 16.0
|
Node.js >= 16.0
|
||||||
Mysql >= 8.0 (可选，默认数据库sqlite3，支持5.7+，推荐8.0版本)
|
Mysql >= 8.0 (Optional, default database: SQLite3, supports 5.7+, recommended version: 8.0)
|
||||||
Redis (可选，最新版)
|
Redis (Optional, latest version)
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
## 前端♝
|
## frontend♝
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 克隆项目
|
# clone code
|
||||||
git clone https://gitee.com/huge-dream/django-vue3-admin.git
|
git clone https://gitee.com/huge-dream/django-vue3-admin.git
|
||||||
|
|
||||||
# 进入项目目录
|
# enter code dir
|
||||||
cd web
|
cd web
|
||||||
|
|
||||||
# 安装依赖
|
# install dependence
|
||||||
npm install yarn
|
npm install yarn
|
||||||
yarn install --registry=https://registry.npm.taobao.org
|
yarn install --registry=https://registry.npm.taobao.org
|
||||||
|
|
||||||
# 启动服务
|
# Start service
|
||||||
yarn build
|
yarn run dev
|
||||||
# 浏览器访问 http://localhost:8080
|
# Visit http://localhost:8080 in your browser
|
||||||
# .env.development 文件中可配置启动端口等参数
|
# Parameters such as boot port can be configured in the #.env.development file
|
||||||
# 构建生产环境
|
# Build the production environment
|
||||||
# yarn run build
|
# yarn run build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## backend💈
|
||||||
|
|
||||||
## 后端💈
|
|
||||||
|
|
||||||
~~~bash
|
~~~bash
|
||||||
1. 进入项目目录 cd backend
|
1. enter code dir cd backend
|
||||||
2. 在项目根目录中，复制 ./conf/env.example.py 文件为一份新的到 ./conf 文件夹下，并重命名为 env.py
|
2. copy ./conf/env.example.py to ./conf dir，rename as env.py
|
||||||
3. 在 env.py 中配置数据库信息
|
3. in env.py configure database information
|
||||||
mysql数据库版本建议：8.0
|
mysql database recommended version: 8.0
|
||||||
mysql数据库字符集：utf8mb4
|
mysql database character set: utf8mb4
|
||||||
4. 安装依赖环境
|
4. install pip dependence
|
||||||
pip3 install -r requirements.txt
|
pip3 install -r requirements.txt
|
||||||
5. 执行迁移命令：
|
5. Execute the migration command:
|
||||||
python3 manage.py makemigrations
|
python3 manage.py makemigrations
|
||||||
python3 manage.py migrate
|
python3 manage.py migrate
|
||||||
6. 初始化数据
|
6. Initialization data
|
||||||
python3 manage.py init
|
python3 manage.py init
|
||||||
7. 初始化省市县数据:
|
7. Initialize provincial, municipal and county data:
|
||||||
python3 manage.py init_area
|
python3 manage.py init_area
|
||||||
8. 启动项目
|
8. start backend
|
||||||
python3 manage.py runserver 0.0.0.0:8000
|
python3 manage.py runserver 0.0.0.0:8000
|
||||||
或使用 uvicorn :
|
or uvicorn :
|
||||||
uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
|
uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
|
||||||
~~~
|
~~~
|
||||||
## 开发建议
|
|
||||||
前后端backend与web各自单独一个窗口打开进行开发
|
|
||||||
|
|
||||||
### 访问项目
|
### visit backend swagger
|
||||||
|
|
||||||
- 访问地址：[http://localhost:8080](http://localhost:8080) (默认为此地址，如有修改请按照配置文件)
|
* visit url：[http://localhost:8080](http://localhost:8080) (The default address is this one. If you want to change it, follow the configuration file)
|
||||||
- 账号：`superadmin` 密码：`admin123456`
|
* account：`superadmin` password：`admin123456`
|
||||||
|
|
||||||
|
### docker-compose
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### docker-compose 运行
|
|
||||||
|
|
||||||
~~~shell
|
~~~shell
|
||||||
# 先安装docker-compose (自行百度安装),执行此命令等待安装，如有使用celery插件请打开docker-compose.yml中celery 部分注释
|
|
||||||
docker-compose up -d
|
docker-compose up -d
|
||||||
# 初始化后端数据(第一次执行即可)
|
# Initialize backend data (first execution only)
|
||||||
docker exec -ti dvadmin3-django bash
|
docker exec -ti dvadmin3-django bash
|
||||||
python manage.py makemigrations
|
python manage.py makemigrations
|
||||||
python manage.py migrate
|
python manage.py migrate
|
||||||
@@ -173,22 +137,20 @@ python manage.py init_area
|
|||||||
python manage.py init
|
python manage.py init
|
||||||
exit
|
exit
|
||||||
|
|
||||||
前端地址：http://127.0.0.1:8080
|
frontend url：http://127.0.0.1:8080
|
||||||
后端地址：http://127.0.0.1:8080/api
|
backend url：http://127.0.0.1:8080/api
|
||||||
# 在服务器上请把127.0.0.1 换成自己公网ip
|
# Change 127.0.0.1 to your own public ip address on the server
|
||||||
账号：superadmin 密码：admin123456
|
account：`superadmin` password：`admin123456`
|
||||||
|
|
||||||
# docker-compose 停止
|
# docker-compose stop
|
||||||
docker-compose down
|
docker-compose down
|
||||||
# docker-compose 重启
|
# docker-compose restart
|
||||||
docker-compose restart
|
docker-compose restart
|
||||||
# docker-compose 启动时重新进行 build
|
# docker-compose on start build
|
||||||
docker-compose up -d --build
|
docker-compose up -d --build
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
|
## Demo screenshot✅
|
||||||
|
|
||||||
## 演示图✅
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@@ -211,4 +173,3 @@ docker-compose up -d --build
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
214
README.zh.md
Normal file
214
README.zh.md
Normal file
@@ -0,0 +1,214 @@
|
|||||||
|
# Django-Vue3-Admin
|
||||||
|
|
||||||
|
[](https://gitee.com/liqianglog/django-vue-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/liqianglog/django-vue-admin)
|
||||||
|
|
||||||
|
[预 览](https://demo.dvadmin.com) | [官网文档](https://www.django-vue-admin.com) | [群聊](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [社区](https://bbs.django-vue-admin.com) | [插件市场](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
💡 **「关于」**
|
||||||
|
|
||||||
|
我们是一群热爱代码的青年，在这个炙热的时代下，我们希望静下心来通过Code带来一点我们的色彩和颜色。
|
||||||
|
|
||||||
|
因为热爱，所以拥抱未来!
|
||||||
|
|
||||||
|
|
||||||
|
## 平台简介
|
||||||
|
|
||||||
|
💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) 是一套全部开源的快速开发平台，毫无保留给个人免费使用、团体授权使用。
|
||||||
|
django-vue3-admin 基于RBAC模型的权限控制的一整套基础开发平台，权限粒度达到列级别，前后端分离，后端采用django + django-rest-framework，前端采用基于 vue3 + CompositionAPI + typescript + vite + element plus
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* 🧑🤝🧑前端采用 Vue3+TS+pinia+fastcrud(感谢[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/))
|
||||||
|
* 👭后端采用 Python 语言 Django 框架以及强大的 [Django REST Framework](https://pypi.org/project/djangorestframework)。
|
||||||
|
* 👫权限认证使用[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt)，支持多终端认证系统。
|
||||||
|
* 👬支持加载动态权限菜单，多方式轻松权限控制。
|
||||||
|
* 👬全新的列权限管控，粒度细化到每一列。
|
||||||
|
* 💏特别鸣谢：[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/)。
|
||||||
|
* 💡特别感谢[jetbrains](https://www.jetbrains.com/) 为本开源项目提供免费的 IntelliJ IDEA 授权。
|
||||||
|
|
||||||
|
#### 🏭 环境支持
|
||||||
|
|
||||||
|
| Edge | Firefox | Chrome | Safari |
|
||||||
|
| --------- | ------------ | ----------- | ----------- |
|
||||||
|
| Edge ≥ 79 | Firefox ≥ 78 | Chrome ≥ 64 | Safari ≥ 12 |
|
||||||
|
|
||||||
|
> 由于 Vue3 不再支持 IE11，故而 ElementPlus 也不支持 IE11 及之前版本。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 在线体验
|
||||||
|
|
||||||
|
👩👧👦演示地址：[https://demo.dvadmin.com](https://demo.dvadmin.com)
|
||||||
|
|
||||||
|
- 账号：superadmin
|
||||||
|
|
||||||
|
- 密码：admin123456
|
||||||
|
|
||||||
|
👩👦👦文档地址：[coding](https://dvadmin-private.coding.net/share/km/cec69f3d-30fe-47d5-bd97-e9e851f0b776/K-2)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 交流
|
||||||
|
|
||||||
|
- 交流社区：[戳我](https://bbs.django-vue-admin.com)👩👦👦
|
||||||
|
|
||||||
|
- 插件市场：[戳我](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦
|
||||||
|
|
||||||
|
- django-vue-admin交流01群(已满)：812482043 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=aJVwjDvH-Es4MPJQuoO32N0SucK22TE5&jump_from=webapi)
|
||||||
|
- django-vue-admin交流02群(已满)：687252418 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=4jJN4IjWGfxJ8YJXbb_gTsuWjR34WLdc&jump_from=webapi)
|
||||||
|
- django-vue-admin交流03群：442108213 [点击链接加入群聊](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=wsm5oSz3K8dElBYUDtLTcQSEPhINFkl8&authKey=M6sbER0z59ZakgBr5erFeZyFZU15CI52bErNZa%2FxSvvGIuVAbY0N5866v89hm%2FK4&noverify=0&group_code=442108213)
|
||||||
|
|
||||||
|
- 二维码
|
||||||
|
|
||||||
|
<img src='https://images.gitee.com/uploads/images/2022/0530/233203_5fb11883_5074988.jpeg' width='200'>
|
||||||
|
|
||||||
|
## 源码地址
|
||||||
|
|
||||||
|
gitee地址(主推)：[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦
|
||||||
|
|
||||||
|
github地址：[https://github.com/huge-dream/django-vue3-admin](https://github.com/huge-dream/django-vue3-admin)👩👦👦
|
||||||
|
|
||||||
|
|
||||||
|
## 内置功能
|
||||||
|
|
||||||
|
1. 👨⚕️菜单管理：配置系统菜单，操作权限，按钮权限标识、后端接口权限等。
|
||||||
|
2. 🧑⚕️部门管理：配置系统组织机构（公司、部门、角色）。
|
||||||
|
3. 👩⚕️角色管理：角色菜单权限分配、数据权限分配、设置角色按部门进行数据范围权限划分。
|
||||||
|
4. 🧑🎓按钮权限控制：授权角色的按钮权限和接口权限,可做到每一个接口都能授权数据范围。
|
||||||
|
5. 🧑🎓字段列权限控制：授权页面的字段显示权限，具体到某一列的显示权限。
|
||||||
|
7. 👨🎓用户管理：用户是系统操作者，该功能主要完成系统用户配置。
|
||||||
|
8. 👬接口白名单：配置不需要进行权限校验的接口。
|
||||||
|
9. 🧑🔧字典管理：对系统中经常使用的一些较为固定的数据进行维护。
|
||||||
|
10. 🧑🔧地区管理：对省市县区域进行管理。
|
||||||
|
11. 📁附件管理：对平台上所有文件、图片等进行统一管理。
|
||||||
|
12. 🗓️操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
|
||||||
|
13. 🔌[插件市场 ](https://bbs.django-vue-admin.com/plugMarket.html)：基于Django-Vue-Admin框架开发的应用和插件。
|
||||||
|
|
||||||
|
## 插件市场 🔌
|
||||||
|
更新中...
|
||||||
|
|
||||||
|
## 仓库分支说明 💈
|
||||||
|
主分支：master（稳定版本）
|
||||||
|
开发分支：develop
|
||||||
|
|
||||||
|
|
||||||
|
## 准备工作
|
||||||
|
~~~
|
||||||
|
Python >= 3.11.0 (最低3.9+版本)
|
||||||
|
nodejs >= 16.0
|
||||||
|
Mysql >= 8.0 (可选，默认数据库sqlite3，支持5.7+，推荐8.0版本)
|
||||||
|
Redis (可选，最新版)
|
||||||
|
~~~
|
||||||
|
|
||||||
|
## 前端♝
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 克隆项目
|
||||||
|
git clone https://gitee.com/huge-dream/django-vue3-admin.git
|
||||||
|
|
||||||
|
# 进入项目目录
|
||||||
|
cd web
|
||||||
|
|
||||||
|
# 安装依赖
|
||||||
|
npm install yarn
|
||||||
|
yarn install --registry=https://registry.npm.taobao.org
|
||||||
|
|
||||||
|
# 启动服务
|
||||||
|
yarn build
|
||||||
|
# 浏览器访问 http://localhost:8080
|
||||||
|
# .env.development 文件中可配置启动端口等参数
|
||||||
|
# 构建生产环境
|
||||||
|
# yarn run build
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 后端💈
|
||||||
|
|
||||||
|
~~~bash
|
||||||
|
1. 进入项目目录 cd backend
|
||||||
|
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
|
||||||
|
或使用 uvicorn :
|
||||||
|
uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
|
||||||
|
~~~
|
||||||
|
## 开发建议
|
||||||
|
前后端backend与web各自单独一个窗口打开进行开发
|
||||||
|
|
||||||
|
### 访问项目
|
||||||
|
|
||||||
|
- 访问地址：[http://localhost:8080](http://localhost:8080) (默认为此地址，如有修改请按照配置文件)
|
||||||
|
- 账号：`superadmin` 密码：`admin123456`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### docker-compose 运行
|
||||||
|
|
||||||
|
~~~shell
|
||||||
|
# 先安装docker-compose (自行百度安装),执行此命令等待安装，如有使用celery插件请打开docker-compose.yml中celery 部分注释
|
||||||
|
docker-compose up -d
|
||||||
|
# 初始化后端数据(第一次执行即可)
|
||||||
|
docker exec -ti dvadmin3-django bash
|
||||||
|
python manage.py makemigrations
|
||||||
|
python manage.py migrate
|
||||||
|
python manage.py init_area
|
||||||
|
python manage.py init
|
||||||
|
exit
|
||||||
|
|
||||||
|
前端地址：http://127.0.0.1:8080
|
||||||
|
后端地址：http://127.0.0.1:8080/api
|
||||||
|
# 在服务器上请把127.0.0.1 换成自己公网ip
|
||||||
|
账号：superadmin 密码：admin123456
|
||||||
|
|
||||||
|
# docker-compose 停止
|
||||||
|
docker-compose down
|
||||||
|
# docker-compose 重启
|
||||||
|
docker-compose restart
|
||||||
|
# docker-compose 启动时重新进行 build
|
||||||
|
docker-compose up -d --build
|
||||||
|
~~~
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 演示图✅
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@@ -26,7 +26,7 @@ class CustomModelSerializer(DynamicFieldsMixin, ModelSerializer):
|
|||||||
# 修改人的审计字段名称, 默认modifier, 继承使用时可自定义覆盖
|
# 修改人的审计字段名称, 默认modifier, 继承使用时可自定义覆盖
|
||||||
modifier_field_id = "modifier"
|
modifier_field_id = "modifier"
|
||||||
modifier_name = serializers.SerializerMethodField(read_only=True)
|
modifier_name = serializers.SerializerMethodField(read_only=True)
|
||||||
dept_belong_id = serializers.IntegerField(required=False)
|
dept_belong_id = serializers.IntegerField(required=False, default=None)
|
||||||
|
|
||||||
def get_modifier_name(self, instance):
|
def get_modifier_name(self, instance):
|
||||||
if not hasattr(instance, "modifier"):
|
if not hasattr(instance, "modifier"):
|
||||||
|
|||||||
Reference in New Issue
Block a user