Editor Visual e Modelagem

O Editor Visual é a ferramenta do Console dedicada à criação e edição da estrutura dos fluxos de integração. Através de uma interface gráfica amigável baseada no navegador, o desenvolvedor desenha o comportamento do pipeline conectando etapas e definindo regras de transição de forma declarativa.

Conceito e Notação

A ferramenta de modelagem da plataforma é inspirada na notação BPMN 2.0. Ela adapta os elementos visuais padrão da indústria para representar o ciclo de processamento de dados e orquestração de microsserviços:

Etapas (Tarefas/Nós)

Blocos de processamento que representam a execução de uma ação atômica operada por um runner específico (ex: validação de entrada, execução de script, chamada HTTP ou consulta a banco).

Destinos (Conectores/Fluxos de Sequência)

Linhas de conexão direcionadas que ligam uma etapa de origem a uma etapa de destino, definindo a ordem e as condições de navegação do processo.

Início e Fim

Pontos de entrada e interrupção/conclusão da sessão de execução dentro do diagrama.

Estrutura da Modelagem Visual

Cada fluxo desenhado no Editor Visual é traduzido e normalizado em uma estrutura composta por Etapas e Destinos.

┌─────────────────┐       Destino (Condição)      ┌─────────────────┐
│ Etapa de Origem │ ────────────────────────────► │ Etapa de Destino│
│ (Motor / Alias) │                               │ (Motor / Alias) │
└─────────────────┘                               └─────────────────┘

1. Etapas (`EntidadeEtapa`)

Cada bloco inserido no diagrama gera um registro normalizado contendo os metadados de execução:

Código: Identificador único da etapa dentro do fluxo.
Alias: Nome amigável atribuído pelo desenvolvedor para exibição gráfica e identificação técnica no diagrama.
Motor (Runner): Tipo do nó de processamento encarregado de executar aquela tarefa (ex: DADOS_ENTRADA, SCRIPT_JS, HTTP_CLIENT, DATASOURCE_JDBC).
Definição JSON: Documento estruturado contendo os parâmetros específicos do motor configurados através do painel de propriedades do Editor (ex: comandos SQL, scripts JS, URLs e headers).
Hash de Validação: Resumo gerado para garantir a integridade do modelo XML salvo.

2. Destinos (`EntidadeDestino`)

Representam as conexões de transição e regras de desvio entre as etapas do fluxo:

Mapeamento Origem/Destino: Vínculo direto entre o código da etapa que finalizou a execução e o código da próxima etapa a ser acionada.
Avaliador de Condições: Regras dinâmicas de transição que avaliam atributos e retornos do contexto do fluxo. O motor de avaliação inspeciona operando, operador de comparação (ex: igual, diferente, contém) e valor para decidir qual caminho o fluxo deve seguir em tempo de execução.

Paleta de Componentes (Motores)

O Editor Visual disponibiliza uma paleta com os nós de processamento suportados pela plataforma. O desenvolvedor arrasta o nó desejado para a tela e configura suas propriedades em um formulário dedicado:

Validação de Entrada (`DADOS_ENTRADA`)

Aplica regras de validação estruturada e Expressões Regulares (Regex) sobre query params ou corpo da requisição.

Persistência de Saída (`DADOS_SAIDA`)

Persiste dados processados na sessão do fluxo.

Script JS (`SCRIPT_JS`)

Abre um editor de código integrado para escrita de funções JavaScript dinâmicas que transformam dados e manipulam o objeto do fluxo.

Cliente HTTP (`HTTP_CLIENT`)

Configura requisições para APIs e serviços REST externos (método, URL, cabeçalhos, corpo e timeout).

Autorreferência (`BDOT_AUTORREFERENCIA`)

Permite invocar recursivamente outro fluxo publicado na própria plataforma de forma síncrona ou assíncrona.

Segurança (`AUTH_JWT`)

Valida a integridade, emissor, papéis (roles), público (audience) e reivindicações (claims) de tokens JWT.

Operações de Cache (`DATASOURCE_CACHE`)

Configura comandos de leitura e escrita do tipo chave/valor (ex: GET, SET, DEL, EXISTS).

Banco de Dados (`DATASOURCE_JDBC`)

Permite escrever comandos SQL nativos (consultas ou atualizações) com suporte a amarração (binding) de parâmetros posicionais.

Operações do Editor e Sincronização

A interação do desenvolvedor com a tela de modelagem dispara rotinas no Console para garantir consistência:

Criação e Substituição

O Editor permite criar um modelo visual em branco ou importar/substituir a estrutura completa colando um arquivo XML.
Transição de Estado

A criação de um modelo visual em uma versão recém-instanciada altera automaticamente seu estado de CRIADO para DESENVOLVIMENTO.
Sincronização Automática

Ao salvar as alterações no diagrama, o Console processa o modelo XML, extrai e normaliza automaticamente as etapas e destinos no banco de dados e dispara a atualização de cache para a Engine do ambiente onde o fluxo estiver publicado.
Exibição do Código XML

O Editor permite visualizar e exportar o XML gerado pela modelagem para auditoria ou transporte manual.