Gestão de Variáveis de Ambiente

A Gestão de Variáveis de Ambiente é o recurso responsável por parametrizar e centralizar as configurações dinâmicas, URLs de endpoints, prazos de timeout e parâmetros operacionais consumidos pelos fluxos e runners.

O mecanismo assegura a separação entre o desenho do fluxo e as configurações do ambiente, permitindo que o mesmo fluxo rode em Desenvolvimento, Homologação e Produção sem qualquer alteração em suas definições visuais.

Parametrização e Resolução por Ambiente

As variáveis são cadastradas por chave e valor vinculadas ao ambiente em execução. Dessa forma, a Engine injeta as configurações corretas no momento em que a etapa é processada:

┌────────────────────────────────────────────────────────────────────────┐
│                          CONSOLE DE GESTÃO                             │
│  - Cadastro de Variáveis (Chave e Valor)                               │
│  - Vincular Variáveis por Ambiente (DEV / HML / PRD)                   │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                        CACHE DE CONFIGURAÇÕES                          │
│  - Carregamento e sincronização dos pares chave/valor em memória       │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
                                    ▼ Injeção em Tempo de Execução
┌────────────────────────────────────────────────────────────────────────┐
│                      MOTOR DE EXECUÇÃO (ENGINE)                        │
│  - Resolução dinâmica via namespace $variaveis                         │
│  - Ex: ${variaveis.URL_SERVICO_PARCEIRO} ou ${variaveis.TIMEOUT_PADRAO}│
└────────────────────────────────────────────────────────────────────────┘

Consumo nos Fluxos (`$variaveis`)

Durante o ciclo de vida do processamento, o motor de substituição da Engine resolve dinamicamente os valores das variáveis cadastradas para aquele ambiente no momento da interpolação do JSON da etapa:

Exemplo em um Runner de Cliente HTTP (`HTTP_CLIENT`):

Em vez de utilizar URLs fixas na definição da etapa, o desenvolvedor utiliza a sintaxe de interpolação ${variaveis.NOME_DA_VARIAVEL}:

{
  "bdot:url": "${variaveis.URL_SERVICO_AUTORIZACAO}/v1/aprovar",
  "bdot:timeout": "${variaveis.TIMEOUT_REQUISICAO_HTTP}"
}

Boas Práticas de Parametrização

Evitar Valores Fixos no Desenho (Hardcode)

URLs de serviços externos, parâmetros temporais e identificadores globais devem ser mapeados via namespace $variaveis.
Nomenclatura Padronizada

Recomenda-se o uso de chaves em caixa alta com sublinhados (SNAKE_CASE_UPPER), facilitando a leitura e a identificação nos diagramas visuais (ex: URL_API_CLIENTES, PAGINACAO_LIMITE_PADRAO).