# fastapi-react-admin > 开源中后台底座,FastAPI + React 19 + shadcn/ui:Web、桌面、手机三端同一个 monorepo,权限细到数据行、多页签保留状态、审批流、不越权的 AI 助手,支持 PostgreSQL / SQL Server / MySQL。 每一页都有 Markdown 原文:把页面地址结尾的 `/` 换成 `.md`。全部文档合并成一个文件:https://yile2020.github.io/fastapi-react-admin/llms-full.txt - 源码仓库:https://github.com/yile2020/fastapi-react-admin - 给编码代理的约定在仓库里:根目录的 `CLAUDE.md`,以及各模块目录下的 `AGENTS.md` - English: https://yile2020.github.io/fastapi-react-admin/en/llms.txt ## 入门指南 - [fastapi-react-admin 是什么](https://yile2020.github.io/fastapi-react-admin/getting-started/introduction.md): 基于 FastAPI + React 19 + shadcn/ui 的开源中后台底座:Web、桌面、手机三端同一个 monorepo,为和 AI 一起写代码而设计;为什么做它,以及它和常见后台模板的区别。 - [快速开始](https://yile2020.github.io/fastapi-react-admin/getting-started/quick-start.md): 用 Docker 启动 PostgreSQL 和 Redis,安装依赖、初始化开发库,再登录本地工作台。每一步都有检查方法。 ## 功能指南 - [功能总览](https://yile2020.github.io/fastapi-react-admin/features/overview.md): fastapi-react-admin 自带的全部功能,按领域列出:权限与数据范围、登录与安全、导入导出、审批、AI 助手、开放平台、文件、消息、运维与多端;每项在哪个菜单、属于哪个插件、手机 App 支持到哪。 - [登录与安全](https://yile2020.github.io/fastapi-react-admin/features/login-security.md): 选择登录方式、绑定二次验证、修改密码和设置口令规则;会话管理与完整配置另有专页。 - [登录会话](https://yile2020.github.io/fastapi-react-admin/features/login-sessions.md): 查看已登录设备、强制下线,并设置网页、桌面和移动端的会话上限与空闲时长。 - [用户 · 角色 · 部门 · 菜单](https://yile2020.github.io/fastapi-react-admin/features/rbac.md): 后台权限的四个基础页怎么用:用户的启停、重置密码与「后台管理权限」,角色的权限矩阵,部门树的约束,菜单的五种类型(目录 / 菜单 / 按钮 / 内嵌页 / 外链)与死链检查;改了权限之后什么时候生效。 - [数据权限(RBAC + 行级数据范围)](https://yile2020.github.io/fastapi-react-admin/features/data-permissions.md): 管菜单、按钮、接口的 RBAC,加上行级数据范围:角色的规则编译成一条 SQL WHERE 条件,在 DAO 层自动套到每次读取上。 - [日志与审计](https://yile2020.github.io/fastapi-react-admin/features/audit-logs.md): 登录日志(含锁定、强制下线等安全事件)、操作日志(自动脱敏)、数据变更记录(谁、什么时候、从哪来,把哪个字段从什么改成了什么,和操作日志互跳);带签名的防篡改链,默认留存 180 天满足《网络安全法》的六个月下限。 - [工作台与界面](https://yile2020.github.io/fastapi-react-admin/features/workspace.md): 每个人自己的工作台(选卡片、拖拽排序、调宽度,按权限出现,布局存服务端跨设备同步);命令面板 ⌘K、快捷键、功能引导;主题色 / 圆角 / 密度 / 页签外观;列表列的显隐与排序写进地址栏;每人自己的时区、中英双语、发新版提示。 - [多页签保活](https://yile2020.github.io/fastapi-react-admin/features/multi-tab.md): 已打开的页签用 React 19.2 的 同时挂载,切走不丢表单和树的展开状态;筛选、分页写进 URL,刷新也还在。 - [审批流](https://yile2020.github.io/fastapi-react-admin/features/approval-workflow.md): FastAPI + React 的飞书式审批:表单设计器、带条件分支的流程树,或签 / 会签、退回、加签、拿回、超时自动处理。 - [消息与通知](https://yile2020.github.io/fastapi-react-admin/features/notifications.md): 实时推送的站内消息、带富文本 / 附件 / 发布范围的通知公告,以及按类型路由到邮件、短信和飞书 / 钉钉 / 企业微信群机器人。 - [导入导出](https://yile2020.github.io/fastapi-react-admin/features/import-export.md): 列表页一键导出 xlsx / csv(按当前筛选或勾选的行,超过 5000 行转后台、完成发站内消息,防公式注入);用户、部门、字典项三处通用导入:带下拉的模板、先预览校验再提交、三种模式、错误报告,一份文件建出整棵部门树。 - [文件与存储](https://yile2020.github.io/fastapi-react-admin/features/file-storage.md): 带在线预览的文件管理器,本地盘与 S3 兼容存储走同一套 Apache OpenDAL 接口;支持秒传、分片并发上传,页面刷新后可以断点续传。 - [AI 助手](https://yile2020.github.io/fastapi-react-admin/features/ai-assistant.md): 对话式 AI 助手:工具调用以当前登录人的身份执行,权限码和数据范围与界面一致;写操作先预演、本人确认才执行,每次调用都留审计。 - [桌面端与移动端](https://yile2020.github.io/fastapi-react-admin/features/clients.md): Electron 桌面端:三平台安装包、自动更新、静默打印;移动端是 Expo / React Native 原生 App,不是 WebView 套壳。 ## 开发指南 - [技术架构与项目结构](https://yile2020.github.io/fastapi-react-admin/guides/project-structure.md): 前后端怎么分层、一次请求经过哪些文件:以用户列表为例,从前端路由文件一路跟到数据库:每一环在哪个文件、负责什么;以及想改表单、列表、接口字段、权限码、表结构时该去哪个目录找。 - [从零加一个业务模块](https://yile2020.github.io/fastapi-react-admin/guides/first-module.md): 以「客户管理」为例,从模型、迁移、三层接口、菜单权限到列表页和数据权限,走通一个真实业务模块。 - [开发者工具](https://yile2020.github.io/fastapi-react-admin/features/developer-tools.md): 组件沙箱(49 个组件演示,旋钮实时调、代码只列和默认值不同的属性)、调色盘、查询区和表格的演练页;组件库 packages/ui 对其他包零依赖,可以整包搬进别的项目;前后端契约从后端 OpenAPI 离线生成。 - [插件机制](https://yile2020.github.io/fastapi-react-admin/features/plugins.md): 后端插件沿用上游 FBA 的设计:一个目录、一份 plugin.toml,声明路由、配置、依赖和支持的数据库;内置 10 个插件各是什么,fba add 怎么装,插件管理页上启停的效果,以及插件能挂进哪些扩展点(通知类型、数据变更、导入导出、Webhook 事件、短信模板、AI 工具)。 - [能力开放(AK/SK 签名接口)](https://yile2020.github.io/fastapi-react-admin/features/open-api.md): 给外部系统的只读开放接口:AK/SK + HMAC-SHA256 签名,scope、IP 白名单、防重放、限流、调用日志、增量同步与 Webhook。 ## 部署运维 - [部署到服务器](https://yile2020.github.io/fastapi-react-admin/getting-started/deployment.md): 用 CI 推到 GHCR 的镜像 + Docker Compose 部署:服务器上只放三份文件,先迁移再启动,一个健康检查地址,按提交号回滚。 - [数据库:PostgreSQL / SQL Server / MySQL](https://yile2020.github.io/fastapi-react-admin/features/databases.md): 同一套代码、同一条 Alembic 迁移链支持 PostgreSQL(默认)、SQL Server、MySQL,改 DATABASE_TYPE 即可切换。 - [参数配置与数据字典](https://yile2020.github.io/fastapi-react-admin/features/config-dict.md): 参数配置让管理员在界面上改一部分运行时配置(登录策略、口令与锁定、会话、邮件、通知、Webhook、文件上传、日志保留),覆盖 .env、不用重启,写入时按范围校验;数据字典维护「类型 → 选项」的键值表,带缓存、能导入导出。 - [登录安全配置](https://yile2020.github.io/fastapi-react-admin/reference/security-config.md): 登录、密码与会话的配置键、默认值和生效顺序,以及扩展注意事项、源码与测试入口。 - [定时任务](https://yile2020.github.io/fastapi-react-admin/features/scheduler.md): 在界面上管理 Celery 定时任务:cron 或固定间隔、cron 预览、启停、立即执行一次、执行记录;改动不用重启 beat;内置 11 条任务(日志清理、回收站、导出过期、通知与 Webhook 投递、审批超时、心跳)各自干什么。 - [监控与健康检查](https://yile2020.github.io/fastapi-react-admin/features/monitoring.md): 服务器监控(CPU、内存、磁盘、进程)和 Redis 监控(内存、键数、ops/s、命令统计)只看此刻、不存历史;一个不用登录的健康检查地址列出 API、数据库、Redis、调度器、worker 的状态,全部正常 200、任一异常 503。 - [版本升级](https://yile2020.github.io/fastapi-react-admin/reference/upgrade.md): 怎么从旧版本升级:直接用镜像部署的拉新镜像即可;fork 后写了业务的按 tag 合并上游,再跑迁移。附兼容承诺和升级前检查清单。 ## 常见问题 - [常见问题](https://yile2020.github.io/fastapi-react-admin/reference/faq.md): 按报错原文排的排障清单:本地起服务、登录、数据库迁移、前端开发和生产部署里最常撞到的 25 个问题,各附原因、处理和出处。