Arquitetura da Plataforma JedIN — Integracao, R2-CX e Ecossistema MCP — JedIN Wiki

Tres Produtos, Uma Plataforma

O JedIN nao e uma ferramenta unica. E uma plataforma construida a partir de tres produtos interconectados que servem diferentes papeis no ciclo de vida da integracao empresarial. O produto Integration cuida do design de fluxos, deploy e monitoramento. O R2-CX fornece acesso autonomo orientado por IA a sistemas empresariais. O Ecossistema MCP fornece as 152 ferramentas que alimentam ambos os produtos por baixo dos panos.

Este post explica como cada produto funciona, o que ele contem e como os tres se conectam para formar uma plataforma coerente. Foi escrito para arquitetos, lideres tecnicos e tomadores de decisao avaliando a plataforma — nao como um guia passo a passo, mas como um mapa do territorio.

Pre-requisitos

Para aproveitar ao maximo esta visao geral, voce deve ter:

Familiaridade basica com conceitos de iPaaS — fluxos de integracao, conectores, transformacao de mensagens, deploy
Entendimento de arquiteturas orientadas a API — APIs REST, OAuth2, payloads JSON
Conhecimento de SAP Cloud for Customer (C4C) e conceitos de SAP Cloud Integration (CPI) — util mas nao obrigatorio
Acesso a um tenant JedIN — recomendado se voce deseja verificar a arquitetura contra uma instancia real, mas este post e autocontido

Produto 1: JedIN Integration

O produto Integration e o iPaaS central. Ele fornece quatro superficies principais:

Flow Designer

O Flow Designer e um canvas visual construido sobre ReactFlow onde fluxos de integracao sao criados, configurados e gerenciados. Cada fluxo e um grafo direcionado de nodes (etapas de processamento) conectados por edges (caminhos de execucao).

Caracteristicas-chave:

Paleta de nodes com 12 categorias — cobrindo Participants, Events, Process, Call, Message Routing, Message Transformers, Persistence, Security, Encoder, Validator, SAP Adapters e Connectors
Painel de propriedades com 8 abas — General, Runtime Configuration, Error Configuration, References, Externalized Parameters, Problems, Deployment Status e Design Guidelines
Layout de swimlanes — nodes sao organizados dentro de swimlanes Sender, Integration Process e Receiver, espelhando o modelo visual do SAP CPI
Deploy com um clique — fluxos sao compilados da representacao visual para Camel K YAML e deployados no motor de runtime diretamente da barra de ferramentas

O designer atualmente suporta todos os tipos de node da paleta do SAP CPI (84/84 componentes com 100% de paridade), tornando possivel importar fluxos SAP CPI existentes e edita-los visualmente.

Pagina Design

A pagina Design e a camada de gerenciamento de pacotes. Ela contem 101+ pacotes, cada um contendo um ou mais artefatos:

Tipo de Artefato	Descricao
iflow	Fluxos de integracao — o tipo de artefato primario, aberto no Flow Designer
valuemapping	Tabelas de lookup chave-valor usadas durante transformacao de mensagens
scriptcollection	Bibliotecas de scripts Groovy ou JavaScript compartilhadas entre fluxos
messagemapping	Definicoes visuais de mapeamento campo-a-campo

Os pacotes sao organizados por fornecedor, dominio ou projeto. Os 101 pacotes pre-carregados cobrem replicacao SAP-para-SAP, sincronizacao de CRM de terceiros, integracoes de e-commerce e padroes utilitarios. Cada pacote rastreia historico de versoes e status de deploy independentemente.

Monitoring

A superficie de Monitoring fornece visibilidade em tempo real e historica sobre a execucao de fluxos:

Dashboard em tempo real — status de execucao ao vivo, fluxos ativos, throughput atual (mensagens/segundo)
Historico de 30 dias — contagens de execucao, taxas de sucesso/falha, latencia media e distribuicao de erros por fluxo
Rastreamento de mensagens — mergulhe em execucoes individuais para ver o payload da mensagem em cada node, headers e propriedades
Configuracao de alertas — alertas baseados em limites para taxas de falha, picos de latencia e profundidade de filas

