Guia de uso do Greyes

Videomonitoramento e alarmes das usinas. Este guia mostra as telas que o seu acesso permite — se alguém falar de uma tela que você não encontra aqui, é porque o seu Papel não tem permissão para ela.

1Primeiro acesso

Versão BETA. O selo BETA ao lado do logo indica que o Greyes está em fase de validação com o cliente: as telas já fazem o trabalho de verdade, mas ainda recebem ajustes. Se algo não se comportar como este guia descreve, ou se faltar alguma coisa no seu dia a dia, avise o suporte (ícone de ajuda → Falar com o Suporte).

Você entra com usuário e senha — e, no campo do usuário, vale tanto o usuário de login quanto o e-mail cadastrado na sua conta. Se um administrador criou a sua conta e mandou um e-mail de "defina a sua senha", abra o link do e-mail e escolha a senha antes de tentar entrar — o link vale por 48 horas e só pode ser usado uma vez. O mesmo e-mail já traz o endereço do sistema, para você saber onde voltar depois de definir a senha.

Esqueceu a senha? Na tela de login existe "Esqueci a senha": informe o e-mail da conta e você recebe um link para criar uma nova. Por segurança, a mensagem na tela é sempre a mesma, exista ou não conta com aquele e-mail. Trocar a senha (por esse link ou em Minha conta) encerra as outras sessões abertas da conta.

Se a sua conta tiver 2FA (verificação em duas etapas) ativado, o sistema pede o código de 6 dígitos do aplicativo autenticador depois da senha. Se você perdeu o aparelho, o mesmo campo aceita um dos códigos de recuperação (cada um vale uma vez só).

Você está lendo este guia porque acabou de entrar pela primeira vez? É exatamente para isso que ele existe — a tela de boas-vindas do primeiro login te trouxe até aqui de propósito. Vale a pena ler pelo menos as seções das telas que aparecem no seu menu antes de sair clicando.
Instale no celular. O Greyes é um PWA: abra o site no navegador do celular e use "Adicionar à tela de início". Ele passa a abrir como aplicativo e se atualiza sozinho quando sai uma versão nova. No celular, uma barra inferior traz Início, Alarmes, Ao vivo e Avisos (o sino, com o mesmo contador) — cada botão aparece só se o seu Papel dá acesso àquela tela.

No canto superior direito ficam os botões, só com ícone — passe o mouse para ver o que cada um faz: tema claro/escuro, ajuda (abre este tutorial, os contatos do suporte ou o Reportar problema), notificações (o sino, que sobe o contador ao vivo, sem precisar atualizar a página), minha conta e sair.

Minha conta reúne os seus dados: nome, e-mail, senha e a verificação em duas etapas (2FA). Trocar o e-mail ou a senha pede a senha atual. O 2FA é opcional e você mesmo liga e desliga ali:

  • Configurar 2FA: informe a senha atual, leia o QR Code no aplicativo autenticador, digite o código de 6 dígitos e clique em Ativar.
  • O sistema mostra 10 códigos de recuperação, uma única vez. Use Copiar ou Baixar .txt, guarde em lugar seguro e só então clique em Já guardei. Ativar o 2FA encerra as suas outras sessões.
  • Com o 2FA ligado, a tela mostra quantos códigos ainda restam. Dá para Gerar novos códigos de recuperação (os antigos deixam de valer) e Desativar 2FA — as duas ações pedem a senha e um código (do aplicativo ou de recuperação).
Perdeu o aparelho e os códigos? Peça a um super administrador: ele consegue zerar o 2FA da sua conta em Administração → Usuários, e você entra de novo só com a senha.

2Dashboard

É a visão geral do parque. Os cartões do topo mostram usinas monitoradas, câmeras online, NVRs online, alarmes ativos agora, câmeras offline, NVRs offline e regras de evento. Todo cartão é clicável e leva ao detalhamento dele — o de câmeras offline abre a lista já filtrada, o de alarmes ativos leva à Central de Alarmes, o de regras abre a contagem por usina, e assim por diante.

Como o sistema conta câmera offline. A câmera conta como online só se o canal dela está mesmo entregando imagem; se o NVR inteiro está fora do ar, as câmeras dele contam como offline.

Logo abaixo ficam:

  • Início rápido: atalhos para as telas mais usadas. A aba 🕘 Vistos recentemente lista as últimas telas que você abriu, para voltar a elas com um clique.
  • ⚡ Eventos em tempo real: mostra, sem precisar atualizar a página, os alarmes de regra cadastrada e as câmeras e NVRs que ficaram offline, na ordem em que acontecem (no máximo 30 linhas) — é o painel para deixar aberto durante o plantão. A queda e a volta da mesma câmera viram uma linha só: "caiu 16× · ainda fora do ar" ou "· voltou às HH:MM". Clicar na linha abre o pop-up do alarme por cima do Dashboard.
  • 🕒 Linha do tempo de alertas: uma faixa por usina (a mais movimentada primeiro) com uma bolinha por evento, na cor do tipo — as bolinhas maiores juntam vários eventos do mesmo momento. O período vai de Últimas 6 horas a Últimos 7 dias. Entram os alarmes de regra cadastrada, Câmera offline e NVR Offline (o "NVR inacessível" não aparece aqui, só nas outras telas) e, como marcação, Câmera online e NVR online (anel vazio na cor da queda: o equipamento voltou) e Alarme reconhecido (bolinha verde cheia, com quem reconheceu e a justificativa). Passe o mouse para ver o evento, clique para abrir o alarme; a legenda liga e desliga cada tipo.

O mapa das usinas mostra todas as unidades monitoradas. Clique num marcador para ver o resumo daquela usina; ⤢ Expandir (ou um clique no próprio mapa) abre em tela cheia, e há alternância entre mapa claro e escuro.

Mais abaixo ficam os gráficos: NVRs e câmeras online x offline (as rosquinhas são clicáveis — abrem a lista, com PDF e Excel), câmeras que mais alarmaram nas últimas 24h, tempo médio de reconhecimento (dos últimos 7 dias), NVRs offline no momento, últimos exports com cadeia de custódia (inclusive os que ainda estão ⏳ processando ou ❌ falharam) e alarmes por hora do dia, com filtro por usina e período — esse gráfico conta só alarmes de regra.

✏️ Editar dashboard deixa o Dashboard do seu jeito: o ✕ tira um card, + Adicionar card traz de volta os que saíram (e cards extras, fora do padrão), e blocos e cards podem ser arrastados para outra posição. Nada muda até 💾 Salvar; ↺ Restaurar padrão volta ao original. O que você salvar fica na sua conta, em qualquer navegador.

No topo fica o botão Atualizar, que recarrega os números na hora.

Use o gráfico por hora para caçar falso positivo. Se os alarmes de uma usina se concentram sempre no mesmo horário, normalmente é causa ambiental (sol baixo, chuva, inseto na lente), não invasão.

3Ao Vivo

O menu Vídeo tem duas abas: Ao Vivo e Gravação. As duas usam a mesma árvore à esquerda e a mesma grade de câmeras — muda só o que aparece dentro das células (imagem de agora ou imagem gravada). O título da tela mostra o que está aberto (por exemplo, "Ao Vivo — Jussara 2" ou "2 NVRs").

Na árvore você navega por área → NVR → câmera:

  • Tocar no nome do NVR (ou da câmera) carrega ele na grade, substituindo o que estava lá.
  • Tocar na seta ▸ ao lado só expande/recolhe a lista de câmeras, sem mexer na grade.
  • O botão + da linha acrescenta as câmeras à grade em vez de substituir; a estrela marca favorito, que sobe para o topo.
  • No computador também dá para arrastar uma câmera da árvore direto para a célula onde você quer que ela apareça.
  • A caixa "Buscar área, NVR ou câmera" filtra a árvore enquanto você digita (ignora acento).

