Esta seção detalha os principais processos de negócio do NexarGrid, ilustrando como os diferentes serviços interagem para completar tarefas complexas.

# Ciclo de Vida da Escala (Shift Lifecycle)

O diagrama abaixo ilustra o fluxo completo de uma escala médica, desde o planejamento inicial até o faturamento e pagamento final.

Gerando diagrama...

# Descrição das Etapas

1. Rascunho (Draft):

   • O gestor cria um pacote de escalas (ShiftPack) para uma unidade e mês.
   • Adiciona itens de plantão (ShiftItem) e define os médicos (Rostered).
   • O sistema valida regras de negócio (ex: descanso mínimo, especialidade) através do serviço de Collision.

2. Publicação:

   • Após validação, o gestor publica a escala.
   • O serviço PublishFSM orquestra a transição, notificando os médicos envolvidos.
   • A escala passa a ser imutável em sua estrutura base, permitindo apenas trocas e ajustes operacionais.

3. Execução (Runtime):

   • Ocorre o dia-a-dia da escala.
   • Médicos realizam check-in/check-out (serviço Attendance).
   • Podem ocorrer trocas de plantão, que requerem aprovação.

4. Consolidação e Pagamento:

   • Ao final do ciclo, a escala é auditada.
   • O serviço Billing calcula os valores baseados nas regras de pagamento (Payment Rules).
   • O status final transita para Faturado e posteriormente Pago.

# Validação de Conflitos e Colisões

Um dos diferenciais críticos do NexarGrid é seu robusto sistema de detecção de colisões (Collision Service). Diferente de sistemas simples que validam apenas a sobreposição de horários dentro da mesma escala, o NexarGrid realiza uma validação cruzada em todo o ecossistema.

# Lógica de Verificação

Quando um plantão é adicionado ou modificado, o sistema verifica:

1. Sobreposição Temporal (time_overlap): O médico já possui outro plantão no mesmo intervalo de horário?
2. Conflito Inter-Projetos: A verificação abrange todos os projetos e grades onde o médico está cadastrado. Isso impede que um profissional seja escalado no “Hospital A” e na “Clínica B” simultaneamente.
3. Regras de Descanso: Verifica se o intervalo entre o fim de um plantão e o início do próximo respeita o descanso mínimo obrigatório (interjornada).

# Resolução de Conflitos

Ao detectar uma colisão, o sistema retorna um relatório detalhado (veja exemplo na Referência da API) contendo:

• Gravidade: Alta (impeditiva) ou Baixa (aviso).
• Contexto Completo: Nome do projeto, unidade e grade onde ocorre o conflito.
• Detalhes do Turno Conflitante: Dia da semana, horário e local do outro compromisso.

Isso permite que o gestor tome uma decisão informada: substituir o médico, ajustar o horário ou, em casos permitidos, forçar a alocação assumindo o risco.