← todos os posts
Tutorial 9 min de leitura

"Banco de dados, servidor, API: o vocabulário mínimo sem jargão"

Não é aula de programação. São as dez palavras pra conversar com a IA e entender a resposta: analogia, definição e a frase em que cada uma aparece.

"Eu não sou programador. Tenho TDAH. E não falo inglês. Todos — eu disse todos — os frameworks de agentes de IA são em inglês."

É um brasileiro, no TabNews, em abril de 2026. Ele montou quarenta e dois agentes de IA pra trabalhar por ele e descreve o resultado como "uma luta diária tentando lembrar o que cada agente fazia". Não por falta de capacidade — ele montou os quarenta e dois. Por falta de vocabulário em português.

Quando eu fui levantar o que faltava no mercado pra quem constrói sem ser dev, essa lacuna apareceu com nome: português com o jargão traduzido, pra quem não fala inglês. Quase ninguém atende isso. Todo curso ensina a ferramenta; nenhum ensina as dez palavras que a ferramenta usa quando fala com você.

Este post é essas dez palavras. Não é aula de programação. É o vocabulário pra conversar com a IA, entender a resposta e saber quando ela está te enrolando. Cada termo em três partes: a analogia do mundo real, o que é de verdade, e a frase em que ele aparece quando a IA fala com você. Na ordem do visível pro invisível.

1. Tela (ou "frente", ou frontend)

A analogia. A vitrine e o balcão da loja. É o que o cliente vê e toca.

O que é. Tudo que roda no navegador ou no celular de quem usa: os botões, os campos, as cores, o que aparece quando clica. A IA é excelente nisso, e é por isso que o app parece pronto tão cedo.

Quando aparece. "Atualizei o frontend para mostrar a mensagem de erro." Traduzindo: ela mudou a tela. Não mudou o que acontece por trás — e o que acontece por trás é o resto desta lista.

2. Servidor (backend)

A analogia. A cozinha do restaurante. O cliente não entra, mas é lá que o prato é feito.

O que é. Um computador ligado na internet, que recebe o pedido da tela, decide o que fazer e responde. É onde as regras de verdade moram: quem pode ver o quê, quanto custa, se o cupom vale. Tudo que fica só na tela pode ser contornado por quem não usa a sua tela; o que fica no servidor, não.

Quando aparece. "Essa validação está sendo feita no cliente." Cliente, aqui, não é o seu cliente — é o navegador dele, a tela. A frase quer dizer: a checagem está na vitrine, não na cozinha. Peça pra fazer "também no servidor".

3. Banco de dados

A analogia. O arquivo de fichas. Cada cliente, cada pedido, cada agendamento é uma ficha numa gaveta; a gaveta é a tabela.

O que é. O lugar onde o app guarda o que precisa lembrar depois que a tela fecha. Não está no código: código é a receita, banco é a despensa. Se você perde o código, a IA refaz. Se perde o banco, os cadastros dos seus clientes não voltam.

Quando aparece. "Criei uma tabela pedidos com as colunas id, cliente_id e total." Tabela é a gaveta; coluna é o campo da ficha; cliente_id é o número da ficha do cliente, escrito na ficha do pedido pra ligar as duas. Quando a IA diz "vou alterar o schema", ela vai mudar o formato das fichas — e isso pede cuidado quando já existem fichas dentro.

4. API

A analogia. A janelinha de atendimento entre dois sistemas. O seu app não entra atrás do balcão do Mercado Pago; fala pela janelinha, num formulário combinado, e recebe a resposta por ela.

O que é. O conjunto de perguntas que um sistema aceita de outro, e o formato das respostas. Quando o seu app manda um e-mail, cobra um Pix ou pergunta o CEP, ele está usando a API de alguém. E o seu servidor também tem uma API: é por ela que a sua tela conversa com a sua cozinha.

Quando aparece. "A API retornou erro 401." Os números são o código da resposta da janelinha: 401 é "não sei quem você é", 403 é "sei quem é e não pode", 404 é "isso não existe", 500 é "quebrou do meu lado". Você não precisa decorar; precisa saber que o número diz de quem é o problema — e 401 quase sempre é chave faltando, o próximo termo.

5. Variável de ambiente

A analogia. A senha do cofre, que muda de prédio pra prédio. A instrução "abra o cofre" é a mesma em todo lugar; a senha, não, e ela não fica escrita na instrução.

O que é. Um valor guardado fora do código, porque muda conforme onde o app está rodando — no seu computador é a chave de teste do pagamento, no servidor é a chave real — ou porque é segredo. Tem duas famílias: a pública, que pode ir pro navegador, e a secreta, que só pode existir no servidor. A explicação inteira, com onde clicar, está aqui.

