Histórico de Senhas e Exportação

A vista de histórico de senhas permite aos administradores rever todas as senhas que passaram por uma fila — com filtros de estado e data, paginados por keyset para filas grandes — e exportar o conjunto filtrado dessa fila como um ficheiro CSV.

Ver o histórico de senhas (admin)

1. No admin, abra um estabelecimento e vá ao separador Registo de senhas na sub-navegação.
2. A lista mostra todas as senhas das filas do estabelecimento, 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)
   • Registo de data/hora de criação
   • Registo de data/hora da última atualização
3. Filtre por estado e/ou intervalo de datas usando os controlos acima da lista.
4. Percorra ou pagine para carregar mais resultados. A paginação é estável — novas senhas que cheguem enquanto navega não deslocam a página.

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

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

O pessoal 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 saltado, ou verificar o estado a meio da fila.

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

Nota

A consulta no balcão tem âmbito na fila a que o balcão está atribuído. Uma senha de outra fila no mesmo estabelecimento 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 transmite o resultado como um descarregamento de ficheiro. Exportações grandes são transmitidas em fragmentos — o descarregamento é concluído sem armazenar todo o conjunto de dados em memória.

O que a exportação contém: cinco campos por senha — número, estado, balcão que chamou, registo de data/hora de criação e registo de data/hora da última atualização. A exportação tem âmbito na fila selecionada; as anotações do pessoal (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 aplicações de folha de cálculo.

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