Este glossário define a terminologia padrão utilizada em todo o ecossistema NexarGrid. O uso preciso destes termos é obrigatório para manter a consistência entre a documentação, o código e a comunicação da equipe.

# Entidades de Domínio

# ShiftPack

A unidade fundamental de planejamento e publicação. Um ShiftPack encapsula todas as escalas de uma unidade específica para um período de tempo (geralmente um mês).

• Contexto: Planejamento, Faturamento.
• Imutabilidade: Após publicado, sua estrutura base é versionada.

# ShiftItem

A menor unidade indivisível de trabalho agendado. Representa um “slot” de plantão com data, hora de início, hora de fim e requisitos de qualificação.

• Relação: Pertence a um único ShiftPack.

# Rostered

O profissional de saúde (médico) alocado a um ShiftItem.

• Atributos: Possui especialidade, CRM e status de validação.

# Grid

A representação visual e lógica da matriz de escalas. O “Grid” é a interface onde ShiftItems e Rostereds se encontram.

# Processos e Estados

# Collision (Colisão)

Um estado de erro ou alerta gerado quando uma regra de negócio é violada durante a tentativa de alocação de um profissional.

• Tipos:
  • Hard Collision: Impede a alocação (ex: médico já escalado no mesmo horário em outra unidade).
  • Soft Collision: Gera alerta mas permite override (ex: intervalo de descanso reduzido, mas aceitável em emergência).

# Publish (Publicação)

A transição de estado de um ShiftPack de “Rascunho” (Draft) para “Publicado” (Published).

• Efeito: Dispara notificações, torna a escala visível no App móvel e ativa as regras de imutabilidade.

# Check-in / Check-out

Eventos de registro de ponto gerados pelo profissional via App móvel.

• Uso: Base para o cálculo de pagamento efetivo versus planejado.

# Infraestrutura e Arquitetura

# Event Sourcing

Padrão arquitetural onde o estado do sistema é determinado pela sequência de eventos que ocorreram, em vez de apenas o estado atual.

• Aplicação: Todas as mudanças em ShiftItems geram eventos auditáveis.

# Service Mesh

Camada de infraestrutura que gerencia a comunicação entre os microsserviços (MoleculerJS), provendo descoberta de serviço e balanceamento de carga.