Lista de espera: visão geral
A lista de espera registra pacientes que aguardam atendimento sem horário marcado. Quando surge uma vaga (um cancelamento, um encaixe), a clínica consulta essa fila para decidir quem chamar.
Três operações sobre um registro individual
| Operação | Finalidade |
|---|---|
POST /lista-espera/novo | Colocar um paciente na fila |
GET /lista-espera/{id} | Consultar um registro específico |
PUT /lista-espera/{id} | Alterar a observação, o profissional ou o tipo de consulta |
Um registro tem apenas quatro informações: o paciente, uma observação obrigatória, e opcionalmente o profissional desejado e o tipo de consulta.
O identificador retornado na criação é usado para consultar e alterar o registro.
O modelo: entrada e evento
O sistema registra separadamente a entrada na fila e os eventos de status:
ENTRADA NA FILA EVENTOS DE STATUS
paciente + profissional o histórico do que aconteceu
+ tipo de consulta com aquela entrada
│ │
│ ┌────────────────────────────────┤
│ │ evento 1: entrou na fila │
│ │ evento 2: foi agendado │
│ │ evento 3: voltou para a fila │ ◄── id retornado pelo POST
└──┴────────────────────────────────┘
O id da API identifica o evento. Quando o paciente sai da fila e é recolocado, a entrada é a
mesma e um novo id é gerado.
A observação pertence ao evento, por isso é obrigatória em toda alteração.
Uma entrada é o par paciente + profissional: o mesmo paciente pode estar na fila com profissionais diferentes, e sem profissional o paciente fica disponível para qualquer um. As regras de duplicidade estão em Usar a fila.
Situação do registro
A situação do registro (em espera, agendado, atendido, removido) é controlada pelo sistema e não faz parte da resposta. A situação do paciente pode ser acompanhada pela agenda dele.
A saída da fila ocorre automaticamente, por eventos do sistema. Ver Como o paciente sai da fila.