Agenda - Agendamento de Atendimentos

O Agenda é o serviço de agendamento. As organizações configuram recursos disponíveis, horários e feriados. Cidadãos agendam atendimentos online ou via totem.

Conceitos Principais

Agendas

Uma Agenda é o container de configuração de agendamento. Cada agenda tem suas próprias regras de disponibilidade, recursos e categorias.

Categorias e Recursos

• Categoria: Tipo de serviço que pode ser agendado (ex.: "Certidão de Nascimento", "Registro de Imóvel")
• Recurso: Unidade específica de agendamento dentro de uma categoria (ex.: "Guichê 1 - Documentos", "Cartório A")
• Localização: Local físico onde o serviço é prestado

Tipos de Documento

Se for necessária verificação de identidade, configure Tipos de Documento (ex.: CPF, RG, Passaporte).

Disponibilidade

A disponibilidade é determinada por:

Configuração	Descrição
Turnos de Trabalho	Dias da semana e horários em que cada recurso aceita agendamentos
Cota Diária	Máximo de agendamentos por dia por recurso
Feriados	Datas em que nenhum agendamento está disponível

Agendamentos

Um registro de Agendamento inclui:

Campo	Descrição
name	Nome do cidadão
email	E-mail de contato
phone	Telefone de contato
documentId	Número do documento
date	Data do agendamento (YYYY-MM-DD)
time	Horário (HH:MM)
resource	Recurso reservado
location	Local de atendimento
status	scheduled, confirmed, canceled, attended
code	Código único de agendamento (para referência do cidadão)
printingInfo	Texto para imprimir na confirmação

Guia do Operador

Configurar uma Categoria

1. Vá em Admin → Categorias → Nova
2. Defina nome, descrição e tipo de documento exigido (opcional)
3. Salve

Configurar um Recurso

1. Vá em Admin → Recursos → Novo
2. Selecione a categoria e a localização
3. Defina os Turnos de Trabalho (dias e horários)
4. Defina a Cota Diária (máximo de agendamentos por dia)
5. Salve

Gerenciar Feriados

1. Vá em Configurações → Feriados
2. Adicione datas de feriado - todos os recursos ficarão indisponíveis nessas datas

Visualizar Agendamentos

1. Vá em Agendamentos para uma lista com filtros (data, localização, status)
2. Vá em Calendário para uma visão calendário de todas as reservas

Exportação

A lista de agendamentos suporta exportação para CSV/Excel para relatórios.

Fluxo de Agendamento pelo Cidadão

1. Cidadão acessa o portal de agendamento (ou totem)
2. Seleciona categoria e recurso
3. A API retorna datas disponíveis (GET /api/agendas/{id}/dates)
4. Cidadão seleciona a data
5. A API retorna horários disponíveis (GET /api/agendas/{id}/times?date=YYYY-MM-DD)
6. Cidadão preenche dados pessoais e confirma
7. Agendamento é criado (POST /api/appointments)
8. Código de confirmação e resumo imprimível são retornados

Cancelamento

O cidadão pode cancelar usando o código de agendamento:

DELETE /api/appointments/{id}?code=CODIGO_DO_AGENDAMENTO

Operadores também podem cancelar pelo painel de administração.