跳转到内容
GitHub

中后台底座,
像榫卯一样咬合。

基于 FastAPI 与 React 19 的开源中后台底座。Web、桌面、手机三端同一个仓库;行级数据权限、审批流、AI 助手这些每个系统都要做的,已经做好了。

  • FastAPI
  • React 19
  • TypeScript
  • PostgreSQL · SQL Server · MySQL
角色管理:菜单与按钮权限矩阵

菜单、按钮权限在一张矩阵里勾选,改完立即生效。

一次重构,沉淀成一个拿来就能写业务的底座

AI 让要做的系统越来越多,可每个新系统开头都在重复登录、权限、审批这批活。这个项目起步于几套 Java + Vue 2 小系统的重构:用 FastAPI + React 19 从头搭一遍,把每次都要重做的部分沉淀下来——下一个系统,从写业务开始。

为什么做它
一份底座,三种体验

Web · 桌面 · 手机一个仓库。

Web 的工作台和多页签,桌面的打印与硬件桥接,手机的原生审批与通知。共用底层能力,各有适合自己的界面。

后端、客户端与文档站,都在同一个 pnpm + turbo monorepo。依赖严格单向,CI 用架构检查把关。

看仓库结构
系统真实工作台:待我处理、我发起的审批、常用入口与消息
Web 工作台 · 仓库实拍截图
apps/web

从今天的待办开始

工作台把待我处理、我发起的、常用入口与消息放在一起,卡片布局按人保存。

  • 待办与审批进度
  • 多页签保留页面状态
  • 按权限显示功能入口
当前端直接复用的包
ui通用组件
platform平台能力
i18n语言包
api接口契约

Web 是完整后台;桌面和手机从各自的客户端模板起步。

同一张表,不同视野

权限细到数据行

菜单和按钮决定能做什么,数据范围决定能看见什么。切换一个角色,看看这张表。

规则配在模型列上,配置有误时,界面直接提示。

了解数据权限
用户列表sys_user
姓名部门可见性
林晓上海可见
陈禾杭州可见
周远深圳可见
许宁广州可见
本部门及以下 · 上海、杭州的 2 条数据可见

交互示意 · 范围外的行不会由接口返回WHERE dept_id IN (…)

让每一次改动有据可依

为 AI 协作而设计

把上下文交给 AI,把验证留给工程。目录规约、真实测试、接口契约,一起托住快速迭代。

1600+ 条测试连接真实依赖;OpenAPI 类型已用于移动端,Web 客户端持续迁移中。

了解协作方式
schema.d.ts+2 −1
一次类型改动OpenAPI → TypeScript
  export interface User {
−   id: number
+   id: string
+   dept_id: string | null
  }
CLAUDE.md按目录提供上下文
1600+ 条测试,连接真实依赖

后端连接真实数据库,前端运行真实浏览器。行为有没有改变,用运行结果说话。

pnpm --filter web e2e

工程流程示意 · 非实时 CI 运行结果

五条命令,在本地跑起来

MIT 协议,拿去随便改,详细步骤见快速开始。后端最初 fork 自 fastapi-best-architecture(FBA),三层结构、插件机制和 RBAC 模型都来自它的设计。

# PostgreSQL + Redis
$ docker compose -f docker-compose.dev.yml up -d
$ pnpm install:all
$ cp apps/api/backend/.env.example apps/api/backend/.env
$ pnpm db:init
$ pnpm dev