146 lines
5.7 KiB
Markdown
146 lines
5.7 KiB
Markdown
# FuAdmin
|
||
|
||
[](https://gitee.com/fuadmin/fu-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/4.0.4/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/fuadmin/fu-admin) [](https://github.com/FuAdmin/FuAdmin)
|
||
|
||
## 为什么使用 Django-Ninja 和 Vue3
|
||
|
||
💡 **「Django Ninja 相比于 Django Rest Framework 」**
|
||
|
||
- 简单：旨在易于使用和直观，直接使用@装饰器（java好像叫注解）开发api
|
||
|
||
- 快速执行：由于 Pydantic 和异步的支持，性能非常高。
|
||
|
||
- 快速编码：输入提示和自动文档让您只关注业务逻辑。
|
||
|
||
- 基于标准：基于 API 的开放标准：OpenAPI（以前称为 Swagger）和 JSON Schema。
|
||
|
||
- Django 集成：与 Django 自身的功能和 ORM 有很好的集成。
|
||
|
||
|
||
|
||
💡 **「Vue3 」**
|
||
|
||
- 最火的框架，国内最火的前端框架之一。
|
||
- 性能提升，运行速度是 vue2 的 1.5 倍。
|
||
- 体积更小，按需编译体积 vue2 要更小。
|
||
- 类型推断，更好的支持 ts 这个也是趋势。
|
||
- 高级给予，暴露了更底层的 API 和提供更先进的内置组件。
|
||
- 组合 API，能够更好的组织逻辑，封装逻辑，复用逻辑
|
||
|
||
## 平台简介
|
||
|
||
💡 [fu-admin-web](https://gitee.com/fuadmin/fu-admin-web) 采用 VUE3，TS 开发。 💡 [fu-admin-backend](https://gitee.com/fuadmin/fu-admin-backend) 采用 Python，Django 和 Django-Ninija 开发。数据库支持MySql，SqlServer，Sqlite。
|
||
|
||
- 🧑🤝🧑 前端采用[VbenAdmin](https://vvbin.cn/doc-next) 、[Vue3](https://cn.vuejs.org/)、[Ant Design Vue](https://www.antdv.com/docs/vue/getting-started-cn)。
|
||
- 👭 后端采用 Python 语言 Django 框架以及强大的 [Django Ninja](https://django-ninja.rest-framework.com/)。
|
||
- 👬 支持加载动态权限菜单，多方式轻松权限控制。
|
||
- 💡 Vue2 项目移步[Dvadmin](https://gitee.com/liqianglog/django-vue-admin)
|
||
- 💏 特别鸣谢：[VbenAdmin](https://github.com/vbenjs/vue-vben-admin) 、[Ant Design Vue](https://github.com/vueComponent/ant-design-vue)。
|
||
- 💡 特别感谢[jetbrains](https://www.jetbrains.com/) 为本开源项目提供免费的 IntelliJ IDEA 授权。
|
||
|
||
## 在线体验
|
||
|
||
👩👧👦 演示地址：[http://175.24.184.165:8080](http://175.24.184.165:8080)
|
||
|
||
- 账号：superadmin
|
||
|
||
- 密码：123456
|
||
|
||
|
||
## 交流
|
||
|
||
- FuAdmin 交流群：726947525
|
||
|
||
<img src="backend/utils/picture/qq.png" alt="qq 群" style="zoom: 25%;" />
|
||
|
||
## 源码地址
|
||
|
||
| | 项目地址 |
|
||
|--------|-------------------------------------|
|
||
| github | https://github.com/FuAdmin/fu-admin |
|
||
| 码云 | https://gitee.com/fuadmin/fu-admin |
|
||
|
||
## 内置功能
|
||
|
||
1. 👨⚕️ 菜单管理：配置系统菜单，操作权限，按钮权限标识、后端接口权限等。
|
||
2. 🧑⚕️ 部门管理：配置系统组织机构（公司、部门、角色）。
|
||
3. 👩⚕️ 角色管理：角色菜单权限分配、数据权限分配、设置角色按部门进行数据范围权限划分。
|
||
4. 🧑🎓 权限权限：授权角色的权限范围。
|
||
5. 👨🎓 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
|
||
6. 🧑🔧 数据字典：对系统中经常使用的一些较为固定的数据进行维护。
|
||
7. 🧑🔧 分类字典：对系统中经常使用的一些树形数据进行维护。
|
||
8. 📁 附件管理：对平台上所有文件、图片等进行统一管理。
|
||
9. 🗓️ 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
|
||
10. 定时任务：系统设置定时任务。
|
||
|
||
## 准备工作
|
||
|
||
```
|
||
Python >= 3.8.0 (推荐3.8+版本)
|
||
nodejs >= 16.0 (推荐最新)
|
||
Mysql >= 5.7.0 (可选，默认数据库sqlite3，推荐8.0版本)
|
||
Redis(可选，最新版)
|
||
```
|
||
|
||
## 前端 ♝
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git https://gitee.com/fuadmin/fu-admin.git
|
||
|
||
# 进入项目目录
|
||
cd web
|
||
|
||
# 安装依赖
|
||
yarn install --registry=https://registry.npm.taobao.org
|
||
|
||
# 启动服务
|
||
yarn run dev
|
||
# 浏览器访问 http://localhost:8080
|
||
# .env 文件中可配置启动端口等参数
|
||
# 构建生产环境
|
||
# yarn run build
|
||
```
|
||
|
||
## 后端 💈
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git https://gitee.com/fuadmin/fu-admin.git
|
||
# 进入项目目录
|
||
cd backend
|
||
# 在 `env.py` 中配置数据库信息
|
||
# 默认是Mysql，如果使用SqlServer，qing在requirements.txt中打开
|
||
mssql-django==1.1.2
|
||
pyodbc==4.0.32
|
||
# 安装依赖环境
|
||
pip3 install -r requirements.txt
|
||
# 执行迁移命令：
|
||
python3 manage.py makemigrations system
|
||
python3 manage.py migrate
|
||
# 初始化数据
|
||
python3 manage.py init
|
||
# 初始化省市县数据:
|
||
python3 manage.py init_area
|
||
# 启动项目
|
||
python3 manage.py runserver 0.0.0.0:8000
|
||
# 或使用 daphne :
|
||
daphne -b 0.0.0.0 -p 8000 application.asgi:application
|
||
```
|
||
|
||
### 访问项目
|
||
|
||
- 文档访问地址：[http://localhost:8080/api/docs](http://localhost:8080/api/docs) (默认为此地址，如有修改请按照配置文件)
|
||
- 账号：`superadmin` 密码：`123456`
|
||
|
||
## 演示图 ✅
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
 |