9.2 KiB
type, layer, tags, title
| type | layer | tags | title | ||||
|---|---|---|---|---|---|---|---|
| Index | wiki |
|
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