Python Web-FastApi和Django开发的最强平台 ZQ-Platform

优质文章学习记录

— 8 min read

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 后端（推荐用于生产环境）
  1. 克隆项目

git clone https://github.com/jiangzhikj/zq-platform.git cd zq-platform/backend-django

  1. 创建虚拟环境

python -m venv venv source venv/bin/activate  # Linux/Mac # 或 venv\Scripts\activate     # Windows

  1. 安装依赖

pip install -r requirements.txt

  1. 配置环境变量

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

  1. 数据库迁移

python manage.py makemigrations core scheduler python manage.py migrate

  1. 初始化数据

python manage.py loaddata db_init.json

  1. 启动服务

# 开发环境 python manage.py runserver 0.0.0.0:8000 ​

  1. 启动任务调度器（可选）

# 生产环境 python start_scheduler.py

选项 2: FastAPI 后端（推荐用于高性能场景）
  1. 进入 FastAPI 目录

cd zq-platform/backend-fastapi

  1. 创建虚拟环境

conda create -n zq-fastapi python=3.12 conda activate zq-fastapi

  1. 安装依赖

pip install -r requirements.txt

  1. 配置环境变量

cp env/example.env env/dev.env # 编辑 env/dev.env 配置数据库连接

  1. 数据库迁移

alembic revision --autogenerate -m "init tables" alembic upgrade head ​ # 导入初始数据（可选） python scripts/loaddata.py db_init.json

  1. 启动服务

python main.py # 或 uvicorn main:app --reload --host 0.0.0.0 --port 8000

  1. 访问 API 文档

前端安装

  1. 进入前端目录

cd zq-platform/web

  1. 安装依赖

pnpm install

  1. 配置环境变量

cd apps/web-ele cp .env.development .env # 编辑 .env 文件，配置后端 API 地址

  1. 启动开发服务器

# 在 web 根目录下 pnpm dev

  1. 构建生产版本

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

🛠️ 开发指南

后端开发

  1. 添加新模块
    • 在 core/ 或创建新 app
    • 定义 models、schemas、services、api
    • 在 router 中注册路由
  2. API 开发规范
    • 使用 Django Ninja 装饰器
    • 统一返回格式
    • 异常处理
    • 权限验证

前端开发

  1. 添加新页面
    • 在 src/views/ 创建页面组件
    • 在 src/router/routes/modules/ 添加路由
    • 在 src/api/ 添加接口定义
  2. 组件开发规范
    • 使用 Element Plus 组件
    • 优先使用 Tailwind CSS
    • 支持暗黑模式
    • 图标从 @vben/icons 导入

📦 部署

  1. 后端部署
    • 使用 Gunicorn + Nginx
    • 配置 Supervisor 进程守护
    • 配置 SSL 证书
  2. 前端部署
    • 执行 pnpm build 构建
    • 将 dist 目录部署到 Nginx
    • 配置反向代理

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

🙏 致谢

​

Made with ❤️ by ZQ Team

​

Read more

FLUX.2[klein]开源！小香蕉平替，本地部署AI绘画的极简方案

FLUX.2[klein]开源！小香蕉平替，本地部署AI绘画的极简方案

文章目录 * 前言 * 一、FLUX.2[klein]到底香在哪？ * 二、部署前准备：硬件+环境一键搞定 * 1. 硬件要求（最低配置） * 2. 环境安装（3行命令搞定） * 三、极简部署方案：2种方式任选（新手首选方式1） * 方式1：Python脚本一键运行（纯代码，无界面，最快上手） * 步骤1：创建运行脚本 * 步骤2：运行脚本 * 方式2：ComfyUI可视化部署（适合喜欢拖拽操作的用户） * 步骤1：安装ComfyUI * 步骤2：下载FLUX.2[klein]模型 * 步骤3：启动ComfyUI并加载工作流 * 四、常见问题&优化技巧 * 1. 显存不足怎么办？ * 2. 模型下载慢/
openclaw配置飞书（Feishu）机器人（2026.03.07）

openclaw配置飞书（Feishu）机器人（2026.03.07）

前提：你已经安装好openclaw，配置好了大模型。 可借鉴我另一篇博文：https://mp.ZEEKLOG.net/mp_blog/creation/editor/157513751 一、配置openclaw channel 打开终端，输入： openclaw config 开始安装，需要等一会，安装好需要你填飞书的App ID和App Secret，先放着，等执行下面的步骤 然 二、配置飞书机器人 , 获取App ID和App Secret 安装流程如下链接，太长了，不想编辑了，完成版本发布。 https://www.feishu.cn/content/article/7613711414611463386 1.配置事件长连接时，需要在openclaw上安装飞书SDK（如果步骤一没执行会长连接失败） 2.当然以上配还是有问题的，

无人机数据集汇总无人机航拍各个方面检测分割数据集合集

本数据集集合了面向无人机视觉任务的大规模、多场景、多目标标注数据资源，涵盖了地理环境、智慧城市、基础设施巡检、农业生产、公共安全与灾害监测等多个关键领域。数据主要以两种主流格式提供：适用于目标检测的VOC/YOLO格式与适用于像素级语义分割的LabelMe格式，为算法开发与模型训练提供了高度结构化的标注支持。 在地理与农业监测方面，包含田地、道路、森林、水体等地理要素的分割数据集，以及作物病害、杂草识别、农田农机、牛羊牲畜等农业目标的检测数据，支持精准农业与生态研究。智慧城市与交通领域提供了丰富的城市街道场景数据，涵盖行人、车辆、交通标志、占道经营、消防通道、广告牌等目标的检测与分割，助力城市智能化管理。基础设施巡检是另一重点，覆盖电力线、光伏板、桥梁、铁路、风力发电机等设备的缺陷与异常检测，以及工地车辆、施工人员、物料垃圾的识别，满足工业自动化巡检需求。在灾害与安全监控中，包含滑坡、洪水、火灾烟雾、河道垃圾、违规建筑等应急场景的检测与分割数据，同时提供了溺水人员、海上救援、军事目标等特殊任务的专项数据集。此外，
2026低代码选型指南：AI与低代码双向赋能，破解企业数字化落地难题

2026低代码选型指南：AI与低代码双向赋能，破解企业数字化落地难题

在数字化转型深化的今天，低代码平台已从“边缘工具”升级为企业数字化的核心基建，成为破解“开发效率低、技术门槛高、系统集成难”的关键抓手。根据Gartner预测，2026年全球80%的新应用将通过低代码构建，但企业在选型过程中，往往陷入“重功能、轻适配”“追概念、缺落地”的误区——要么平台易用性不足，业务人员无法上手；要么技术拓展性欠缺，难以支撑复杂业务场景；要么AI功能流于表面，无法真正赋能全流程。 真正优秀的低代码平台，应当兼顾“易用性、专业性、扩展性”三大核心，而2026年的核心趋势的是“AI与低代码深度融合”：AI降低使用门槛，低代码提供落地底座，二者互为支撑、双向赋能，才能真正让数字化转型落地到每一个业务环节。 一、企业低代码选型的3个核心维度（避开90%的坑） 很多企业选型时，过度关注“拖拽功能多炫”“模板数量多少”，却忽略了核心适配性，导致项目上线后无法落地、反复返工。结合上千家企业落地经验，