Como decisões de processo, responsabilidade e arquitetura foram transformadas em uma solução real sem depender de um pacote de funcionalidades pré-definido.
O cenário
A operação já utilizava um sistema especializado que concentrava informações essenciais. Substituí-lo não fazia sentido. Ao mesmo tempo, equipes operacionais precisavam consumir esse contexto dentro de uma plataforma própria, junto com fluxos e controles que o sistema original não tinha sido desenhado para executar.
A primeira decisão: definir a fonte de verdade
Antes da integração, foi necessário deixar claro quais informações pertenciam ao sistema especialista e quais pertenciam à plataforma Nexus. Essa separação evita que dois sistemas passem a competir pela mesma responsabilidade e reduz reconciliações manuais.
Leitura não é o mesmo que escrita
A arquitetura tratou consulta, transformação, decisão e eventual escrita como capacidades distintas. Ler uma reserva, por exemplo, não significa que a plataforma operacional deve se tornar responsável por alterar aquela reserva. Essa distinção protege governança e reduz o risco de uma integração tecnicamente funcional produzir inconsistência.
Normalização e contexto operacional
Dados de origem foram transformados para o contexto necessário aos módulos internos. O objetivo não era apenas copiar campos, mas interpretar o que a operação precisava enxergar e manter regras consistentes sobre usuários, unidades, ocupação e outras dimensões operacionais.
Resiliência e observabilidade
Integrações reais falham. Por isso, o sistema foi evoluindo com tratamento de erros, novas tentativas, atualização de contexto e mecanismos para evitar que uma indisponibilidade temporária do sistema fonte quebrasse a experiência operacional inteira.
O aprendizado do case
Uma boa integração não é medida pela quantidade de endpoints conectados. Ela é medida pela clareza de responsabilidade entre sistemas, pela previsibilidade quando existe divergência e pela capacidade de diagnosticar o que aconteceu. Automatizar uma regra confusa apenas torna a inconsistência mais rápida.