Na barra de cima ficam o tamanho da grade (1×1, 2×2, 3×3 ou 4×4) e as setas de página, e depois:

  • 🔎 Filtros: um botão com o contador de filtros ativos. Dentro dele ficam Apenas câmeras online (esconde da grade as câmeras fora do ar), Tag, Tipo de câmera (ópticas e térmicas, apenas ópticas ou apenas térmicas) e Limpar filtros.
  • ↻ Atualizar: rebusca o status das câmeras que estão na tela, sem perder a seleção que você montou.
  • 🖥️ Modo TV: abre em outra aba uma visualização em tela cheia que vai rodando as câmeras sozinha — é o modo para a TV da sala de monitoramento. Ele nasce espelhando a sua tela (as mesmas posições, a página em que você estava e a visualização aberta). Detalhes na seção "Modo TV", abaixo.
  • ✕ Limpar visualização: esvazia a grade.

Em telas estreitas (abaixo de uns 1.700 px de largura) a barra mostra só os ícones; passe o mouse para ver o nome de cada botão.

Visualizações salvas

Monte a grade do seu jeito e ela volta pronta depois, pelo seletor "Minhas visualizações...". O 💾 Salvar visualização guarda a grade como está agora; o 🗑 exclui a selecionada. Para montar com mais cuidado, use o editor ✏️ Visualizações:

  • defina Nome, Escala (tamanho da grade) e Só câmeras online;
  • na árvore "Sites, NVRs e câmeras", marque câmeras avulsas, NVRs inteiros ou sites inteiros. NVR e site marcados são dinâmicos: uma câmera nova cadastrada neles entra sozinha na visualização;
  • Salvar guarda; Salvar e abrir já carrega na grade. É preciso marcar ao menos um item e dar um nome.

Com Compartilhar com todos os usuários marcado, a visualização aparece para os outros como "🔗 nome (de fulano)". Só o dono edita ou exclui; quem recebe pode Abrir ou Duplicar como minha. Compartilhar não amplia o acesso: cada pessoa continua vendo só as câmeras que o Papel dela permite. O mesmo editor abre pela Gravação (⋯ Mais → Visualizações salvas).

Dentro de cada célula

  • Clique na imagem para abrir a câmera grande, em janela própria. Lá dentro você pode dar zoom com a roda do mouse no ponto apontado, expandir em tela cheia, e usar ⏪ Rever 1 min para rever o minuto que acabou de passar sem sair do ao vivo.
  • 🎞 abre a gravação daquela câmera direto, sem trocar de tela.
  • 🎯 marca a célula como destino: a próxima câmera que você tocar na árvore entra exatamente ali.
  • PTZ: em câmeras móveis aparecem as setas de movimento e o zoom na própria célula. O controle é exclusivo enquanto você está usando, para dois operadores não disputarem a mesma câmera.

Modo TV

No HUD do Modo TV há Tela cheia e Configurar. O painel de configuração permite escolher a Visualização (que trava o site), a Grade, a Rotação automática (em segundos; 0 = sem rotação), Mostrar apenas câmeras online e o Tipo de câmera, e depois Aplicar. A lista de câmeras se atualiza sozinha a cada minuto, mantendo a página em que estava.

No celular a grade se ajusta sozinha e as câmeras sobem escalonadas, uma de cada vez, para não abrir 16 streams de uma vez e derrubar o NVR.

4Gravação

É a mesma área de câmeras do Ao Vivo — mesma árvore, mesma grade — só que mostrando a imagem gravada em vez da imagem de agora. Os controles ficam numa barra única, no topo: grade, páginas, reprodução, relógio, linha do tempo, baixar/exportar e o botão ⋯ Mais. A gravação vem direto do NVR. Abrir um NVR usa grade 2×2; abrir uma câmera, 1×1.

Para começar: escolha um NVR ou câmera na árvore e clique em ▶ Reproduzir (que vira ⏸ Parar). Sem um ponto escolhido, a reprodução começa no início do período; sem período, 2 minutos antes do fim. Um duplo clique no nome do NVR já carrega as câmeras dele e começa a reproduzir no momento ao vivo, sem mais nenhum clique.

A linha do tempo mostra:

  • a faixa colorida = o que existe gravado no NVR naquele período;
  • marcadores coloridos = os alarmes das câmeras que estão na grade, na cor do próprio tipo de evento (a legenda fica em ⋯ Mais → Linha do tempo);
  • o traço claro = o ponto que está sendo reproduzido agora.
  • Clique em qualquer ponto para posicionar. Se já estava reproduzindo, todas as câmeras da grade pulam para aquele instante; se estava parado, aperte ▶ Reproduzir para começar dali.
  • Arraste para selecionar um trecho: a reprodução começa no início dele e o trecho fica destacado, liberando os botões de baixar/exportar.
  • Clique num marcador de alarme e, além de ir para aquele momento, o sistema avisa qual câmera e qual evento foi, e a célula daquela câmera fica piscando por alguns segundos. Se a câmera não estiver na página atual da grade, o aviso diz em que página ela está.
  • Sem período escolhido, a linha do tempo cobre as últimas 24 horas. Em ⋯ Mais → Período da linha do tempo, os campos Início e Fim + Aplicar período fixam outra janela — e já começam a reproduzir dela.

Nos controles de reprodução, na própria barra:

  • ◀◀ e ▶▶ andam 10 segundos para trás e para a frente, todas as câmeras da grade juntas.
  • 1× / 2× / 4× acelera a exibição: o vídeo e o relógio da câmera correm acelerados, até onde o link da usina aguenta (o NVR manda a gravação o mais rápido que a internet de lá permite). Quando a usina não alcança a velocidade pedida, aparece ao lado a velocidade real (ex.: 3,2× real; passe o mouse para ver "4× pedido · 3,2× possível nesta usina") e um botão ⓘ que explica o porquê, com os números do momento. As câmeras da grade andam juntas, na velocidade da mais lenta. Se o NVR não aceitar a reprodução acelerada, o sistema volta a avançar aos saltos — +10 s (2×) ou +30 s (4×) a cada 10 segundos — e mostra "aos saltos" ao lado do botão. O mesmo vale no "Ver gravação" de uma câmera.
  • 📷 em cada câmera (aparece ao passar o mouse; no "Ver gravação", junto dos controles) baixa só a imagem daquela câmera naquele instante, em JPG, com o nome da câmera e a hora da gravação no nome do arquivo.
  • Zoom: na grade e no "Ver gravação", posicione o mouse sobre a câmera e use a roda do mouse para aproximar ou afastar naquele ponto (até 8×); arraste para mover a imagem aproximada e dê duplo clique para voltar ao normal.
  • O relógio (dia/mês e hora:minuto:segundo) mostra o ponto que está passando. Ele anda junto com o vídeo, não com o relógio do computador: fica parado enquanto a câmera abre ou enche o buffer.

Em ⋯ Mais há um pop-up "Opções da Gravação" com quatro blocos: o Período da linha do tempo; a Exibição (Apenas com alarmes, Apenas com gravação, Tipo de câmera, Tag, ↻ Atualizar e 🖥️ Modo TV); as Visualizações salvas (o seletor, 🗑, 💾 e o editor ✏️ Criar ou editar visualizações); e a legenda da linha do tempo. Os filtros próprios desta tela:

  • Apenas com alarmes: enquanto a gravação corre, a grade mostra só as câmeras que tiveram alarme no último minuto — de qualquer tipo, inclusive câmera offline. A câmera entra sozinha na tela quando o alarme dela acontece e sai 1 minuto depois, a menos que aconteça outro alarme antes disso. É a forma de varrer um período inteiro sem ficar olhando câmera parada.
  • Apenas com gravação: esconde as câmeras sem imagem gravada. Com um ponto da linha do tempo escolhido, vale "tem gravação neste instante"; sem ponto, "tem gravação no período". (Aqui o que importa é ter imagem, não o estado da câmera agora.) Este filtro vale só na Gravação — o "Apenas câmeras online" não.