O backend de monitoring agrega metricas do runtime Camel K e armazena historico rotativo de 30 dias. Dados mais antigos podem ser exportados para ClickHouse para analytics de longo prazo.

Marketplace

O Marketplace fornece 15+ pacotes de conectores pre-construidos prontos para instalacao:

Conectores SAP — IDoc, RFC, OData V2/V4, SuccessFactors, Ariba, S/4HANA
Conectores Cloud — Salesforce, HubSpot, Vtex, TOTVS Protheus
Conectores de protocolo — HTTP/REST, SFTP, AMQP, Kafka, JDBC, AS2, Mail
Pacotes utilitarios — padroes de tratamento de erros, frameworks de logging, templates de rotacao de credenciais

Cada entrada do marketplace inclui documentacao, fluxos de exemplo e informacoes de compatibilidade de versao. Instalar um pacote o adiciona a sua pagina Design onde voce pode customiza-lo.

Produto 2: R2-CX

O R2-CX e o consultor autonomo alimentado por IA. Ele se conecta a sistemas empresariais atraves de automacao de navegador (Playwright) e chamadas de API, executando acoes reais a partir de comandos em linguagem natural.

Hub Multi-Produto

O Hub R2-CX em /r2cx mostra todos os sistemas alvo disponiveis. Atualmente 14 sistemas estao registrados em tres niveis de prontidao:

Nivel	Sistemas	Status
Producao	SAP C4C, JedIN, SAP CPI	Totalmente testados, 152 ferramentas validadas
API-Ready	Power BI, Power Apps	Ferramentas construidas, aguardando tenant Azure AD
Beta	Salesforce, HubSpot, Vtex, TOTVS, S/4HANA, ABAP, SAC, Emarsys, C4C v2	Ferramentas em desenvolvimento

Cada sistema alvo tem seu proprio servidor MCP fornecendo ferramentas especializadas. Clicar em um sistema alvo abre seu workspace dedicado.

Workspace

O Workspace e a interface primaria do R2-CX. Ele consiste em:

Painel de chat (esquerda) — uma interface conversacional onde voce digita comandos em linguagem natural. O R2-CX interpreta sua intencao, seleciona as ferramentas MCP apropriadas, executa-as e retorna resultados estruturados.
Live View (direita) — uma visualizacao do navegador em tempo real mostrando a tela do sistema alvo. Quando o R2-CX navega no SAP C4C, voce ve cada clique, preenchimento de formulario e carregamento de pagina conforme acontece.

A camada de IA suporta conversas multi-turno com retencao de contexto. Voce pode fazer perguntas de acompanhamento, refinar comandos anteriores e encadear operacoes entre multiplos sistemas em uma unica sessao.

Projetos

Os Projetos R2-CX fornecem contexto de longa duracao para engajamentos complexos:

Documentos — anexe requisitos, especificacoes e materiais de referencia
Tarefas — acompanhe progresso de implementacao com status e prioridade
Sessoes — todas as sessoes de chat vinculadas ao projeto para trilha de auditoria
Configuracoes — configuracao especifica do projeto (sistemas alvo, credenciais, parametros de IA)

Projetos sao projetados para cenarios de implementacao SAP onde um consultor trabalha ao longo de multiplas sessoes por dias ou semanas, construindo contexto progressivamente.

Sessoes

Toda interacao R2-CX e registrada como uma sessao. Sessoes capturam:

Historico completo do chat com timestamps
Toda chamada de ferramenta MCP com parametros e resultados
Screenshots tiradas durante automacao de navegador
Erros, tentativas e acoes de recuperacao

Sessoes podem ser revisadas para propositos de auditoria, usadas como dados de treinamento para melhorar respostas de IA, ou exportadas como documentacao do trabalho realizado.

Skills e Docs

O R2-CX inclui 17 skills pre-construidas e uma biblioteca de documentacao:

