Vibecoding
Como decidir onde cada dado do seu sistema vai morar
É a decisão mais cara de mudar depois e a que mais gente deixa a IA tomar sozinha. Quatro perguntas resolvem, e nenhuma delas é técnica.
Entre todas as decisões de um sistema, essa é a mais cara de mudar depois.
Funcionalidade você reescreve. Tela você refaz. Mas mover um dado de lugar significa mexer em tudo que lê aquele dado, e isso costuma ser o sistema inteiro.
E é justamente a decisão que mais gente delega pra IA sem perceber.
Por que delegar aqui sai caro
Você pede um sistema de pedidos. A IA cria as tabelas que fazem sentido no padrão mais comum da internet.
Funciona. E ela não sabia três coisas: que o seu volume é pequeno, que aquele campo é sensível e que aquele arquivo pode ter 2GB.
A estrutura que ela escolheu é correta em geral e inadequada pro seu caso. Como arquitetura não se delega, essa decisão continua sendo sua.
As quatro perguntas
Pra cada tipo de informação, quatro perguntas. Nenhuma técnica.
1. Quem precisa enxergar?
Só o dono, a equipe, ou é público? Essa resposta define a regra de permissão, e misturar dado com níveis diferentes de acesso na mesma estrutura é a origem do vazamento mais comum. Se um pedaço é mais sensível que o resto, ele merece lugar próprio.
2. Com que frequência é lido e escrito?
Lido o tempo todo e escrito raramente é um caso. Escrito a cada clique e lido quase nunca é outro completamente diferente. Registro de acesso e dado de cadastro não deveriam viver no mesmo lugar, porque um cresce rápido e é consultado pouco.
3. Por quanto tempo precisa ficar?
Pra sempre, cinco anos por obrigação fiscal, ou trinta dias? Isso define retenção, e retenção definida é o que torna possível atender um pedido de exclusão. Dado sem prazo definido fica pra sempre por omissão.
4. O que acontece se perder?
Catástrofe, chateação ou nada? Isso define onde investir em backup. Nem tudo merece o mesmo cuidado, e tratar tudo igual é caro de um lado e insuficiente do outro.
As quatro gavetas
Na prática, quase todo sistema pequeno se organiza em quatro naturezas, e misturá-las é a origem da maioria dos problemas.
Operacional: cliente, pedido, produto. Lido e escrito o tempo todo, precisa ser consultável e é onde a permissão importa mais. Vai no banco.
Arquivo: PDF, imagem, documento enviado. Grande, lido às vezes, nunca consultado por conteúdo. Vai em armazenamento de objeto; o banco guarda só a referência e os metadados. Arquivo dentro do banco é caro e lento, e é um erro comum em sistema feito rápido.
Segredo: chave de API, token, credencial. Nunca no banco de aplicação e nunca no código. Vai em variável de ambiente ou cofre, no servidor.
Registro histórico: log, auditoria, evento. Cresce muito, é consultado raramente, e tem prazo de expiração. Separado do operacional, senão ele engorda a base principal e encarece tudo.
O erro mais comum em sistema feito rápido
Tudo no mesmo lugar.
Arquivo em base64 dentro do banco. Log na mesma tabela do pedido. Token guardado num campo de configuração.
Funciona, e por um tempo funciona bem. Depois a base fica lenta, a conta sobe, e separar depois é a migração que ninguém quer fazer.
Como decidir rápido
Faz uma tabela antes de escrever código. Uma linha por tipo de informação, quatro colunas com as quatro respostas.
Quinze minutos. Quinze linhas, no caso de um sistema pequeno.
Essa tabela é o que você entrega pra IA junto com o pedido. Com ela, o que vem de volta já nasce com a estrutura certa, em vez de nascer com o padrão genérico da internet.
Estrutura errada não quebra nada hoje. Cobra em volume, em permissão e no dia em que você precisa mudar.
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Por que essa decisão é tão cara de mudar?
Porque ela define o modelo de permissão e as consultas de todo o sistema. Mudar onde um dado mora depois costuma encostar em todas as telas que o utilizam.
+Posso deixar a IA decidir a estrutura?
Ela sugere bem o padrão comum, e o padrão comum ignora o seu contexto de custo, volume e sensibilidade. A sugestão serve como ponto de partida, não como decisão.
+Qual a separação mais importante?
Separar dado operacional, arquivo, segredo e registro histórico. Cada um tem regra de acesso, custo e prazo de retenção diferentes, e misturá-los é o que cria o problema.
+Arquivo deve ficar no banco?
Em geral não. Arquivo custa caro no banco e barato em armazenamento de objeto. O banco guarda a referência e os metadados, o arquivo fica onde é barato servir.
Continue lendo
Como apagar código com segurança
Todo projeto tem código que não faz mais nada. Tirar dá medo porque ninguém sabe quem depende daquilo. Existe um caminho de quatro passos que remove o medo.
VibecodingComo escrever comentário que ajuda em vez de atrapalhar
A IA gera comentário que repete o que o código já diz. Isso não é documentação, é ruído. Comentário útil responde uma pergunta que o código não consegue responder.
VibecodingComo atualizar dependência sem passar a noite acordado
Atualizar tudo de uma vez é o caminho garantido para a madrugada. Uma por vez, com ordem certa e ponto de retorno, transforma isso numa tarefa de meia hora.