Clique numa câmera da grade e ela ocupa a área da grade toda, no mesmo instante que estava passando — com período, linha do tempo própria, velocidade, 📷 e botão para baixar o trecho. ← Voltar para a grade (ou Esc) volta à grade, que continua do ponto em que a câmera ampliada parou. O mesmo vale no Ao Vivo: o clique amplia a câmera em HD, com "Rever 1 min", PTZ, presets e patrulha, snapshot e áudio ao lado do vídeo.

Com um trecho selecionado, aparecem:

  • ⬇ Baixar: baixa o vídeo direto (arquivo .mkv, com o áudio do NVR), sem burocracia. O trecho precisa ser contínuo (um único segmento gravado), tem teto de 4 horas e, com várias câmeras na grade, o sistema pede para você escolher uma. Serve para uso interno.
  • 🔒 Exportar: a exportação com cadeia de custódia. Abre um formulário com a câmera, Início, Fim, Motivo (obrigatório) e Nº do incidente (opcional) e roda em segundo plano — a lista mostra "⏳ Processando…" até ficar pronta. Gera o trecho original do NVR com hash SHA-256 calculado antes de qualquer conversão, uma cópia com marca d'água em .mp4 e o manifesto (JSON e PDF); registra quem exportou. É este que serve como evidência para boletim de ocorrência ou processo. Pode haver no máximo 2 exportações ao mesmo tempo; a terceira é recusada até uma terminar.
  • 📊 Relatório de alertas: abre uma lista dos alertas das câmeras que estão na grade, no período da linha do tempo (até 2.000), com botões PDF e Excel.

Limites e comportamentos que ajudam a entender

  • Espera inicial: a gravação entra com um pequeno buffer, então a imagem leva de 2 a 5 segundos para aparecer. Se o buffer esvaziar, ela espera encher.
  • Limite por NVR: cada gravador aguenta um número fixo de reproduções ao mesmo tempo — somando todos os usuários, abas, grade, "Rever 1 min", download e exportação. Em geral são 8 (modelos "-M4") ou 16. Passou disso, a célula mostra o aviso de limite. Uma grade 3×3 num NVR de limite 8 perde a nona célula.
  • Câmera que não começou em 30 s: o sistema libera a sessão e a célula mostra aviso (limite do equipamento ou NVR sem resposta). A aba precisa estar visível.
  • Fim do arquivo: cada célula reabre sozinha ao chegar ao fim do trecho; se não houver gravação adiante, aparece "Sem gravação disponível nesse instante".
  • H.265: a gravação vem do stream principal, que quase sempre é H.265. Navegador que não toca H.265 recebe uma versão convertida na hora, e a imagem demora uns 7 a 11 segundos a mais.
  • Áudio: toca na tela só em canal com áudio ativo no NVR; senão fica só o vídeo. Baixar e exportar mantêm o áudio.
  • Relógio de NVR errado: o horário que o sistema mostra é o do NVR. Um NVR com relógio desajustado (veja Relatórios → Desvio de relógio) mostra a gravação deslocada.
O 🖥️ Modo TV desta tela mostra o AO VIVO das câmeras selecionadas aqui, não a gravação — não existe parede rotativa de gravação.

5Início (Alarmes)

Primeira tela do menu Alarmes: mostra quantos alarmes estão ativos agora, por usina. Clique num cartão de usina para ir direto à Central de Alarmes já filtrada por ela.

Abaixo ficam dois gráficos de apoio: alertas por dia (últimos 7 ou 30 dias) e os tipos de alarme mais comuns no mesmo período — úteis para ver se uma usina está gerando alarme demais e de que tipo.

6Central de Alarmes

Lista todos os alarmes com o rastro completo do que aconteceu com cada um. Escolha entre ▦ Cards (com foto — padrão) ou ☰ Lista (compacta, cabe mais alarme na tela); a escolha fica salva no seu navegador. A lista se atualiza sozinha a cada 30 segundos, e o card ganha a foto assim que ela fica pronta.

Como a tela abre

A Central sempre abre em 24 horas · Regras cadastradas · Status Ativo — ou seja, só o que é ocorrência de segurança e ainda está em aberto. Os filtros ficam recolhidos: o botão ▾ Mostrar filtros (N) abre o painel (e ▴ Ocultar filtros recolhe de novo; a sua escolha fica salva). Com o painel recolhido, uma faixa lista os filtros ativos, cada um com um × para tirar só aquele. Limpar filtros volta ao padrão acima.

Filtros

  • Período: 24 horas, 3 dias, 7 dias, 30 dias ou Todos — e, à parte, data e hora de/até.
  • Categoria (cada uma com a sua contagem): Todos, Regras cadastradas (os alarmes que casaram com alguma regra), 🔥 Incêndio e fumaça (veja a seção própria), Câmeras offline e NVR offline — separa o que é ocorrência de segurança do que é problema de equipamento.
  • Status: 🔴 Ativos (padrão), ⏸ Pausados, ✅ Reconhecidos, ⏱ Encerrados por tempo e Todos; a lista completa de status (Comentado, Em verificação, Alarme Falso, Concluído...) fica no campo Status do painel.
  • ⭐ Só estratégicas, Área (um botão por área), Criticidade (Crítico, Alto, Médio, Baixo, com contagem), usina, NVR (a usina filtra a lista de NVR), tipo de evento, prioridade (Alta, Média, Baixa) e busca livre por usina, câmera, NVR, regra, evento, mensagem ou o número do alarme.
  • Exibição: ordenar (Mais recentes ou Maior criticidade), agrupar (Não agrupar, Por área ou Por usina), alarmes por página (25 a 500; padrão 100) e a 🎨 Legenda de cores. Ordenar e filtrar por criticidade valem para a página carregada.

O card

Uma câmera = um card. Se a mesma câmera tem vários alarmes, o card mostra 🔔 N (até 20 alarmes dela). A barra de páginas (« Primeira, ‹ Anterior, Próxima ›, Última ») some quando tudo cabe numa página. O card traz, de cima para baixo:

  • a criticidade ("Crítico 72") e o "há X min";
  • o evento, a usina · área, a câmera e o #número com data e hora;
  • selos de ícone: 🔔 alarmes agrupados, ⭐ estratégica, 📌 fixado, ⚠️ aviso, 🔇 silenciado, 📊 N/7d (quantos alarmes essa regra gerou em 7 dias — mede o ruído) e 🎯 X% (dos alarmes já tratados em 30 dias, quantos eram reais — a reputação da câmera; só aparece se houver alarme tratado);
  • os botões diretos ⏪ Gravação (janela de 30s antes a 1min depois do alarme), 🔴 Ao vivo e 📌 Fixar.

Clique no card ou na linha (fora dos botões) abre o detalhe completo.

Criticidade

Cada alarme recebe uma nota de criticidade que combina tipo de evento, prioridade, horário e histórico da câmera. As faixas são Crítico (60 ou mais), Alto (40+), Médio (25+) e Baixo. Clique no selo para ver o cálculo item a item. O botão 📊 Criticidade, na barra da Central, abre o ranking e o mapa de calor por hora.

Fixar e câmeras estratégicas

  • 📌 Fixar: o alarme fixado vai para a seção 📌 Fixados no topo da lista (até 50, independente de filtros e de página) e nunca é encerrado por tempo. Quem é admin também vê 📌 Para todos.
  • ⭐ Estratégica: marca uma câmera de importância especial. O alarme dela ganha o selo ⭐ e notifica mesmo abaixo da prioridade mínima que você escolheu em Notificação de Alarmes (categoria desligada continua desligada). O botão ⚙ Câmeras estratégicas, na barra da Central, lista e remove.
  • Os botões 📌 e ⭐ aparecem só para quem tem a permissão no Papel.

