项目背景
FastapiAdmin 诞生于企业级中后台开发中反复出现的痛点:前后端分离架构下,一个简单的 CRUD 页面需要跨越多个目录、多个文件、多种技术栈,开发体验割裂,协作成本高昂。
传统的 Admin 方案(如 Django Admin)功能受限且难以定制;纯前端模板(如 AdminLTE、Ant Design Pro)没有后端支撑,仍需从零搭建 API 层。市场缺少一个真正开箱即用、全栈一体、且具备 AI 能力的企业级后台解决方案。
FastapiAdmin 的目标是:让开发者5 分钟搭建一个完整的企业级中后台系统,把重复劳动交给自动化,把创造力留给业务。
技术理念
⚡ 全栈异步 + 高性能
后端采用 FastAPI 原生 async/await 架构,配合 Pydantic v2 自动类型校验与 Redis 缓存加速,从底层保障系统性能。前端基于 Vue3 + TypeScript 构建,组件化开发、类型安全,兼顾开发体验与运行效率。
🧩 Vertical Slice 竖切架构
摒弃传统的分层架构(Controller → Service → DAO),采用 Vertical Slice 架构按业务领域组织代码。每个模块自包含完整的 Controller、Service、Model、Schema,模块间零耦合。多人协作时互不干扰,需要拆分独立微服务时直接整目录搬走。
🤖 AI 驱动的开发效率
从 2.0 版本开始引入 AI 代码生成器:选择数据库表 → AI 自动生成前后端完整 CRUD 代码(Controller / Service / Model / Vue 页面)。开发效率提升 10 倍,让开发者从繁复的样板代码中解放出来。
📱 多端统一交付
基于 UniApp 的移动端方案,一套代码同时生成 H5、微信小程序、支付宝小程序、App 等多端应用。后端 API 层天然支持多端复用,无需为每个端重复开发同一套接口。
项目亮点
| 维度 | 说明 |
|---|---|
| 🏗️ 架构模式 | Vertical Slice + 模块化,支持单体与微服务灵活切换 |
| 🔐 权限体系 | RBAC 三级粒度(菜单 / 按钮 / 数据),JWT + OAuth2 双认证 |
| 🏢 多租户 | 数据隔离 + 配额管理 + 个性化配置,原生 SaaS 支持 |
| 🤖 AI 能力 | 数据模型驱动代码生成,前后端 CRUD 一键生成 |
| 🐳 部署运维 | Docker Compose 全栈编排(含 Nginx + SSL),多环境配置管理 |
| 🧪 质量保障 | 完整的单元测试、集成测试体系,CI/CD 自动化 |
| 📖 文档体系 | 中英双语文档,从概述到二开的完整教程,配套示例代码 |
| 📜 开源协议 | MIT 协议,完全开放,可自由使用和商用 |
发展历程
v1.0 — 基础框架搭建:FastAPI 后端 + Vue3 前端,RBAC 权限体系上线。
v2.0 — AI 代码生成器发布,大幅提升开发效率;支持多租户 SaaS 架构。
v3.0 — 架构全面升级:Vertical Slice 重构,UniApp 移动端上线,国际化支持,性能优化与稳定性增强。
社区价值观
- 开放共享 — MIT 协议,代码完全开放,鼓励社区贡献和商业使用
- 务实高效 — 不做过度设计,每一行代码都为解决实际问题
- 持续进化 — 紧跟技术前沿,定期发布版本,持续迭代优化
- 生态共建 — 欢迎 Issue、PR、功能建议,每一位贡献者都是项目的一部分
展望未来
FastapiAdmin 将持续在以下方向深耕:
- 深度 AI 集成 — 从代码生成延伸到智能测试、自动部署、智能运维
- 低代码能力 — 可视化表单设计、工作流编排、报表配置
- 生态插件 — 官方插件市场,支持社区开发扩展
- 性能极致化 — 冷启动优化、缓存策略升级、边缘部署支持
团队介绍
我们是一支热爱开源的团队,致力于为开发者提供高质量的开发工具和解决方案。
核心成员
- @fastapiadmin — 项目创始人,深耕企业级系统架构多年
特别感谢
感谢每一位通过 Star、Issue、PR 参与项目的开发者。你的一键 Star、一次 Bug 反馈、一行代码贡献,都在推动这个项目变得更好。
想要参与贡献?欢迎通过 GitHub Issues 或 PR 参与到项目中来。
联系方式
- 微信:948080782
- 邮箱:948080782@qq.com
项目仓库
| 平台 | 地址 |
|---|---|
| GitHub | FastapiAdmin |
| Gitee | FastapiAdmin |
| GitCode | FastapiAdmin |
如果 FastapiAdmin 对你有帮助,欢迎持续关注和支持项目发展 ❤️