📄 Documento de Execução — Card 38: [M6.5] n8n + Gemini: Infraestrutura e Troca de Motor IA
| Campo | Valor |
|---|---|
| URL Trello | https://trello.com/c/LdtNyXGk |
| Marco | M6.5 (09/08–15/08/2026) |
| Data execução | 15/08/2026 |
| Doc anterior | Card 31: E-mail Workflows |
| Próximo card | Card 75: [M14] Novo AdminShell |
🎯 1. O que foi implementado
Infraestrutura n8n self-hosted + troca do motor de IA OpenAI→Gemini.
Infra VPS:
- Docker
n8nio/n8n(/home/ubuntu/n8n/, containergenioon-n8n, bind127.0.0.1:5678, volumen8n_data, 1GB RAM — 512M causava heap OOM) - DNS
n8n.wellka.com.br→ VPS (Hostinger) + Nginx (websocket upgrade) + SSL Let's Encrypt - Env do container:
N8N_WEBHOOK_URL,GENIOON_API_BASE,AUTOMATION_API_KEY,GEMINI_API_KEY,WAHA_*(viaextra_hosts: host.docker.internal)
Código GENIOON:
src/lib/bot/gemini.ts— cliente Gemini (@google/generative-ai,gemini-2.0-flash): 6 tools de function calling (criar_lead,criar_matricula,gerar_cobranca,validar_pagamento,liberar_acesso,falar_humano), system prompt ANIK, fallback mock heurístico semGEMINI_API_KEYsrc/lib/bot/index.ts— factorygetBotEngine()porAI_PROVIDER(gemini default, openai legado)bot-process.ts— usa a factory; dormente quandoN8N_WEBHOOK_URLativo (n8n assume)master/bot/config— badge "Gemini ativo/Mock" + indica n8n ativo (provider,aiEnabled,n8nActivenobot.status)
✅ Critérios de aceite validados
| # | Critério | Status |
|---|---|---|
| 1 | n8n acessível em https://n8n.wellka.com.br (HTTPS verde) | ✅ |
| 2 | generateBotReply via Gemini (fallback mock sem key) | ✅ tsc+build |
| 3 | Fallback mock funciona | ✅ |
| 4 | Painel mostra provider correto | ✅ |
📁 2. Arquivos criados/modificados
Criados: src/lib/bot/gemini.ts, src/lib/bot/index.ts
Modificados: bot-process.ts, master.ts (bot.status), master/bot/config/page.tsx, bot/openai.ts (+geminiToolCall opcional), .env.example, package.json (+@google/generative-ai)
🔌 4. Handoff
- Env novas (VPS .env genioon):
AI_PROVIDER=gemini,N8N_WEBHOOK_URL,AUTOMATION_API_KEY - Env n8n:
GEMINI_API_KEYpendente (Wellington fornece via Google AI Studio — sem ela o n8n/bot usam fallback mock) - n8n editor: https://n8n.wellka.com.br (owner setup 1º acesso manual; workflows já ativos via CLI)
🎯 8. Próximo card
Card 39 — endpoints /api/automation/* (executado na mesma sessão).