O detalhe do alarme

  • no topo, a criticidade (clicável), o status atual em destaque, o botão ✅ Reconhecer alarme e a caixa Alterar status… (Em verificação, Alarme Falso). Atalhos para 🔴 Ao vivo, 📌 e ⭐;
  • o bloco Detalhes: dispositivo, nome da regra, prioridade, categoria, descrição e número do alarme;
  • a aba Imagem — a foto do momento: clique para dar zoom (2,5×), use a roda do mouse para ajustar, e o botão ↗ abre o arquivo original em nova aba. Quando o alarme tem câmera irmã (par óptica/térmica no mesmo NVR), aparecem as duas fotos, com seta para alternar — o card já mostra "🖼 2";
  • a aba Vídeo, com o mesmo player de Gravação: a roda do mouse dá zoom até 4× no ponto do cursor e, ampliado, dá para arrastar a imagem. O clique continua sendo play/pause;
  • a aba 💬 Comentários (com uma barra de comentário rápido sempre visível) e a 🕘 Atividades — a linha do tempo de reconhecimento, pausa e conclusão, com justificativa;
  • o que o sistema fez: a regra que casou e as ações que ela executou sozinha (e-mail, webhook, corneta...);
  • setas nos cantos da tela (e um contador no rodapé) para passear pelos alarmes da lista atual sem fechar o detalhe. No computador o detalhe cabe sem rolar; no celular, rola.

Quando o alarme "fecha sozinho"

  • Câmera ou NVR que voltou: o alarme de câmera/NVR offline é concluído automaticamente quando o equipamento volta, e a aba Atividades registra "🟢 Concluído automaticamente — Câmera voltou a ficar online" (ou NVR).
  • ⏱ Encerrado por tempo: alarme de regra com mais de 24 horas desde o primeiro disparo sem ninguém tratar é encerrado pelo sistema (a checagem roda a cada 10 minutos). Ele não some: continua no filtro ⏱ Encerrados por tempo, no histórico e nos relatórios. Não entram nessa regra câmera/NVR offline e manutenção (que só fecham quando o equipamento volta), alarmes fixados, pausados e suprimidos.
  • Concluído passa a significar só o que uma pessoa tratou. E um alarme encerrado por tempo não conta como tratado na reputação 🎯 da câmera.
Repetiu depois de encerrar, abre alarme novo. Se a fonte do alarme continua disparando (um sol na câmera todo fim de tarde, por exemplo), cada ocorrência depois do encerramento abre um alarme novo e uma nova notificação — um por dia, no caso do sol.
Faixa 🌙 "Horário noturno". Entre 18h e 7h (pela hora do seu computador) aparece um aviso no topo lembrando que as usinas estão sem expediente e que alarme de intrusão merece atenção redobrada. É só aviso, não filtra nada.
Alarme sem regra não é erro. Alarmes de disponibilidade (NVR sem conexão, equipamento instável) são gerados pelo próprio monitoramento e não têm ação configurável — o detalhe diz isso com todas as letras.
🌫️ "Imagem comprometida". Quando a função Saúde da imagem estiver ligada pelo administrador, este alarme avisa uma câmera online mas cega (coberta, fora de foco, sem luz ou virada para outro lugar). Abra o 🔴 Ao vivo para conferir e, se a imagem estiver mesmo ruim, acione a manutenção da usina. Ele fecha sozinho quando a imagem volta ao normal.
Card sem foto nem sempre é falha. Se a câmera estava com instabilidade de rede no instante exato do alarme, não há o que capturar — o sistema tenta 3 vezes antes de desistir. Alarme sem regra cadastrada também não captura foto de propósito.

7Regras de Alarme

Uma regra diz o que fazer quando um tipo de evento acontece em determinado lugar. Cada regra tem abrangência (usina, NVR ou câmera), tipo de evento, prioridade, carência (tempo mínimo entre dois alarmes iguais), vigência (dias e horários) e a lista de ações.

Na listagem, cada linha traz o nome, o selo do tipo de evento e o selo da usina. Os dois selos são clicáveis e filtram a lista por aquele valor; clicar de novo desliga o filtro. A seta à esquerda abre a configuração completa da regra ali mesmo, sem abrir pop-up.

No formulário da regra, o primeiro controle é o switch "Regra habilitada", no topo — dá para ver e mudar se a regra está no ar sem rolar nada. Depois vêm Identificação, Abrangência, Comportamento e Vigência (dias da semana e horário).

Ações ao disparar — são nove, e cada linha tem um botão ⓘ ao lado do tipo que explica, em português, o que aquela ação faz de verdade quando o alarme acontece:

  • Popup ao vivo — faz o alarme saltar na tela de quem estiver com o sistema aberto naquele momento.
  • Mover PTZ p/ preset — gira a câmera móvel para um preset já salvo.
  • Associar saída de alarme (corneta/relé) — aciona a sirene/relé do NVR pelo tempo configurado. É ação no mundo real, sem ninguém confirmar na hora.
  • Enviar e-mail — precisa do servidor de e-mail configurado em Administração → Sistema.
  • Enviar solicitação HTTP — avisa um sistema de terceiro. Dá para escolher o comando (GET/POST/PUT/DELETE), o tipo de conteúdo, o corpo (com botões que inserem variáveis como {{camera_name}}), cabeçalhos próprios e autenticação básica. Guarda um histórico dos últimos envios, com sucesso ou falha, para você conferir se o outro lado recebeu.
  • Criar etiqueta — cola uma etiqueta de texto no alarme assim que ele nasce, para achar e filtrar depois.
  • Ligar unidade de altifalante — toca no alto-falante da câmera uma mensagem de áudio já cadastrada em Cornetas.
  • Capturar gravação e Capturar imagem — garantem que o trecho de vídeo e a foto do momento fiquem ligados ao alarme. A captura já é automática para toda câmera elegível; estas duas ações deixam isso explícito na regra.
  • Modo em lote: selecione várias regras para habilitar, desativar, editar em massa ou excluir.
  • Testar regra: dispara um alarme de teste que executa as ações de verdade — serve para conferir se a solicitação HTTP e a corneta respondem.
A regra é o que faz o evento virar alarme. Com a opção "esconder alarme sem regra cadastrada" ligada (Administração → Sistema → Configuração global de alarmes), um evento só aparece na Central se existir uma regra para o mesmo tipo de evento — a comparação é exata, inclusive maiúsculas e minúsculas. Regras que sobraram de migração são desativadas, não apagadas, para preservar o histórico.
Carência é o que segura enxurrada de alarme. Ela tem um ⓘ próprio explicando o detalhe que o nome não diz: a repetição dentro da janela não é jogada fora — ela soma no alarme que já está aberto, e a janela é rolante (reconta a partir da última repetição). Enquanto isso, não sai notificação nova nem as ações da regra rodam de novo. Se uma câmera dispara sem parar, aumente a carência antes de desligar a regra — desligar cega a câmera, a carência só espaça o aviso. Exceção: alarme com mais de 24 horas é encerrado por tempo; a repetição seguinte abre um alarme novo, com nova notificação.

8Notificação de Alarmes

Esta tela não fica no menu: abra o sino na barra superior e clique na engrenagem de configuração dentro dele.

É uma preferência pessoal — só afeta a sua própria conta, não o parque inteiro. Escolha quais tipos de alarme e a partir de qual prioridade você quer receber na Central de Notificações (o próprio sino).

Como o sino funciona: o contador sobe ao vivo (mostra "99+" quando passa disso), o painel lista as últimas 20, e há Marcar todas como lidas. Clicar numa notificação marca como lida e abre o alarme por cima da tela em que você está. Se a conexão cair, o sino se ressincroniza sozinho quando ela volta.

Também é aqui que fica a notificação pop-up do navegador (avisa na tela quando chega um alarme novo, mesmo com o Greyes em outra aba) — desligada por padrão.

Câmera estratégica sempre avisa. O alarme de uma câmera marcada com ⭐ chega a você mesmo abaixo da prioridade mínima escolhida aqui. Só uma categoria inteira desligada continua valendo.
Não recebe aviso de um alarme que aparece na tela? Quando a opção "esconder alarme sem regra cadastrada" está ligada (Administração → Sistema → Configuração global de alarmes), os alarmes sem regra também deixam de gerar notificação e de aparecer na Central. O cartão "Eventos em tempo real" do Dashboard tem critério próprio: só mostra alarme de regra cadastrada e câmera/NVR offline.

