---
type: Index
layer: wiki
tags: [stack, dashdescomplicar, okf, grafo]
title: "DashDescomplicar — OKF / Grafo de Conhecimento"
---

# DashDescomplicar — OKF / Grafo de Conhecimento

Representação do DashDescomplicar como um grafo de entidades e relacionamentos seguindo os princípios Karpathy:
- 1 conceito = 1 ficheiro atómico
- Navegável e bidireccional
- Classificado por layer

---

## Entidades Principais (25)

### Motor Central (3)
- [[Dashboard-Engine]] — Orquestrador principal, router React, layout
- [[Express-API]] — Servidor backend Express 4 com 15 rotas REST
- [[MySQL-Pool]] — Pool de ligações MySQL2 ao Desk CRM Perfex

### Painéis Frontend (9)
- [[Painel-Dashboard]] — Página principal, hero stats Desk CRM
- [[Painel-Monitor]] — Monitorização de infraestrutura, WP, Beszel, Hetzner
- [[Painel-Financeiro]] — Métricas de negócio (vendas, despesas, lucro)
- [[Painel-MCPs]] — Estado dos 32 MCPs via gateway
- [[Painel-N8n]] — Automações determinísticas (workflows + execuções)
- [[Painel-Paperclip]] — Orquestrador autónomo (suspenso, manutenção)
- [[Painel-IA]] — Overview do ecossistema Claude Code (3 camadas)
- [[Painel-Operacoes]] — Gestão operacional (tickets + cobertura PROCs)
- [[Painel-Sessoes]] — Observabilidade de sessões Claude Code

### Backend — Integrações (6)
- [[Integracao-Hetzner]] — Hetzner Cloud API (servidores + métricas)
- [[Integracao-Beszel]] — Beszel Hub (fleet monitoring)
- [[Integracao-SSH-Metrics]] — Métricas via SSH2 (EasyPanel)
- [[Integracao-WordPress]] — Plugin WP Monitor (ingestão de dados)
- [[Integracao-N8n-API]] — n8n REST API (workflows + execuções)
- [[Integracao-MCP-Gateway]] — MCP Gateway (health check 32 MCPs)

### Infraestrutura (4)
- [[Docker-Deploy]] — Docker + EasyPanel Swarm deployment
- [[Systemd-Timers]] — Systemd user timers (indexação + observabilidade)
- [[Monitorizacao-Gemini]] — Gemini CLI telemetry hooks
- [[Observabilidade-Sessions]] — SQLite sessions DB + indexer + patterns

### Cross-Cutting (2)
- [[CSR-Integration]] — Camada de Cliente (fetch, cache, reconnection)
- [[Metrics]] — Telemetria e observabilidade (multi-camada)

### Proposto (1)
- [[Painel-CronDev]] — Cron dev server (proposto, não implementado)

---

## Relacionamentos (17)

### Estrutura Core (4)
- [[DashboardEngine-exibe-Paineis]] — Dashboard-Engine exibe todos os painéis
- [[ExpressAPI-roteia-Paineis]] — Express-API fornece dados a todos os painéis
- [[MySQL-Pool-alimenta-Servicos]] — MySQL-Pool alimenta serviços de dados
- [[Docker-Deploy-serve-Dashboard]] — Docker-Deploy empacota e serve a aplicação

### Integrações Funcionais (2)
- [[DashboardEngine-integra-CSRIntegration]] — Integração com camada CSR
- [[CSRIntegration-integra-Metrics]] — Telemetria integrada

### Backend → Painéis (4)
- [[Integracao-Hetzner-alimenta-Monitor]] — Métricas Hetzner → Painel-Monitor
- [[Integracao-Beszel-alimenta-Monitor]] — Fleet Beszel → Painel-Monitor
- [[Integracao-WordPress-alimenta-Monitor]] — Sites WP → Painel-Monitor
- [[Integracao-N8n-alimenta-Paineis]] — n8n → Painel-N8n + Painel-IA
- [[Integracao-MCPGateway-alimenta-Paineis]] — MCP Gateway → Painel-MCPs + Painel-IA

### Consumo de Dados (4)
- [[Paineis-consomem-DeskCRM]] — Desk CRM (tarefas, tickets, horas)
- [[Paineis-consomem-Moloni]] — Moloni API (faturação)
- [[Paineis-consomem-SSH]] — SSH/Infraestrutura (Hetzner, CWP, EasyPanel)
- [[Paineis-consomem-MCPGateway]] — MCP Gateway (status dos 32 MCPs)

### Observabilidade (3)
- [[DashboardEngine-integra-Observabilidade]] — Integração sistema Observabilidade
- [[Systemd-Timers-alimenta-Observabilidade]] — Timers → Indexação sessions
- [[Gemini-Telemetry-alimenta-Observabilidade]] — Gemini telemetry → sessions DB
- [[Observabilidade-alimenta-PainelSessoes]] — Sessions DB → Painel-Sessoes

### Melhoria Contínua (1)
- [[DashboardEngine-integra-SelfImprovement]] — Ciclo melhoria contínua (PDCA)
- [[Metrics-alimenta-PainelMonitor]] — Métricas agregadas → Painel-Monitor

---

## Taxonomia de Relacionamentos

| Tipo | Exemplo | Significado |
|---|---|---|
| `exibe` | Dashboard-Engine → exibe → Painéis | Motor renderiza painel |
| `roteia` | Express-API → roteia → Painéis | API fornece dados via endpoints |
| `alimenta` | MySQL-Pool → alimenta → Serviços | Fonte de dados abastece consumidor |
| `serve` | Docker-Deploy → serve → Dashboard | Infra serve aplicação |
| `integra-com` | Dashboard-Engine → integra-com → CSR | Integração funcional |
| `usa` / `consome` | Painéis → consomem → Desk CRM | Consumo de dados externos |

