跳到主要内容

多租户（Organizations）

fulla 的多租户目前是一个组织层：组织归组用户与客户端、承载品牌字段、 经管理 API 管理。本页如实记录现状有什么、没有什么、以及如何在不过度 假设隔离的前提下使用它。

先读这段：组织是元数据与归属归组，不是硬隔离边界。授权由 RBAC + scope 强制（见 RBAC 指南）；今天属于某组织的主体并不会 自动与其他组织的数据隔离。

1. 模型（V017）​

organizations (
    id              SERIAL PRIMARY KEY,
    slug            VARCHAR(50) UNIQUE,   -- 3–50 字符，小写
    name            VARCHAR(200),
    logo_uri        VARCHAR(512),         -- 品牌
    primary_color   VARCHAR(7),           -- 品牌
    issuer_override VARCHAR(512),         -- 已存储；见 §4 路线图
    created_at / updated_at
)

两个可空外键把实体挂到组织上：

列所在表语义
org_idusers用户属于该组织；NULL = 未分配（向后兼容）
org_idoauth2_clients客户端由该组织拥有；NULL = 全局/无主

两者按设计可空：V017 之前的数据与平台级主体（种子 admin、 admin-console 客户端）没有组织。

2. 管理 API 面​

所有路由要求 admin scope 令牌（AuthorizationFilter；impliedBy: admin）—— API 参考客户端管理一节：

方法与路径用途
GET /api/admin/organizations列出组织（id、slug、name、品牌字段）
POST /api/admin/organizations创建（slug：3–50 个小写字符，唯一）
GET /api/admin/organizations/{slug}查询单个

另：

  • POST/PATCH /api/admin/users 接受 org_id——整数分配用户到组织； JSON null 清除归属。

示例：

# 创建组织（令牌：admin scope）
curl -X POST http://localhost:5555/api/admin/organizations \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"slug":"acme","name":"ACME Corp","logo_uri":"https://acme.example/logo.svg","primary_color":"#5b2fd1"}'

# 把用户挂到组织
curl -X PATCH http://localhost:5555/api/admin/users/42 \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"org_id": 1}'

3. 现在能买到什么​

  • 归属记账：哪个人属于哪家公司、哪个客户端应用属于哪家公司——管理 API 与 SQL（users.org_id、oauth2_clients.org_id）均可查。
  • 品牌目录：按组织存 logo 与主色，前端可按租户换肤登录体验。
  • 无迁移断崖：一切都是可选、增量式的；不关心组织的部署完全不碰它。

4. 还没有的（路线图）​

对利益相关方要说清楚——以下未实现：

  1. issuer_override 已存储但未生效：按组织的 issuer（进发现文档与签发 令牌）schema 就绪、运行时未接入。
  2. 用户/客户端列表无按组织过滤/隔离；admin 跨组织可见。
  3. 无组织级角色：角色是全局的（RBAC），不按组织。
  4. 组织无 update/delete 端点（只有 create/list/get）。
  5. 无按组织的限流、配额、密钥。

如果今天就需要硬租户隔离：每租户跑一套 fulla 栈——Docker Compose / Helm 路径让这很便宜（部署）。

5. Schema 参考​

权威 DDL 是 V017__multi_tenant.sql （users(org_id)、oauth2_clients(org_id)、organizations(slug) 上有索引）。 存储层细节见数据与持久化。