Histórico de Senhas e Exportação

A vista de histórico de senhas permite consultar todas as senhas de uma fila. Você pode filtrar por estado e data e exportar o resultado em CSV. Filas grandes usam paginação por keyset.

Ver o histórico de senhas (admin)

1. No admin, abra um local e vá à aba Registro de senhas na subnavegação.
2. A lista mostra todas as senhas das filas do local, as mais recentes primeiro. Cada linha mostra:
   • Número da senha
   • Nome da fila
   • Estado (WAITING, CALLED, COMPLETED, SKIPPED, CANCELED, NO_SHOW)
   • Balcão que chamou (travessão para balcões de token estático)
   • Registro de data/hora de criação
   • Registro de data/hora da última atualização
3. Filtre por estado e/ou intervalo de datas usando os controles acima da lista.
4. Carregue mais resultados conforme necessário. A paginação é estável: novas senhas que chegam durante a consulta não mudam os resultados da página atual.

O acesso requer o papel de org-manager ou location-manager, e a vista tem escopo nos seus locais atribuídos.

Consultar uma senha pelo número (balcão)

A equipe pode consultar qualquer senha na fila associada pelo seu número — útil para responder “a senha 47 ainda é válida?”, chamar de volta um cliente pulado, ou verificar o estado a meio da fila.

1. No balcão, toque no link Procurar (ou no ícone de pesquisa).
2. Insira o número da senha e pressione Procurar.
3. O resultado mostra o estado atual da senha, os registros de data/hora e quaisquer anotações da equipe. A partir daqui, a equipe também pode chamar de volta uma senha SKIPPED ou marcá-la como ausência.

Nota

A consulta no balcão tem escopo na fila a que o balcão está atribuído. Uma senha de outra fila no mesmo local não é visível a partir desta vista.

Exportar dados de senhas (admin)

Para exportar senhas de uma fila:

1. Selecione uma fila e aplique os filtros de estado ou data que quiser na vista de histórico de senhas do admin.
2. Clique em Exportar CSV.
3. O servidor inicia o download. Em exportações grandes, envia o arquivo em partes sem manter todos os dados na memória.

O que a exportação contém: cinco campos por senha — número, estado, balcão que chamou, registro de data/hora de criação e registro de data/hora da última atualização. A exportação tem escopo na fila selecionada; as anotações da equipe (nome, número de pessoas, nota) não são incluídas.

Proteção contra injeção de fórmulas: os valores que começam por =, +, -, @, uma tabulação ou um retorno de carro recebem um prefixo de aspa simples, para que sejam apresentados como texto simples em aplicativos de planilha.

A rota de exportação é autenticada com a sua sessão de admin — o download começa de imediato no navegador, sem um pedido de login separado.