FTS Assistants

• [Phase 1] Integração com n8n
  Endpoints da API: Utilizaremos a URL https://evolution.ftsflows.com.br diretamente no backend.
  Criptografia: Mesmo em modo Stateless, as instâncias locais no n8n precisam de segurança. Utilizaremos o Header apikey dinâmico.
  Proposed Changes (Para a Sessão Atual)
  Finalizar a modelagem de dados no backend.
  Desenvolver o driver completo para Evolution API.

Walkthrough — Sprint 13: Integração com LLMs e Credenciais N8N
Nesta sprint, implementamos a base para integrar serviços de IA ao FTSAssistants, garantindo segurança na persistência de chaves e automação na configuração do n8n.

Mudanças Principais
Backend (NestJS & Prisma)
Validação de Tokens: Criamos o LlmService que valida chaves da OpenAI e Anthropic em tempo real consultando seus endpoints oficiais de modelos.
Segurança: Expandimos o modelo Integration com o campo encryptedData. As chaves de API são criptografadas via AES-256-GCM antes de serem salvas no banco.
Automação N8N: O N8nService agora cria automaticamente credenciais do tipo openAiApi e anthropicApi no cofre do n8n sempre que uma integração é salva.
Endpoints:
POST /integrations/llm/test: Para testes instantâneos no frontend.
POST /integrations/llm/save: Para persistência e sincronização com n8n.
Frontend (Flutter)
IntegrationsRepository: Implementação da camada de dados para comunicação com os novos endpoints de LLM.
Bot Wizard (Passo 2):
Substituímos a lógica simulada por chamadas reais à API.
Adicionamos suporte ao provedor Anthropic.
Implementamos feedback visual de "Testando conexão" e sucesso/erro.
O salvamento da chave agora ocorre de forma transparente ao avançar no wizard.
Verificação e Testes
Testes Automatizados (Backend)
Executamos as suítes de teste unitário para garantir a integridade dos payloads e do tratamento de erros:

llm.service.spec.ts: PASS (3 testes)
n8n.service.spec.ts: PASS (9 testes, incluindo novos casos de LLM)
Demonstração Técnica
TIP

No Passo 2 do Wizard, ao selecionar "OpenAI" ou "Anthropic", o usuário pode clicar no ícone de raio (⚡) para validar sua chave. Somente chaves válidas são persistidas no sistema.

Sprint 13 concluída com sucesso. O sistema está pronto para a Sprint 14 (OAuth2/Google).