ruo_python_django/README.md

154 lines
5.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">django-ruoyi-admin</h1>
<h4 align="center">基于django+ 若依Vue3版本快速开发框架v1.0.1</h4>
<!-- <p align="center">
👉 <a target="_blank" href="http://124.71.212.219:8028/">个人网站http://124.71.212.219:8028/</a> 👈
</p> -->
<p align="center">
<a href="https://gitee.com/mengyinggitee/sanic-vue-admin/stargazers"><img src="https://gitee.com/mengyinggitee/sanic-vue-admin/badge/star.svg"></a>
<a href="https://gitee.com/mengyinggitee/sanic-vue-admin/members"><img src="https://gitee.com/mengyinggitee/sanic-vue-admin/badge/fork.svg"></a>
<a><img src="https://img.shields.io/badge/QQ-652044581-green"></a>
<a><img src=https://img.shields.io/badge/%E5%BE%AE%E4%BF%A1-17783098377-brightgreen"></a>
<a><img src=https://img.shields.io/badge/python-3.70-black"></a>
</p>
### 平台介绍
若依是一套全部开源的快速开发平台,毫无保留给个人及企业免费使用。[若依框架地址]([Vue3](https://v3.cn.vuejs.org))
但目前主流的若以框架是基于SpringBoot的java开发语言企业开发前端常用的是若依框架而后端没有一个属于python版本的后端因此萌生了调试一套适合python程序员的快速开发框架删除广告页面和日常开发者不必要的功能只保留项目的最核心的配置模块减少初始化的方式做到入手既可以开发功能
python主流框架请查看不同的分支django+mysqlflask+mongosanic-mongo
### 技术栈介绍
* 前端技术栈: [Vue3](https://v3.cn.vuejs.org) + [Element Plus](https://element-plus.org/zh-CN) + [Vite](https://cn.vitejs.dev)
若依框架版本。
* 后端技术栈: [django](https://www.djangoproject.com/) + [mysql](https://www.mysql.com/) + [redis](https://redis.io/) 实现。
<table>
<tr>
<td style="width:400px"><img src="./admin-ui/src/assets/images/20240418233140.png"/></td>
</tr>
<table>
### 框架能力
* 用户管理:用户是系统操作者,该功能主要完成系统用户配置。
* 部门管理:配置系统组织机构(公司、部门、小组),树结构展现支持数据权限。
* 岗位管理:配置系统用户所属担任职务。
* 菜单管理:配置系统菜单,操作权限,按钮权限标识等。
### 代码优化
* 后端:收集日常的常用方法,增加常用的企业微信机器人通知,数据加解密等常用方法
* 后端数据库配置增加nacos和本地config的配置的2种配置多种配置方式
* 后端配置数据库后项目启动直接初始化相关数据不需要导入sql的方式方便快捷开发进度
* 前端:删除不必要的广告页面,和不必要的功能,比如日志,人员职位,登陆等相关信息,只保留用户,角色,目录,部门核心的模块功能
* 前端:收集封装日常中大佬们封装的一些方法和看到的一些好的方法,实现工具箱似的开发,开箱即用
* 前端优化若依框架的部分ui和提取字段如titlebase_path等变为env配置字段和调试时候的vite代理等均有展示
### 前端部署
```
# 本地部署
# 安装依赖(设置镜像源)
yarn --registry=https://registry.npmmirror.com
# 启动服务
yarn run dev
# 打包构建
yarn build:prod
# 前端访问地址
http://localhost:80
# api地址修改
vite.config.js文件 server.proxy.target指向后端地址
=======================================================================
# 线上docker部署
# 前提确认宿主机含有node环境(调试环境) node_version = v21.1.0
# 安装了yarn 和vite环境
# npm install -g yarn vite
# 安装依赖
yarn --registry=https://registry.npmmirror.com
# 启动服务
yarn run dev
# 打包构建
yarn build:prod
# 前端访问地址
http://localhost:80
# api地址修改
.env.production文件 VITE_APP_BASE_API 属性
# 构建命令
sh build.sh
```
### 后端部署
```
本地部署
# 进入目录
cd admin-api
# 安装依赖
pip install -r requirements.txt
# 配置数据库
/config.py 或者 配置nacos地址 配置mongo和redis的数据
# 迁移数据库--生成数据库表
python manage.py migrate
# 初始化数据库--插入初始数据
cd admin-api
python initDatabase.py
# 启动服务
python manage.py runserver 0.0.0.0:8000
=======================================================================
# docker部署docker-compose
docker-compose build && docker-compose up -d
# 或者执行脚本构建(gunicorn部署已内置调试)
sh build.sh
内置一个超级管理员账号
superAdmin/superAdmin
```
<!-- ### 在线体验
演示地址:[http://124.71.212.219:8101/#/login](http://124.71.212.219:8101/#/login)
账号密码superAdmin/superAdmin
如果能帮助到您快速的构建您的项目麻烦帮我star一下吧谢谢咯如果有问题的请加我微信 -->
## 演示图
<table>
<tr>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow1.jpg"/></td>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow2.jpg"/></td>
</tr>
<tr>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow3.jpg"/></td>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow4.jpg"/></td>
</tr>
<tr>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow5.jpg"/></td>
<td style="width:400px"><img src="./admin-ui/src/assets/images/gitshow6.jpg"/></td>
</tr>
<table>