DashDescomplicar/okf/index.md

type, layer, tags, title

type	layer	tags	title
Index	wiki	stack dashdescomplicar okf grafo	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