项目源码｜FastapiAdmin 全栈后台管理系统｜FastAPI + Vue 3

Python 技术栈的课设／毕设，常卡在「后端接口写得出，后台权限与菜单却拼不成故事」：角色怎么分、按钮级权限怎么控、代码生成与定时任务怎么演示。这篇整理的是一套前后端分离的全栈后台底座：FastAPI 异步后端 + Vue 3 管理端，自带 RBAC、用户／角色／菜单、代码生成、定时任务与统一文件存储；首次启动可自动建表并写入演示数据，适合在其上二开成绩、选课、图书等管理系统。

本机已按源码 + Docker（MySQL／Redis）路径实跑：前端可开、健康检查通过、管理员可完成拼图并登录。资源含界面截图与完整源码包（积分约 60，以站内资源页为准）。适合「Python 后台／RBAC／代码生成」答辩演示；不是可直接裸奔公网的生产后台。

能做什么

权限与组织：用户、角色、菜单／按钮权限、部门与岗位；数据权限可区分「全部／本人」等范围
工作台：登录后首页看板、在线用户与基础监控入口
开发效率：选表生成前后端代码；Swagger 接口文档
任务与运维：定时任务调度器监控、节点与流程相关能力；可选 SQL／SSH 运维入口（按菜单为准）
扩展模块：文件／对象存储、轻量内部聊天、可选 AI 对话等，可用配置裁剪，不必一次全开
多端方向：仓库含 Web 管理端与 UniApp 移动端工程；本机验收以 Web 为主，移动端可按文档另起 H5

相对「只有几张 CRUD 表」的课设，本文更强调RBAC 闭环 + 代码生成 + 定时任务 + 可一键依赖，报告可按「权限模型 → 生成器 → 调度／部署」三条线讲。

技术栈一览

层级	技术
后端	Python ≥3.12、FastAPI、Pydantic 2、SQLAlchemy 2、Alembic、Redis
Web	Vue 3、TypeScript、Vite、Element Plus、Pinia
移动端（可选）	UniApp（H5／小程序／App 同一套工程）
数据	MySQL 8+（亦可 PostgreSQL／SQLite，按文档切换）
部署	Docker Compose（Nginx，可选 SSL）、或本机源码调试

环境与资源提醒

源码跑：Python ≥3.12、Node ≥20 + pnpm、MySQL、Redis
Docker 跑：Docker 与 Compose；首次需填 MySQL／Redis 密码与 SECRET_KEY
后端默认 8001，Web 开发默认 5173（本机冲突时可改端口）；浏览器入口多为 /web，路由为 hash
登录依赖 Redis：拼图验证码状态写在 Redis，Redis 不通会登录失败
国内拉 Python／前端依赖可换镜像；仓库默认可能指向国内 PyPI 镜像，若 403 再改官方源
当前设计偏单实例（实时聊天 WebSocket、本地调度器）；水平扩展需自行改架构

源码方式部署（本机已跑通）

解压源码包，进入项目根目录（含 backend/、frontend/、docker/）。
配置后端环境：

cp backend/env/.env.example backend/env/.env.dev
# 至少修改：DATABASE_*、REDIS_*、SECRET_KEY
# 建议：口令用字母数字，避免特殊字符在连接串里被百分号编码后干扰 Alembic

准备 MySQL 库（例如 fastapiadmin）与 Redis，保证端口与 .env.dev 一致。
安装并启动后端（需 MySQL extra）：

cd backend
uv sync --extra mysql
uv run main.py run --env=dev
# 健康检查：http://127.0.0.1:8001/api/v1/monitor/health/check

启动 Web：

cd frontend/web
cp .env.development.example .env.development
pnpm install
pnpm run dev
# 浏览器打开提示的本地地址（常见为 http://127.0.0.1:5173/web ）

使用演示账号登录（口令见包内 README 演示说明，正文与截图勿写明文）。首次需拖动拼图完成验证。

Docker Compose 部署（通用流程）

适合希望 Nginx 反代、一键起依赖的同学（本机因 Docker 网络策略对 Compose 做过 host 适配，你在常规 Linux／macOS 上按仓库 docker/README.md 即可）：

cp docker/.env.example docker/.env
# 填写 MYSQL_ROOT_PASSWORD、MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY 等
# 本地测试可先关 SSL／按文档调整 HTTP 端口
./deploy.sh
# 需要前端产物时：./deploy.sh --build-frontend

常用排障：