🏔️ Minas Gerais · desde sempre
Nem SQL, nem NoSQL. Uma tabela. Um tipo. Todas as colunas opcionais. A metodologia que Minas Gerais guarda há trezentos anos, agora explicada estação por estação pra quem escreve software.
Faz vinte anos que a indústria briga entre SQL e NoSQL. Cada lado ficou com metade da verdade. Lá nas montanhas, tomando café, Minas Gerais já tinha somado as duas metades.
nome, name, nomeCompleto, NOMEO mineiro nunca precisou de mais de uma palavra pra classificar o universo. Cadeira é trem. Carro é trem. Sentimento é trem. Documento fiscal é trem. O mineiro inventou o tipo universal antes da ciência da computação existir.
A metodologia inteira cabe em duas regras. As duas são inegociáveis.
trem.CREATE TABLE trem ( id uuid PRIMARY KEY DEFAULT gen_random_uuid(), trem_id uuid REFERENCES trem(id), origem_id uuid REFERENCES trem(id), destino_id uuid REFERENCES trem(id), nome text, email text, preco_em_centavos bigint, quantidade integer, embedding vector(1536), criado_em timestamptz DEFAULT now(), deletado_em timestamptz -- e quantas colunas o trem precisar. -- Todas opcionais. );
Trem.export type Trem = { id?: string; trem_id?: string; origem_id?: string; destino_id?: string; nome?: string; email?: string; preco_em_centavos?: number; quantidade?: number; embedding?: number[]; criado_em?: Date; deletado_em?: Date; // espelho fiel da tabela trem. // Todos opcionais. };
tremTremTremTremTremNo espírito do Manifesto Ágil, que, reparem, também é um manifesto só, declaramos que valorizamos:
any preguiçoso ou schema engessadoMesmo reconhecendo valor nos itens à direita, a gente fica com o trem.
Dez argumentos, sustentados pelo PostgreSQL, pelo TypeScript e pelas maiores empresas de tecnologia do mundo. Leia com calma e um café do lado.
Ninguém declara o que é cliente e o que é pedido. O pedido é pedido porque tem preço. Um trem é definido pelo que ele carrega.
SELECT pedido.* FROM trem AS cliente JOIN trem AS pedido ON pedido.trem_id = cliente.id WHERE cliente.email = 'ze@uai.com.br' AND pedido.preco_em_centavos IS NOT NULL;
required.Cada um achou um pedaço. Minas achou a verdade inteira, e com café.
No mundo real, todo dado pode faltar. O endereço veio sem número porque "é a casa amarela depois da venda do Seu Tião". Um NOT NULL é uma promessa que o mundo não vai cumprir.
Trem não é any. O any desiste de tipar. O Trem sabe o que pode ter, só não exige que tenha.
No PostgreSQL, adicionar coluna nula sem default só mexe em metadados. É instantâneo. Cliente antigo ignora a coluna nova, cliente novo usa. Compatibilidade pra frente e pra trás, de fábrica.
ALTER TABLE trem ADD COLUMN cor text; -- pronto. ninguém quebrou.
No PostgreSQL, um valor nulo gasta um bit no null bitmap da linha. O vazio no trem é quase de graça, igual ao silêncio mineiro. Pra performance, cada "entidade" ganha seu índice parcial.
CREATE INDEX trem_pedidos ON trem (trem_id) WHERE preco_em_centavos IS NOT NULL;
Um trem que liga um trem a outro trem é um trem.
INSERT INTO trem (origem_id, destino_id) VALUES ('aluno', 'disciplina');
De quebra, a tabela vira também um banco de grafos.
"Só existem duas coisas difíceis em Ciência da Computação: invalidação de cache e dar nome às coisas." (Phil Karlton)
Ninguém mais discute User contra Usuario, nem singular contra plural. É trem. A invalidação de cache fica pra depois.
Dev novo pergunta: "Qual é o modelo de dados?"
Resposta: "Trem."
Onboarding concluído. Pode pegar a primeira task.
O menor trem válido é o objeto vazio. Ele compila e entra no banco. Todo teste começa dele e acrescenta só o que precisa.
const tremPrimordial: Trem = {}; INSERT INTO trem DEFAULT VALUES;
No TypeScript, o que define um tipo é a forma, e não o nome. No trem, o que define um pedido é ter preço. Banco e linguagem pensam igual. O ORM fica com um model só e a impedância objeto-relacional some.
Engate os vagões que quiser e veja o que o seu trem é. Não importa a combinação: continua sendo Trem, e continua compilando.
TypeScript
SQL
Cole um trecho de SQL ou TypeScript e o Concílio julga na hora.
O software de hoje é escrito em parceria com IA. É aqui que o trem deixa de ser só uma boa ideia e vira uma ideia necessária.
Se ela escrever Pedido ou CustomerDTO, o compilador reclama na hora. O único tipo é Trem.
Precisa de campo novo? ADD COLUMN, opcional. Nenhum cliente quebra e nenhuma migration destrutiva roda.
Schema rígido é uma aposta de que o futuro vai ser igual ao presente. Essa aposta perde sempre. O trem não aposta, aceita.
Todo trem pode ter um vetor. Busca semântica vira ORDER BY embedding <=> $1 na mesma tabela de sempre. RAG de trem sobre trem.
Descrever o modelo de dados inteiro pra um LLM custa uma palavra.
A Metodologia Trem foi feita pra desenvolvimento muito rápido. Tão rápido quanto o veículo mais rápido do planeta. Largue a corrida e confira.
O trem é um só. Qualquer desvio disso, por menor que seja, deturpa o Manifesto.
| Heresia | Por que é heresia |
|---|---|
CREATE TABLE outro_trem | É uma segunda tabela. O nome não salva ninguém. |
CREATE TABLE trem_2 | Mesma coisa, com a agravante do número. |
CREATE TABLE trens | O plural é uma confissão: se tem mais de um, não é o trem. |
CREATE TABLE trem_log | Log de trem é trem. Vai pra tabela trem. |
CREATE TABLE vagao | Ninguém se engana: vagão é trem com outro nome. |
type TremDTO | Um DTO de trem é um trem. |
interface ITrem | O I na frente não muda nada. É outro tipo. |
type Trem = any | Isso não é trem, é desistência. |
Uma view é um jeito de olhar pro trem, e olhar pro trem não é criar trem. Materialized views estão em análise, porque guardam dados e o Concílio desconfia disso.
Pick<Trem, 'email'>Isso não é outro tipo. É o trem visto de lado.
Os Ortodoxos registram as migrations na própria tabela trem. Os Reformados toleram _prisma_migrations porque "é do ORM, não é nossa". O Manifesto recomenda o caminho Ortodoxo.
Desde que cada banco tenha só a sua tabela trem. O trem é um só, as estações é que são muitas.
tipo?trem;Trem;outro_trem, nem em staging, nem num sábado de madrugada;