QC-RBAC认证、授权、多端接入的一体化基础工程

建议阅读顺序 ​

1. 先读 快速开始，把数据库、后端、Web、Uni 跑起来。
2. 再读 开发指南，建立仓库整体地图。
3. 需要理解后端主链路时，直接看 后端实现。
4. 需要改控制台页面时，先看 Web 前端 和 内置组件。
5. 需要改移动端页面时，先看 Uni 前端。
6. 需要新增协议、请求头、客户端类型或共享 API 时，先看 共享抽象。
7. 需要理解 websocket、topic、心跳和组件级订阅方式时，直接看 实时通信。
8. 动代码前先看 测试用例 和 扩展指南。

主链路总览 ​

图中各层职责如下：

• packages/api-common 是多端共用协议层，负责共享类型、客户端头、请求客户端、实时协议和 API 工厂。
• 实时链路也已经收敛到共享层和后端 hub，详见 实时通信。
• apps/backend /api 提供后台管理、认证、文件、附件、客户端管理、OAuth 管理等业务接口。
• apps/backend /oauth2 提供标准 OAuth2 / OIDC Provider 端点。
• Web 和 Uni 都不自己拼请求协议，优先复用 api-common 生成的客户端和 API 面。
• 后端的持久化主库是 PostgreSQL，会话和部分缓存依赖 Redis。

文档覆盖什么 ​

• 后端实现：认证、RBAC、菜单、OAuth/OIDC、文件上传、附件管理、RequestRecord / Operation 请求审计、Excel 导出、BackendRuntimeContext、自动事务、受管 Prisma、删除保护、定时任务。
• Web 前端：登录页、动态菜单路由、工作台状态、分页列表、导出、页面结构和表单关系选择。
• Uni 前端：登录注册、门户、个人中心、设置、自定义 Header / Tabbar / Safe Area、多端客户端识别。
• 共享抽象：客户端类型、共享类型、请求核心、平台适配器、实时协议、API 工厂、下载请求配置。
• 测试体系：framework / integration 拆分、测试基建、mock OAuth Provider、各测试文件覆盖点。

仓库结构 ​

simple-project-demo
├─ apps
│  ├─ backend                  # Express + Prisma + PostgreSQL + Redis
│  ├─ web-frontend             # Web 控制台
│  ├─ app-frontend             # uni-app 移动端
│  ├─ oauth-test-provider      # 外部 OAuth Provider 测试服务
│  ├─ oauth-test-application   # OAuth Client 测试应用
│  └─ docs                     # 当前文档站
└─ packages
   └─ api-common               # 共享类型、请求抽象、实时协议、API 工厂

常见阅读入口 ​