Persistência
Relacional primeiro. O banco é a última linha de defesa das regras: chaves, unique, check e foreign key. Schema por serviço e consultas pensadas para não crescer com a tabela. Toda mudança de estrutura é uma migration nova, versionada e só aditiva, porque durante o deploy a versão nova e a anterior usam o mesmo banco.
Decisões e por quê
- PostgreSQL com constraints
- Duas requisições simultâneas passam por qualquer if. Um unique (organization_id, user_id) não deixa passar.
- Schema por serviço, uma instância
- Cada serviço só enxerga o seu schema, mas a operação continua barata: uma instância, um backup.
- Paginação por cursor, sem COUNT
- OFFSET e COUNT ficam mais caros a cada linha nova. Cursor com índice composto custa o mesmo na página 1 e na 10.000.
- Sem N+1, uma transação por caso de uso
- fetch join e consultas pensadas; o caso de uso é a fronteira da transação.
- Toda alteração é uma migration nova
- Uma vez aplicada, nunca é editada, renomeada nem apagada; o Liquibase guarda o checksum e recusa a mudança.
- Só aditiva: coluna opcional ou tabela nova
- A versão anterior continua no ar durante o rollout; renomear ou apagar de uma vez derruba ela.
- Mudança grande em passos (expandir e contrair)
- Adiciona o novo, migra o código, e só num deploy seguinte remove o antigo.
- Comentário e rollback em cada changeset
- Quem lê sabe por que existe, e dá para voltar sem improviso.
- A migration roda antes do código
- No deploy uma tarefa aplica o changelog e espera sair com 0; só então os serviços sobem.
- A entidade é conferida contra a tabela
- ddl-auto=validate na suíte: entidade sem migration é build vermelho, não surpresa em produção.
requisiçãoresposta
Escolha um cenário acima para ver a mensagem percorrendo a arquitetura.