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,52 @@
+---
+type: Relationship
+layer: wiki
+tags: [stack, dashdescomplicar, relacionamento, observabilidade, sistema]
+title: "Dashboard-Engine → integra-com → Observabilidade (Sistema)"
+---
+
+# Dashboard-Engine integra Observabilidade
+
+Dashboard-Engine integra o sistema Observabilidade para visibilidade de sessões Claude Code, métricas cross-sistema e operações.
+
+## Escopo de Integração
+
+**Observabilidade é um sistema transversal (Desk #2059) que:**
+- Fornece SPEC autoritária em `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/SPEC.md`
+- Fornece PLAN autoritário em `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/PLAN.md`
+- Indexa e expõe sessões Claude Code (replay, timeline, eventos)
+- Coleta telemetria cross-projeto (IJFW, n8n, MCPs, SelfImprovement)
+
+## Touchpoints no DashDescomplicar
+
+1. **Painel Sessions** (`/sessions`) — Replay de sessões Claude Code
+   - Consome índice SQLite do Observabilidade
+   - Timeline + busca + filtros por agente/projecto
+   
+2. **Painel Monitor** (`/monitor`) — Métricas de infraestrutura
+   - Integrado com telemetria Observabilidade
+   - Health de MCPs, n8n, servidores VPS
+   
+3. **Painel Operações** (`/operations`) — Desk CRM + eventos cross-sistema
+   - Visibility de tarefas + webhooks/eventos Observabilidade
+
+4. **Metrics Entity** (`okf/entidades/Metrics.md`)
+   - Coleta de eventos do Observabilidade
+   - Agregação em `logs/performance-metrics.json`
+
+## Tipo de relação
+
+`integra-com` — Dashboard-Engine depende de Observabilidade para visibilidade completa do stack
+
+## Relacionamentos Secundários (Bidirecional)
+
+- Metrics ← alimenta → Painel-Monitor (okf/relacionamentos/Metrics-alimenta-PainelMonitor.md)
+- Painel-Sessions ← consome → Observabilidade
+- Observabilidade ← expõe-em → Painel-Monitor + Painel-Operacoes
+
+## Referências Autoritárias
+
+- **Observabilidade SPEC:** `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/SPEC.md`
+- **Observabilidade PLAN:** `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/PLAN.md`
+- **Desk Observabilidade:** #2059
+- **SelfImprovement:** #2066 (melhoria contínua da Observabilidade)