Passes de acesso

Passes de acesso: o que faz e como funciona

Controle de acesso de uma obra. Não é uma lista de trabalhadores, mas a ligação entre a obra, as pessoas, as organizações, as zonas, os passes, as credenciais, os dispositivos e os eventos. Zonas: uma parte da obra, nível de acesso, responsável, regras (dias e horários, se é preciso treinamento ou habilitação e por quanto tempo). Passes: permanente, temporário, de visitante, de empreiteiro, restrito; o portador é um funcionário da empresa ou uma pessoa de “Contatos” com a organização da obra; bloqueio, revogação (o motivo é obrigatório), reemissão vinculada ao passe anterior.

Credenciais: RFID, NFC, QR ou um código próprio; um mesmo UID não pode estar em dois passes ativos, o QR contém um código aleatório e não dados da pessoa, e é desenhado na janela sem serviços externos. Uma única função no servidor decide o acesso e informa o motivo da recusa: cartão desconhecido, passe vencido, bloqueado ou revogado, fora do horário permitido, zona não autorizada, sem treinamento ou habilitação. O registro de acessos só aceita inclusões (gatilhos do banco de dados e dos endereços impedem edição e exclusão); os lançamentos manuais da segurança levam a marca “manual” e a assinatura do autor. Posto de segurança pelo celular: escanear um QR com a câmera (se o navegador permitir) ou digitar o número, ver a decisão em letras grandes, registrar a entrada ou a saída; uma recusa avisa a segurança uma vez por passe e zona a cada 10 minutos.

Empreiteiros: designar as pessoas da organização, as zonas, os prazos e um responsável, emitir e revogar passes em lote; o empreiteiro vê só os passes das suas pessoas. Passes que vencem nos próximos 7 dias são um problema da obra e um aviso diário para quem os emitiu. Quando a participação de uma organização termina, o app apenas avisa sobre os passes ativos dela, sem bloquear ninguém. Com honestidade sobre os limites: nenhum controlador, leitor ou catraca física foi conectado ou testado — o que foi testado é a lógica do software.

O dispositivo continua “desconectado” até enviar o sinal de vida por conta própria; só ele define que o sistema está “online”. O app não consegue abrir uma porta e não finge que consegue: a decisão volta ao dispositivo como resposta, e quem a executa é o equipamento. A conexão é um webhook com assinatura HMAC-SHA256 (server/adapters).