Backend
Express 5 + Prisma。认证、RBAC、OAuth/OIDC、上传、导出、定时任务都在这里实现。
QC-RBAC认证、授权、多端接入的一体化基础工程
面向开发者的文档。重点讲仓库结构、运行方式、实现细节、现有抽象和扩展路径。
Skip to content
文档范围
- 后端实现：认证、RBAC、OAuth/OIDC、上传、附件、导出、定时任务、Prisma 扩展。
- Web 前端：登录、动态路由、工作台状态、分页列表、导出、页面组织方式。
- Uni 前端：登录注册、门户、个人页、设置页、自定义 Header / Tabbar / 安全区。
- 共享抽象：
api-common里的类型、权限常量、请求客户端、适配器、API 工厂。 - 测试体系：框架级测试、业务集成测试、测试基建与运行方式。
- 扩展方式：新增模块、新增客户端类型、新增列表页、新增导出与测试怎么接。
仓库结构
text
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 工厂核心入口
| 场景 | 入口文件 |
|---|---|
| 后端应用启动 | apps/backend/src/app.ts |
| API 路由挂载 | apps/backend/src/routes/index.ts |
| OAuth/OIDC 协议路由 | apps/backend/src/routes/oauth2.ts |
| 数据治理 | apps/backend/src/lib/prisma.ts |
| Web API 客户端 | apps/web-frontend/src/api/client.ts |
| Web 动态菜单 | apps/web-frontend/src/stores/menus.ts |
| Uni API 客户端 | apps/app-frontend/src/api/client.ts |
| Uni 页面外壳 | apps/app-frontend/src/components/app-page-shell/app-page-shell.vue |
| 共享 API 工厂 | packages/api-common/src/api/factory.ts |