Skip to content

docs: organizations (multi-tenancy) layer — ADR-0005 (PR4/4)#72

Merged
Isonimus merged 1 commit into
mainfrom
feat/organizations-layer-pr4
Jun 21, 2026
Merged

docs: organizations (multi-tenancy) layer — ADR-0005 (PR4/4)#72
Isonimus merged 1 commit into
mainfrom
feat/organizations-layer-pr4

Conversation

@Isonimus

Copy link
Copy Markdown
Contributor

Why

PR4 of 4 (docs) for the organizations tenant layer shipped in PRs #69#71. Records the decision and updates the living docs.

What

  • ADR-0005 (docs/adr/0005-organizations-and-tenancy.md): organizations are the tenant boundary; owner re-scoped from global superuser to org-scoped; 404-not-403 on cross-org (no existence leak); per-org 2FA; the nullable→backfill→NOT NULL rollout (migrations 013–014) that keeps self-host a no-op; deferred public signup. Indexed in the ADR README.
  • ROADMAP: the multi-tenancy section flips from planned to SHIPPED, with public signup + metering/billing + Observatory org-management UI kept as explicit follow-ups.
  • OpenAPI: a note that all /admin responses are org-scoped (cross-org → 404). Lints clean (redocly).
  • CHANGELOG: Internal entry summarizing the layer.

Docs-only — no code changes.

- ADR-0005: organizations are the tenant boundary; owner re-scoped from
  global to org-scoped; 404-not-403 on cross-org; per-org 2FA; the
  nullable->backfill->NOT NULL rollout; deferred public signup. Indexed in
  the ADR README.
- ROADMAP: flip the multi-tenancy section from planned to SHIPPED (migrations
  013-014, PRs #69-#72), keeping public signup + metering/billing + org-mgmt
  UI as explicit follow-ups.
- OpenAPI: note that all /admin responses are org-scoped (cross-org -> 404).
  Lints clean.
- CHANGELOG: Internal entry for the organizations layer.
@Isonimus Isonimus merged commit a4c0c29 into main Jun 21, 2026
4 checks passed
@Isonimus Isonimus deleted the feat/organizations-layer-pr4 branch June 21, 2026 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant