为什么值得关注

该项目提供了生产就绪的模块化单体架构，内置丰富的开箱即用功能（多租户、RBAC、OIDC、MFA、审计、事件、文件存储），并具备清晰的架构分层和强大的开发者工具链，例如自动生成的 API 客户端。

适合谁使用

使用 FastAPI 构建 SaaS 平台的后端开发者
使用 Vue Vben Admin 实现管理界面的前端开发者
需要可组合、可部署的管理面板栈的 DevOps 工程师
需要多租户管理系统并包含 ERP 模块的初创企业或大型企业

典型使用场景

构建可定制的多租户 SaaS 管理后台
开发具有 Items、ERP 等模块的 ERP 或库存管理系统
快速原型开发包含身份认证、RBAC 和审计日志的全栈管理面板
针对不同客户需求按 Edition 组合交付管理平台

项目优势

模块化单体架构与 Edition YAML 组合机制，支持按需灵活部署功能集
内置完整功能模块：多租户、RBAC、OIDC 单点登录、TOTP 多因子认证、审计、消息、文件存储（支持 S3/MinIO）
前后端分离清晰，通过 OpenAPI Schema 自动生成前端 TypeScript 类型和客户端代码
出色的开发者体验：Docker Compose 本地环境、CLI 命令用于 Edition 构建、迁移和代码生成

使用前须知

必须依赖 PostgreSQL 和 Redis，最小环境配置较重
使用了非常新的版本（Python 3.14、pnpm 11、Node.js 22），可能带来兼容性或稳定性问题
复杂的模块化架构和大量文档（包括 Agent 开发规范）对新贡献者可能存在学习曲线

README 快速开始

Fast Vben Admin

中文 | English

Fast Vben Admin 是一个面向中后台和多租户 SaaS 场景的模块化全栈管理平台。项目采用“模块化单体 + 构建期 Edition 组合”：FastAPI 提供 API、事务与安全边界，Vue Vben Admin 的 web-antd 应用负责管理界面，Platform 提供认证、租户、RBAC、系统管理和基础设施能力，Items、ERP 等业务模块通过统一契约按 Edition 组合交付。

在线演示

http://114.132.74.2:5173/auth/login

租户编码：default
邮箱：admin@example.com
密码：changethis

开发须知

自动化编码模型和协作者开始修改前必须阅读仓库级 Agent 开发规范，并继续读取目标目录最近的 AGENTS.md。
前端接口类型由后端 OpenAPI Schema 生成。修改 API 后请执行 pnpm generate:api，不要手动修改 src/api/generated 中的文件。
Edition 模块集合以 editions/.yaml 为唯一事实源，Build Manifest、前端模块注册和镜像组合均由构建命令生成。
Docker Compose 的默认覆盖配置用于本地热更新，前端地址为 http://localhost:5174；生产组合配置使用 http://localhost:5173。

平台简介

项目采用前后端分离的模块化单体架构。后端 API 统一挂载在 /api/v1，前端根据 Build Manifest、后端菜单和权限码装配页面、导航与按钮权限。Platform 是所有 Edition 的必选模块，业务模块拥有独立的后端实现、前端页面、数据库 Schema、迁移 namespace 和公开契约。

总体架构

架构由横向业务与技术分层、纵向安全和构建交付体系共同组成：

业务应用层：Platform 应用与 Items、ERP 等可选业务模块并列；采购、销售、库存、财务和统计是 ERP 内部业务域。
统一接入层：Vue、Nginx、FastAPI 和生成式 OpenAPI Client 构成访问通道，请求依次经过身份认证、可信租户解析、模块访问判定和 RBAC/数据权限。
平台服务层：Platform 内部划分 Kernel、System 和 Infra 限界上下文；模块引擎统一处理 Edition、模块契约、权益、能力和生命周期。
事件与任务：跨模块状态变化使用事务 Outbox，消费者通过 Inbox 回执实现幂等，并共享重试、租约、死信和逐租户调度机制。
数据与安全：Platform 和业务模块拥有独立表所有权；Tenant UoW、ORM 自动过滤、PostgreSQL RLS 与受限运行角色共同构成租户隔离边界。
构建交付：Edition YAML 生成 Build Manifest、迁移计划、OpenAPI Client 和前后端镜像，并接入扫描、SBOM、签名和发布审计。

图中的 IOA 表示按既定模块契约接入的扩展业务模块；当前仓库实际可用模块及组合始终以 editions/ 下的 YAML 为准。更完整的边界、状态和验收规则见模块化架构实施基线。

内置能力

Platform 核心与系统能力

模块	说明
登录与账户安全	JWT 登录、密码找回与重置、登录限流和验证码、二维码登录、TOTP MFA 与恢复码、个人资料及密码管理。
企业身份接入	可配置企业 OIDC 单点登录、账户映射、角色映射和账号有效状态同步。
RBAC	用户、角色、菜单、权限码、后端权限校验和后端动态菜单。
组织管理	部门、岗位、用户岗位关联，以及角色级的全部、部门、部门及下级、本人和自定义部门数据权限。
多租户	共享表租户隔离、成员关系、租户切换与旧会话失效、租户套餐、配额和初始化模板。
模块治理	Edition 装配、模块运行状态、套餐权益、合同例外、租户启用偏好和模块访问缓存。
审计与消息	登录日志、操作日志、公告发布、站内消息和已读状态管理。

Platform Infra 与开发支撑

模块	说明
参数与字典	租户级系统参数、公开参数、字典类型和字典项管理。
文件服务	文件管理、头像上传、扩展名及大小限制、本地存储和 S3/MinIO 兼容对象存储、私有文件预签名下载。
通信配置	邮箱、短信渠道、模板和发送日志管理页。
代码生成	按数据库表结构生成 FastAPI Schema、CRUD 路由骨架、Vben API 封装及列表页的 ZIP 起始模块。
OpenAPI 契约	从当前后端导出 Schema，生成前端 TypeScript 类型和客户端代码。
事件与任务	事务 Outbox、Inbox 幂等回执、消费

项目描述

FastAPI + Vue Vben Admin full-stack admin template with RBAC, dynamic menus, and Docker Compose support.

Fast-Vben-Admin