docs(okf): entidades e relacionamentos OKF do DashDescomplicar
This commit is contained in:
+202
@@ -0,0 +1,202 @@
|
||||
---
|
||||
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
|
||||
Reference in New Issue
Block a user