Skills — templates de prompt reutilizaveis para tarefas comuns (ex.: "Create REST Integration", "Run Full Audit", "Generate ABSL Validation Code")
Docs — documentacao de referencia para cada sistema alvo, acessivel de dentro do workspace
APIs — documentacao de endpoints para acesso programatico as capacidades do R2-CX

Produto 3: Ecossistema MCP

O Ecossistema MCP (Model Context Protocol) e a camada de ferramentas que alimenta tanto o Integration quanto o R2-CX. Ele consiste em tres servidores MCP de producao fornecendo 152 ferramentas validadas:

MCP C4C — 26 Ferramentas

O servidor MCP SAP C4C usa automacao de navegador Playwright exclusivamente (sem acesso externo a API OData). As ferramentas incluem:

Categoria	Ferramentas	Exemplos
Navegacao	4	`c4c_login`, `c4c_navigate`, `c4c_screenshot`, `c4c_evaluate`
Dados	6	`c4c_count`, `c4c_search`, `c4c_read_entity`, `c4c_list_entities`
Configuracao	5	`c4c_fine_tuning`, `c4c_adaptation_mode`, `c4c_list_code_lists`
Analise	3	`c4c_analyze` (4 tipos), `c4c_generate_absl`, `c4c_test_environment`
Sessao	4	`c4c_start_session`, `c4c_end_session`, `c4c_get_status`, `c4c_recover`
KUT/Extensao	4	`c4c_create_field`, `c4c_list_fields`, `c4c_create_extension`, `c4c_deploy_extension`

Todo acesso a dados ocorre atraves de chamadas fetch() no navegador contra endpoints OData, usando os cookies de sessao ativa. Esta abordagem funciona com tenants que nao expoem acesso externo a API.

MCP JedIN — 79 Ferramentas

O servidor MCP JedIN fornece gerenciamento abrangente da plataforma:

Categoria	Ferramentas	Exemplos
Fluxos	15	`jedin_list_flows`, `jedin_create_flow`, `jedin_deploy_flow`, `jedin_execute_flow`
Pacotes	8	`jedin_list_packages`, `jedin_create_package`, `jedin_export_package`
Monitoramento	10	`jedin_get_execution_metrics`, `jedin_get_health`, `jedin_get_message_trace`
Credenciais	6	`jedin_list_credentials`, `jedin_create_credential`, `jedin_rotate_credential`
Tenant	5	`jedin_get_tenant_info`, `jedin_get_tier_limits`, `jedin_get_usage`
Assistencia de Codigo	15	`jedin_get_node_types` (210 tipos), `jedin_get_templates` (10), `jedin_get_connector_patterns` (15)
Skills	11	`create_rest_integration`, `create_sap_integration`, `get_connector_info`
Ponte CPI	9	`jedin_import_cpi_package`, `jedin_export_iflow`, `jedin_convert_cpi_flow`

MCP CPI — 47 Ferramentas

O servidor MCP SAP CPI fornece paridade com operacoes do SAP Cloud Integration:

Categoria	Ferramentas	Exemplos
Pacotes	8	`cpi_list_packages`, `cpi_create_package`, `cpi_download_package`
Artefatos	10	`cpi_list_artifacts`, `cpi_deploy_artifact`, `cpi_get_artifact_content`
Monitoramento	8	`cpi_get_message_processing_logs`, `cpi_get_integration_content`
Configuracao	6	`cpi_get_externalized_parameters`, `cpi_update_configuration`
Seguranca	5	`cpi_list_security_materials`, `cpi_deploy_certificate`
Design	10	`cpi_get_resources`, `cpi_update_resource`, `cpi_get_configurations`

Como os Produtos se Conectam

Os tres produtos formam um ciclo de feedback:

                  Comandos em Linguagem Natural
                           |
                           v
                    +------+------+
                    |    R2-CX    |
                    | (Camada IA) |
                    +------+------+
                           |
              +------------+------------+
              |            |            |
              v            v            v
        +---------+  +---------+  +---------+
        | MCP C4C |  | MCP     |  | MCP CPI |
        | 26 ferr.|  | JedIN   |  | 47 ferr.|
        |         |  | 79 ferr.|  |         |
        +---------+  +---------+  +---------+
              |            |            |
              v            v            v
        +---------+  +---------+  +---------+
        | SAP C4C |  | JedIN   |  | SAP CPI |
        |(Browser)|  |  (API)  |  |  (API)  |
        +---------+  +---------+  +---------+

