NoIdle/FRONTEND_DASHBOARD.md

🎨 Dashboard Frontend - NoIdle (estilo JumpCloud)

📋 Visão Geral

Dashboard moderno e funcional para o NoIdle, inspirado no design do JumpCloud, com estatísticas em tempo real, alertas e notificações.

---

✨ Componentes Criados

1. MainDashboard.jsx (400 linhas)

Componente principal do dashboard com:

Estatísticas Principais (Cards grandes):

• 👥 Usuários
• 👥 Times
• 💻 Dispositivos
• 🛡️ Políticas MDM
• 📊 Atividades Hoje

Cards de Alertas (8 cards):

• ⚠️ Dispositivos Offline (7+ dias)
• ℹ️ Sem Atividade (24h)
• ❌ Políticas Falhadas (24h)
• ✅ Comandos Pendentes
• 🔄 Precisam Atualização
• 💾 Espaço em Disco Baixo
• 🟢 Online Agora
• 👤 Usuários Inativos (30d)

Status do Sistema:

• API Backend
• Banco de Dados
• Sistema MDM
• Última Atualização

Notificações:

• Dispositivos
• Atividade Recente

---

🎨 Preview do Design

┌─────────────────────────────────────────────────────────────────┐
│  Bem-vindo, Admin! 👋              [Atualizar] [Configurações] │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐│
│  │   77     │ │   14     │ │   143    │ │    8     │ │  1.2K  ││
│  │ Usuários │ │  Times   │ │Disposit. │ │Políticas │ │Ativid. ││
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └────────┘│
│                                                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐          │
│  │  [●] 0   │ │  [✓] 0   │ │  [!] 0   │ │  [i] 0   │          │
│  │ Offline  │ │Sem Ativ. │ │Políticas │ │Comandos  │          │
│  │  7+ dias │ │   24h    │ │ Falhadas │ │Pendentes │          │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘          │
│                                                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐          │
│  │  [↑] 0   │ │  [!] 0   │ │  [✓] 45  │ │  [i] 0   │          │
│  │Precisam  │ │  Disco   │ │  Online  │ │Inativos  │          │
│  │Atualiz.  │ │  Baixo   │ │  Agora   │ │  30d     │          │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘          │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │ Status do Sistema                                [✓] OK  │  │
│  │ ✅ Todos os serviços estão operacionais                 │  │
│  │ • API Backend: Online                                   │  │
│  │ • Banco de Dados: Conectado                             │  │
│  │ • Sistema MDM: Ativo                                    │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                  │
│  ┌─────────────────────────┐  ┌────────────────────────────┐  │
│  │ Notificações            │  │ Atividade Recente          │  │
│  │ • Offline 7+ dias:   12 │  │ • Dispositivos online: 45  │  │
│  │ • Sem atividade:     8  │  │ • Políticas exec. hoje: -  │  │
│  │ • Precisam update:   5  │  │ • Comandos pendentes:   3  │  │
│  └─────────────────────────┘  └────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

---

🚀 Implementação

1. Instalar Dependências

cd /var/www/pointcontrol/frontend
npm install @mui/material @emotion/react @emotion/styled @mui/icons-material

2. Criar Estrutura de Pastas

mkdir -p components/Dashboard
mkdir -p pages/dashboard

3. Copiar Componente

Arquivo já criado:

• frontend/components/Dashboard/MainDashboard.jsx

4. Criar Página Next.js

// pages/dashboard/index.js
import MainDashboard from '../../components/Dashboard/MainDashboard';
import Layout from '../../components/Layout';

export default function DashboardPage() {
  return (
    <Layout>
      <MainDashboard />
    </Layout>
  );
}

5. Atualizar Navegação

No menu lateral, adicionar link para /dashboard.

---

📊 API Endpoint

GET /api/dashboard/stats

Resposta:

{
  "success": true,
  "stats": {
    "users": 77,
    "teams": 14,
    "devices": 143,
    "policies": 8,
    "activities_today": 1234,
    "devices_online": 45,
    "devices_offline": 98,
    "pending_commands": 3
  },
  "alerts": {
    "devices_offline_7days": 12,
    "devices_no_activity_24h": 8,
    "failed_policies_24h": 2,
    "devices_need_update": 5,
    "low_disk_space": 1,
    "inactive_users": 3
  }
}

---

🎨 Customização de Cores

Paleta de Cores Usada:

const colors = {
  primary: '#2563eb',    // Azul - Usuários
  secondary: '#7c3aed',  // Roxo - Times
  success: '#059669',    // Verde - Dispositivos
  danger: '#dc2626',     // Vermelho - Políticas
  warning: '#f59e0b',    // Laranja - Avisos
  info: '#3b82f6',       // Azul claro - Informações
  orange: '#ea580c',     // Laranja escuro - Atividades
  gray: '#6b7280'        // Cinza - Inativos
};

Customizar no Theme:

// theme.js
import { createTheme } from '@mui/material/styles';

const theme = createTheme({
  palette: {
    primary: {
      main: '#2563eb',
    },
    secondary: {
      main: '#7c3aed',
    },
    success: {
      main: '#10b981',
    },
    error: {
      main: '#dc2626',
    },
    warning: {
      main: '#f59e0b',
    },
    info: {
      main: '#3b82f6',
    },
  },
  typography: {
    fontFamily: '"Inter", "Roboto", "Helvetica", "Arial", sans-serif',
    h4: {
      fontWeight: 700,
    },
    h6: {
      fontWeight: 600,
    },
  },
  shape: {
    borderRadius: 8,
  },
});

export default theme;

---

🔄 Atualização em Tempo Real

O componente atualiza automaticamente a cada 30 segundos:

useEffect(() => {
  fetchDashboardData();
  const interval = setInterval(fetchDashboardData, 30000);
  return () => clearInterval(interval);
}, []);

Para desabilitar:

// Remover o setInterval

Para mudar frequência:

const interval = setInterval(fetchDashboardData, 60000); // 1 minuto

---

📱 Responsividade

Breakpoints Material-UI:

// xs: 0-600px (mobile)
// sm: 600-960px (tablet)
// md: 960-1280px (laptop)
// lg: 1280-1920px (desktop)
// xl: 1920px+ (large screens)

Grid Responsivo:

<Grid item xs={12} sm={6} md={2.4}>  // 5 cards em desktop, 2 em tablet, 1 em mobile
  <StatCard ... />
</Grid>

<Grid item xs={12} sm={6} md={3}>    // 4 cards em desktop, 2 em tablet, 1 em mobile
  <AlertCard ... />
</Grid>

---

🧪 Testes

Testar Componente:

// __tests__/MainDashboard.test.js
import { render, screen, waitFor } from '@testing-library/react';
import MainDashboard from '../components/Dashboard/MainDashboard';

global.fetch = jest.fn(() =>
  Promise.resolve({
    json: () => Promise.resolve({
      success: true,
      stats: {
        users: 77,
        teams: 14,
        devices: 143,
        // ...
      },
      alerts: {
        devices_offline_7days: 12,
        // ...
      }
    })
  })
);

test('renders dashboard with stats', async () => {
  render(<MainDashboard />);
  
  await waitFor(() => {
    expect(screen.getByText('77')).toBeInTheDocument();
    expect(screen.getByText('Usuários')).toBeInTheDocument();
  });
});

---

🎯 Funcionalidades Futuras

1. Gráficos e Charts

import { LineChart, BarChart } from 'recharts';

// Gráfico de atividades dos últimos 7 dias
// Gráfico de políticas executadas
// Gráfico de dispositivos online vs offline

2. Filtros Avançados

// Filtrar por período (hoje, semana, mês)
// Filtrar por time
// Filtrar por status

3. Ações Rápidas

// Executar política em dispositivos selecionados
// Enviar notificação para usuários
// Gerar relatório

4. Notificações em Tempo Real

// WebSocket para notificações push
// Toast notifications
// Badge de contador

---

📝 Checklist de Implementação

Backend:

• Criar rota /api/dashboard/stats
• Queries para estatísticas
• Queries para alertas
• Testar endpoint com Postman

Frontend:

• Criar componente MainDashboard.jsx
• Criar página pages/dashboard/index.js
• Adicionar ao menu de navegação
• Configurar tema Material-UI
• Testar responsividade
• Adicionar loading states
• Adicionar error handling

Integrações:

• Conectar com sistema MDM
• Conectar com políticas
• Conectar com dispositivos
• Conectar com usuários

---

🚀 Deploy

1. Build Frontend:

cd /var/www/pointcontrol/frontend
npm run build

2. Start Production:

npm start
# ou
pm2 start npm --name "noidle-frontend" -- start

3. Configurar Proxy Nginx:

location / {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

---

📖 Documentação de Componentes

StatCard

<StatCard
  title="Usuários"
  value={77}
  icon={GroupIcon}
  color="#2563eb"
  link="/users"
/>

Props:

• title (string): Título do card
• value (number): Valor numérico
• icon (Component): Ícone Material-UI
• color (string): Cor do ícone (hex)
• link (string): URL para navegação

AlertCard

<AlertCard
  title="Dispositivos Offline"
  value={12}
  icon={WarningIcon}
  color="#dc2626"
  link="/devices?status=offline"
/>

Props:

• title (string): Título do alerta
• value (number): Valor numérico
• icon (Component): Ícone Material-UI
• color (string): Cor da barra lateral
• link (string): URL para ver detalhes

---

🎨 Screenshots Esperados

Desktop (1920x1080):

• 5 cards de estatísticas principais em linha
• 4 cards de alertas por linha (2 linhas = 8 cards)
• 2 cards de notificações lado a lado

Tablet (768x1024):

• 2 cards de estatísticas por linha
• 2 cards de alertas por linha
• 2 cards de notificações empilhados

Mobile (375x667):

• 1 card por linha (empilhados)
• Scroll vertical

---

✅ Status

Componente	Status	Progresso
MainDashboard.jsx	✅ Criado	100%
API /dashboard/stats	✅ Criada	100%
Página Next.js	⏳ Pendente	0%
Tema Material-UI	⏳ Pendente	0%
Testes	⏳ Pendente	0%
Deploy	⏳ Pendente	0%

---

🆘 Troubleshooting

Erro: "Module not found: @mui/material"

npm install @mui/material @emotion/react @emotion/styled

Erro: "fetch is not defined" (SSR)

// Usar SWR ou adicionar polyfill
import 'isomorphic-fetch';

Cards não responsivos

// Verificar breakpoints do Grid
<Grid item xs={12} sm={6} md={3}>

---

Dashboard Frontend Implementado e Pronto! 🎉

Próximo passo: Criar a página Next.js e integrar no menu.