v beta-2.0.1 Released

Visão Geral do Sistema: NexarGrid para ImedGroup

05 de janeiro de 2026
beta-2.0.1
Time Técnico NexarSystems

O NexarGrid representa a evolução tecnológica na gestão de escalas médicas de alta complexidade. Desenvolvido especificamente para atender às demandas operacionais do ImedGroup, o sistema transcende as limitações das planilhas tradicionais e softwares monolíticos, oferecendo uma arquitetura distribuída, resiliente e orientada a eventos.

# Propósito e Escopo

O objetivo primário do NexarGrid é orquestrar a alocação de profissionais de saúde em múltiplas unidades, garantindo conformidade regulatória, otimização de recursos e transparência operacional. O sistema atua como a “fonte da verdade” para todas as operações de agendamento, desde o planejamento estratégico de longo prazo até a gestão tática de trocas de plantão em tempo real.

# Diferenciais Técnicos

  • Arquitetura de Microsserviços: Decomposição funcional em serviços autônomos (ShiftPack, Roster, Collision), permitindo escalabilidade horizontal e isolamento de falhas.
  • Validação Cruzada de Conflitos: Motor de detecção de colisões (Collision Service) que opera em nível global, impedindo que um mesmo profissional seja alocado simultaneamente em unidades distintas do grupo, garantindo a integridade da força de trabalho.
  • Imutabilidade e Auditoria: Utilização de padrões de Event Sourcing para rastrear cada mudança de estado na escala, oferecendo uma trilha de auditoria completa e imutável.

# Estágio Maturacional e Homologação

Atualmente na versão beta-2.0.1, a plataforma NexarGrid encontra-se em um estágio avançado de homologação assistida e refatoração estratégica. Este ciclo de vida é caracterizado por uma interação contínua e iterativa com os stakeholders chave do ecossistema ImedGroup.

# Ciclo de Validação com POs Médicos

O desenvolvimento do produto é estritamente guiado pelas diretrizes de Product Owners (POs) Médicos e gestores de escala de alta performance (heavy-users). Esta abordagem garante que:

  1. Aderência Operacional: As funcionalidades desenvolvidas refletem a realidade complexa dos plantões, e não apenas requisitos teóricos.
  2. Refatoração Orientada a Feedback: Módulos críticos, como o Grid de Agendamento e o Motor de Colisões, sofrem refatorações constantes baseadas em testes de carga reais e cenários de borda identificados pelos usuários especialistas.
  3. Aprovação Granular: Nenhuma feature é promovida para o ambiente de produção (GA - General Availability) sem a validação explícita de usabilidade e eficiência por parte do comitê médico.

Este período de “beta” não denota instabilidade técnica, mas sim uma flexibilidade arquitetural intencional, permitindo ajustes rápidos nas regras de negócio e fluxos de interface para atingir o “Product-Market Fit” interno antes da expansão para todas as unidades da rede.

# Contexto Operacional

No ecossistema ImedGroup, o NexarGrid posiciona-se como o núcleo operacional, integrando-se futuramente com o iMedNet (CRM proprietário do iMedGroup) e plataformas de gestão financeira.

# Atores Principais

  1. Gestores de Escala: Responsáveis pelo planejamento macro e publicação das grades mensais.
  2. Médicos: Usuários finais que interagem via aplicativo móvel para visualizar agendas, solicitar trocas e realizar check-in/check-out.
  3. Administradores do Sistema: Supervisores que configuram regras de negócio, unidades e permissões de acesso.

# Glossário Técnico e de Negócio

Para garantir a precisão na comunicação entre times técnicos e operacionais, definimos os seguintes termos fundamentais, categorizados por domínio:

# Entidades de Escala (Core Domain)

Termo Definição Técnica Contexto de Negócio
ShiftPack Agregado raiz que define um padrão de recorrência de escalas. Contém a configuração de slots, regras de rotação e metadados da escala. O “esqueleto” da escala (ex: “Escala de Segunda-feira da UTI”). Define como a escala funciona, não os plantões individuais de uma data.
Slot Intervalo de tempo abstrato definido dentro de um ShiftPack (ex: start: 07:00, end: 19:00). O “buraco” na agenda que precisa ser preenchido. Ex: “Vaga Diurna” ou “Vaga Noturna”.
ShiftItem Instância concreta de um plantão gerada a partir de um Slot para uma data específica. Possui estado (Draft, Published, Assigned). O plantão real que aparece no calendário (ex: “Plantão do dia 25/01/2025 das 07h às 19h”). É o item que gera pagamento.
Grid Estrutura hierárquica que agrupa múltiplos ShiftPacks. Pertence a uma Unidade (Project). O “quadro de avisos” digital de um setor (ex: “Grade da UTI Adulto” ou “Grade do Pronto Socorro”).
Rotation Lógica algorítmica que determina a distribuição de profissionais em ciclos (semanal, quinzenal, mensal). A regra de repetição (ex: “Dr. João trabalha nas semanas ímpares, Dra. Maria nas pares”).

# Atores e Participantes

Termo Definição Técnica Contexto de Negócio
Rostered Entidade que representa um profissional alocável. Vinculado a um User de autenticação, mas com atributos específicos de escala (especialidade, custo). O médico ou profissional de saúde cadastrado e apto a pegar plantões.
Client Entidade de nível superior na hierarquia (Tenant). O grupo hospitalar ou organização contratante (ex: “ImedGroup”).
Project / Unit Subdivisão de um Client. Representa uma unidade física ou lógica de custo. O hospital ou clínica específica (ex: “Hospital Santa Catarina”, “Unidade Morumbi”).

# Regras e Validações

Termo Definição Técnica Contexto de Negócio
Collision Evento gerado pelo CollisionDetector quando duas alocações violam restrições de integridade (ex: sobreposição temporal). Conflito de agenda. Ocorre quando um médico tenta pegar dois plantões ao mesmo tempo ou em locais distantes sem tempo de deslocamento.
PaymentRule Objeto de valor (Value Object) acoplado ao ShiftItem que define as regras de remuneração. A regra de pagamento do plantão (ex: “Valor fixo de R$ 1.200,00” ou “Valor hora + Adicional Noturno”).
Event Sourcing Padrão de persistência onde o estado é derivado de uma sequência de eventos imutáveis. Histórico completo e auditável. Permite “voltar no tempo” para saber quem alterou a escala e quando.

Esta documentação destina-se a desenvolvedores, arquitetos de software e gestores técnicos envolvidos na manutenção, integração e evolução da plataforma NexarGrid.