# fastapi_best_architecture_docs

**Repository Path**: fastapi-practices/fastapi_best_architecture_docs

## Basic Information

- **Project Name**: fastapi_best_architecture_docs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-13
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
pageLayout: home
home: true
title: fba | FastAPI Best Architecture
watermark: false
signDown: true
config:
  - type: hero
    full: true
    background: tint-plate
    tintPlate: 240
    hero:
      name: FastAPI Best Architecture
      tagline: 企业级后端架构解决方案
      text: 基于 FastAPI 框架，前后端分离，遵循「三层架构」设计，支持 Python 3.10+ 版本
      actions:
        - theme: brand
          text: 快速上手 ->
          link: /backend/summary/quick-start
        - theme: sponsor
          text: 在线体验 ->
          link: https://fastapi-practices.github.io/fba-offline/
        - theme: alt
          text: 三层架构?
          link: /backend/summary/intro#三层架构
        - theme: alt
          text: 为什么选择我们?
          link: /backend/summary/why
        - theme: alt
          text: DeepWiki 文档
          link: https://deepwiki.com/fastapi-practices/fastapi-best-architecture
  - type: SponsorHome
  - type: ProjectStats
  - type: SponsorSwiper
  - type: FeatureBento
  - type: image-text
    title: 三层架构，极简而强大
    description: API → Service → CRUD/DAO 三层划分，边界清晰，协作天然分工
    image: https://api.iconify.design/ph:squares-four-duotone.svg?color=%23009485&width=320
    list:
      - title: 层次边界清晰
        description: 协议、业务、数据三层各司其职，一目了然
      - title: 业务与数据解耦
        description: 切换数据库、替换 ORM 都不再牵一发动全身
      - title: 配套代码生成
        description: 一键生成三层模板，新人 30 分钟即可上手
  - type: text-image
    title: 插件生态，零耦合扩展
    description: 富含 AI、Auth、Storage、Notification 等多种分类，社区共建，装即用、卸即净
    image: https://api.iconify.design/ph:puzzle-piece-duotone.svg?color=%237c3aed&width=320
    list:
      - title: 装即用，卸即净
        description: 插件物理隔离，独立维护、独立升级
      - title: 官方插件市场
        description: 浏览、安装、分享，支持 MySQL / PostgreSQL
      - title: 商业场景友好
        description: 企业可自建私有插件仓库，复用 fba 全套基础设施
  - type: image-text
    title: AI 赋能，效率倍增
    description: 借助 fba skills，让 AI 直接读懂你的项目结构与规范，效率倍增
    image: https://api.iconify.design/ph:sparkle-duotone.svg?color=%23ec4899&width=320
    list:
      - title: 全平台兼容
        description: Claude Code / Cursor / Trae / Codex / Continue 一键接入
      - title: 项目知识一次配置
        description: 团队共享 AI 上下文，新人入职即同步
      - title: LLMs.txt
        description: 官方 LLMs.txt，让 AI 轻松读取实时文档
  - type: Testimonials
  - type: custom
  - type: HomeSponsor
---

::: center

## 常见问题

<p class="subtitle">也许，你正想问</p>

:::

::: collapse accordion
- 与原生 FastAPI 项目相比，fba 多了什么？

  在 FastAPI 之上预置了三层架构、RBAC、JWT、缓存、全链路日志、时区、Docker、代码生成、插件系统等企业级必需件——开箱即用，不必从零搭脚手架

- 为什么选三层架构，而不是 DDD？

  三层是 DDD 思想的轻量落地：上手门槛低，边界清晰，依然为未来向 DDD 演进留好空间

- 支持多租户吗？

  支持。实验性多租户已落地，详见 [PR #1101](https://github.com/fastapi-practices/fastapi-best-architecture/pull/1101)，咱不包含前端实施

- 可以商用吗？

  MIT 协议，永久免费商用，源码完全开放。如果项目对你有价值，欢迎成为赞助商或贡献者

- 支持哪些数据库？

  一等支持 MySQL 与 PostgreSQL；Redis 作为缓存与队列底座；其他数据库可通过 AI 轻松适配

- AI 赋能怎么开启？

  安装 [fba skills](/fastapi_best_architecture_docs/ai/skills.html) 即可在 Claude Code、Cursor、Trae 等 AI 工具中获取 fba 专属上下文与脚手架命令
:::

::: center

## 贡献者

<p class="subtitle">每一次提交，都在让 fba 变得更好</p>

<a href="https://github.com/fastapi-practices/fastapi-best-architecture/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=fastapi-practices/fastapi-best-architecture"/>
</a>

:::

<style scoped>
  :deep(.subtitle) {
    font-size: 15px;
    color: var(--vp-c-text-2);
    margin-bottom: 36px;
  }
</style>