Integração DOMOCAM (Monitoramento HQVT)
A integração DOMOCAM conecta o ACCELERO a câmeras DOMOCAM com reconhecimento facial. Os dispositivos identificam pessoas, e o ACCELERO recebe esses eventos em tempo real, registra-os, gera logs de acesso e dispara notificações (pop-up, e-mail, Telegram e MQTT) conforme o tipo de evento e o nível de alerta da câmera.
Esta integração é disponibilizada como plugin (hqvt, internamente identificado como HQVT) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 2.1.0 — compatível com ACCELERO 2.17.0 ou superior.
O que a integração faz
Com o plugin ativo, as câmeras DOMOCAM passam a se comunicar com o ACCELERO. O sistema sincroniza os templates faciais das pessoas para os dispositivos e recebe de volta os eventos de reconhecimento, transformando-os em registros e logs de acesso.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Cadastro de dispositivos | Cada câmera DOMOCAM é registrada como um device com IP, porta, credenciais, gateway de comunicação e área associada |
| Sincronização de templates faciais | As fotos das pessoas (conforme categorias configuradas) são enviadas às câmeras para reconhecimento |
| Recebimento de eventos | Pessoa conhecida, pessoa bloqueada e pessoa desconhecida são recebidas e armazenadas como eventos DOMOCAM |
| Geração de logs de acesso | Cada evento de reconhecimento gera um log de acesso no ACCELERO, passando pela regra de verificação de acesso |
| Monitoramento em tempo real | Tela de monitor que exibe os eventos conforme chegam, com a imagem capturada |
| Notificações | Pop-up ao operador, e-mail, Telegram e MQTT, filtrados por tipo de evento e nível de alerta |
| Última vez vista | Registra no cadastro da pessoa o horário e o dispositivo da última identificação |
Transforma câmeras de reconhecimento facial DOMOCAM em pontos de controle de acesso integrados ao ACCELERO, com logs, monitoramento e alertas centralizados.
Configuração
Caminho de acesso: Configurações > DOMOCAM
A tela é organizada em abas: Reconhecimento facial, Gateways, Configurações, Sincronizar templates e Limpar armazenamento.
Aba Configurações
Define o comportamento de notificações e armazenamento.
| Campo | Descrição |
|---|---|
| Qual evento deve gerar Pop-up de alerta? | Multi-seleção dos tipos de evento que geram pop-up de alerta ao operador: Acesso permitido, Acesso bloqueado e Acesso negado |
| Deseja receber as notificações no Telegram? | Habilita o envio de notificações por Telegram |
| Deseja receber notificações por e-mail? | Habilita o envio de notificações por e-mail |
| Deseja receber notificações por MQTT? | Habilita a publicação de notificações por MQTT no tópico `{FACILITY}/io/domocam/{DEVICEID}/{known,unknown,blocked}` |
| Categorias | Categorias de pessoas cujos templates faciais são sincronizados com os dispositivos |
| Categorias para baixa automática | Categorias cujos templates são removidos automaticamente dos dispositivos |
| Exceção de baixa automática | Categorias que ficam de fora da baixa automática |
| Qual o tamanho do espaço que será reservado para as imagens DOMOCAM? (MB) | Espaço em disco reservado para as imagens capturadas pelos eventos |
Quando o limite de armazenamento é atingido, o sistema remove automaticamente a imagem mais antiga ao salvar uma nova, mantendo o uso de disco sob controle.
Aba Sincronizar templates
Permite enviar manualmente os templates faciais para os dispositivos selecionados.
| Botão | Função |
|---|---|
| Testar envio de templates | Conta quantos templates seriam enviados, sem fazer o envio (dry-run) |
| Re-enviar templates | Sincroniza os templates faciais das pessoas elegíveis para os dispositivos selecionados |
| Excluir todos | Exclui todos os cadastros faciais dos dispositivos selecionados |
Aba Limpar armazenamento
Exclui todas as imagens armazenadas pelos eventos DOMOCAM.
A limpeza de armazenamento não pode ser desfeita. O botão exige confirmação por captcha antes de executar.
Cadastro de dispositivos DOMOCAM
Caminho de acesso: Configurações > DOMOCAM, aba Reconhecimento facial
Cada câmera DOMOCAM é cadastrada como um dispositivo. A listagem permite criar, editar, pesquisar e excluir dispositivos.
O formulário de inclusão (botão Novo device) pede descrição, IP, porta, gateway, usuário, senha e Device ID. Localização, nível de alerta, Atualizar área e Sincronizar apenas as categorias ficam na edição do dispositivo.
Campos do dispositivo
| Campo | Descrição |
|---|---|
| Descrição | Nome de identificação do dispositivo |
| Ativo | Define se o dispositivo está ativo (apenas dispositivos ativos sincronizam templates) |
| Endereço IP | IP da câmera DOMOCAM |
| Porta | Porta de comunicação |
| Gateway | Gateway de comunicação responsável por intermediar a troca de mensagens com a câmera |
| Usuário | Usuário de acesso à câmera |
| Senha | Senha de acesso (deixe em branco para não alterar dados existentes) |
| Device ID | Identificador do dispositivo na câmera DOMOCAM |
| Qual a localização da DOMOCAM? | Área associada ao dispositivo — usada para o log de acesso e atualização de localização da pessoa |
| Qual o nivel de alerta desejado? | Nível de alerta da câmera: Nível de alerta leve, Nível de alerta médio ou Nível de alerta alto. É usado para filtrar quais operadores recebem notificações |
| Atualizar área | Chave exibida no cadastro. Veja a observação abaixo sobre o comportamento na versão 2.1.0 |
| Sincronizar apenas as categorias | Restringe a sincronização de templates a categorias específicas neste dispositivo |
A câmera DOMOCAM se comunica com o ACCELERO através de um gateway (configurado na aba Gateways). Cadastre o gateway antes de associá-lo ao dispositivo.
Campos adicionados às entidades
O plugin estende o cadastro de Pessoa e o de Operador com dados específicos da DOMOCAM.
Pessoa
No cadastro de pessoa, o plugin adiciona o campo:
| Campo | Descrição |
|---|---|
| DOMOCAM - Status da pessoa | Permitido ou Bloqueado. Define se a pessoa é tratada como bloqueada no reconhecimento DOMOCAM |
Operador
No cadastro de operador, o plugin adiciona a seção Domocam:
| Campo | Descrição |
|---|---|
| Usuário Telegram | Usuário do Telegram (@) que recebe as notificações |
| Qual o nivel de alerta desejado? | Multi-seleção dos níveis de alerta (leve, médio, alto) que o operador deseja receber por e-mail/Telegram |
Um operador só recebe a notificação de uma câmera se o nível de alerta configurado na câmera estiver entre os níveis que o operador selecionou no seu cadastro.
Monitor DOMOCAM
Caminho de acesso: Logs > Monitor DOMOCAM
Tela de monitoramento (Monitorar eventos DOMOCAM) que exibe os eventos de reconhecimento conforme chegam, em tempo real.
Como funciona
- Clique em Monitorar para iniciar a recepção de eventos em tempo real. O botão muda para Interromper monitoramento.
- Cada novo evento aparece no topo da lista com os dados e as imagens: a foto do cadastro da pessoa e a imagem capturada pela câmera, lado a lado. A lista mantém os últimos eventos recebidos.
- Eventos de pessoa bloqueada são destacados em vermelho; eventos de pessoa desconhecida, em amarelo.
Filtros
Os filtros ficam no botão Filtros....
| Filtro | Descrição |
|---|---|
| Dispositivos | Filtra por uma ou mais câmeras DOMOCAM |
| Tipo de Evento | Filtra por tipo de evento de reconhecimento |
O botão Salvar filtros guarda a preferência de filtros no navegador, para que ela seja reaplicada na próxima visita.
Dados exibidos por evento
Tipo do evento, horário, similaridade, nome, nome do dispositivo e a imagem capturada.
Log DOMOCAM
Caminho de acesso: Logs > Log DOMOCAM
Histórico completo de todos os eventos DOMOCAM recebidos, com filtros (botão Pesquisar) e detalhamento.
Filtros
| Filtro | Descrição |
|---|---|
| Grupo | Tipo de evento de reconhecimento |
| Devices | Uma ou mais câmeras DOMOCAM |
| Nome da pessoa | Pesquisa pelo nome da pessoa |
| Data/hora início e Data/hora fim | Recorte por período |
Colunas
Data e hora, tipo, metadata (dados serializados do evento) e ações.
Detalhamento do evento
Ao abrir um evento, o ACCELERO exibe: tipo do evento, horário, similaridade, nome, nome do dispositivo, ID da pessoa e a imagem capturada.
Tipos de evento
As câmeras DOMOCAM enviam diferentes tipos de evento. O ACCELERO os classifica assim:
| Tipo (rótulo na tela) | Significado |
|---|---|
| Pessoa conhecida | Pessoa reconhecida e com acesso permitido |
| Pessoa bloqueada | Pessoa reconhecida, porém marcada como bloqueada |
| Pessoa desconhecida | Captura de rosto não identificado no cadastro |
As câmeras também enviam mensagens de keep-alive (heartbeat) para sinalizar que estão online. Esses sinais são registrados como eventos do tipo HeartBeat, mas não geram log de acesso nem notificação.
Como os eventos viram log de acesso
Quando uma câmera DOMOCAM reconhece uma pessoa, o ACCELERO gera automaticamente um log de acesso:
- O sistema identifica a pessoa a partir do dado enviado pela câmera.
- Se a pessoa não for encontrada no cadastro, é gerado o log Acesso negado - Pessoa desconhecida DOMOCAM.
- Se a pessoa for encontrada, o ACCELERO aplica a regra de verificação de acesso sobre a área do dispositivo:
- Acesso autorizado → gera o log Acesso autorizado - DOMOCAM e atualiza a área atual da pessoa para a área da câmera.
- Acesso não autorizado → gera o log com o código de negação correspondente.
No código atual do plugin, a área atual da pessoa é atualizada em todo acesso autorizado, mesmo com a chave Atualizar área desligada no dispositivo. Considere isso ao posicionar câmeras em áreas que não devem mexer na lotação.
O dispositivo DOMOCAM é tratado como um canal de controle virtual: a área associada à câmera é usada como destino do acesso, e a verificação segue as mesmas regras de acesso do ACCELERO.
Notificações
A cada evento elegível, o plugin pode disparar notificações por diferentes canais. O envio depende das opções habilitadas na aba Configurações e do filtro por tipo de evento e nível de alerta.
| Canal | Quando dispara |
|---|---|
| Pop-up | Para os tipos de evento marcados em "Qual evento deve gerar Pop-up de alerta?" |
| Quando habilitado; enviado aos operadores cujo nível de alerta corresponde ao da câmera | |
| Telegram | Quando habilitado; enviado aos operadores com Telegram configurado |
| MQTT | Quando habilitado; publicado no tópico `{FACILITY}/io/domocam/{DEVICEID}/{known,unknown,blocked}` |
Exemplo do e-mail de notificação "Evento de segurança detectado DOMOCAM!" recebido por um operador. Pendente: na versão 2.1.0 o corpo gerado sai com Nome do dispositivo vazio (o plugin busca o dispositivo pelo nome em vez do ID) e com o marcador %%MESSAGE%% sobrando no fim.
Configure câmeras críticas com nível de alerta alto e, no cadastro dos operadores, selecione quais níveis cada um deve receber. Assim, um evento de uma câmera de alto risco só notifica quem precisa ser acionado.
Casos de uso
Habilitar uma câmera DOMOCAM
- Solicitar à IONGRADE a instalação do plugin
hqvt. - Em
Configurações > DOMOCAM, cadastrar o gateway de comunicação. - Na aba Reconhecimento facial, cadastrar a câmera (IP, porta, credenciais, Device ID, área e nível de alerta).
- Na aba Configurações, selecionar as categorias cujas pessoas devem ser reconhecidas e ajustar as notificações.
- Na aba Sincronizar templates, usar Testar envio de templates e depois Re-enviar templates.
- Acompanhar o Monitor DOMOCAM para validar a chegada dos eventos.
Investigar um acesso negado
- Acessar Log DOMOCAM e filtrar pela pessoa e pelo período.
- Abrir o evento para ver tipo, similaridade, dispositivo e a imagem capturada.
- Verificar se a pessoa está no cadastro, vinculada a uma categoria sincronizada, e se a regra de acesso da área permite a entrada.
Acompanhar a portaria em tempo real
- Abrir Monitor DOMOCAM e clicar em Monitorar.
- Opcionalmente, filtrar por dispositivos e tipos de evento e salvar a preferência.
- Acompanhar os reconhecimentos: bloqueados (vermelho) e desconhecidos (amarelo) ganham destaque.
Boas práticas
- Categorias específicas: sincronize apenas as categorias de pessoas que devem ser reconhecidas pelas câmeras, evitando enviar templates desnecessários aos dispositivos.
- Gateway antes do dispositivo: cadastre e valide o gateway de comunicação antes de associar a câmera.
- Teste antes do envio real: use Testar envio de templates (dry-run) antes de sincronizar os templates de verdade.
- Níveis de alerta coerentes: padronize o uso de níveis (leve/médio/alto) entre câmeras e operadores para que as notificações cheguem a quem precisa.
- Controle de armazenamento: ajuste o tamanho do espaço reservado para imagens conforme o volume de eventos, lembrando que as imagens mais antigas são removidas ao atingir o limite.
Troubleshooting
Eventos não aparecem no Monitor
Possíveis causas:
- Gateway de comunicação offline ou mal configurado
- Dispositivo inativo ou com IP/porta/credenciais incorretos
- Navegador incompatível com o monitoramento em tempo real
Solução:
- Verifique o status do gateway na aba Gateways.
- Confirme IP, porta, usuário, senha e Device ID na edição do dispositivo.
- Confirme que o dispositivo está Ativo.
Reconhecimentos não geram log de acesso
Possíveis causas:
- Pessoa não está no cadastro do ACCELERO (gera "Acesso negado - Pessoa desconhecida DOMOCAM")
- Pessoa não vinculada a uma categoria sincronizada
- Regra de acesso da área nega a entrada
Solução:
- Confirme o cadastro da pessoa e o vínculo de categoria.
- Verifique a área associada ao dispositivo e a regra de acesso dessa área.
- Reenvie os templates pela aba Sincronizar templates.
Operador não recebe notificações
Possíveis causas:
- Canal de notificação (e-mail/Telegram/MQTT) desabilitado na aba Configurações
- Nível de alerta da câmera não está entre os selecionados pelo operador
- Tipo do evento não está marcado para gerar pop-up
Solução:
- Verifique os switches de notificação na aba Configurações.
- Confira o nível de alerta da câmera e os níveis selecionados no cadastro do operador.
- Para pop-up, confirme o tipo de evento em "Qual evento deve gerar Pop-up de alerta?".
Integração com outros módulos
Pessoas e Categorias
A sincronização de templates depende do cadastro de Pessoas (com foto facial) e da configuração de categorias. Apenas pessoas das categorias selecionadas têm seus templates enviados às câmeras.
Áreas
Cada dispositivo é associado a uma Área, que define o destino do acesso e pode ser atualizada como localização atual da pessoa quando o reconhecimento ocorre.
Logs e Eventos
Cada reconhecimento gera um log de acesso. Consulte Logs e Monitoramento para entender como esses eventos aparecem no histórico de acessos.
Próximos Passos
- Pessoas — Cadastre as pessoas com foto facial e o status DOMOCAM
- Áreas — Associe cada câmera a uma área de destino
- Logs e Monitoramento — Acompanhe os logs gerados pelos reconhecimentos
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO