zq-platform(芷青开发平台)
一个现代化的完全开源免费的企业级后台管理系统，提供 Django 和 FastAPI 双后端选择 + Vue3 + Element Plus 构建
演示链接（支持Django和FastApi）
https://django-ninja.zq-platform.cn
开源地址
https://github.com/jiangzhikj/zq-platform.git
项目简介
zq-platform 是一个功能完善的企业级后台管理系统解决方案，采用前后端分离架构。提供两种后端选择：Django 5.2 + Django Ninja 或 FastAPI + SQLAlchemy 异步 ORM，前端基于 Vue 3 + Vben Admin + Element Plus 打造现代化的管理界面。
✨ 核心特性
- 完整的 RBAC 权限系统 – 用户、角色、权限、部门、岗位多维度权限控制
- JWT 认证机制 – 安全的 Token 认证，支持 Access Token 和 Refresh Token
- 系统监控 – 服务器监控、Redis 监控、数据库监控，实时掌握系统状态
- 文件管理 – 完善的文件上传、下载、预览功能
- 操作日志 – 详细的登录日志和操作审计
- ️ 数据字典 – 灵活的字典管理，支持多级分类
- ⏰ 任务调度 – 基于 APScheduler 的定时任务管理
- WebSocket 支持 – 实时通信能力
- 多数据库支持 – MySQL、PostgreSQL、SQL Server、SQLite
- 现代化 UI – 响应式设计，支持暗黑模式
- Monorepo 架构 – 基于 pnpm workspace 的前端工程化方案
️ 技术栈
后端技术
Django 后端 (backend-django)
- 核心框架: Django 5.2.7
- API 框架: Django Ninja 1.4.5 (高性能 API 框架)
- 认证: PyJWT 2.8.0
- 异步任务: Celery 5.4.0 + Django Celery Beat
- 任务调度: APScheduler 3.10.4
- 缓存: Redis + django-redis
- WebSocket: Django Channels 4.2
- 数据库驱动: psycopg2-binary, pymysql, pyodbc
- 服务器: Uvicorn 0.38.0 / Gunicorn 23.0.0
- 其他: openpyxl, geoip2, psutil, cryptography
FastAPI 后端 (backend-fastapi)
- 核心框架: FastAPI 0.115+
- ORM: SQLAlchemy 2.0+ (异步)
- 数据库: PostgreSQL 16+
- 迁移: Alembic
- 认证: JWT
- 缓存: Redis
- Python: 3.12+
前端技术
- 核心框架: Vue 3.x
- 构建工具: Vite 5.x
- UI 组件库: Element Plus
- 状态管理: Pinia
- 路由: Vue Router
- HTTP 客户端: Axios
- 工具库: VueUse, dayjs, lodash-es
- 代码规范: ESLint, Prettier, Stylelint
- 包管理: pnpm 10.14.0
- Monorepo: Turbo
项目结构
zq-platform/
├── backend-django/ # Django 后端
│ ├── application/ # 项目配置
│ ├── core/ # 核心业务模块
│ │ ├── auth/ # 认证授权
│ │ ├── user/ # 用户管理
│ │ ├── role/ # 角色管理
│ │ ├── permission/ # 权限管理
│ │ ├── dept/ # 部门管理
│ │ ├── post/ # 岗位管理
│ │ ├── menu/ # 菜单管理
│ │ ├── dict/ # 字典管理
│ │ ├── login_log/ # 登录日志
│ │ ├── file_manager/ # 文件管理
│ │ ├── server_monitor/ # 服务器监控
│ │ ├── redis_monitor/ # Redis 监控
│ │ ├── redis_manager/ # Redis 管理
│ │ ├── database_monitor/ # 数据库监控
│ │ └── database_manager/ # 数据库管理
│ ├── scheduler/ # 任务调度模块
│ ├── common/ # 公共模块
│ ├── env/ # 环境配置
│ ├── requirements.txt # Python 依赖
│ └── manage.py # Django 管理脚本
│
├── backend-fastapi/ # FastAPI 后端（可选）
│ ├── app/ # 核心应用模块
│ ├── core/ # 核心业务模块
│ ├── scheduler/ # 定时任务模块
│ ├── scripts/ # 工具脚本
│ ├── alembic/ # 数据库迁移
│ ├── env/ # 环境配置
│ ├── requirements.txt # Python 依赖
│ └── main.py # 应用入口
│
└── web/ # Vue 前端 (Monorepo)
├── apps/
│ └── web-ele/ # Element Plus 版本主应用
│ ├── src/
│ │ ├── api/ # API 接口
│ │ ├── views/ # 页面组件
│ │ ├── router/ # 路由配置
│ │ └── store/ # 状态管理
│ └── package.json
├── packages/ # 共享包
│ ├── @core/ # 核心包
│ ├── effects/ # 副作用包
│ ├── hooks/ # Hooks
│ ├── icons/ # 图标
│ ├── locales/ # 国际化
│ ├── stores/ # 状态管理
│ └── utils/ # 工具函数
├── internal/ # 内部工具
└── package.json # 根配置快速开始
环境要求
- 后端
- Python >= 3.10
- MySQL >= 5.7 / PostgreSQL >= 12 / SQL Server / SQLite
- Redis >= 5.0
- 前端
- Node.js >= 20.10.0
- pnpm >= 9.12.0
后端安装
选项 1: Django 后端
- 克隆项目
git clone https://github.com/jiangzhikj/zq-platform.git
cd zq-platform/backend-django- 创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/Mac
# 或
venvScriptsactivate # Windows- 安装依赖
pip install -r requirements.txt- 配置环境变量
cp env
# 编辑 .env 文件，配置数据库、Redis、JWT 密钥等主要配置项：
# JWT 密钥
JWT_ACCESS_SECRET_KEY=your-jwt-access-secret
JWT_REFRESH_SECRET_KEY=your-jwt-refresh-secret
# 数据库配置
DATABASE_TYPE=MYSQL # MYSQL/POSTGRESQL/SQLSERVER/SQLITE3
DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_USER=root
DATABASE_PASSWORD=password
DATABASE_NAME=zq_admin
# Redis 配置
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=2- 数据库迁移
python manage.py makemigrations core scheduler
python manage.py migrate- 初始化数据
python manage.py loaddata db_init.json- 启动服务
# 开发环境
python manage.py runserver 0.0.0.0:8000
- 启动任务调度器（可选）
# 生产环境
python start_scheduler.py选项 2: FastAPI 后端（推荐用于高性能场景）
- 进入 FastAPI 目录
cd zq-platform/backend-fastapi- 创建虚拟环境
conda create -n zq-fastapi python=3.12
conda activate zq-fastapi- 安装依赖
pip install -r requirements.txt- 配置环境变量
cp env/example.env env/dev.env
# 编辑 env/dev.env 配置数据库连接- 数据库迁移
alembic revision --autogenerate -m "init tables"
alembic upgrade head
# 导入初始数据（可选）
python scripts/loaddata.py db_init.json- 启动服务
python main.py
# 或
uvicorn main:app --reload --host 0.0.0.0 --port 8000- 访问 API 文档
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
前端安装
- 进入前端目录
cd zq-platform/web- 安装依赖
pnpm install- 配置环境变量
cd apps/web-ele
cp .env.development .env
# 编辑 .env 文件，配置后端 API 地址- 启动开发服务器
# 在 web 根目录下
pnpm dev- 构建生产版本
pnpm build:ele默认账号
初始化数据后，可使用以下账号登录：
- 账号: superadmin
- 密码: 请查看 123456 或联系管理员
主要功能模块
系统管理
- 用户管理: 用户的增删改查、密码重置、状态管理
- 角色管理: 角色权限分配、数据权限控制
- 权限管理: 接口权限、按钮权限细粒度控制
- 部门管理: 树形部门结构管理
- 岗位管理: 岗位信息维护
- 菜单管理: 动态菜单配置、路由管理
- 字典管理: 系统字典维护
系统监控
- 服务器监控: CPU、内存、磁盘、网络实时监控
- Redis 监控: Redis 性能指标、键值管理
- 数据库监控: 数据库连接、性能监控
- 登录日志: 用户登录记录、IP 地理位置
任务调度
- 定时任务: Cron 表达式配置
- 任务日志: 执行历史、结果查看
- 任务管理: 启动、停止、立即执行
文件管理
- 文件上传: 支持多文件上传
- 文件预览: 图片、文档在线预览
- 文件下载: 批量下载功能
API 文档
Django 后端
- Swagger UI: http://localhost:8000/api/docs
- ReDoc: http://localhost:8000/api/redoc
FastAPI 后端
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
️ 开发指南
后端开发
- 添加新模块
- 在 core/ 或创建新 app
- 定义 models、schemas、services、api
- 在 router 中注册路由
- API 开发规范
- 使用 Django Ninja 装饰器
- 统一返回格式
- 异常处理
- 权限验证
前端开发
- 添加新页面
- 在 src/views/ 创建页面组件
- 在 src/router/routes/modules/ 添加路由
- 在 src/api/ 添加接口定义
- 组件开发规范
- 使用 Element Plus 组件
- 优先使用 Tailwind CSS
- 支持暗黑模式
- 图标从 @vben/icons 导入
部署
- 后端部署
- 使用 Gunicorn + Nginx
- 配置 Supervisor 进程守护
- 配置 SSL 证书
- 前端部署
- 执行 pnpm build 构建
- 将 dist 目录部署到 Nginx
- 配置反向代理
贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 本项目
- 创建特性分支 (git checkout -b feature/AmazingFeature)
- 提交更改 (git commit -m 'Add some AmazingFeature')
- 推送到分支 (git push origin feature/AmazingFeature)
- 开启 Pull Request
致谢
- Django – 强劲的 Python Web 框架
- Django Ninja – 快速的 Django REST 框架
- Vue Vben Admin – 优秀的 Vue3 后台管理模板
- Element Plus – 基于 Vue 3 的组件库
Made with ❤️ by ZQ Team
© 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论...
