大家好,最近我做了一个项目:Fast Vben Admin 。
预览图:

这个项目的初衷很简单:我想要一个真正适合二次开发的全栈后台模板。
现在做后台系统,经常会遇到几个很尴尬的问题:
-
传统后台模板页面比较丑
很多模板功能是有的,但 UI 风格停留在几年前,拿去交付、做产品原型或者给客户演示,总感觉差点意思。 -
成品系统又太重
很多权限系统、OA 、CRM 、ERP 后台,功能非常多,但业务耦合也重。想删掉不需要的东西很麻烦,想加自己的业务也要先理解一大堆历史包袱。 -
从零开发太浪费时间
登录、用户、角色、菜单、部门、权限、日志、上传、导入导出,这些东西几乎每个后台都要做。每次新项目都重新写一遍,其实挺低效。 -
AI 很适合写业务代码,但不太擅长从零写出一个完整、好看、统一的后台界面
我试过让 AI 直接生成后台页面,能用,但经常是“组件拼起来了,审美没跟上”。
页面细节、交互一致性、布局密度、表格操作、弹窗表单、暗色模式、菜单权限这些东西,AI 单独生成很容易散。
所以我最后选择了一个思路:
用 Vue Vben Admin 这样成熟、好看的前端后台作为界面基础,再接一个完整的 FastAPI 后端,把通用后台能力真正打通。
这样既不用接受传统模板的老旧 UI ,也不用背一个很重的成品系统,更不用从登录权限开始全部重写。
目前项目已经实现了:
- 登录认证、当前用户、忘记密码、个人资料、修改密码
- 用户管理、角色管理、菜单管理、部门管理
- RBAC 权限码、后端权限校验、后端动态菜单
- 字典管理、系统设置
- 登录日志、操作日志
- 文件上传、下载、删除、头像上传、文件管理
- 通知公告、个人消息
- 用户导出、事项导出、CSV 模板、CSV 导入
- OpenAPI 自动生成 TypeScript 客户端
- Docker Compose 一键启动
- 后端测试、前端类型检查、构建和 CI 工作流
技术栈:
- 后端:FastAPI 、SQLModel 、Alembic 、PostgreSQL 、JWT 、Pytest 、uv
- 前端:Vue 3 、Vite 、TypeScript 、Pinia 、Vue Router 、Vue Vben Admin 、Ant Design Vue
- 部署:Docker Compose 、Nginx 、Mailpit 、Adminer
本地启动:
git clone https://github.com/LoD-Dawn/Fast-Vben-Admin.git
cd Fast-Vben-Admin
cp .env.example .env
docker compose up --build