first commit

code/README.md

@@ -0,0 +1,146 @@
+# FuAdmin
+
+[![img](https://img.shields.io/badge/license-Apache%202.0-dark)](https://gitee.com/fuadmin/fu-admin/blob/master/LICENSE) [![img](https://img.shields.io/badge/python-%3E=3.7.x-green.svg)](https://python.org/) [![PyPI - Django Version badge](https://img.shields.io/badge/django%20versions-4.0-blue)](https://docs.djangoproject.com/zh-hans/4.0.4/) [![img](https://img.shields.io/badge/node-%3E%3D%2016.0.0-brightgreen)](https://nodejs.org/zh-cn/) [![img](https://gitee.com/fuadmin/fu-admin/badge/star.svg?theme=dark)](https://gitee.com/fuadmin/fu-admin) [![GitHub stars](https://img.shields.io/github/stars/FuAdmin/FuAdmin.svg?theme=dark&label=Github)](https://github.com/FuAdmin/FuAdmin)
+
+## 为什么使用 Django-Ninja 和 Vue3
+
+💡 **「Django Ninja 相比于 Django Rest Framework 」**
+
+- 简单：旨在易于使用和直观，直接使用@装饰器（java好像叫注解）开发api
+
+- 快速执行：由于 Pydantic 和异步的支持，性能非常高。
+
+- 快速编码：输入提示和自动文档让您只关注业务逻辑。
+
+- 基于标准：基于 API 的开放标准：OpenAPI（以前称为 Swagger）和 JSON Schema。
+
+- Django 集成：与 Django 自身的功能和 ORM 有很好的集成。
+
+![](backend/utils/picture/benchmark.png)
+
+💡 **「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`
+
+## 演示图 ✅
+![](backend/utils/picture/1.png) 
+![](backend/utils/picture/2.png) 
+![](backend/utils/picture/3.png) 
+![](backend/utils/picture/4.png) 
+![](backend/utils/picture/5.png) 
+![](backend/utils/picture/6.png) 
+![](backend/utils/picture/7.png) 
+![](backend/utils/picture/8.png) 
+![](backend/utils/picture/9.png) 
+![](backend/utils/picture/10.png)