Serviços e Componentes

Visão inicial

Com base no escopo atual, o SSDOi é estruturado em blocos que garantem escalabilidade e separação de responsabilidades:

Aplicação web: Interface de usuário (frontend) voltada para o gestor e analista, permitindo a configuração de projetos de balanço, visualização de resultados e gestão de outorgas.
Serviços de simulação: O "cérebro" do sistema, contendo os algoritmos matemáticos que processam os balanços hídricos e verificam o atendimento aos critérios de outorga.
Serviços de parametrização: Responsáveis por gerenciar a lógica de busca e aplicação de parâmetros técnicos conforme o contexto geográfico da análise.
Serviços de integração externa: Camada de tradução e comunicação com sistemas como CNARH e SNISB, garantindo a integridade dos dados importados.
Banco relacional: Armazenamento persistente de entidades de negócio, usuários, configurações de projeto e metadados.
Armazenamento de cache: Utilizado para acelerar o acesso a dados de leitura frequente (como trechos da BHO ou parâmetros estáticos).
Mecanismo de execução assíncrona: Gerenciador de tarefas para processamentos longos ou complexos, garantindo que a interface permaneça responsiva durante grandes simulações.

Este é o componente central para a entrega de valor do sistema.

Motores e simuladores: Implementação das lógicas de análise superficial e subterrânea, tratando interferências e disponibilidades.
Cálculo de indicadores: Geração automatizada de métricas como o ICH (Índice de Comprometimento Hídrico) e saldos de vazão.
Registro de execuções: Histórico detalhado de cada simulação realizada para fins de rastreabilidade e comparação.

Garante que o sistema seja configurável sem necessidade de alterações no código-fonte para cada nova regra.

Gerenciamento e versionamento: Controle fino sobre as variáveis técnicas e seus períodos de vigência.
Regras por domínio: Aplicação inteligente de parâmetros baseada na localização da outorga (ex: regras específicas para rios de domínio da União).
Disponibilização de dados: API interna que fornece os parâmetros validados para os motores de simulação.

Ponte entre o SSDOi e o ecossistema de dados da ANA e Estados.

Conectores oficiais: Implementações específicas para falar com os protocolos de cada sistema externo (CNARH, SNISB, BHO v6).
Auditoria de sincronização: Monitoramento da saúde das integrações e log de todas as trocas de informações realizadas.

Esta visão deve ser refinada futuramente com diagramas de contexto, containers, componentes e interfaces.