docs(okf): entidades e relacionamentos OKF do DashDescomplicar

okf/entidades/Painel-Paperclip.md

@@ -0,0 +1,53 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, painel, paperclip, agentes, automacao]
+title: "Painel-Paperclip"
+---
+
+# Painel-Paperclip
+
+Painel do orquestrador autónomo Paperclip (Camada 3 — Autónomo). Monitoriza agentes (64), routines e issues. Suspenso desde 08-04-2026, mantido para reintrodução progressiva.
+
+## Responsabilidades
+
+- **Agentes**: Total, Activos, Idle, Erro — agrupados por role hierárquico (Board → CEO → C-Level → Director → Specialist)
+- **Routines**: Total, Activas, com cron expression e última execução
+- **Issues**: Abertas, Em Progresso, Fechadas (7d)
+- **Fallback**: Dados zeros quando BD Paperclip inacessível (sem erro 500)
+- **Ordenação Hierárquica**: Roles ordenadas por senioridade (ROLE_ORDER map)
+
+## Stack
+
+- **React 19** + TypeScript 5.6
+- **Framer Motion**: Stagger + spring animations
+- **Lucide React**: Bot, Users, Calendar, CheckCircle2, AlertTriangle, Activity, Zap
+- **Tailwind CSS**: Glass cards, status colors
+
+## Tipos
+
+- `PaperclipAgent`: id, name, role, status (active|idle|error|archived), last_heartbeat, last_run, total_runs
+- `PaperclipRoutine`: id, name, cron, active, last_run, last_status, next_run
+- `PaperclipDashboard`: agents (total, active, idle, error, list), routines (total, active, list), issues (open, in_progress, closed_7d)
+
+## API Consumida
+
+| API | Rota | Dados |
+|---|---|---|
+| Paperclip | `GET /api/paperclip` | PostgreSQL Paperclip (com fallback) |
+
+## Localizações
+
+- **Código**: `src/pages/Paperclip.tsx` (546 linhas)
+- **Rota**: `/paperclip`
+
+## Dependências
+
+- **Express-API**: Rota `/api/paperclip`
+- **Paperclip PostgreSQL**: Base de dados de agentes/routines
+- **Dashboard-Engine**: Layout, navegação
+
+## Estado
+
+- **Suspenso** (08-04-2026) — reintrodução progressiva planeada
+- Painel mantido para monitorização durante reintrodução