9Equipamentos

É onde o inventário é cadastrado e mantido.

  • Áreas: o agrupamento regional das usinas, usado nos filtros do Dashboard, da Central de Alarmes e na árvore do Vídeo. Dá para gerenciar os sites de uma área direto daqui.
  • Sites: as usinas, com área, endereço e coordenadas do mapa.
  • NVRs: gravadores, com status, modelo, firmware e quantidade de câmeras. Dá para importar por planilha (há modelo para baixar) e exportar em PDF/Excel. Veja os detalhes do cadastro logo abaixo.
  • Câmeras: lista completa com status, imagem sob demanda, área, NVR e etiquetas. As imagens não carregam sozinhas de propósito, para não sobrecarregar os NVRs.
  • Cornetas: saídas de relé ligadas ao NVR (sirene, alarme sonoro), com histórico de acionamento.
  • Configuração em lote: aplica a mesma configuração a vários equipamentos — sincronismo de horário (NTP) com fuso horário do NVR, troca de senha dos NVRs e normalização de substream.
  • Tags: catálogo central de etiquetas de câmera, usado pelos filtros do Ao Vivo. Uma tag em uso não pode ser excluída — o sistema diz o que está preso nela.

Cadastrando e editando um NVR.

  • Em + Novo NVR e em Editar NVR existem os campos Porta e Porta RTSP (padrão 554). Os dois só aceitam número inteiro de 1 a 65535; valor inválido destaca o campo em vermelho e nada é gravado.
  • Mudar o IP ou a Porta RTSP e salvar atualiza sozinho o endereço de todas as câmeras do NVR: o Ao Vivo e a Gravação passam a usar o endereço novo (a gravação reabre em até uns 30 segundos).
  • Salvar e testar / Cadastrar + testar tentam descobrir as câmeras. Se a descoberta falhar ou não achar nenhuma, o NVR é salvo mesmo assim e um aviso manda usar Descobrir câmeras em Editar NVR.
  • Usuário e senha do NVR com caracteres como # / ? : % @ funcionam normalmente.
Troca de senha em lote: confira os "estado incerto". Cada NVR é auditado individualmente e uma falha não derruba o lote. O sistema só grava a senha nova quando o NVR aceitou e a nova senha autenticou. Os NVRs que aparecem num bloco vermelho no topo ("Senha possivelmente trocada no NVR") ficaram em estado incerto — não repita o lote neles sem conferir no equipamento.
Relógio errado no NVR quebra a gravação. Se um NVR aparece com desvio de relógio, use o bloco de NTP da Configuração em lote — alarme e gravação passam a bater no horário certo. O campo Fuso horário do NVR ("Não alterar" por padrão; UTC-3 Brasília, UTC-4 ou UTC-5 Acre) grava o fuso junto, e pede confirmação antes.

10Relatórios

Números do período escolhido: total de alarmes, uptime médio dos NVRs, câmera com mais quedas e espaço livre em disco.

Abaixo, cada relatório é um cartão que você abre sob demanda (não carregam todos de uma vez, para não pesar). Os gráficos de alarmes por dia, tipo, usina e status aparecem ao abrir o Relatório de Alarmes. Todos os cartões têm botões próprios de PDF e Excel:

  • Relatório de Alarmes e Quedas por usina;
  • 🎯 Criticidade dos alarmes: o relatório da nota de criticidade. Filtros de período (padrão 7 dias, máximo 31), site → NVR → câmera, tipo de evento, faixa de criticidade, status e "só correlacionados". Mexer num filtro não busca nada: só ▶ Gerar relatório (e os botões PDF/Excel, com os mesmos filtros). A tela mostra 200 alarmes; PDF e Excel trazem até 1.000. O mapa de calor por hora é clicável e abre a Central naquela hora quando o período termina hoje;
  • Uptime dos NVRs e Câmeras que mais caem (a tela mostra os últimos 3 dias; PDF e Excel seguem o campo "Período (dias)", até 30, com tempo fora do ar e disponibilidade %);
  • Câmeras e NVRs offline: o que está fora do ar agora, com a linha "Total: N dispositivo(s) offline agora" e a opção Incluir instabilidade (flapping) — equipamento que cai e volta o tempo todo. PDF e Excel seguem a ordenação da tabela;
  • Histórico de quedas (câmeras e NVR): não tem tabela na tela — só filtros e os botões PDF/Excel. Sem datas, usa os últimos 30 dias (máximo 366). O PDF abre com "Ainda offline agora" e traz um gráfico das 10 maiores;
  • Uso de disco por câmera e Desvio de relógio dos NVRs;
  • Regras de evento mais acionadas — útil para achar regra ruidosa;
  • Veículos (leitura de placa);
  • Cadeia de custódia (somente admin) — o que foi exportado como evidência, por quem e quando. Mostra só exports prontos;
  • Auditoria de atividade de usuários (somente admin) — o log de auditoria em formato de relatório.

Todo PDF sai com faixa de cabeçalho (Greyes, a usina — ou "Todas as usinas (N)" — e quem gerou) e rodapé de uso interno, com os horários em horário de Brasília. Quem gerou e quando também vai nas primeiras linhas do Excel.

Alarme encerrado por tempo conta como Concluído nos totais dos relatórios, mas não entra na reputação da câmera — ninguém o tratou de verdade.

11Administração

  • Usuários: criar, editar, ativar/desativar. O cadastro pede Nome completo e Usuário separados — recomendado usar o e-mail como usuário de login (o campo copia sozinho enquanto você não editar ele na mão). Tanto o Usuário quanto o E-mail servem para entrar no sistema, então o mesmo valor não pode se repetir entre contas — se repetir, a tela avisa na hora. O Usuário (login) também pode ser editado em "Editar": trocar esse campo muda o que a pessoa digita na tela de login (avise ela antes), não derruba a sessão de ninguém e não reescreve o histórico — comentários e auditoria antigos continuam com o nome anterior, de propósito. O campo Papel lista os papéis cadastrados. Há seleção múltipla com ações em massa: enviar e-mail de criação de senha, ativar, desativar, alterar papel e excluir — sempre com confirmação e um resumo no fim dizendo quantos deram certo e o porquê de cada falha.
    • A coluna 2FA mostra (✔ / —) quem usa a verificação em duas etapas. O botão Zerar, só para super administrador (e nunca na própria linha), desliga o 2FA da conta, apaga os códigos de recuperação e encerra as sessões da pessoa — é o caminho de quem perdeu o aparelho.
    • Definir uma Nova senha encerra todas as sessões abertas daquela conta; o aviso diz quantas foram encerradas. Se você redefinir a sua própria senha, precisará entrar de novo.
    • Administrador não edita nem promove conta acima do próprio nível, e excluir usuário é só para super administrador.
  • Papéis (somente super administrador): além da janela de horário de login e de quais usinas e menus a pessoa enxerga, cada Papel carrega um checklist de ações permitidas — mais de 100 ações agrupadas por área do sistema, com checkbox. Três atalhos ("Carregar padrão Visualização/Operador/Admin") pré-marcam um conjunto pronto para ajustar depois, e "Desmarcar tudo" zera. É o que faz este próprio tutorial mostrar uma coisa diferente para cada pessoa. O formulário traz também um resumo em português do que o Papel permite fazer. Um Papel com usuário vinculado não pode ser excluído, e toda criação, alteração ou exclusão é auditada com o que mudou (permissões concedidas ou removidas, usinas, telas, horário).
  • Sistema: servidor de e-mail (SMTP) com botão de teste, destinatários de notificação, endereços de webhook, Integrações por evento genérico (veja abaixo), rotas de notificação (quem recebe o quê, de qual usina, em qual horário), status dos serviços, segurança dos dispositivos, catálogo de firmware e a Configuração global de alarmes — onde fica a opção "Esconder do Histórico e da Central de Alarmes todo alarme sem regra cadastrada". Com ela ligada, alarme sem regra também não captura foto nem clipe. O 2FA da sua própria conta fica em Minha conta, não aqui.
  • Log de Auditoria: registro de toda ação de escrita — quem, o quê, quando e de qual IP. Em "Detalhes" aparece o que mudou (por exemplo, a diferença de um Papel).
