Visão Geral do Sistema: NexarGrid para ImedGroup
Visão Geral do Sistema: NexarGrid para ImedGroup
NexarGrid Documentation • v beta-2.0.1
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:
- Aderência Operacional: As funcionalidades desenvolvidas refletem a realidade complexa dos plantões, e não apenas requisitos teóricos.
- 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.
- 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
- Gestores de Escala: Responsáveis pelo planejamento macro e publicação das grades mensais.
- Médicos: Usuários finais que interagem via aplicativo móvel para visualizar agendas, solicitar trocas e realizar check-in/check-out.
- 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.