## 💡 为什么选择 FastapiAdmin？
| 你需要的 | FastapiAdmin | Django Admin | 纯前端模板 |
| ---------------------------------------- | :----------: | :----------: | :--------: |
| 🎯 **开箱即用**的后台系统 | ✅ | ⚠️ 功能有限 | ❌ 只有 UI |
| ⚡ **FastAPI 异步**高性能后端 | ✅ | ❌ 同步为主 | ❌ 无后端 |
| 🔐 **RBAC** 菜单/按钮/数据三级权限 | ✅ | ❌ 基础 | ❌ |
| 🤖 **代码生成器**（选表 → 出前后端代码） | ✅ | ❌ | ❌ |
| 📱 **移动端**（H5 + 小程序）一体 | ✅ | ❌ | ❌ |
| 🐳 **Docker 一键部署**（含 Nginx + SSL） | ✅ | ❌ | ❌ |
> 👉 详细技术选型对比：[为什么选择 FastapiAdmin？](https://service.fastapiadmin.com/guide/why)
## 🍪 在线体验
| 端 | 地址 | 账号 |
| ----------- | -------------------------------------------------------------------- | ------------------ |
| 💻 Web 端 | [service.fastapiadmin.com/web](https://service.fastapiadmin.com/web) | `admin` / `123456` |
| 📱 移动端 | [service.fastapiadmin.com/app](https://service.fastapiadmin.com/app) | `admin` / `123456` |
| 📖 官方文档 | [service.fastapiadmin.com](https://service.fastapiadmin.com) | 无需登录 |
## 🚀 5 分钟本地跑起来
```bash
# 1. 克隆
git clone https://gitee.com/fastapiadmin/FastapiAdmin.git
# 2. 配置环境
cp backend/env/.env.example backend/env/.env.dev
cp frontend/.env.development.example frontend/.env.development
# 3. 迁移数据库、初始化基础数据并创建管理员
cd backend
uv sync
uv run main.py upgrade --env=dev
uv run main.py init-data --env=dev
uv run main.py bootstrap-admin --env=dev --username=admin
# 只开发同步 HTTP 接口时，仅启动 Web
uv run main.py run --env=dev
# 如需使用定时任务，改用一条开发命令同时管理 Web/Coordinator/Worker
uv run python dev_runtime.py --env=dev
# 4. 启动前端
cd ../frontend && pnpm install && pnpm run dev
# ✅ 浏览器打开 http://127.0.0.1:5173，使用命令输出的一次性密码登录
```
任务管理页通过统一 Runtime Overview 展示 Coordinator、Worker、Outbox、积压和真实任务运行状态；“启用/暂停/维护排空/停止调度”只控制逻辑 admission，不会从 Web 启停系统进程。`dev_runtime.py` 仅简化本地开发，明确拒绝 prod；发布或关机前应先进入维护排空，等待 `drain_complete=true`，再使用 Compose、systemd 或 Windows Service 停止进程，详见[定时任务运维手册](docs/runbooks/backend-task-runtime-operations.md#6-日常发布与优雅停机)。
| 环境要求 | |
| ------------- | --------------------- |
| Python ≥ 3.12 | Node.js ≥ 20.0 + pnpm |
| PostgreSQL 16 | Redis 7.x |
## 📦 工程结构
```
FastapiAdmin/ # Monorepo 全栈工程
├─ backend/ # FastAPI 后端（Pydantic 2.0 + SQLAlchemy + Alembic）
├─ frontend/
│ ├── web/ # Vue3 Web 前端（Element Plus + TypeScript）
│ ├── app/ # UniApp 移动端（H5 + 小程序 + App）
│ └── docs/ # VitePress 文档网站
├─ docker/ # Docker Compose 一键部署（Nginx + SSL）
├─ deploy.sh # 一键部署脚本
└─ LICENSE # MIT 开源协议
```
## 📌 内置功能（开箱即用）
| 模块 | 包含能力 |
| ----------- | ----------------------------------------------------------------------------------------------- |
| 📊 仪表盘 | 工作台、数据分析 |
| ⚙️ 系统管理 | 用户 / 角色 / 菜单 / 部门 / 岗位 / 字典 / 配置 / 公告 |
| 👀 监控管理 | 在线用户 / 服务器监控 / 缓存监控 |
| 📋 任务管理 | Runtime 总览与维护排空、SQL 运行账本、独立调度器、可信 Handler、Celery Worker 与类型化 Workflow |
| 📝 日志管理 | 登录 / 操作 / 异常日志审计与 request ID 关联 |
| 🧰 开发工具 | 代码生成、表单构建、接口文档 |
| 📁 文件管理 | 统一文件管理 |
| 🤖 智能体 | 基于 Agno 的智能体框架 |
## 🔧 截图展示
| 登录 | 仪表盘 | 代码生成 | AI 助手 |
| -------------------------------------- | -------------------------------------------- | -------------------------------------------- | --------------------------------- |
|  |  |  |  |
## 📖 文档地址
- 🌐 [官网文档](https://service.fastapiadmin.com) — 完整开发指南、架构设计、二开教程
- 📁 子工程 README：[backend](backend/README.md) · [web](frontend/web/README.md) · [移动端](frontend/app/README.md) · [Docker](docker/README.md)
- 🛠️ 定时任务运维：[独立进程部署与日常运维](docs/runbooks/backend-task-runtime-operations.md) · [切换与受控回滚](docs/runbooks/backend-task-scheduler-cutover.md)
- 🔀 Workflow 运维：[迁移、发布、SSE 与故障处置](docs/runbooks/backend-workflow-operations.md)
- 🐘 数据库切换：[PostgreSQL 16 迁移、对账与回滚](docs/runbooks/backend-postgresql-cutover.md)
- 🧾 系统审计日志：[部署、迁移、保留与故障排查](docs/runbooks/backend-system-audit-log-operations.md)
## 🤝 参与贡献
欢迎提交 Issue / PR！详见 [贡献指南](https://service.fastapiadmin.com/about/contributing)。
## 👥 社区与支持
| 微信群 | 赞赏支持 |
| -------------------------------------------- | ---------------------------------------------- |
|  |  |
## 👥 贡献者