Antes de ativar o SMTP, use "Enviar e-mail de teste". O teste funciona mesmo com a configuração desativada; só marcando "Usar esta configuração" é que os alarmes passam a sair de verdade.

Integrações por evento genérico

Para um sistema que não é câmera nem NVR (um sensor, um alarme de cerca, um software de terceiro) mandar eventos para o Greyes. Fica em Administração → Sistema, logo abaixo de "Endereços de webhook". Cada origem tem nome, usina e o canal de entrada — HTTP ou TCP (com porta própria).

  • + Nova origem abre o cadastro; ao salvar, a tela "Como enviar eventos" mostra o endereço, o token (cabeçalho X-Event-Token, exibido só ali), um exemplo de curl e botões ⧉ Copiar. Em Editar, Gerar novo token invalida o antigo na hora.
  • A lista mostra, por origem: onde recebe, quantas regras tem ("nenhuma: nada vira alarme" quando está vazia, ou "⚠ N com aviso") e se está ativa. Os botões são Regras, Editar e Excluir.
  • No modal de Regras, a coluna Alarme diz se aquele casamento aparece mesmo ("✔ aparece"), fica escondido ("⚠ escondido") ou só aparece em certo horário ("⚠ só no horário"). A caixa Testar uma mensagem mostra qual regra casaria, sem gerar alarme.
Para o evento virar alarme visível, com "esconder alarme sem regra" ligado, precisa existir também uma Regra de Alarme com o mesmo tipo de evento (comparação exata). A porta TCP não tem senha: libere no firewall só o IP de quem envia.

12Disponibilidade por câmera e dia

Estado: recurso desligado por padrão — o card só aparece em Relatórios depois que o administrador do sistema ativar; se não encontrar, peça a ele. Quem usa: quem enxerga Relatórios, sempre só com as usinas do seu acesso.

Mostra, câmera por câmera e dia por dia, quanto tempo cada uma ficou no ar — o número que vai para o cliente quando ele pergunta "quanto a câmera X ficou fora em outubro?".

  • Em Relatórios, abra o card 🟩 Disponibilidade por câmera e dia.
  • Escolha De e Até (sem datas, vale os últimos 7 dias; no máximo 90 dias), e, se quiser, Cluster, Usina e NVR. Ordem põe as piores primeiro ou em ordem de nome; Câmeras na tela limita quantas aparecem (50, 200 ou 1000).
  • NVR/usina fora do ar conta (marcado por padrão): NVR ou usina sem comunicação conta como câmera fora do ar. Desmarque para medir só a câmera.
  • Clique em ▶ Gerar. No topo vêm a disponibilidade geral, quantas câmeras, quantas tiveram tempo fora do ar, as quedas e a soma do tempo fora.

Como ler o mapa de calor

  • Cada linha é uma câmera (com usina e NVR embaixo do nome) e cada coluna é um dia de Brasília — o dia de hoje vai só até agora. As últimas colunas trazem o total do Período, o tempo Fora do ar e as Quedas.
  • A cor segue a legenda: 100%, ≥ 99%, ≥ 95%, ≥ 80% e < 80%. Abaixo de 100% a célula mostra o número.
  • Passe o mouse numa célula para ver o percentual no ar, o tempo fora (e quanto disso foi NVR/usina) e quantas quedas houve naquele dia.
  • Sem dados (cinza): a câmera ainda não estava cadastrada naquele dia, ou é de antes de o sistema medir câmera a câmera. Sem dados nunca vira 100%.
O que conta como fora do ar. O incidente Câmera offline (e, com a caixa marcada, NVR offline/inacessível e usina inacessível); períodos que se sobrepõem contam uma vez só. Queda de menos de 5 minutos não gera incidente e não aparece. Câmeras marcadas como inexistentes ficam de fora. O botão ⓘ ao lado da caixa resume isso na própria tela.

Exportar CSV e abrir no Excel

  • ⬇ Exportar CSV usa os mesmos filtros e traz todas as câmeras do recorte (mesmo as que não couberam na tela), uma linha por câmera e por dia: data, usina, cluster, NVR, câmera, disponibilidade (%), tempos em minutos, quedas e a observação "sem dados" quando for o caso.
  • Dê duplo clique no arquivo: o Excel abre já em colunas, com acentos, datas no formato dd/mm/aaaa e vírgula decimal.
  • Se abrir tudo numa coluna só (Excel configurado em outro idioma), use Dados → De Texto/CSV, escolha a origem UTF-8 e o delimitador ponto e vírgula.

13Saúde da imagem

Estado: recurso desligado por padrão — peça ao administrador do sistema para ativar; ao ligar, ele começa em modo sombra (só mede e mostra, sem abrir alarme). Quem usa: quem enxerga Relatórios; o ↺ Reaprender é de administrador.

Acha a câmera cega: a que está online (o NVR diz que ela está bem), mas não enxerga nada útil. O sistema tira uma foto de poucas câmeras por minuto, em rodízio, e compara com a imagem de referência daquela câmera. Fica em Relatórios → Câmeras e NVRs offline, no bloco Saúde da imagem, logo abaixo da tabela de quedas.

O que significa cada problema

  • obstruída/coberta: boa parte da imagem ficou lisa, sem detalhe — lente tampada, saco, teia grossa, sujeira.
  • fora de foco: a imagem perdeu nitidez em relação ao normal dela — lente embaçada, molhada ou foco desregulado.
  • pouca luz: imagem quase toda escura — IR queimado, iluminação apagada. Não vale para câmera térmica.
  • cena alterada: a câmera está olhando outra coisa — foi virada, derrubada ou trocada. Não vale para câmera PTZ, que se move de propósito.

A Situação de cada câmera é Imagem comprometida (confirmada em várias verificações ruins seguidas), Suspeita (verificação ruim ainda não confirmada — o sistema refaz em poucos minutos), Imagem OK ou Aprendendo (ainda montando a referência). Por padrão a lista mostra só as comprometidas e suspeitas; Mostrar todas as câmeras verificadas traz as outras.

O que fazer quando uma câmera aparece

  • Clique em 📷 Ver agora para ver a imagem atual (fica registrado na auditoria).
  • Se a imagem está mesmo ruim, acione a manutenção da usina (limpeza, ajuste, troca).
  • Se a câmera foi reposicionada ou trocada de propósito, um administrador usa ↺ Reaprender: a referência antiga é descartada e o alarme aberto é encerrado. Não use para "calar" uma câmera que está de fato ruim.
Modo sombra x alarme. Em modo sombra a lista aparece aqui, mas nenhum alarme é aberto. Só quando o administrador liga a segunda etapa é que a câmera comprometida vira o alarme 🌫️ Imagem comprometida na Central (e no sino), que fecha sozinho quando a imagem volta. Câmera térmica é verificada também, mas pega menos casos (desfoque leve e cobertura parcial passam com mais facilidade).

14Fora do padrão

Estado: recurso desligado por padrão (peça ao administrador do sistema para ativar) e, quando ligado, sempre em modo observação: não notifica, não abre alarme e não mexe em nenhum alarme. Quem usa: quem enxerga Relatórios; marcar Relevante/Ruído pede o papel de operador ou acima, e reiniciar o padrão é de administrador.

Detecção de anomalia por estatística: aponta quando uma câmera teve intrusão num horário em que quase nunca tem ("Atividade rara") ou muito mais eventos do que o normal dela ("Pico"). Compara cada hora com as últimas 8 semanas da mesma câmera, no mesmo dia da semana e hora. Não olha a imagem e não é aprendizado de máquina — é contagem.

