Visão geral do modelo

O modelo de dados descreve 71 tabelas em 11 domínios. Cada domínio é um pacote (packages/<domínio>) cujas entities geram o schema, e cada domínio tem a sua primeira migration, na ordem abaixo. A ordem é a direção das dependências: um domínio só referencia os anteriores. Quando uma FK precisa apontar para um domínio posterior, quem a cria é o domínio posterior (por exemplo, tenants → platform_tenant_blueprints é criada por Authorization).

Depois dos domínios vêm as migrations de infraestrutura, fora do modelo de dados: 0015_idempotency (2 tabelas, ver Idempotência) e 0016_work (8 tabelas, ver Background work).

Regras de fronteiraCopiar link

• Parties, Credentials e Identity não conhecem tenant.
• Toda tabela de tenant carrega tenant_id. Quando uma linha aponta para outra que também é de tenant, a FK é composta e inclui tenant_id dos dois lados, então as duas pontas ficam sempre no mesmo tenant (ver Garantias do banco).
• Trabalho acima dos tenants (plataforma) mora em tabelas próprias platform_*, nunca em tenant_id nulo ou com valor sentinela.
• Quando uma coluna só faria sentido para alguns casos, o modelo prefere uma tabela própria a uma coluna anulável (por exemplo, invitation_session_contexts).

Como ler as páginas de domínioCopiar link

Cada página traz um diagrama ER pequeno com as relações principais e, para cada tabela:

• colunas, com tipo, nulidade, padrão e as notas do modelo;
• chaves estrangeiras, com as colunas dos dois lados (FKs compostas aparecem inteiras) e quem referencia a tabela;
• garantido pelo banco: PK, UNIQUE, índices únicos parciais (as unicidades "uma ativa por vez"), CHECK, EXCLUDE, triggers e colunas geradas, exatamente como estão no schema migrado;
• fora do banco: regras do modelo que o banco não impõe e que cabem à aplicação, ou que ainda não são garantidas.

Nenhuma FK é DEFERRABLE e nenhuma tem ação em cascata (ON DELETE/ON UPDATE são NO ACTION). FKs compostas com colunas anuláveis usam MATCH SIMPLE: a verificação é pulada enquanto alguma coluna da FK for nula.

Todas as tabelasCopiar link