Ferramentas #01 — Visão geral do nosso stack

Bem-vindo à trilha Ferramentas — o guia completo do stack que faz o ClubPetro funcionar. Cada post pega uma ferramenta e responde: o que é, onde usamos, como começar, boas práticas e pegadinhas. É a referência prática pra quem chega no time e pra quem quer entender o porquê de cada escolha.

O mapa do stack, por função

IA — Claude / Anthropic (#02). Do Claude Code (construir) ao produto (feature).
Dados — Supabase (#03). Postgres, Auth e a regra do RLS.
Automação — Trigger.dev (#04, código) e n8n (#13, visual).
Mensageria — Evolution API (#05, WhatsApp) e Resend (#09, e-mail).
Código & entrega — GitHub (#06) e GCP (#12, produção).
Marketing & dados externos — Google Analytics (#07) e Facebook Ads (#08).
Observabilidade — Sentry (#10).
Complementares — Firebase (#11), onde faz sentido além do Supabase.

"Preciso de X → use Y" (atalho de decisão)

Guardar/consultar dado relacional → Supabase.
Rodar algo no horário, com retry → Trigger.dev.
Colar duas APIs rápido, sem deploy → n8n (e promova pro Trigger.dev se virar crítico).
Falar com o cliente → WhatsApp/Evolution (relacionamento) ou Resend (transacional).
Gerar/resumir/classificar texto → Claude.
Saber se quebrou em produção → Sentry.
Entender tráfego e campanha → GA4 + Facebook Ads.

Os 3 critérios por trás de toda escolha

Resolve uma etapa real? Ferramenta sem dor que resolve é assinatura abandonada.
Já temos isso no stack? Metade do "preciso de algo novo" se resolve com o que já existe.
Já existe pronto e seguro? Energia do time é pro que é do ClubPetro, não pra reimplementar commodity.

Custo e lock-in: o que olhar antes de adotar

Como o preço escala? Por uso, por seat, por volume de leitura? O barato no MVP pode doer na escala (ex.: bancos NoSQL cobrados por leitura).
Quão preso eu fico? Dá pra exportar o dado e sair? Padrões abertos (Postgres, SQL) reduzem risco; formatos proprietários aumentam.
Quem mantém isso vivo? Toda ferramenta nova é mais uma peça pra atualizar, monitorar e proteger.

Ferramenta é meio, não fim. O stack existe pra uma coisa: facilitar a vida do dono de posto mais rápido do que a gente conseguiria sem ele. Cada guia a seguir é autocontido — pule pra ferramenta que te interessa.

Próximo da série: #02 — Claude (Anthropic).