N8N

N8N é a ferramenta de automação e integração da AEX. Usamos para conectar sistemas e automatizar fluxos sem escrever um serviço dedicado para cada tarefa.

Documentação oficial: docs.n8n.io. Aqui está apenas como usamos na AEX.

---

Papel na AEX

• Automatizar processos repetitivos (princípio: automatize antes de repetir).
• Integrar ferramentas e serviços via webhooks e APIs.
• Orquestrar tarefas de apoio (notificações, sincronizações, rotinas agendadas).

---

Como usamos

• Cada automação relevante é documentada no projeto que a utiliza (o que faz, gatilho, dependências).
• Credenciais ficam no gerenciador de credenciais do N8N — nunca em nós expostos ou no repositório.
• Fluxos que impactam o produto são registrados como decisão quando estruturais (docs/DECISIONS.md).

---

Boas práticas

• Simplicidade: automatize o que se repete; não crie fluxos complexos para casos raros.
• Nomeie fluxos e nós de forma clara — outro dev precisa entender.
• Trate erros: defina o que acontece quando um passo falha.
• Exporte/versione os fluxos importantes quando possível.

---

Evite

• Guardar segredos em nós ou variáveis expostas do fluxo.
• Automação crítica sem tratamento de erro nem documentação.
• Recriar no N8N o que já existe como regra de negócio no backend — mantenha a fonte única.