基于 FastAPI 构建的企业级后端架构解决方案

三层架构

MVC 架构是 Python Web 项目中常见的设计模式。fba 采用更贴近后端工程分层的三层架构，将接口、业务和数据访问边界拆开，便于协作和维护

注意

请注意

fba 没有采用传统多应用或微服务目录结构，而是根据 FastAPI 后端工程实践组织目录，详情见项目结构

如果此结构不适合你的团队，可以在保留分层边界的前提下自行调整

模块	java	fastapi-best-architecture
视图	controller	api
数据传输	dto	schema
业务逻辑	service + impl	service
数据访问	dao / mapper	crud
模型	entity	model

特性

• 全异步设计（async/await + asgiref）
• 遵循 RESTful API 设计规范
• SQLAlchemy 2.0 现代语法
• Pydantic v2 全栈数据验证
• 角色菜单 RBAC 权限控制
• 原生 Celery 异步任务支持
• 自研高性能 JWT 认证中间件
• 全局自定义时区处理
• 一键 Docker / Docker-Compose 部署
• 集成 Pytest 单元测试
• Grafana 全链路可观测性

内置功能

• 用户管理：灵活分配角色与权限
• 部门管理：轻松构建组织架构
• 菜单管理：精准到按钮级的权限配置
• 角色管理：一站式角色权限分配
• 字典管理：全局参数统一维护
• 参数管理：运行时动态配置系统参数
• 通知公告：快速发布系统消息
• 令牌管理：实时在线监测 + 强制下线
• 多端登录：一键切换多终端模式
• 自研 OAuth 2.0：开箱即用授权登录
• 插件系统：零耦合扩展，随意拼装
• 定时任务：灵活调度异步任务
• 代码生成：一键预览、写入、下载
• 操作日志：完整记录正常/异常操作
• 登录日志：详尽追踪登录行为
• 缓存监控：实时查看缓存统计
• 服务监控：服务器硬件与状态一目了然
• 接口文档：自动生成交互式 Swagger 文档

项目结构

backend# 后端

alembic# 数据库迁移

…

app# 应用

admin# 系统后台

api# 接口

…

crud# CRUD

…

model# 模型

__init__.py# 必须在此文件内导入所有模型类

…

schema# 数据传输

…

service# 服务

…

tests# 单元测试

…

task# 任务

…

…

common# 公共资源

…

core# 核心配置

…

database# 数据库连接

…

locale# 国际化语言包

…

log# 日志

…

middleware# 中间件

…

plugin# 插件

code_generator# 代码生成

…

…

scripts# 脚本

…

sql# 初始化 SQL 文件

…

static# 静态文件

…

tests# 全局测试辅助

…

utils# 工具包

…

deploy# 部署配置

…

…

贡献者

许可证

本项目由 MIT 许可证的条款进行许可

特别鸣谢

• downdawn 积极推动创建此项目
• 无名 精心设计的 LOGO（包含了 fba 三个字母抽象结合，形成了一个类似从地面扩散投影上来的闪电）
• vuepress-theme-plume 为官网文档提供驱动支持
• FastAPI、SQLAlchemy、Pydantic 等开源先行者
• 所有赞助商们（包含所有渠道）的大力支持
• 此项目的所有贡献者、参与者和使用者

编辑此页面

下一页快速开始