@poolzin/pool-bot 2026.3.22 → 2026.3.24

package/docs/MIKRODASH-ANALYSIS.md

@@ -0,0 +1,412 @@
+# MikroDash Analysis — Features for PoolBot Integration
+
+**Data:** 2026-03-13  
+**Analista:** Build Agent  
+**Status:** ✅ Analysis Complete
+
+---
+
+## 📊 RESUMO EXECUTIVO
+
+**MikroDash** é um dashboard em tempo real para MikroTik RouterOS que monitora:
+- Tráfego de rede por interface
+- Sistema (CPU, RAM, Storage)
+- Conexões ativas com geo-IP
+- Clientes wireless
+- DHCP leases
+- VPN/WireGuard peers
+- Firewall rules
+- Logs do router
+
+**PoolBot** pode se beneficiar de várias features do MikroDash para criar um **Network Monitoring Dashboard** integrado.
+
+---
+
+## 🎯 FEATURES TRANSFERÍVEIS
+
+### 1. **Network Traffic Monitoring** 🔴 ALTA PRIORIDADE
+
+**O que faz:**
+- Live traffic chart per-interface (RX/TX Mbps)
+- Configurable history window (1m-30m)
+- Animated SVG topology diagram
+- WAN IP, LAN subnets display
+- Latency chart (ping to 1.1.1.1)
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot Network Monitor Extension
+extensions/network-monitor/
+├── src/
+│   ├── collectors/
+│   │   ├── traffic.ts        # Coleta tráfego de rede
+│   │   ├── interfaces.ts     # Status de interfaces
+│   │   ├── ping.ts           # Latency monitoring
+│   │   └── connections.ts    # Conexões ativas
+│   ├── dashboard/
+│   │   ├── traffic-chart.ts  # Chart de tráfego
+│   │   ├── topology-map.ts   # Mapa de topologia
+│   │   └── latency-chart.ts  # Chart de latência
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Monitora saúde da rede do gateway
+- ✅ Detecta problemas de conectividade
+- ✅ Visualiza tráfego por canal (Telegram, Discord, etc.)
+
+**Esforço:** 8-12 horas
+
+---
+
+### 2. **System Resource Monitoring** 🟡 MÉDIA PRIORIDADE
+
+**O que faz:**
+- CPU gauge com thresholds (amber >75%, red >90%)
+- RAM usage gauge
+- Storage usage gauge
+- Temperature monitoring
+- Uptime display
+- Board info
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot System Monitor
+extensions/system-monitor/
+├── src/
+│   ├── collectors/
+│   │   ├── cpu.ts          # CPU usage
+│   │   ├── memory.ts       # RAM usage
+│   │   ├── disk.ts         # Storage usage
+│   │   └── temperature.ts  # Temperature (se disponível)
+│   ├── dashboard/
+│   │   └── resource-gauges.ts
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Alertas de resource exhaustion
+- ✅ Previne crashes por falta de memória
+- ✅ Otimiza performance do gateway
+
+**Esforço:** 4-6 horas
+
+---
+
+### 3. **Connection Tracking with Geo-IP** 🟡 MÉDIA PRIORIDADE
+
+**O que faz:**
+- Total connection count sparkline
+- Protocol breakdown (TCP/UDP/ICMP)
+- Top sources with hostname resolution
+- Top destinations with geo-IP country flags
+- World map with animated arcs
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot Connection Monitor
+extensions/connection-monitor/
+├── src/
+│   ├── collectors/
+│   │   ├── connections.ts   # Conexões ativas
+│   │   ├── geoip.ts         # Geo-IP lookup
+│   │   └── protocols.ts     # Protocol breakdown
+│   ├── dashboard/
+│   │   ├── connection-map.ts  # World map
+│   │   └── protocol-chart.ts  # Protocol bars
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Detecta padrões de acesso suspeitos
+- ✅ Monitora conexões por canal
+- ✅ Identifica gargalos de rede
+
+**Esforço:** 12-16 horas (geo-IP é complexo)
+
+---
+
+### 4. **DHCP Lease Monitoring** 🟢 BAIXA PRIORIDADE
+
+**O que faz:**
+- Active DHCP leases list
+- Hostname, IP, MAC display
+- Lease expiry tracking
+- Device count by subnet
+
+**Como adaptar para PoolBot:**
+- ⚠️ **NÃO RECOMENDADO** — Muito específico para routers MikroTik
+- PoolBot não gerencia redes DHCP
+
+**Veredito:** ❌ Não portar
+
+---
+
+### 5. **Wireless Client Monitoring** 🟢 BAIXA PRIORIDADE
+
+**O que faz:**
+- Clients grouped by interface
+- Signal quality display
+- Band badge (2.4/5/6 GHz)
+- TX/RX rates per client
+
+**Como adaptar para PoolBot:**
+- ⚠️ **NÃO RECOMENDADO** — Específico para access points wireless
+- PoolBot não gerencia wireless
+
+**Veredito:** ❌ Não portar
+
+---
+
+### 6. **VPN/WireGuard Peer Monitoring** 🟡 MÉDIA PRIORIDADE
+
+**O que faz:**
+- Active peer list with status
+- Last handshake display
+- Traffic counters per peer
+- Allowed IPs display
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot VPN Monitor (opcional)
+extensions/vpn-monitor/
+├── src/
+│   ├── collectors/
+│   │   └── wireguard.ts   # WireGuard peers
+│   ├── dashboard/
+│   │   └── vpn-peers.ts   # Peer tiles
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Monitora túneis VPN do gateway
+- ✅ Alertas de peer disconnected
+- ✅ Visualiza tráfego criptografado
+
+**Esforço:** 6-8 horas
+
+---
+
+### 7. **Firewall Rule Monitoring** 🟢 BAIXA PRIORIDADE
+
+**O que faz:**
+- Top hits rules
+- Filter, NAT, Mangle tables
+- Packet counts per rule
+
+**Como adaptar para PoolBot:**
+- ⚠️ **NÃO RECOMENDADO** — Específico para routers
+- PoolBot não gerencia firewall rules
+
+**Veredito:** ❌ Não portar
+
+---
+
+### 8. **Live Log Streaming** 🔴 ALTA PRIORIDADE
+
+**O que faz:**
+- Live router log stream
+- Severity filter (info, warning, error)
+- Text search
+- Real-time updates
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot Log Viewer (JÁ EXISTE - MELHORAR)
+// Atualmente: src/gateway/logs.tail.ts
+// Melhorias do MikroDash:
+extensions/log-viewer-enhanced/
+├── src/
+│   ├── collectors/
+│   │   └── logs.ts        # Log streaming
+│   ├── dashboard/
+│   │   └── log-stream.ts  # Live log UI
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Debug em tempo real do gateway
+- ✅ Filtra por severidade
+- ✅ Search em logs históricos
+
+**Esforço:** 4-6 horas (aprimoramento do existente)
+
+---
+
+### 9. **Health Check Endpoints** ✅ JÁ IMPLEMENTADO
+
+**O que faz:**
+- `/healthz` endpoint (200 only after startup)
+- RouterOS connection status
+- Startup completion detection
+
+**Status no PoolBot:**
+- ✅ **JÁ IMPLEMENTADO** em v2026.3.21
+- `/health`, `/healthz`, `/ready`, `/readyz`
+
+**Veredito:** ✅ Já feito!
+
+---
+
+### 10. **Browser Push Notifications** 🟡 MÉDIA PRIORIDADE
+
+**O que faz:**
+- Interface down/up notifications
+- WireGuard peer disconnected/reconnected
+- CPU exceeds 90% (1-minute cooldown)
+- 100% ping loss alerts
+
+**Como adaptar para PoolBot:**
+```typescript
+// PoolBot Notifications
+extensions/browser-notifications/
+├── src/
+│   ├── notifications/
+│   │   ├── gateway-alerts.ts   # Gateway alerts
+│   │   ├── channel-alerts.ts   # Channel status
+│   │   └── resource-alerts.ts  # CPU/RAM alerts
+│   ├── dashboard/
+│   │   └── notification-bell.ts
+│   └── index.ts
+└── package.json
+```
+
+**Benefícios:**
+- ✅ Alertas proativos para admins
+- ✅ Notificações de channel down
+- ✅ Alertas de resource exhaustion
+
+**Esforço:** 6-8 horas
+
+---
+
+## 📋 RECOMENDAÇÕES DE IMPLEMENTAÇÃO
+
+### Prioridade P0 (Implementar Agora)
+
+| Feature | Esforço | Impacto | Status |
+|---------|---------|---------|--------|
+| **Network Traffic Monitoring** | 8-12h | 🔴 Alto | ⏳ Pendente |
+| **Live Log Streaming (Enhanced)** | 4-6h | 🔴 Alto | ⏳ Pendente |
+
+### Prioridade P1 (Próxima Release)
+
+| Feature | Esforço | Impacto | Status |
+|---------|---------|---------|--------|
+| **System Resource Monitoring** | 4-6h | 🟡 Médio | ⏳ Pendente |
+| **Browser Push Notifications** | 6-8h | 🟡 Médio | ⏳ Pendente |
+
+### Prioridade P2 (Feature Release)
+
+| Feature | Esforço | Impacto | Status |
+|---------|---------|---------|--------|
+| **Connection Tracking with Geo-IP** | 12-16h | 🟡 Médio | ⏳ Pendente |
+| **VPN/WireGuard Monitor** | 6-8h | 🟢 Baixo | ⏳ Pendente |
+
+### Não Implementar
+
+| Feature | Motivo |
+|---------|--------|
+| DHCP Lease Monitoring | Específico para routers |
+| Wireless Client Monitoring | Específico para APs |
+| Firewall Rule Monitoring | Específico para routers |
+
+---
+
+## 🎯 ARQUITETURA RECOMENDADA
+
+### PoolBot Network Dashboard
+
+```
+PoolBot Gateway (porta 18789)
+├── WebSocket API (existente)
+├── HTTP Health Endpoints (existente)
+└── Network Dashboard (novo)
+    ├── /dashboard/network      # Traffic monitoring
+    ├── /dashboard/system       # Resource monitoring
+    ├── /dashboard/connections  # Connection tracking
+    ├── /dashboard/logs         # Log streaming
+    └── /dashboard/vpn          # VPN monitoring (opcional)
+```
+
+### Data Flow
+
+```
+┌─────────────────┐      WebSocket      ┌──────────────────┐
+│  PoolBot Gateway├────────────────────►│  Dashboard UI    │
+│                 │◄────────────────────┤  (React/Vue)     │
+│  - Collectors   │      REST API       │                  │
+│  - Metrics      │                     │  - Charts        │
+│  - Logs         │                     │  - Maps          │
+│                 │                     │  - Gauges        │
+└─────────────────┘                     └──────────────────┘
+```
+
+---
+
+## 🔧 TECNOLOGIAS RECOMENDADAS
+
+### Baseado no MikroDash
+
+| Componente | Tecnologia |
+|------------|------------|
+| **Backend** | Node.js 22+ (existente no PoolBot) |
+| **Frontend** | React 19 + Vite 6 (já usado no PoolBot UI) |
+| **Charts** | Chart.js (MikroDash) ou Recharts (PoolBot) |
+| **Real-time** | Socket.IO (MikroDash) ou WebSocket nativo (PoolBot) |
+| **Maps** | TopoJSON + D3 (MikroDash) |
+| **Styling** | Tailwind CSS 4 (já usado no PoolBot) |
+
+---
+
+## 📊 COMPARAÇÃO: MIKRODASH VS POOLBOT DASHBOARD
+
+| Feature | MikroDash | PoolBot Atual | PoolBot Futuro |
+|---------|-----------|---------------|----------------|
+| **Traffic Monitoring** | ✅ Completo | ❌ Não tem | ✅ Planejado |
+| **System Resources** | ✅ Completo | ⚠️ Parcial | ✅ Melhorado |
+| **Connection Tracking** | ✅ Com Geo-IP | ❌ Não tem | ✅ Planejado |
+| **Log Streaming** | ✅ Live | ✅ Básico | ✅ Melhorado |
+| **Health Endpoints** | ✅ `/healthz` | ✅ 4 endpoints | ✅ Igual |
+| **Push Notifications** | ✅ Browser | ❌ Não tem | ✅ Planejado |
+| **VPN Monitoring** | ✅ WireGuard | ❌ Não tem | ⚠️ Opcional |
+| **DHCP Monitoring** | ✅ Completo | ❌ Não tem | ❌ Não implementar |
+| **Wireless Monitoring** | ✅ Completo | ❌ Não tem | ❌ Não implementar |
+| **Firewall Monitoring** | ✅ Completo | ❌ Não tem | ❌ Não implementar |
+
+---
+
+## 🎯 CONCLUSÃO
+
+**Features Recomendadas para PoolBot:**
+
+1. ✅ **Network Traffic Monitoring** (8-12h) — Alta prioridade
+2. ✅ **Enhanced Log Streaming** (4-6h) — Alta prioridade
+3. ✅ **System Resource Monitoring** (4-6h) — Média prioridade
+4. ✅ **Browser Push Notifications** (6-8h) — Média prioridade
+5. ⚠️ **Connection Tracking with Geo-IP** (12-16h) — Baixa prioridade
+6. ⚠️ **VPN/WireGuard Monitor** (6-8h) — Opcional
+
+**Total Esforço:** 36-56 horas para implementação completa
+
+**NÃO Implementar:**
+- DHCP Lease Monitoring (específico demais)
+- Wireless Client Monitoring (específico demais)
+- Firewall Rule Monitoring (específico demais)
+
+---
+
+**Próximos Passos:**
+1. Aprovar plano de implementação
+2. Criar extensão `network-monitor`
+3. Implementar collectors de tráfego
+4. Criar dashboard UI
+5. Adicionar alertas e notificações
+
+**Assinado:** Build Agent  
+**Data:** 2026-03-13