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 核心与系统能力

Platform Infra 与开发支撑