docs(okf): entidades e relacionamentos OKF do DashDescomplicar

2026-10-28 16:01:20 +00:00
parent f063a2ec8c
commit 61ae4697f9
48 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,50 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, backend, integracao, n8n, automacoes]
+title: "Integracao-N8n-API"
+---
+
+# Integracao-N8n-API
+
+Integração com a API REST do n8n para monitorização de workflows determinísticos. Consulta workflows e execuções e expõe dashboard agregado com cache de 5 minutos.
+
+## Responsabilidades
+
+- **Workflows**: Listar todos os workflows (activos/inactivos)
+- **Execuções**: Última execução por workflow (status, duração)
+- **Falhas 24h**: Contagem de execuções com erro nas últimas 24h
+- **Cache**: 300 segundos TTL em memória para evitar sobrecarga da API n8n
+
+## Stack
+
+- **API**: `automator.descomplicar.pt/api/v1` (REST)
+- **Auth**: `X-N8N-API-KEY` header
+- **Cache**: Em memória (objecto, não Redis), 300s TTL
+- **Validação**: Tipos TypeScript (sem Zod)
+
+## Tipos
+
+- `N8nWorkflow`: id, name, active, last_execution, tags
+- `N8nDashboard`: total, active, inactive, failed_24h, workflows[], last_updated
+
+## Rotas
+
+| Método | Rota | Função |
+|---|---|---|
+| `GET` | `/api/n8n` | Dashboard agregado |
+
+## Localizações
+
+- **Código**: `api/services/n8n.ts` (183 linhas), `api/routes/n8n.ts` (24 linhas)
+
+## Dependências
+
+- **n8n API**: `N8N_API_KEY` e `N8N_API_URL` em `.env`
+- **Express-API**: Rota `/api/n8n`
+
+## Fornece a
+
+- **Painel-N8n**: Workflows, execuções, falhas
+- **Painel-IA**: Camada 2 (Determinístico) — contagem de workflows
+- **Express-API**: Rota `/api/n8n`