Skip to content

docs(multi-tenancy): land the design and phased plan on main (CHOO-2729) - #438

Merged
petr-sandbox merged 1 commit into
mainfrom
docs/land-multi-tenancy-design
Sep 14, 2026
Merged

petr-sandbox merged 1 commit into
mainfrom
docs/land-multi-tenancy-design

Conversation

@wojtyniakAQ

Copy link
Copy Markdown
Collaborator

Summary

  • Adds docs/old/multi-tenancy.md — the multi-tenancy design and the phased plan the work has been following. It was written on the spike branch and its pull request was closed unmerged, so it has never been on main even though all five phase tickets cite it as the source of truth, and Phase 1 shipped against it.
  • Corrects the status header. It said "design spike — not implemented", which stopped being true when Phases 0 and 1 landed. It now names which phases exist and says plainly that the code wins where the two disagree.
  • Indexes it in docs/README.md and CLAUDE.md, and while there indexes docs/old/multi-tenancy-phase1-db.md and docs/old/rds-migration.md, which are already on main but appear in neither list.

No content changes beyond the status header — the design itself is the record of what was intended, and editing it after the fact would destroy that.

Test plan

  • Documentation only; no code touched, so no lint, typecheck or test run.
  • Read for public-repo safety: no credentials, internal hostnames, IPs, account names or personal data. Ticket keys only, which the repository's own guidance permits in design notes.
  • Every path added to the two indexes exists in the tree.

The pull request that would have added this was closed unmerged, so the
document has lived only on the spike branch while every phase ticket
cites it as the source of truth — including Phase 1, which shipped
against it.

Its status header said "not implemented", which stopped being true when
Phase 0 and Phase 1 landed; it now says which phases exist and defers to
the code where the two disagree. Indexes the two multi-tenancy pages and
the RDS runbook, none of which were listed.

@petr-sandbox petr-sandbox left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very nice.

@petr-sandbox
petr-sandbox merged commit 94bbf3b into main Sep 14, 2026
10 checks passed
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.

2 participants