Como ler

  • Em Relatórios, abra o card 🧭 Fora do padrão, escolha período, usina, câmera, tipo ou marcação e clique em ▶ Gerar.
  • Cada ocorrência traz Quando, a Câmera, o Tipo, o Esperado × agora e uma Explicação em português (por exemplo: "nas últimas 8 terças, das 03h às 04h, houve intrusão nesta câmera em 0 delas; desta vez: 3 eventos").
  • 🔔 Ver alarme(s) abre os alarmes daquela hora no mesmo pop-up da Central; 📊 Padrão mostra o mapa da semana da câmera (de "quase nunca" a "quase sempre"), com a hora da ocorrência contornada.
  • Câmera com menos de 4 semanas de histórico ou com eventos de menos ainda não é avaliada — a tela diz isso.

Marcar relevante ou ruído

  • ✔ Relevante: valia a pena olhar. ✖ Ruído: não valia (animal, mantenedor, vento...). O ✎ grava uma nota curta. Clicar de novo no mesmo botão desfaz. Toda marcação fica registrada na auditoria.
  • O resumo mostra a Precisão (marcadas) — relevantes entre as marcadas. É esse número que vai dizer, um dia, se a função merece virar notificação. Por isso vale marcar o máximo possível.
  • ↺ Reiniciar o padrão desta câmera (dentro do 📊 Padrão, só administrador): use só quando a câmera mudou de lugar ou de configuração de propósito. O histórico recomeça e ela fica sem avaliação até juntar 4 semanas.
Onde ele erra mais. Câmera térmica à noite (animal quente no campo vira "atividade rara"), obra ou rotina nova (marca por algumas semanas até o padrão absorver) e câmera recém-cadastrada (ainda sem avaliação). Movimento simples (VMD) não entra.

15IA no alarme

Estado: recurso desligado por padrão — só o administrador do sistema ativa, e sempre primeiro em modo sombra (a IA só indica). Quem usa: o selo e o filtro aparecem para quem vê a Central; o relatório de qualidade é de administrador.

Um filtro de falso alarme: quando o alarme ganha a foto, a foto é enviada a um serviço externo de IA (Gemini, do Google), que diz se vê pessoa, veículo, animal ou nada. O envio só acontece depois que o administrador ativar a função.

Selo e filtro na Central

  • O card ganha o selo 🤖 com o veredito: 🚶 pessoa, 🚗 veículo, 🐾 animal ou ∅ nada detectado (passe o mouse para ver a confiança). Na lista e no detalhe aparece por extenso, por exemplo "🤖 Pessoa · 87%".
  • No painel de filtros, o campo IA filtra por veredito — IA: nada detectado junta os alarmes em que a IA não viu ninguém, o primeiro lugar para procurar falso alarme.
  • No detalhe do alarme, o bloco IA (revalidação da foto) mostra o veredito e o que foi detectado. Alarme sem foto aparece como "foto indisponível para a IA".

Relatório de qualidade (administrador)

O botão 🤖 Qualidade da IA, na barra da Central, compara o veredito da IA com a decisão de quem tratou o alarme, em 7, 30 ou 90 dias. O número que importa é "reais que a IA viu vazios": precisa ser zero. A tabela por limiar mostra quantos alarmes seriam tirados da fila em cada nível de confiança, e quantos deles eram reais.

O que NUNCA muda sozinho. Em modo sombra a IA não muda status de nenhum alarme. O veredito nunca apaga alarme. Incêndio e fumaça, câmera térmica, câmera estratégica (⭐) e alarme fixado (📌) nunca são tirados da fila pela IA. Um modo que tira da fila os alarmes "nada detectado" existe, mas só é ligado por decisão do dono do sistema, depois do período em sombra.

Se um dia a supressão for ligada: como desfazer

  • O alarme tirado da fila mostra "suprimido pela IA" no detalhe. O botão ↩ Desfazer supressão da IA devolve ele à fila; fica registrado nas Atividades. Precisa da permissão "Desfazer supressão da IA num alarme" no seu Papel.
  • Para desfazer de uma vez tudo o que a IA tirou nas últimas horas, peça ao administrador do sistema (não há botão na tela para isso).
  • Desfazer devolve o alarme à fila, mas não desfaz notificação que já tinha saído (Telegram, e-mail, sino): a IA olha a foto depois que o alarme já foi avisado.

16Incêndio e fumaça

Estado: recurso desligado por padrão — peça ao administrador do sistema para ativar; o reconhecimento dos eventos de fogo e fumaça das câmeras ainda precisa ser confirmado com câmera real em cada instalação. Quem usa: todos que veem a Central; as regras-modelo são criadas por administrador.

Para câmeras térmicas com detecção de fogo (e de fumaça, nos modelos que têm), o Greyes trata o evento como prioridade máxima.

O que é crítico

  • Incêndio e fumaça entram como Crítico, prioridade Alta, com selo 🔥.
  • Aparecem sempre: mesmo sem regra cadastrada, com a usina ou a câmera silenciada, fora da vigência da regra e no Telegram fora do horário noturno. Ganham foto e clipe. Só a pausa manual do próprio alarme continua valendo.
  • Alarme de temperatura recebe nome e cor próprios, mas não é crítico: segue os filtros normais, porque as térmicas das usinas geram muito alarme de temperatura.

Onde ver

  • Na Central de Alarmes, a categoria 🔥 Incêndio e fumaça (no painel de filtros) junta incêndio, fumaça e temperatura.
  • Também aparecem no card ⚡ Eventos em tempo real, no sino, na linha do tempo do Dashboard e no resumo diário.

Regras-modelo (administrador)

Em Regras de Alarme, o administrador vê o botão 🔥 Modelo incêndio/fumaça (N a criar). Ele cria, depois de você confirmar, uma regra de incêndio e uma de fumaça em cada usina que ainda não tem. Usinas que já têm ficam como estão; quando não falta nenhuma, o botão diz "regras criadas".

Nenhuma ação externa automática. As regras-modelo fazem só pop-up, foto e clipe. Telegram, e-mail e push seguem as rotas de notificação que já existem. Sirene/relé, áudio, webhook ou aviso à central de monitoramento não são criados sozinhos: se a usina quiser, quem opera acrescenta na regra, caso a caso.

17API pública e webhooks

Estado: API e webhooks assinados desligados por padrão — peça ao administrador do sistema para ativar (dá para preparar chaves e endereços antes). Quem usa: administrador, em Administração → API e webhooks, com as permissões de "Chaves da API pública" e "Webhooks assinados" no Papel.

Dois caminhos para um sistema de fora (central de monitoramento, BI, sistema do cliente) conversar com o Greyes: a API, para ele consultar usinas, câmeras, alarmes e disponibilidade (e reconhecer alarme), e os webhooks assinados, para o Greyes avisar quando um alarme é criado, reconhecido ou concluído. O topo da tela mostra se cada um está ligado. Os detalhes técnicos para quem vai integrar estão no documento docs/api-publica.md — mande esse documento para o desenvolvedor do outro lado.

Chaves da API

  • + Nova chave: dê um nome que diga quem vai usar (ex.: "Central X").
  • Marque os escopos — só o que o sistema precisa: listar usinas, listar câmeras e NVRs, listar e consultar alarmes, reconhecer alarme (com justificativa) e disponibilidade por câmera e dia.
  • Em Usinas que a chave enxerga, marque só as usinas daquele cliente. Você só consegue marcar usinas do seu próprio acesso.
  • Ajuste o limite de requisições por minuto (padrão 60) e, se quiser, a data em que a chave expira. Clique em Criar chave.
  • A chave aparece uma única vez: use Copiar e entregue por um canal seguro. O Greyes não guarda a chave em si; quem perdeu, ganha uma nova.
  • Revogar corta o acesso na hora. A lista mostra o último uso e o estado (ativa, revogada, expirada).
Desativar um usuário não revoga as chaves que ele criou. A chave pertence à integração, não à pessoa: quando uma integração acabar, revogue a chave dela.

