NovoSGA - Gestão de Filas

O NovoSGA é o sistema central de gestão de filas. Gerencia todo o ciclo de vida de uma senha de atendimento: desde a distribuição no totem de triagem até a chamada, o atendimento e o encerramento na estação do atendente.

Conceitos Principais

Unidades

Uma Unidade é o container organizacional de nível superior - ex.: uma filial, prédio ou departamento. A configuração de fila é por unidade.

Serviços

Um Serviço define um tipo de atendimento oferecido (ex.: "Registro de Documentos", "Pagamento de Tributos"). Cada serviço pode ser atribuído a atendentes específicos.

Prioridades

As Prioridades definem os níveis de preferência das senhas (ex.: Normal, Idoso, PCD). Senhas com maior prioridade são chamadas antes das de menor prioridade.

Departamentos

Os Departamentos agrupam serviços dentro de uma unidade. Úteis para direcionar o cidadão ao grupo de serviços correto.

Ciclo de Vida da Senha (Atendimento)

[Triagem] → distribui → [AGUARDANDO]
                             ↓
[Atendente] → chamar → [CHAMADO]
                             ↓
             iniciar → [EM ATENDIMENTO]
                             ↓
             encerrar → [ENCERRADO / REDIRECIONADO]

Campos do Atendimento

Campo	Descrição
id	ID interno inteiro
status	Status atual (ver ciclo de vida)
resolucao	Código de resolução ao encerrar
dataChegada	Horário de chegada da senha
dataChamada	Horário em que foi chamada pela primeira vez
dataInicio	Horário de início do atendimento
dataFim	Horário de encerramento

Fila

A Fila é o estado em tempo real da fila numa unidade. Mostra quais senhas estão aguardando, sendo chamadas ou em atendimento para cada serviço.

Clientes

Registros opcionais de cliente vinculados a senhas. Incluem nome, e-mail, telefone e número de documento.

Agendamentos

Senhas pré-agendadas para um horário específico. São convertidas em atendimentos regulares quando o cidadão chega.

Atualizações em Tempo Real

O NovoSGA usa Mercure (protocolo server-sent events) para atualizações em tempo real. O endpoint raiz da API (GET /api) retorna a URL do hub Mercure. Assine os eventos para atualizar painéis de exibição e estações de atendimento ao vivo.

Painéis

As configurações dos painéis de exibição são armazenadas no NovoSGA, mas renderizadas pelo serviço de extensão Painel.

Triagem

A interface do totem de triagem é gerenciada pelo serviço de extensão Triagem. Ele chama o endpoint POST /api/distribui do NovoSGA para emitir novas senhas.

Autenticação

O NovoSGA usa OAuth2 com tokens emitidos pelo Mangati Cloud. O endpoint de token é local: POST /api/token.

Para totens de triagem e painéis de exibição, a autenticação por dispositivo é gerenciada via registro de dispositivo (consulte os guias do Triagem e do Painel).

Operações Comuns

Emitir Senha (via Triagem)

curl -X POST https://novosga.mangati.com/api/distribui \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "unidade": 1,
    "servico": 3,
    "prioridade": 1
  }'

Chamar Próxima Senha (Atendente)

curl -X POST https://novosga.mangati.com/api/atendimentos/456/chamar \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"local": 2, "numeroLocal": 1}'

Iniciar Atendimento

curl -X POST https://novosga.mangati.com/api/atendimentos/456/iniciar \
  -H "Authorization: Bearer TOKEN"

Encerrar Atendimento

curl -X POST https://novosga.mangati.com/api/atendimentos/456/encerrar \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "servicosRealizados": [3],
    "servicoRedirecionado": null,
    "novoUsuario": null
  }'

Webhooks

O NovoSGA envia webhooks para os serviços configurados (Monitor, Avaliação, Notificação) quando o status da senha muda. Configure os webhooks no painel de administração.