---

## Regras Karpathy

✅ **1 conceito = 1 ficheiro** — 25 entidades + 17 relacionamentos atómicos
✅ **Atómico** — Ficheiros independentes e legíveis
✅ **Navegável** — Este índice liga todas as peças
✅ **Partilhado** — Entidades externas (Desk CRM, Hetzner) referenciadas sem duplicação
✅ **Bidireccional** — Relacionamentos documentados nos dois sentidos (via index)

---

## Estrutura de Ficheiros

```
okf/
├── index.md                                          # Este ficheiro
├── FASE-C-VALIDACAO.md                               # Validação Fase C
├── entidades/                                        # 25 entidades atómicas
│   ├── Dashboard-Engine.md
│   ├── Express-API.md                                # NOVO
│   ├── MySQL-Pool.md                                 # NOVO
│   ├── Painel-Dashboard.md
│   ├── Painel-Monitor.md
│   ├── Painel-Financeiro.md
│   ├── Painel-MCPs.md
│   ├── Painel-N8n.md
│   ├── Painel-Paperclip.md
│   ├── Painel-IA.md
│   ├── Painel-Operacoes.md
│   ├── Painel-Sessoes.md                             # NOVO
│   ├── Painel-CronDev.md
│   ├── Integracao-Hetzner.md                         # NOVO
│   ├── Integracao-Beszel.md                          # NOVO
│   ├── Integracao-SSH-Metrics.md                     # NOVO
│   ├── Integracao-WordPress.md                       # NOVO
│   ├── Integracao-N8n-API.md                         # NOVO
│   ├── Integracao-MCP-Gateway.md                     # NOVO
│   ├── Docker-Deploy.md                              # NOVO
│   ├── Systemd-Timers.md                             # NOVO
│   ├── Monitorizacao-Gemini.md                       # NOVO
│   ├── Observabilidade-Sessions.md                   # NOVO
│   ├── CSR-Integration.md
│   └── Metrics.md
└── relacionamentos/                                  # 17 arestas
    ├── DashboardEngine-exibe-Paineis.md
    ├── ExpressAPI-roteia-Paineis.md                   # NOVO
    ├── MySQL-Pool-alimenta-Servicos.md                # NOVO
    ├── Docker-Deploy-serve-Dashboard.md               # NOVO
    ├── DashboardEngine-integra-CSRIntegration.md
    ├── CSRIntegration-integra-Metrics.md
    ├── Integracao-Hetzner-alimenta-Monitor.md         # NOVO
    ├── Integracao-Beszel-alimenta-Monitor.md          # NOVO
    ├── Integracao-WordPress-alimenta-Monitor.md       # NOVO
    ├── Integracao-N8n-alimenta-Paineis.md             # NOVO
    ├── Integracao-MCPGateway-alimenta-Paineis.md      # NOVO
    ├── Observabilidade-alimenta-PainelSessoes.md      # NOVO
    ├── Systemd-Timers-alimenta-Observabilidade.md     # NOVO
    ├── Gemini-Telemetry-alimenta-Observabilidade.md   # NOVO
    ├── Paineis-consomem-DeskCRM.md
    ├── Paineis-consomem-Moloni.md
    ├── Paineis-consomem-SSH.md
    ├── Paineis-consomem-MCPGateway.md
    ├── DashboardEngine-integra-Observabilidade.md
    ├── DashboardEngine-integra-SelfImprovement.md
    └── Metrics-alimenta-PainelMonitor.md
```

---

## Critérios de Conclusão

### Fase B (OKF Estrutura)
✅ Entidades: 25 (3 core + 9 painéis + 6 integrações + 4 infra + 2 cross + 1 proposto)
✅ Relacionamentos: 17 arestas (4 core + 2 funcional + 5 backend-painéis + 4 consumo + 4 observabilidade + 1 melhoria)
✅ Frontmatter: `type: Entity` / `type: Relationship` correcto
✅ Tags: stack, dashdescomplicar, tipo-entidade
✅ Navegação: okf/index.md centralizado

### Fase C (5W2H+PDCA + Relacionamentos Cruzados)
✅ **AGENTS.md:** When/How completo com referências PLAN/PROC/QR
✅ **STATUS.md:** PDCA (Plan-Do-Check-Act) ligado a docs/PLANS/ e observabilidade
✅ **Coerência:** Sem entidades órfãs; cada entidade tem ≥1 entrada + ≥1 saída
✅ **Bidireccionalidade:** Relacionamentos documentados em ambos os sentidos (via index)
✅ **Cross-Sistema:** Links a SPEC/PLAN autoritários

### Fase D (Deep OKF — 2026-06-30)
✅ **Entidades Deep:** Todas as 25 entidades com detalhe técnico completo
✅ **Integrações Mapeadas:** 6 integrações backend documentadas (Hetzner, Beszel, SSH, WP, n8n, MCP Gateway)
✅ **Infraestrutura Completa:** Docker, systemd timers, Gemini telemetry, sessions DB
✅ **Painel Sessions:** Documentado com componentes, tipos, API, filtros
✅ **Stack por Entidade:** Tecnologias, localizações, dependências, fornecedores
✅ **Total:** 25 entidades + 17 relacionamentos = 42 ficheiros OKF

---

**Deep OKF Concluído** — 2026-06-30