Webhooks assinados

  • O endereço (URL) é cadastrado antes, em Sistema → Endereços de webhook. Ele aparece na tabela Webhooks assinados; clique em Ativar assinatura.
  • Escolha os eventos (alarme criado, reconhecido, concluído), as usinas e marque Ativo. Ao salvar, o segredo de assinatura é mostrado uma vez: entregue a quem recebe, para ele conferir a assinatura de cada envio.
  • Enviar teste manda um evento de teste na hora (funciona mesmo com tudo desligado) e diz se o outro lado respondeu.
  • Trocar segredo: escolha por quanto tempo o segredo antigo continua valendo junto com o novo (24 horas, 3 ou 7 dias, 1 hora) — assim quem recebe troca sem perder nada. Se o segredo vazou, escolha Cortar agora.
  • Alarme escondido pelo filtro "sem regra" da Central não vira webhook.

Entregas e reenvio

  • A tabela Entregas de webhook mostra cada envio: quando, endereço, evento, estado (na fila, entregue, falhou, cancelada), tentativas e a última resposta. Filtre por estado ou endereço; Ver mostra o conteúdo enviado.
  • Sem resposta de sucesso, o Greyes tenta de novo sozinho, com intervalos cada vez maiores. Esgotadas as tentativas, fica falhou: corrija o outro lado e use Reenviar.
Verificar a assinatura é trabalho de quem recebe: cada envio leva o cabeçalho X-Greyes-Signature, calculado com o segredo. Quem recebe deve recusar envio com assinatura errada ou velha (mais de 5 minutos) e descartar repetidos. O passo a passo, com exemplo pronto, está em docs/api-publica.md.

18Centrais de monitoramento

Estado: recurso desligado por padrão e nenhuma central foi homologada ainda — cada central é homologada junto com o cliente antes de ligar; peça ao administrador do sistema. Quem usa: administrador sem restrição de usina, em Administração → Centrais de monitoramento, com as permissões de "Centrais de monitoramento" no Papel.

Manda os alarmes da Central para a receptora de uma central de monitoramento no padrão de mercado: SIA DC-09 com mensagem Contact ID ou SIA, por TCP ou UDP, com cifra opcional. Cada alarme visível na Central de uma usina com conta cadastrada vira um evento; quando o alarme é concluído, vai a restauração. Reconhecer não gera mensagem.

Cadastrar

  • + Nova central: nome, host e porta da receptora, transporte (TCP/UDP), formato (Contact ID ou SIA), receptor e linha, conta de supervisão e, se a central usar, a chave AES (depois de salva, a tela só mostra o tamanho). Todos esses dados vêm da própria central.
  • A central nasce desativada. Só marque Ativa depois da homologação.

Mapeamento de códigos

Em Editar → Mapeamento tipo de alarme → código, cada tipo de alarme do Greyes tem um código Contact ID e um SIA, e pode ser ligado ou desligado. Já vêm ligados intrusão (perímetro, entrada/saída), incêndio, fumaça, temperatura alta, pânico, violação, câmera offline e NVR sem comunicação. Ficam desligados os de muito volume (movimento, mudança de cena) e os alarmes TMA/TMPA das térmicas, até o significado deles ser confirmado — mandar código errado para a central é pior do que não mandar. Os códigos são um ponto de partida: ajuste com o que a central pedir.

Contas por usina

  • Em Contas, informe para cada usina a conta, a partição e a zona NVR (usada quando o alarme não é de uma câmera, como NVR sem comunicação). Usina sem conta não manda nada.
  • A zona de cada câmera é o canal dela no NVR. Se a central precisar distinguir câmeras de NVRs diferentes com o mesmo canal, use Zonas.

Teste e supervisão

  • Prévia monta a mensagem sem enviar, para conferir com a central.
  • Enviar teste (código 601 de teste manual) e Testar supervisão transmitem na hora — mesmo com tudo desligado — e dizem se a receptora respondeu (ACK).
  • Com a central ativa, o Greyes manda um sinal de vida (heartbeat) de tempos em tempos. Se a receptora parar de responder, abre o alarme "Central de monitoramento sem resposta", que fecha sozinho quando ela volta. A coluna Supervisão mostra "respondendo" ou "sem resposta".

Entregas

  • Entregas para as receptoras lista cada mensagem: central, o quê (evento ou restauração), sequência, estado e resposta. Sem resposta, o Greyes tenta de novo sozinho; esgotadas as tentativas, fica falhou e pode ser reenviada.
  • Central que recebe por HTTP em vez de receptora: em Webhooks com perfil "central", ligue o perfil num endereço que já tenha webhook assinado (veja a seção anterior) e escolha de qual central vêm as contas.
Cada central é homologada com o cliente. Antes de ativar: peça à central porta, TCP ou UDP, formato, receptor e linha, conta de teste e se usa cifra; cadastre desativada com uma usina de teste; faça Prévia, Enviar teste e Testar supervisão com a central na linha; gere um alarme real, confira conta, código, zona e horário do lado dela e a restauração. Só então ative. O roteiro completo está em docs/centrais.md.

19Dúvidas comuns

Uma câmera aparece sempre offline. Abra o card dela no Ao Vivo — o sistema mostra a última vez em que esteve online. Tente reconectar; se continuar offline, avise um administrador (costuma ser queda de energia ou rede no local).

A grade do Ao Vivo abriu vazia no celular. Feche e abra o aplicativo: ele busca a versão nova sozinho. Se persistir, confira se as câmeras daquele NVR estão online no Dashboard.

Não vejo um menu que um colega vê. As telas e as ações são liberadas pelo Papel. Peça a um administrador para revisar o seu Papel — a tela de Papéis (em Administração) é restrita a super administradores, e é lá que o resumo "o que este Papel permite fazer" mostra exatamente o que está liberado.

Sumiu um alarme da lista. A Central abre só com os alarmes ativos das últimas 24 horas. Abra ▾ Mostrar filtros e troque o Status para Todos (ou ⏱ Encerrados por tempo, se ele passou de 24 horas sem tratamento) e o Período para o que precisar. Nada é apagado.

Recebi alarme demais da mesma câmera. Peça o ajuste da carência da regra daquela câmera, ou uma regra de silêncio para a janela de manutenção. Desligar a regra deixa a câmera sem cobertura.

Perdi o aparelho do 2FA. Entre com um código de recuperação no campo do código; se não tiver mais, peça a um super administrador para zerar o 2FA da sua conta.

Preciso de um vídeo para ocorrência policial. Em Vídeo → Gravação, arraste na linha do tempo para marcar o trecho e use 🔒 Exportar com cadeia de custódia, preenchendo o motivo. O arquivo sai com hash e fica registrado quem exportou. O "⬇ Baixar trecho" é mais rápido, mas serve só para uso interno — não vale como evidência.

Quero achar o que aconteceu num período sem ficar olhando câmera parada. Em Vídeo → Gravação, marque Apenas com alarmes e dê play: só aparecem as câmeras no minuto em que elas alarmaram, e elas somem sozinhas depois.

Não encontro uma das funções novas (disponibilidade por câmera, saúde da imagem, fora do padrão, IA no alarme, incêndio e fumaça, API, centrais). Elas nascem desligadas e só aparecem depois que o administrador do sistema ativar — e, mesmo ligadas, seguem o seu Papel. Cada seção deste guia diz o estado e quem pode usar.

Preciso de ajuda humana. Clique no ícone de ajuda na barra superior e escolha Falar com o Suporte — há WhatsApp e e-mail da GR Consultoria.

Quero reportar um problema que estou vendo na tela. No mesmo menu de ajuda, escolha Reportar problema (com print). Descreva o que está acontecendo, escolha a prioridade (Baixa, Média, Alta ou Urgente) e clique em Enviar chamado: o sistema tira um print da tela em que você estava e abre o chamado para a GR Consultoria já com a imagem anexada. O número do chamado aparece na confirmação. Se não conseguir tirar o print (câmeras ao vivo, por exemplo, podem sair em preto), o chamado segue só com o texto.