Grupos de acesso
Onde: menu Controle de Acesso → Grupos de Acesso.
Quem pode usar: administradores. As funções internas (adicionar/remover horário, adicionar/remover pessoas, sincronizar, excluir) podem ser liberadas ou bloqueadas separadamente por perfil — veja Usuários e permissões.
Para que serve
O grupo de acesso é a resposta a três perguntas: quem pode passar, por quais equipamentos e em quais dias e horários. É por meio dele que alunos, responsáveis e funcionários — com suas fotos de cadastro — são enviados às catracas e aos terminais de reconhecimento facial. É aqui que você "cadastra um acesso": cria o grupo, define os horários, escolhe os equipamentos, adiciona as pessoas e sincroniza.
A lista de grupos
| Coluna | O que mostra |
|---|---|
| Código | Número sequencial gerado pelo sistema |
| Nome | Nome do grupo |
| Ativo | Se o grupo está habilitado ou desabilitado |
| Status | Situação do envio das pessoas do grupo aos equipamentos: Ok (todas enviadas), Pendente (há envios em andamento) ou Erro (alguma pessoa falhou) |
A barra de ferramentas permite criar um NOVO grupo, exportar para Excel e pesquisar pelo nome.
O cadastro do grupo — três abas
O cadastro tem três abas. As abas Horários e Pessoas só aparecem depois que o grupo é salvo pela primeira vez.
Aba Grupo de Acesso
| Campo | Obrigatório | Para que serve |
|---|---|---|
| Código | Automático | Número de identificação gerado pelo sistema |
| Nome | Sim | Nome do grupo (ex.: "Alunos manhã", "Funcionários") |
| Desabilitado | Não | Marca o grupo como desabilitado |
| Dispositivos de Acesso | Não | Lista de equipamentos do grupo — marque cada catraca/terminal por onde as pessoas do grupo podem passar. Só aparecem equipamentos ativos |
TODO: VALIDATE — o efeito prático de marcar um grupo como Desabilitado nos equipamentos (se as pessoas do grupo deixam de ser aceitas na catraca).
Aba Horários
Define as janelas de horário por dia da semana em que o grupo tem passagem liberada:
- Selecione um ou mais dias da semana (Domingo a Sábado).
- Informe o horário inicial e o horário final.
- Clique em Adicionar — uma janela é criada para cada dia selecionado.
A grade abaixo lista as janelas já cadastradas (dia, início e fim), com botão para remover cada uma.
:::info Regra do sistema O sistema exige dia da semana, horário inicial e horário final ("Selecione o dia da semana", "Informe horário inicial", "Informe horário final") e recusa uma janela que já esteja coberta por outra existente no mesmo dia, mostrando a mensagem "Conflito de horário com [dia] [início] às [fim]". :::
Aba Pessoas
É onde você vincula quem faz parte do grupo. Há dois caminhos:
- Busca direta: procure a pessoa pelo nome no campo de busca e clique em Adicionar.
- Em lote, pelo menu ao lado do botão Adicionar:
- Alunos — filtre por ano letivo, turma e período, marque os alunos e clique em Adicionar. Só aparecem alunos com matrícula ativa ou pendente e com cadastro ativo.
- Responsáveis — mesma filtragem por ano/turma/período; lista os responsáveis dos alunos filtrados.
- Funcionários — lista os funcionários com cadastro ativo.
A grade de pessoas mostra foto, nome, telefone, e-mail e a coluna Pendente/Status de cada pessoa:
| Situação | Significado |
|---|---|
| Ok | A pessoa foi enviada com sucesso a todos os equipamentos do grupo |
| Pendente | O envio a algum equipamento ainda não foi concluído |
| Erro | O envio a algum equipamento falhou |
Clique na seta no início da linha da pessoa para expandir os detalhes por equipamento: qual equipamento, quando o registro foi criado e atualizado, o status e a mensagem de status — a explicação de um eventual erro.
Ações
- Adicionar / Remover pessoa: inclui ou tira a pessoa do grupo. Adicionar alguém que já está no grupo não cria duplicidade. Ao remover, o sistema atualiza os equipamentos automaticamente.
- Syncronizar (é assim que o botão aparece na tela): reenvia aos equipamentos as pessoas selecionadas na grade — marque uma ou mais pessoas e clique no botão. Use para reprocessar quem ficou em Erro ou Pendente. Sem seleção, o sistema avisa "Selecione pelo menos uma pessoa para sincronizar!".
- Barra de progresso: ao lado do botão de sincronizar, mostra o percentual de pessoas do grupo já enviadas com sucesso; atualiza sozinha a cada poucos segundos enquanto houver envio em andamento (o ícone de recarregar força a atualização).
- Excluir grupo (na lista): remove o grupo, desfaz os vínculos de todas as pessoas e instrui os equipamentos a se atualizarem.
Passo a passo — cadastrar um acesso completo
- Abra Controle de Acesso → Grupos de Acesso e clique em NOVO.
- Dê um Nome ao grupo e clique em Salvar — as abas Horários e Pessoas aparecem.
- Na aba Horários, cadastre as janelas de cada dia da semana.
- Volte à aba Grupo de Acesso, marque os Dispositivos de Acesso do grupo e clique em Salvar.
- Na aba Pessoas, adicione os alunos, responsáveis e funcionários.
- Acompanhe a coluna de status: as pessoas entram como Pendente e passam a Ok conforme os equipamentos confirmam o recebimento.
- Se alguém ficar em Erro, expanda a linha para ler a mensagem, corrija a causa, selecione a pessoa e clique em Syncronizar.
:::info Regra do sistema Toda alteração no grupo — salvar, trocar equipamentos, adicionar ou remover pessoas — é enviada automaticamente aos equipamentos vinculados. A foto do cadastro da pessoa é enviada junto: é ela que o terminal de reconhecimento facial usa para liberar a passagem. Por isso, capriche na foto do cadastro (veja Cadastros básicos). :::
:::info Regra do sistema Uma pessoa pode estar em mais de um grupo. Ao removê-la de um grupo, ela só é apagada de um equipamento se não pertencer a nenhum outro grupo que use aquele mesmo equipamento. :::
Problemas comuns
- O status fica Pendente e não muda. O equipamento pode estar offline ou o serviço de integração da escola pode estar parado. Verifique o status do equipamento na tela de Equipamentos e, se persistir, acione o suporte.
- Uma pessoa ficou em Erro. Expanda a linha da pessoa e leia a mensagem de status do equipamento que falhou. Uma causa frequente em terminais faciais é a foto do cadastro ausente ou inadequada — atualize a foto e sincronize de novo.
TODO: VALIDATE— a mensagem exata mostrada quando a pessoa não tem foto no cadastro. - O aluno não aparece na busca da janela Alunos. Confira o filtro de ano letivo/turma/período, se a matrícula está ativa ou pendente e se o cadastro da pessoa não foi desativado.
- Um equipamento não aparece na lista para vincular. Equipamentos desabilitados não são oferecidos — reative-o na tela de Equipamentos.
- Adicionei a pessoa mas a catraca não libera. Verifique se o horário atual está dentro de uma janela cadastrada para o dia, se o status da pessoa está Ok no equipamento em questão e se o equipamento certo está vinculado ao grupo.