Fluxo de trabalho cross-system tipico:

Um usuario abre o R2-CX e digita: "Verifique quantas contas existem no C4C e confirme que o fluxo de replicacao de contas esta deployado no JedIN"
O R2-CX chama c4c_count (CorporateAccountCollection) e jedin_list_flows (filtrando fluxos de replicacao)
A IA correlaciona os resultados: 847 contas no C4C, o fluxo de replicacao esta deployado e executou 23 vezes nas ultimas 24 horas com 100% de sucesso
O R2-CX reporta: "847 contas no C4C. O fluxo 'Business Partner Replication' esta deployado e saudavel — 23 execucoes, zero falhas."

Este ciclo funciona porque o R2-CX tem acesso simultaneo a ambos os sistemas atraves de seus respectivos servidores MCP. Nenhuma troca manual entre consoles e necessaria.

Auto-Recuperacao e Resiliencia

Sessoes de producao encontram interrupcoes. O R2-CX lida com elas automaticamente:

Cenario	Mecanismo de Recuperacao
Sessao SAP C4C expira	Auto-login usando credenciais armazenadas. A ferramenta `c4c_recover` detecta morte de sessao e re-autentica em ate 3 tentativas.
Token JedIN expira	Refresh automatico de token usando o fluxo de refresh token. Transparente para o usuario.
Crash do navegador	Nova instancia de navegador Playwright lancada, estado da sessao restaurado do checkpoint.
Defaults de geracao ABSL	Ao gerar codigo ABSL, parametros ausentes sao preenchidos com defaults seguros (ex.: tipos BO padrao, namespaces default).
Timeout de ferramenta MCP	Retry automatico com backoff exponencial (1s, 2s, 4s). Apos 3 falhas, R2-CX reporta o erro e sugere intervencao manual.

Resultados Validados

A plataforma foi testada sob estresse com os seguintes resultados:

Metrica	Resultado
Ferramentas MCP validadas	152 em 3 servidores (26 + 79 + 47)
Skills disponiveis	17 templates de prompt reutilizaveis
Cenarios de teste aprovados	61/61 (benchmark E2E, Nota A+)
Posts wiki gerados	33 (documentacao cross-system)
Arquivos de conteudo MDX	99+ em 3 locales
Video walkthroughs	9 demonstracoes gravadas
Teste de estresse	100% de taxa de aprovacao sob carga sustentada
Pontuacao de Prontidao para Producao	95,6 — CERTIFIED
Aceleracao vs. manual	14,1x mais rapido que fluxo de trabalho tradicional de consultor

Resumo

A arquitetura do JedIN separa responsabilidades de forma clara: o produto Integration cuida do ciclo de vida construir-deployar-monitorar, o R2-CX fornece operacoes autonomas orientadas por IA, e o Ecossistema MCP fornece a camada de ferramentas conectando tudo a sistemas empresariais reais.

Os tres produtos compartilham um backend comum (API NestJS, PostgreSQL, Redis) e camada de autenticacao. Um usuario pode projetar um fluxo no Flow Designer do Integration, mudar para o R2-CX para verificar os dados do sistema alvo, fazer deploy do fluxo via linguagem natural e monitorar a execucao — tudo dentro da mesma sessao na plataforma.

Para guias praticos, veja:

Inicio Rapido do Flow Designer — abrindo e navegando seu primeiro fluxo
Comecando com R2-CX — sua primeira sessao autonoma
Avaliacao Cross-System — auditando C4C e JedIN juntos
Auditoria de Qualidade de Dados — executando todos os quatro tipos de analise

Arquitetura da Plataforma JedIN — Integracao, R2-CX e Ecossistema MCP