Arquitetura C4

Objetivo

Apresentar a arquitetura do SSDOi a partir dos dois primeiros diagramas do modelo C4, especificamente o contexto do sistema e seus principais containers.

Descreve-se a relação do SSDOi com partes interessadas, sistemas externos e blocos principais da solução. O detalhamento de requisitos, contratos, componentes e decisões de implementação está nas demais seções deste documento: Requisitos, Modelo Conceitual, Integrações, Dados e Parametrização e Serviços e Componentes.

Nível 1: Contexto do Sistema

O diagrama de contexto apresenta o SSDOi no ecossistema de análise e gestão de outorgas da ANA, destacando seus usuários, sistemas externos e fluxos principais de interação.

Principais elementos representados:

• Requerente de outorga: usuário que realiza a solicitação de outorga e acompanha o status por meio do REGLA/SEIRH.
• Analista de Outorga: usuário externo que revisa e aprova a análise de outorga.
• Gerente: usuário interno responsável por consultar e configurar métodos e parâmetros do SSDOi.
• REGLA/SEIRH: sistema externo de solicitação de uso da água e comunicação com o SSDOi.
• CNARH: sistema externo para dados de usuários e usos da água.
• SNISB: sistema externo para dados de barragens e reservatórios.
• SSDOi/ANA: sistema responsável por apoiar a decisão de outorgas, processando análises e interagindo com os sistemas externos.

Nível 2: Containers do Sistema

O diagrama de containers apresenta a decomposição do SSDOi em blocos de aplicação, serviços, bancos de dados e integrações.

Principais containers representados:

• Aplicação Web (SPA): interface web para consulta e atualização de configurações pelo Gerente.
• API SSDOi/ANA: camada de exposição de endpoints para requisições de simulação, configuração e integração.
• Serviços SSDOi/ANA: camada responsável por orquestrar o processamento dos serviços solicitados.
• Serviços Simulador/Modelagem: serviços voltados à simulação de efeitos de interferências no balanço hídrico.
• Serviços Integração CNARH: serviços para consulta, cadastro e inclusão de usuários cadastrados no balanço.
• Serviços Integração SNISB: serviços para consulta, cadastro e inclusão do efeito de barragens no balanço.
• Serviços Parametrização: serviços para atualização e configuração da BHO_v6 e de parâmetros associados.
• Banco de Dados Relacional: armazenamento do histórico de simulações, dados geoespaciais, configurações e dados relacionados.
• Banco de Dados de Cache: armazenamento de baixa latência para dados de disponibilidade, usuários ativos e cenários operacionais.

Leitura da arquitetura

Os diagramas indicam que o SSDOi deve funcionar como um sistema integrado ao ecossistema institucional da ANA, articulando:

• entrada e retorno de análises por sistemas externos de solicitação e gestão;
• consulta e atualização de cadastros junto ao CNARH e ao SNISB;
• orquestração interna de serviços de simulação, integração e parametrização;
• persistência de histórico, configurações e dados operacionais;
• suporte a interações síncronas e assíncronas conforme a natureza da solicitação.