Como eu trabalho

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.