133 lines
5.5 KiB
Markdown
Executable File
133 lines
5.5 KiB
Markdown
Executable File
---
|
|
layer: wiki
|
|
title: DashDescomplicar — Dashboard de Gestão e Monitorização
|
|
description: >-
|
|
Dashboard interno da Descomplicar® para monitorização e gestão operacional em tempo real. Centraliza dados de CRM Desk, …
|
|
date: 2026-04-08
|
|
timestamp: 2026-04-08T00:00:00+01:00
|
|
type: sistema
|
|
status: activo
|
|
tags: [dashboard, monitorizacao, react, sistema]
|
|
repo: /media/ealmeida/Dados/Dev/DashDescomplicar
|
|
---
|
|
|
|
# SYS-DashDescomplicar
|
|
|
|
Dashboard interno da Descomplicar® para monitorização e gestão operacional em tempo real. Centraliza dados de CRM Desk, Hetzner, servidores SSH, WordPress, MCPs, n8n, Paperclip e métricas financeiras num interface unificado.
|
|
|
|
- **Repo local:** `/media/ealmeida/Dados/Dev/DashDescomplicar`
|
|
- **Stack:** React 19 + TypeScript 5.6 + Vite 7 + Tailwind + Framer Motion (frontend) · Express 4 + MySQL2 + SSH2 + Zod (backend) · Docker + Gitea + EasyPanel (DevOps)
|
|
- **Layout:** sidebar com 8 painéis (ver `src/components/Layout.tsx`)
|
|
|
|
---
|
|
|
|
## Painéis
|
|
|
|
### 1. Dashboard (`/`)
|
|
Página principal. Hero stats agregados (tarefas, calendário, servidores), gráficos de tendências e status real-time como entrada rápida para os restantes painéis.
|
|
|
|
### 2. Monitor (`/monitor`) — `pages/Monitor.tsx`
|
|
Monitorização de infraestrutura e WordPress.
|
|
- Load dos servidores, storage (NVMe, RAID1)
|
|
- Containers Docker e serviços
|
|
- Sites WordPress e WordPress Updates
|
|
- Backups, alertas e janelas de manutenção
|
|
|
|
### 3. Financeiro (`/financial`) — `pages/Financial.tsx`
|
|
Métricas de negócio via Moloni/Desk.
|
|
- Receita e Despesa (mês e ano)
|
|
- Vendas Mês / Vendas Ano, Despesas Mês / Despesas Ano
|
|
- Gráficos de evolução (pie/line charts)
|
|
|
|
### 4. MCPs (`/mcps`) — `pages/McpMonitor.tsx`
|
|
Estado dos 39 MCPs do gateway e locais.
|
|
- Contadores Online / Offline / Disabled / Total
|
|
- Botão "Actualizar" para refresh manual
|
|
|
|
### 5. Automações n8n (`/n8n`) — `pages/N8nMonitor.tsx`
|
|
Workflows determinísticos.
|
|
- Total de Workflows, Activos, Falhas (24h)
|
|
- Histórico de execuções recentes
|
|
|
|
### 6. Paperclip (`/paperclip`) — `pages/Paperclip.tsx`
|
|
Orquestrador autónomo (64 agentes).
|
|
- Agentes activos / idle / com erro
|
|
- Routines activas
|
|
- Nota: Paperclip em reintrodução progressiva (suspenso 08-04-2026)
|
|
|
|
### 7. IA / Claude (`/ai`) — `pages/AiOverview.tsx`
|
|
Overview do ecossistema Claude Code.
|
|
- Skills, agents, plugins, MCPs, hooks
|
|
- Ligação ao inventário do 04-Stack
|
|
|
|
### 8. Operações (`/operations`) — `pages/Operations.tsx`
|
|
Gestão operacional via Desk CRM.
|
|
- Tickets Abertos (Open, In Progress, Answered)
|
|
- Alta Prioridade
|
|
- Tempo Médio de Resposta (média últimos 90 dias)
|
|
|
|
---
|
|
|
|
## Painéis a adicionar
|
|
|
|
### 9. Cron Dev (proposto) — `pages/CronDev.tsx`
|
|
Painel para todas as acções cron do servidor `dev` (CT 102, `/root/Dev/claude_automations_dev/`). Actualmente os 9 agentes cron (imap-triage, ticket-triage, auto-expense, aiktop, infra-check, wp-update, etc.) correm sem visibilidade agregada — o `/today` lê logs via SSH mas não há UI.
|
|
|
|
Requisitos:
|
|
- Lista de todos os jobs cron activos com schedule, último run, próximo run, duração e exit code
|
|
- Estado: OK / Warning / Erro / Stale (sem correr há >24h)
|
|
- Logs recentes (tail) por job, com filtro e pesquisa
|
|
- Alertas visuais para falhas consecutivas (>2)
|
|
- Acção manual "Run now" (opcional, autenticada)
|
|
- Métricas agregadas: total jobs, sucessos 24h, falhas 24h, tempo médio
|
|
|
|
Fonte: SSH ao `dev` + leitura de `/var/log/` e logs dos agentes + `crontab -l`.
|
|
|
|
### 10. Inteligência — Melhorias Propostas (proposto) — `pages/Intelligence.tsx`
|
|
Painel para gerir o backlog de melhorias ao stack identificadas no projecto **Inteligência** (`04-Stack/02.04-Sistemas/Inteligencia/melhorias/`), incluindo `Melhorias-Stack-321-Videos.md` e futuras análises de canais/vídeos/notícias.
|
|
|
|
Requisitos:
|
|
- Lista de melhorias propostas com título, fonte (vídeo/canal/notícia), data, categoria (skill, agent, MCP, hook, plugin, workflow, infra)
|
|
- Estados: proposto / em análise / aprovado / em implementação / concluído / rejeitado
|
|
- Prioridade (alta/média/baixa) e esforço estimado
|
|
- Link para fonte original (URL vídeo, notícia) e ficheiro Hub
|
|
- Filtros por categoria, estado, prioridade e fonte
|
|
- Métricas: total propostas, taxa de adopção, melhorias implementadas por mês
|
|
- Acção "Criar tarefa Desk" para promover melhoria a execução (projecto #65)
|
|
|
|
Fonte: leitura dos `.md` em `Hub/04-Stack/02.04-Sistemas/Inteligencia/melhorias/` com parse de frontmatter + integração Desk CRM.
|
|
|
|
---
|
|
|
|
## Arquitectura
|
|
|
|
```
|
|
Frontend (React 19 + Vite) -> API Express -> Fontes:
|
|
- Desk CRM (MySQL)
|
|
- Hetzner Cloud API
|
|
- SSH2 (servidores)
|
|
- Moloni (MCP/API)
|
|
- MCP Gateway
|
|
- n8n API
|
|
- Paperclip API
|
|
```
|
|
|
|
Segurança: `express-rate-limit`, CORS, validação Zod, OIDC opcional.
|
|
|
|
---
|
|
|
|
## Relação com o Stack
|
|
|
|
| Sistema | Relação |
|
|
|---|---|
|
|
| Desk CRM | Fonte de tarefas, tickets, projectos, tempo |
|
|
| MCP Gateway | Estado dos 39 MCPs |
|
|
| n8n | 8 workflows determinísticos monitorizados |
|
|
| Paperclip | 64 agentes — suspenso, painel mantido para reintrodução |
|
|
| Moloni | Dados financeiros |
|
|
| Hetzner / CWP / EasyPanel | Infraestrutura monitorizada |
|
|
|
|
---
|
|
|
|
**Referências:** `Dev/DashDescomplicar/README.md` · `src/components/Layout.tsx` · `src/pages/*.tsx`
|