Quando aparece. "Configure a variável STRIPE_SECRET_KEY no ambiente de produção." Ela está dizendo: a senha do cofre do prédio novo ainda não foi cadastrada. E é a causa número um de "funcionava aqui e ficou branco lá".

6. Deploy (publicar)

A analogia. Mudar da cozinha de testes pro restaurante aberto ao público. A receita é a mesma; o lugar, os fornecedores e a chave da porta são outros.

O que é. Pegar o código e colocar num servidor que atende quem digita o endereço. Parece um botão, mas atrás dele são três operações — pôr no ar, entregar as chaves, ligar o domínio — que falham de jeitos diferentes.

Quando aparece. "Faça o deploy e teste em produção." Produção é o restaurante aberto. Todo tutorial escreve essa frase como se fosse um passo. É três.

7. Log

A analogia. O diário de bordo, ou a caixa-preta do avião. Ninguém lê enquanto está tudo bem; quando cai, é a testemunha.

O que é. O registro, linha por linha, do que o servidor fez e do que deu errado, com hora. Você não precisa entender o log; precisa saber que ele existe, achar a linha vermelha e colar pra IA.

Quando aparece. "Verifique os logs do servidor para ver o erro." É a IA admitindo que não sabe o que aconteceu — e é honesta: ela não estava lá. O que muda é o seu pedido de volta: "me explique em português o que esta linha diz, e o que eu confiro antes de você mudar qualquer código".

8. Autenticação

A analogia. A portaria do prédio. Você mostra o documento; o porteiro confere que você é quem diz ser.

O que é. O login. E-mail, senha, recuperação, "entrar com o Google". A documentação do Supabase, o banco por trás do Lovable e de muita outra plataforma, define numa linha: authentication means checking that a user is who they say they are — checar que o usuário é quem diz ser. A IA faz isso com capricho, porque é a parte que aparece.

Quando aparece. "Implementei a autenticação com e-mail e senha." Verdade, provavelmente. O que essa frase não diz é o próximo termo — e é a diferença mais cara desta lista.

9. Autorização

A analogia. O porteiro te deixou entrar. A autorização é a chave de cada apartamento: entrar no prédio não abre a porta do vizinho.

O que é. A pergunta feita depois do login, dado por dado: essa pessoa pode ver esse registro? A mesma documentação do Supabase, na frase seguinte: authorization means checking what resources a user is allowed to access — checar o que o usuário tem permissão de acessar. E diz que isso se faz com regra no banco (a tal de RLS, que já traduzi aqui). A IA deixa essa parte pela metade porque, enquanto só existe um usuário, ela nunca aparece.

Quando aparece. Quase nunca — e esse é o sinal. Se a IA disse "autenticação implementada" e não disse nada sobre quem vê o quê, o app tem porteiro e não tem chave de apartamento. O teste dos dois usuários mostra em cinco minutos.

10. Ambiente de teste × produção

A analogia. A cozinha de testes e o restaurante aberto, de novo — mas agora a pergunta é: são a mesma despensa?

O que é. Produção é o app que o cliente usa, com o dado dele. Teste (ou staging, ou desenvolvimento) é uma cópia onde você experimenta a mudança antes. O detalhe que engana: ter uma prévia não é ter ambiente de teste. A documentação do Lovable chama a prévia de "ambiente de staging" e, duas frases depois, avisa: the preview and your published app share the same backend and data — a prévia e o app publicado compartilham o mesmo servidor e os mesmos dados. Ou seja, o que você testa na prévia, testa em cima do cadastro real do cliente.

Quando aparece. "Testei a mudança no ambiente de desenvolvimento." Pergunte de volta: "esse ambiente usa o mesmo banco que o cliente?" Se a resposta for sim, você não tem ambiente de teste; tem duas portas pra mesma despensa.

O teste de saída

Dez palavras, nenhuma exige escrever código.

Faça o teste que eu faço com qualquer pessoa que quer ser dona do próprio app: explique pra alguém a diferença entre autenticação e autorização. Em voz alta, pra uma pessoa de fora, com a analogia do prédio se quiser. Se conseguir, você já está na frente da maioria de quem publicou app este ano, inclusive de gente que programa: é a distinção que mais vaza dado e que menos aparece na tela.

Se não conseguir ainda, releia o 8 e o 9. É a única parte que vale decorar.

Isso é o D do ciclo que eu ensino: definir. Antes de mandar a IA construir, saber nomear o que você quer com precisão suficiente pra pedir a coisa certa — e pra reconhecer, na resposta dela, quando "implementei a autenticação" está escondendo "não fiz a autorização". As outras paredes — publicar, cobrar, proteger, manter — usam exatamente estas dez palavras. Elas têm ordem. E a ordem começa por saber o que cada uma quer dizer.

Fontes