Controle de Acesso (Leitoras)¶
A tela de Controle de Acesso permite gerenciar os dispositivos de controle de acesso do condomínio, como leitoras faciais, de cartão e QR Code. Através desta tela você pode cadastrar, monitorar e operar leitoras de forma centralizada.
Objetivo desta tela
Gerenciar dispositivos de controle de acesso (leitoras), monitorar status em tempo real, executar comandos operacionais (reiniciar, sincronizar usuários/horário) e visualizar usuários e cartões sincronizados em cada equipamento.
Visão Geral da Tela¶
Ao acessar a tela de Controle de Acesso, você encontra:
- Painel de Status Global: Cards de monitoramento em tempo real do Sentinela (gateway)
- Cards de filtro rápido: Estatísticas e filtros visuais por status das leitoras
- Barra de ferramentas: Botões para as principais ações (Novo, Criar Múltiplos, Filtros, Exportar, Colunas, Busca, Relatório, Opções, Ajuda)
- Campo de busca: Permite localizar leitoras por IP, localização ou modelo
- Tabela de leitoras: Lista todos os dispositivos cadastrados com informações de status em tempo real
- Paginação: Controles para navegar entre as páginas de resultados
Status Global do Sentinela¶
O painel no topo da página exibe informações em tempo real sobre a infraestrutura de controle de acesso:
| Card | Descrição |
|---|---|
| Status da Internet | Indica a conexão do gateway Sentinela com a internet |
| Latência da Internet | Exibe a latência média da conexão com os dispositivos |
| Sistema de Filas | Mostra o status da conexão com o servidor de eventos (Kafka) |
Além disso, são exibidos:
- Última atualização: Data e hora da última telemetria recebida
- Eventos no período: Quantidade de eventos registrados no período
Atualização Automática
Os dados de status são atualizados automaticamente em intervalos regulares, sem necessidade de recarregar a página.
Cards de Filtro Rápido¶
Os cards funcionam como filtros e exibem estatísticas em tempo real:
| Card | Descrição |
|---|---|
| Todas | Exibe todas as leitoras cadastradas |
| Ativas | Filtra leitoras com status ativo |
| Inativas | Filtra leitoras desativadas |
| QR Code | Filtra dispositivos que aceitam QR Code |
| Visitantes | Filtra leitoras configuradas para liberar visitantes |
Dica
Clique em qualquer card para aplicar automaticamente o filtro correspondente na tabela.
Cadastrar Nova Leitora¶
Para cadastrar uma leitora individualmente:
- Clique no botão Novo na barra de ferramentas
- Preencha os campos do formulário:
Campos do Formulário¶
| Campo | Obrigatório | Descrição |
|---|---|---|
| Ativa | Sim | Define se a leitora está ativa (Sim/Não) |
| Localização | Sim | Nome ou descrição do local onde a leitora está instalada (máximo 255 caracteres) |
| Endereço IP | Sim | Endereço IP do dispositivo na rede (máximo 15 caracteres) |
| Porta | Não | Porta de comunicação (padrão: 80) |
| Modelo do Equipamento | Sim | Modelo do dispositivo (selecione da lista) |
| Prioridade | Não | Ordem de prioridade para sincronização (padrão: 1) |
| Admin Login | Não | Usuário administrativo do dispositivo |
| Password | Não | Senha do dispositivo |
| Usa QR Code | Sim | Define se o dispositivo aceita leitura de QR Code (Sim/Não) |
| Libera visitante | Sim | Define se a leitora pode liberar visitantes (Sim/Não) |
| Possui item de reserva | Sim | Define se a leitora está vinculada a um espaço de reserva (Sim/Não) |
| Item de reserva | Não | Espaço de reserva vinculado (habilitado apenas se "Possui item de reserva" = Sim) |
Configurações Avançadas de Conexão¶
| Campo | Descrição |
|---|---|
| Tentativas de reconexão | Número de tentativas em caso de falha (padrão: 3) |
| Delay entre tentativas (ms) | Intervalo entre tentativas em milissegundos (padrão: 5000) |
| Timeout padrão (ms) | Tempo máximo de espera por resposta (padrão: 15000) |
| URL de verificação | Endpoint para health check do dispositivo (padrão: /) |
| Status de verificação | Código HTTP esperado na verificação (padrão: 200 - OK) |
- Clique em Cadastrar para finalizar
Gerar Senha Segura
Use o botão Gerar senha segura para criar automaticamente uma senha forte para o dispositivo.
Cadastrar Múltiplas Leitoras¶
Para registrar várias leitoras de uma só vez:
- Clique no botão Criar Múltiplos na barra de ferramentas
- Visualize as instruções de formato clicando em Formato e exemplo de dados
- Cole os dados no campo de texto ou faça upload de arquivo CSV
Formato dos Dados (CSV)¶
Cada linha deve conter os seguintes campos separados por vírgula:
| Campo | Descrição |
|---|---|
| Localização | Nome do local da leitora (obrigatório) |
| IP | Endereço IP do dispositivo (obrigatório) |
| Modelo | Modelo do equipamento (obrigatório) |
| Usa QR Code | S para Sim, N para Não (obrigatório) |
| Libera Visitante | S para Sim, N para Não (obrigatório) |
Exemplo de dados CSV
Portaria Principal, 192.168.0.10, Modelo NX-100, S, N
- Opcionalmente, selecione um Modelo padrão a ser aplicado
- Clique em Validar Dados para verificar o formato
- Clique em Criar em lote para registrar todas as leitoras
Limite de Registros
O sistema permite cadastrar até 20 leitoras por operação em lote.
Modelos de Arquivo
Use os botões Copiar Exemplo ou Baixar CSV de Exemplo para obter o modelo de dados correto.
Busca e Filtros¶
Utilize o campo de busca para localizar leitoras por:
- Endereço IP
- Localização
- Modelo do equipamento
Para buscas mais específicas:
- Clique no botão Filtros na barra de ferramentas
- Configure os critérios desejados:
| Filtro | Descrição |
|---|---|
| IP | Filtrar por endereço IP |
| Localização | Filtrar por nome do local |
| Modelo | Filtrar por modelo do equipamento |
| Fornecedor | Filtrar por fabricante |
| Status | Filtrar por status (Ativa/Inativa) |
| Usa QR Code | Filtrar por suporte a QR Code |
| Possui item de reserva | Filtrar por vínculo com espaço de reserva |
| Recurso | Filtrar por recursos específicos |
| Libera visitante | Filtrar por permissão de visitantes |
| Criada em (De/Até) | Filtrar por período de cadastro |
- Clique em Aplicar Filtros para visualizar os resultados
- Use Limpar Filtros para remover todos os critérios
- Use Salvar Filtro para guardar uma configuração frequentemente utilizada
Tabela de Leitoras¶
A tabela exibe os registros com informações de monitoramento em tempo real:
| Coluna | Descrição |
|---|---|
| Seleção | Checkbox para seleção de registros |
| ID | Identificador único da leitora |
| Ativa | Status de ativação do dispositivo |
| Localização | Nome do local de instalação |
| Endereço IP | IP do dispositivo na rede |
| Modelo | Modelo do equipamento |
| Fornecedor | Fabricante do dispositivo |
| Latência | Tempo de resposta em tempo real (atualização a cada 15s) |
| Sincronização do Horário | Status da sincronização de relógio (tempo real) |
| Sync Usuários | Status da sincronização de usuários (tempo real) |
| Admin | Status de verificação do admin (checagem diária) |
| Eventos | Status de eventos (checagem diária) |
| Ações | Menu de ações disponíveis |
Indicadores de Tempo Real¶
A tabela exibe indicadores que são atualizados automaticamente:
- TEMPO REAL (15S): Dados atualizados a cada 15 segundos
- CHECAGEM DIÁRIA: Dados verificados uma vez por dia
Ordenação e Paginação¶
- Clique nos cabeçalhos das colunas para ordenar os registros
- Na parte inferior, selecione a quantidade de registros por página (padrão: 10)
- Navegue entre páginas usando os botões de navegação
Configuração de Colunas¶
Personalize as colunas visíveis na tabela:
- Clique no botão Colunas na barra de ferramentas
- Marque ou desmarque as colunas desejadas
Colunas Disponíveis¶
| Coluna | Visível por Padrão | Obrigatória |
|---|---|---|
| Seleção | Sim | Sim |
| ID | Sim | Não |
| Ativa | Sim | Não |
| Localização | Sim | Sim |
| Endereço IP | Sim | Sim |
| Modelo | Sim | Não |
| Fornecedor | Sim | Não |
| QR Code | Não | Não |
| Saúde (Tempo Real) | Sim | Não |
| Latência (Tempo Real) | Sim | Não |
| Sincronização do Horário (Tempo Real) | Sim | Não |
| Sincronização de Usuários (Tempo Real) | Sim | Não |
| Admin (Tempo Real) | Sim | Não |
| Eventos (Tempo Real) | Sim | Não |
| Ações | Sim | Sim |
- Clique em Aplicar Configuração para salvar
Limite de Colunas
O sistema permite no máximo 20 colunas visíveis simultaneamente.
Restaurar Padrão
Use o botão Padrão do Sistema para restaurar a configuração original de colunas.
Menu de Ações da Leitora¶
Cada registro possui um menu de ações acessível pelo botão na última coluna:
| Ação | Descrição |
|---|---|
| Ver detalhes | Exibe modal com informações completas da leitora |
| Editar | Abre formulário para atualização dos dados |
| Desativar/Ativar | Alterna o status de ativação da leitora |
| Reiniciar | Envia comando de reboot ao dispositivo |
| Sincronizar usuários | Abre tela para visualizar ou executar sincronização de usuários |
| Sincronizar horário | Ajusta o relógio do dispositivo com o servidor |
| Ver usuários | Lista todos os usuários sincronizados na leitora |
| Ver cartões | Lista todos os cartões cadastrados no dispositivo |
| Ver relés | Visualiza configuração de relés do dispositivo |
| Excluir todos os usuários | Remove todas as biometrias, faces e cartões da leitora física |
| Histórico de Auditoria | Visualiza registro de alterações da leitora |
| Excluir | Remove a leitora do sistema |
Atenção
A ação Excluir todos os usuários remove permanentemente todas as biometrias, faces e cartões do dispositivo físico. Esta operação não pode ser desfeita.
Ver Detalhes da Leitora¶
O modal de detalhes exibe informações completas organizadas em seções:
Informações Básicas¶
- ID, Localização, IP, Porta e Status
Equipamento¶
- Modelo, Fornecedor, Login Admin e Prioridade
Funcionalidades¶
- QR Code, Libera Visitante e Item de Reserva
Configurações de Conexão¶
- Tentativas (Retry), Delay entre Tentativas e Timeout Padrão
Health Check¶
- URL e Status Code Esperado
Auditoria¶
- Datas e responsáveis pela criação e última modificação
Sincronizar Usuários¶
A opção Sincronizar usuários no menu de ações abre uma tela com duas opções:
Simula a sincronização e exibe:
- Usuários que seriam adicionados
- Usuários que seriam removidos
- Usuários que seriam atualizados
Nenhuma alteração é aplicada ao dispositivo.
Aplica as alterações na leitora física:
- Adiciona novos usuários
- Remove usuários excluídos
- Atualiza dados modificados
Dica
Sempre visualize as alterações antes de executar a sincronização para confirmar as mudanças que serão aplicadas.
Operações em Lote¶
Para executar ações em múltiplas leitoras simultaneamente:
- Selecione as leitoras desejadas usando os checkboxes na primeira coluna
- Ou use o checkbox no cabeçalho para selecionar todas
- Utilize os botões de ação em lote disponíveis para:
- Reiniciar múltiplas leitoras
- Sincronizar usuários em lote
- Excluir várias leitoras
Menu Opções¶
O botão Opções na barra de ferramentas oferece funcionalidades adicionais:
| Opção | Descrição |
|---|---|
| Todos Usuários | Visualiza e busca usuários sincronizados em todas as leitoras |
| Todos Cartões | Visualiza e busca cartões cadastrados em todas as leitoras |
| Jobs Automáticos | Configura sincronização automática de leitoras |
| Logs do Sentinela | Visualiza logs do gateway de controle de acesso |
| Gerenciar Fornecedores | Cadastra e edita fabricantes de equipamentos |
| Gerenciar Modelos | Cadastra e edita modelos de leitoras |
| Mostrar Tour Guiado | Exibe o tour de apresentação da tela |
Todos Usuários¶
Acessível pelo menu Opções > Todos Usuários:
- Visualize todos os usuários sincronizados em todas as leitoras
- Filtre por leitora específica
- Filtre por perfil (administrador ou usuário comum)
- Filtre por status de coleta facial
- Solicite visualização de face
- Remova usuários de leitoras específicas
Todos Cartões¶
Acessível pelo menu Opções > Todos Cartões:
- Visualize todos os cartões cadastrados em todas as leitoras
- Filtre por leitora específica
- Filtre por tipo de cartão (normal, master, coação)
- Filtre por valor do cartão
- Remova cartões de leitoras específicas
Ver Cartões de uma Leitora¶
Acessível pelo menu Ações > Ver cartões de cada leitora:
- Visualize todos os cartões/credenciais cadastrados no dispositivo
- Filtre por valor do cartão
- Filtre por tipo (normal, master, coação)
- Remova cartões diretamente
Exportação de Dados¶
Para exportar a lista de leitoras:
- Clique no botão Exportar na barra de ferramentas
- Selecione o formato desejado:
| Formato | Descrição |
|---|---|
| Documento formatado para impressão | |
| CSV | Planilha com valores separados por vírgula |
| XLSX | Planilha do Microsoft Excel |
Observação
A exportação respeita os filtros aplicados. Para exportar todos os registros, limpe os filtros antes.
Dúvidas Frequentes (FAQ)¶
O que é o Sentinela?
O Sentinela é o gateway de comunicação entre o sistema Morador Online e as leitoras físicas instaladas no condomínio. Ele gerencia a conexão, envia comandos e recebe eventos dos dispositivos.
Com que frequência os dados de tempo real são atualizados?
Os indicadores marcados como "TEMPO REAL (15S)" são atualizados a cada 15 segundos. Os indicadores de "CHECAGEM DIÁRIA" são verificados uma vez por dia.
Qual a diferença entre 'Visualizar' e 'Executar' na sincronização de usuários?
A opção "Visualizar" simula a sincronização e mostra quais alterações seriam feitas, sem aplicar nenhuma mudança. A opção "Executar" aplica efetivamente as alterações na leitora física.
O que acontece ao 'Excluir todos os usuários' de uma leitora?
Esta ação remove permanentemente todas as biometrias, faces e cartões armazenados no dispositivo físico. Os dados no sistema são mantidos, mas a leitora não reconhecerá mais nenhum usuário até uma nova sincronização.
Posso cadastrar várias leitoras de uma vez?
Sim. Use o botão "Criar Múltiplos" e cole os dados em formato CSV ou faça upload de um arquivo. O limite é de 20 leitoras por operação.
O que é um 'Item de reserva' vinculado à leitora?
É um espaço de reserva do condomínio (salão de festas, academia, etc.) que está protegido por esta leitora. Quando vinculada, a leitora pode controlar o acesso baseado nas reservas ativas do espaço.
Como reiniciar uma leitora remotamente?
Acesse o menu Ações da leitora desejada e clique em Reiniciar. O comando de reboot será enviado ao dispositivo.
Resumo Rápido¶
Gestão de Leitoras de Controle de Acesso
- Monitore o Status Global do Sentinela no painel superior
- Use os cards de filtro rápido para visualizar leitoras por status
- Clique em Novo para cadastrar uma leitora
- Preencha os campos obrigatórios: localização, IP e modelo
- Use Criar Múltiplos para cadastros em lote via CSV
- Aplique Filtros Avançados para buscas específicas
- Configure as Colunas visíveis conforme sua necessidade
- Use Exportar para gerar documentos consolidados
- Acesse o menu Ações para gerenciar cada leitora individualmente
- Utilize o menu Opções para funcionalidades avançadas como visualizar todos os usuários/cartões e configurar jobs automáticos