• Contadores — cartões com total de alarmes Ativos, Pausados, Reconhecidos e Total. Clique em qualquer cartão para ir à lista correspondente.
• Barra de proporção — distribuição visual (vermelho/amarelo/verde) do status atual.
• Alertas por Cluster/Região — ranking de alarmes por GO, NE, SP, MG, MT/MS.
• Top Usinas — usinas com mais alarmes abertos no momento.
• Top 5 Câmeras — câmeras mais ativas.
• Linha do Tempo — Hoje — lista cronológica dos alarmes do dia com indicador de status.
• Distribuição por Hora — mapa de calor mostrando em quais horas os alarmes são mais frequentes.
• Taxa por Operador — quantos alarmes cada operador reconheceu (últimos 30 dias).
• Tempo Médio de Resposta — tempo médio entre o disparo e o reconhecimento por cluster.

Cada linha dos gráficos no dashboard funciona como atalho para a aba Todos com o filtro já aplicado:

• Alertas por Cluster/Região — clique em uma linha para ver todos os alarmes daquela região.
• Usinas por Cluster — clique em uma usina para ver todos os alarmes daquela usina.
• Top Usinas — clique para filtrar pela usina correspondente.
• Top 5 Câmeras — clique para filtrar pela câmera correspondente.

• Foto da câmera — clique para ampliar no lightbox. Se houver imagem térmica e óptica, use as setas ‹ › para alternar.
• Zoom na foto — no lightbox, role o mouse ou faça pinch no celular para zoom; arraste para mover quando ampliado.
• Usina / Área — localização exata dentro da usina.
• Câmera — nome do sensor que disparou.
• Tipo de evento — ex.: Intrusão, Movimento, Térmico.
• Data/hora — horário em que o evento ocorreu.
• ID do alarme — número único (#0042).
• Reconhecido por — nome do operador e data/hora do reconhecimento.
• Pausado por — quem pausou, quando, e quantos minutos restam.

• Clusters (chips) — botões GO, NE, SP, MG, MT/MS no filtro superior. Clique em vários para combinar.
• Menu lateral — na esquerda (desktop), mostra clusters e top-15 usinas com contagem. Clique em uma usina para filtrar por ela.
• Botão Todos — limpa o filtro de busca (inclusive o aplicado ao clicar numa usina).
• Campo de busca — filtra por usina, câmera, evento ou ID.
• Filtro de data/hora — clique no botão de calendário para filtrar por período. Se a data "Até" for anterior à data "De", o sistema exibe um aviso e ignora o filtro inválido.
• 🌙 Alarmes noturnos — mostra só eventos fora do horário comercial.
• Visualização — escolha entre Cluster, Usina ou Tempo para agrupar os cartões.

Use Pausar quando precisar de tempo para investigar. O alarme fica visível mas notificações são suspensas pelo período escolhido.

• Durações disponíveis: 15, 30, 60 ou 120 minutos.
• Após o tempo, o alarme volta ao status ● Ativo automaticamente.
• O cartão mostra quem pausou, quando, e quanto tempo resta.
• Você pode reconhecer o alarme enquanto está pausado.

Reconhecer registra que você viu e avaliou o alarme. O sistema pede uma justificativa — essa informação fica no histórico para auditoria.

• Clique em Reconhecer no cartão ou dentro do alarme.
• Digite o que foi verificado (ex.: "Inspeção via câmera — falso positivo, veículo de manutenção").
• Seu nome de exibição (configurado em Perfil) e a data/hora são registrados.
• A mensagem original no Telegram é atualizada automaticamente.

Alarmes fixados ficam sempre no topo da lista, independente do status.

• Fixar para mim — disponível para todos os usuários; o alarme aparece fixado apenas na sua conta.
• Fixar para todos — exclusivo de Admin; o alarme aparece fixado para todos os operadores conectados.

Para fixar, clique no ícone 📌 no canto do cartão ou use o botão de fixar dentro do modal. Clique novamente para desfixar.

No modal de qualquer alarme, a seção Comentários permite adicionar observações vinculadas ao alarme.

• Ao excluir um comentário, o texto original é removido mas o registro permanece com a mensagem "comentário excluído", exibindo nome do autor, data do comentário e data da exclusão — para fins de auditoria.
• Admins podem excluir qualquer comentário. Operadores só excluem os próprios.

Para gerenciar vários alarmes de uma vez:

• Clique no botão Selecionar na barra de filtros para entrar no modo de seleção.
• Clique nos cartões que deseja selecionar, ou use Selecionar todos no cabeçalho do grupo.
• Na barra inferior: Reconhecer em lote ou Pausar em lote com duração escolhida.
• Admins também podem mover alarmes em lote para a Lixeira.

• Período — data de início e fim. Se "Até" for anterior a "De", o sistema exibe um aviso.
• Cluster — filtra por região (GO, NE, SP, MG, MT/MS).
• Usina/Área — busca por nome da usina, câmera ou tipo de evento.
• Status — Concluído, Reconhecido, Pausado etc.

Use os botões Cluster / Usina / Tempo acima da lista para agrupar os registros:

• Cluster — agrupa por região (GO, NE, SP, MG, MT/MS).
• Usina — agrupa por usina/área, mostrando a contagem de alarmes de cada uma.
• Tempo — agrupa por data de conclusão, do mais recente para o mais antigo.

Clique no cabeçalho de um grupo para recolhê-lo ou expandí-lo.

Clique no cabeçalho de qualquer coluna para ordenar. Clique numa linha para ver detalhes completos com linha do tempo:

• ID, Status, Horário do disparo.
• Cluster, Usina, Câmera, Tipo de evento.
• Reconhecido por e Horário do reconhecimento.

Alarmes movidos para a lixeira ficam visíveis por 24 horas antes da exclusão definitiva. O tempo restante aparece em cada item.

• Restaurar — devolve o alarme ao estado ativo.
• Excluir permanentemente — remove imediatamente, sem possibilidade de recuperação.
• Esvaziar lixeira — remove todos de uma vez.

• Alarmes concluídos por um operador via botão "Concluir alarme" no modal.
• Alarmes encerrados automaticamente por regra de silêncio programado (veja seção Relatórios).
• Alarmes arquivados automaticamente após o período de conclusão automática configurado pelo admin.

Use os botões Cluster / Usina / Tempo acima da lista:

• Cluster — agrupa os alarmes concluídos por região.
• Usina — agrupa por usina, com contagem de encerrados em cada uma.
• Tempo — agrupa por data de conclusão, facilitando ver o volume de cada dia.

Clique no cabeçalho de um grupo para recolhê-lo ou expandí-lo. O número de alarmes no grupo aparece em destaque.

• Busca por texto — filtra por nome da usina, câmera, tipo de evento ou área.
• Período — filtro de data/hora para restringir o intervalo exibido.
• Cluster (chips) — filtra por região específica.

• Resumo do Período — total arquivados, reconhecidos, taxa de ack e situação atual (ativos/pausados/reconhecidos agora). Inclui gráfico diário de barras.
• Por Cluster — ranking de regiões com total e quantidade de reconhecidos.
• Por Usina — top-50 usinas com mais alarmes no período.
• Por Câmera — câmeras com mais disparos.
• Por Tipo de Evento — intrusão, movimento, etc.

• Período — selecione 7, 30, 90 dias ou 1 ano no menu e clique Atualizar.
• Busca rápida — o campo de busca filtra simultaneamente usinas, câmeras e eventos em tempo real.
• 🌙 Modo noturno — ativo no topo filtra os relatórios para mostrar só alarmes noturnos.

Na aba Relatórios, role até a seção Histórico por Câmera e digite o nome de uma câmera no campo de busca. O sistema exibe:

• Total de alarmes no período selecionado
• Gráfico de barras diário (vermelho = dias de pico)
• Lista dos últimos 30 eventos com horário, tipo de evento, usina e operador que reconheceu
• Destaque ⚠️ ruidosa agora se a câmera disparou acima do limite na última hora

Administradores podem criar regras que indicam quando uma câmera ou usina está em silêncio programado (ex: manutenção, expediente). As regras aparecem como badge 🗓️ Silêncio programado nos cartões de alarme.

Quando um alarme chega dentro do horário de uma regra de silêncio ativa que cobre aquela câmera ou usina, o sistema o conclui automaticamente, sem ação manual:

• O alarme vai diretamente para a aba Concluídos, com o responsável exibido como "Sistema (Silêncio: nome da regra)".
• Nenhuma notificação push ou mensagem Telegram é enviada para esses alarmes.
• O registro permanece no histórico para auditoria.

O sistema analisa os últimos 30 dias do histórico e detecta automaticamente câmeras que disparam repetidamente no mesmo horário em 3 ou mais dias distintos. Essas câmeras aparecem como sugestões no painel de Relatórios.

• Cada sugestão mostra a câmera, a usina, o horário de pico e a quantidade de eventos e dias detectados.
• Sugestões já cobertas por uma regra de silêncio existente são automaticamente excluídas da lista.
• Clique em + Criar regra para criar uma regra de silêncio de segunda a sexta no horário detectado, sem preencher formulário.

O Dashboard exibe um mapa esquemático do Brasil com pontos nos clusters ativos. Cada ponto representa uma região:

• Ponto vermelho pulsando = há alarmes ativos naquele cluster agora
• Ponto âmbar = cluster tem alarmes, mas todos reconhecidos/pausados
• Ponto cinza = sem alarmes no momento

Clique em qualquer ponto para filtrar a lista de alarmes por aquele cluster.

Câmeras que disparam mais alarmes do que o limite configurado na última hora são marcadas automaticamente com o badge ⚠️ ruidosa nos cartões e no modal.

• O limite padrão é 5 alarmes/hora por câmera
• Administradores podem ajustar o limite em Configurações → Sistema → Threshold câmera ruidosa
• Use o Histórico por Câmera (em Relatórios) para investigar o padrão ao longo do tempo

No modal de qualquer alarme (ativo ou histórico), há uma seção Comentários abaixo da linha do tempo. Use para registrar observações como:

• "Falso positivo — galho passando na câmera"
• "Guarda verificou e liberou área"
• "Cliente informado por telefone às 14h"

Os comentários ficam vinculados ao alarme e aparecem sempre que ele for aberto — inclusive no histórico futuro. Admins podem excluir qualquer comentário; operadores só podem excluir os próprios.

Com um modal de alarme aberto, você pode navegar para o próximo ou anterior sem fechar e abrir novamente:

• Desktop: use as setas ‹ e › nas laterais da tela, ou as teclas ← → do teclado
• Mobile: arraste o modal horizontalmente com o dedo (swipe esquerda/direita). Swipe vertical ainda fecha o modal normalmente.

Um contador fixo no rodapé da tela (ex.: 2 / 47) mostra sua posição na lista enquanto navega.

Alarmes que chegam durante um período coberto por uma regra de silêncio são concluídos automaticamente — sem intervenção do operador. O registro aparece na aba Concluídos com autor "Sistema (Silêncio: nome da regra)". Configure as regras em Relatórios → Regras de Silêncio Programado.

As abas Concluídos e Histórico oferecem 3 modos de visualização via botões no topo:

• Cluster — agrupa por região operacional.
• Usina — agrupa por usina/área.
• Tempo — agrupa por data de conclusão.

Clique em qualquer linha dos gráficos Alertas por Cluster, Usinas por Cluster, Top Usinas ou Top 5 Câmeras para ir direto à aba Todos com o filtro aplicado.

Pressione ? para ver todos os atalhos disponíveis, ou use diretamente:

• Esc — fechar modal ou overlay
• A — reconhecer o alarme aberto
• P — pausar o alarme aberto por 30 min
• D — ir ao Dashboard
• 1 2 3 — alternar entre Ativos / Pausados / Reconhecidos

Use o botão ☀️/🌙 no canto superior direito para alternar entre o tema escuro (padrão) e o tema claro. A escolha é salva e mantida entre sessões. Ao usar o tema automático do sistema operacional, o dashboard segue essa preferência.

Quando a mesma câmera dispara múltiplos alarmes em menos de 30 minutos, o sistema os consolida automaticamente em um único cartão com contador de eventos — em vez de poluir a tela com dezenas de cartões idênticos.

• O cartão principal exibe a câmera, a usina e o badge ⚡ N eventos ▼.
• Clique no badge para expandir e ver cada alarme individual do grupo.
• Reconhecer ou pausar o alarme principal não afeta os demais — cada um pode ser tratado individualmente após expandir o grupo.
• O agrupamento funciona nas abas Ativos e Todos, e em todos os modos de visualização (cluster, usina, tempo).

Na aba Relatórios, o painel Sugestões de Regra de Silêncio lista câmeras que apresentaram padrões repetitivos de disparo no mesmo horário por 3 ou mais dias nos últimos 30 dias.

• Cada sugestão mostra câmera, usina, horário de pico, número de eventos e dias detectados.
• Câmeras já cobertas por uma regra ativa são filtradas automaticamente — só aparecem situações novas.
• Um clique em + Criar regra cria a regra de silêncio no horário sugerido (segunda a sexta por padrão) sem precisar preencher o formulário.

• Quando um alarme é registrado, o bot envia uma mensagem com foto (ou álbum térmica+óptica) para o grupo do cluster (GO, NE, SP, MG, MT/MS) e para o grupo geral.
• A mensagem contém: usina, câmera, tipo de evento, horário e ID do alarme.
• Dois botões aparecem: ⏸ Pausar 30min e ✅ Reconhecer.

Ao clicar em ⏸ Pausar ou ✅ Reconhecer no Telegram:

• O alarme é atualizado imediatamente no sistema web.
• A mensagem original no Telegram é editada para mostrar quem fez a ação e quando — nenhuma mensagem nova é enviada.
• Os botões são removidos da mensagem após a ação.
• Na web, o alarme aparece como reconhecido/pausado por Usuário (Telegram), deixando claro que a ação veio do Telegram.

Toda ação feita pelo Telegram é sincronizada instantaneamente para todos os usuários conectados via WebSocket — sem precisar recarregar a página web.

Em Preferências de Notificação você controla:

• Clusters — receba só alarmes das regiões que você monitora.
• Tipos de evento — filtre por intrusão, movimento, térmico, etc.
• Horário — defina um intervalo (ex.: 18h às 7h) para notificações fora do expediente.

Se sua função é monitorar apenas alarmes fora do horário comercial, peça para um admin ativar o modo noturno no seu perfil. Nesse modo, o dashboard filtra automaticamente para mostrar só alarmes do período noturno.

O nome de exibição é o nome que aparece quando você reconhece ou pausa um alarme — tanto na web quanto nas mensagens do Telegram. Se não for definido, o sistema usa o nome de usuário (login).

Clique no botão Sair no canto superior direito para encerrar a sessão. O token de acesso é invalidado no servidor — não basta fechar a aba.

Em Administração você pode:

• Criar usuários com perfil Admin ou Visualizador.
• Definir quais clusters cada usuário pode ver.
• Ativar ou desativar o acesso sem excluir o usuário.
• Ativar modo noturno para usuários que monitoram apenas alarmes noturnos.

Em Configurações → Integrações configure:

• A conta de serviço do Google (JSON) para autenticação.
• A pasta de destino no Drive onde os backups serão salvos.
• O agendamento: diário ou semanal, com horário preferido.
• A retenção: quantos backups manter (padrão: 14).

O backup inclui o banco de dados completo (pg_dump) comprimido.

Em Configurações → E-mail (SMTP) informe os dados do servidor. Use o botão 📨 Enviar teste para validar antes de salvar. O SMTP é usado para convites de acesso e notificação de falhas em backups.

• Conclusão automática — tempo (em horas) até um alarme ser fechado automaticamente sem reconhecimento.
• Período noturno — define o intervalo considerado "noturno" para filtros e notificações.