Agenda

Para que serve

É o calendário da clínica, em /dashboard/schedule. Cada agendamento prende um paciente, um profissional e um serviço a um dia e a um horário, opcionalmente dentro de uma sala. É onde a recepção marca, remarca, cancela e registra presença.

Antes de começar

A clínica precisa de ao menos uma unidade e um serviço cadastrados. E o profissional precisa ter o serviço marcado como especialidade dele, na tela de Profissionais: sem isso ele até aparece na busca do diálogo, mas some dela assim que você escolhe um "Serviço", e não há como marcar um atendimento sem serviço.

Como fazer

O topo da tela alterna entre "Dia", "Semana" e "Mês", com as setas de período ao lado e um botão "Hoje" para voltar. Logo abaixo ficam os filtros: "Unidade", "Sala" (que só habilita depois de escolher a unidade e traz "Sem sala" como último item), "Profissional", "Paciente", e as pastilhas de status, que você clica para ligar e desligar cada uma.

Para marcar, clique em "Novo agendamento" ou direto no horário vago da grade, que já vem preenchido com o dia e a hora clicados. O diálogo "Novo agendamento" pede "Paciente", "Profissional", "Serviço", "Unidade", "Sala", "Duração (min)", "Data", "Horário" e "Observações". Clique em "Salvar".

Para um horário fixo, ligue "Repetir semanalmente" no mesmo diálogo. Marque os "Dias da semana", informe "A cada N semana(s)" e escolha o "Término", que pode ser "Em uma data" ou "Após N ocorrências".

Clique no card de um agendamento para abrir o popover. Ele mostra o paciente, o horário, se aquilo se repete, e os seis status para marcar presença: "Agendado", "Confirmado", "Em atendimento", "Atendido", "Faltou" e "Desmarcado". No rodapé estão "Editar" e "Cancelar agendamento".

Para remarcar, arraste o card para o novo dia, horário ou, na visão "Dia", para outra sala. É a mesma edição do diálogo, só que pelo arrasto.

O que costuma surpreender

Conflito avisa, não bloqueia. Antes de salvar, a tela confere o horário contra todo agendamento não cancelado que divida o mesmo profissional, a mesma sala ou o mesmo paciente. Se achar algum, mostra "Conflito de horário" com a lista do que colide e o motivo de cada linha ("profissional ocupado", "sala ocupada", "paciente já tem agendamento nesse horário"). Você pode voltar e ajustar, ou clicar em "Salvar mesmo assim" e seguir. É decisão da clínica, não do sistema: a recepção sabe de coisas que o sistema não sabe. Dois detalhes que economizam susto: agendamento já desmarcado nunca conta como conflito, e horários colados, um terminando 09:50 e o outro começando 09:50, não conflitam.

Editar uma ocorrência não é editar a série. Uma série não é uma regra guardada em algum lugar: ela vira agendamentos de verdade na grade, um por ocorrência. Por isso, ao clicar em "Editar" ou em "Cancelar agendamento" sobre uma ocorrência que ainda pertence à série, a tela pergunta antes o escopo, com três opções:

• "Somente este" - "Altera apenas este agendamento. Os demais da série continuam como estão."
• "Este e os futuros" - "Altera este agendamento e todos os futuros da série. Os anteriores não mudam."
• "Todos" - "Altera todas as ocorrências futuras da série, mantendo o histórico passado."

Escolher "Somente este" solta aquela ocorrência da série para sempre. A partir dali ela não acompanha mais nenhuma mudança feita nas outras, e o popover passa a dizer "Ocorrência editada: não acompanha mudanças da série." O que decide se o passado é alcançado é o escopo, não o verbo. "Este e os futuros" e "Todos" são limitados ao futuro, tanto para editar quanto para cancelar: nenhum dos dois volta atrás, porque mexer retroativamente destruiria o histórico de presença. "Somente este" não tem esse limite, e também nos dois casos: ele mexe naquela linha e só nela, então clicá-lo sobre uma ocorrência que já passou edita mesmo o atendimento passado, e cancelar por ali desmarca mesmo o atendimento passado. Vale igual para um agendamento avulso, que não tem série nem pergunta de escopo: "Cancelar agendamento" desmarca a ocorrência clicada, tenha ela acontecido ou não.

A especialidade restringe o que a tela oferece, não o que o motor aceita. Escolher o profissional limita o "Serviço" às especialidades dele; escolher o serviço limita a busca de profissional a quem atende aquilo. O filtro só vale nesse sentido: enquanto nenhum serviço estiver escolhido, a busca lista todo profissional ativo, inclusive quem não tem especialidade nenhuma. Ele aparece, mas some da lista no instante em que você escolhe o "Serviço", e como o serviço é obrigatório, o agendamento não fecha. É a causa comum do "o profissional estava lá e sumiu". E isso é filtro de tela, não regra do motor: agendamentos antigos com um par profissional e serviço que hoje não estaria vinculado continuam válidos, e ao editar um deles o serviço já escolhido continua na lista.

O calendário pinta a mudança antes do servidor responder. Ao arrastar, o card muda de lugar na hora. Se o servidor recusar, ele volta sozinho para onde estava e a tela mostra o motivo. Vale para criar, trocar status, cancelar e arrastar uma ocorrência; criar ou editar uma série inteira não é pintado, porque quais ocorrências existem é decisão do servidor.

Uma série existe até 180 dias à frente, e só. As ocorrências são gravadas nesse horizonte e vão sendo estendidas conforme alguém navega o calendário para frente. Não existe processo noturno: quem estende é a própria navegação.

Quem enxerga

Módulo Agenda. Leitura abre o calendário, os filtros e o popover, com a lista de status apenas informativa e sem "Novo agendamento", "Editar" nem "Cancelar agendamento". Completo faz tudo: criar, editar em qualquer escopo, arrastar, cancelar e marcar presença. A linha de cobertura de convênio dentro do popover depende de Leitura no módulo Convênios, e o interruptor "Atendimento particular (não consumir convênio)" depende de Leitura em Convênios mais Completo em Agenda.