JedIN Wiki -- Base de Conhecimento com Busca, Categorias e 24 Artigos

<video controls width="100%" style={{borderRadius: '8px', marginBottom: '1.5rem'}}> <source src="/blog/videos/wiki-search-tour.mp4" type="video/mp4" /> Your browser does not support the video tag. </video>

Uma Base de Conhecimento Integrada à Plataforma

Plataformas de integração empresarial geram dispersão de documentação. Referências de API ficam em um sistema, tutoriais em outro, guias de arquitetura em uma wiki em algum lugar, e passos de troubleshooting em tickets de suporte. O JedIN Wiki consolida todo o conhecimento da plataforma em uma única interface pesquisável, acessível diretamente pela navegação principal.

O título da página exibe "JedIN Wiki" e o subtítulo explica seu propósito: "Knowledge base with articles, tutorials and guides about enterprise integration and SAP automation." Abaixo do subtítulo há uma barra de busca com o placeholder "Search Wiki..." seguida por filtros de categoria e uma grade de cards de artigos.

O wiki é acessível pela barra de navegação superior onde aparece ao lado de Products, Features, Integrations, Security e Pricing. Esse posicionamento o torna uma seção de primeira classe da plataforma, em vez de um link de documentação escondido.

24 Artigos em 3 Categorias

O wiki contém 24 artigos organizados em 3 categorias. O contador de artigos no topo da página exibe "24 / 24 articles" quando nenhum filtro está aplicado, confirmando o inventário total de conteúdo.

JedIN Integration -- 13 Artigos

A maior categoria cobre a plataforma de integração JedIN principal com 13 artigos. Esta categoria aborda os fundamentos da integração empresarial como implementada no JedIN: conceitos de design de flows, gerenciamento de pacotes, manipulação de artefatos, workflows de deployment, monitoramento e o ecossistema de conectores.

Os artigos nesta categoria atendem dois públicos. Novos usuários aprendendo a plataforma encontram guias de introdução e visões gerais conceituais. Usuários experientes construindo integrações em produção encontram material de referência detalhado sobre compilação de flows, comportamento do runtime e padrões avançados de configuração.

Os 13 artigos representam a documentação acumulada de meses de desenvolvimento da plataforma, destilada dos documentos detalhados de especificação e registros de decisão arquitetural em formato wiki acessível. Cada artigo foca em um tópico específico em vez de tentar cobrir toda a plataforma em uma única peça.

R2-CX Autonomous Consultant -- 21 Artigos

A documentação do R2-CX é a categoria mais extensa com 21 artigos. Isso reflete tanto a complexidade do sistema de consultor autônomo quanto sua rápida evolução de uma ferramenta para um único sistema SAP C4C para um hub multi-produto suportando 14 sistemas alvo.

Os artigos do R2-CX cobrem todo o espectro de operações do consultor autônomo: como o protocolo de ferramentas MCP funciona, como sessões de automação de navegador são gerenciadas, como consultas OData executam via fetch dentro do navegador, como templates de geração de código ABSL são estruturados, como operações entre sistemas são coordenadas e como o mecanismo de análise produz pontuações de qualidade de dados e relatórios executivos.

Vários artigos documentam resultados de validação e benchmarks específicos. Estes não são materiais de marketing -- são registros técnicos de execuções reais de testes com contagens exatas de chamadas de ferramentas, tempos de execução, taxas de sucesso e análise de falhas. A documentação de testes de stress, os registros de reconciliação entre sistemas e a certificação de prontidão para produção vivem nesta categoria como evidência permanente da capacidade da plataforma.

Os 21 artigos também servem como recurso de treinamento para consultores adotando o R2-CX. Em vez de aprender o sistema por tentativa e erro, consultores podem ler workflows documentados, entender capacidades de ferramentas antes de invocá-las e revisar exemplos reais de operações autônomas bem-sucedidas.

MCP Ecosystem -- 8 Artigos

A categoria MCP Ecosystem contém 8 artigos cobrindo a infraestrutura Model Context Protocol que alimenta tanto o JedIN quanto o R2-CX. Os tópicos incluem a arquitetura do servidor MCP, registro e validação de ferramentas, a camada compartilhada de autenticação (incluindo Azure OAuth2 para integrações Microsoft) e o esquema de alocação de portas nos 14 servidores MCP.

Estes 8 artigos são os mais técnicos do wiki, direcionados a desenvolvedores e arquitetos que precisam entender ou estender a infraestrutura MCP. Eles documentam a classe base do servidor, o protocolo de definição de ferramentas, o formato de request/response e os padrões de integração que garantem que cada ferramenta anunciada na UI realmente existe e funciona no servidor MCP correspondente.

Busca: Full-Text em Todos os Artigos

A barra de busca no topo da página do wiki oferece busca full-text em todos os 24 artigos. Digitar uma consulta filtra a grade de artigos em tempo real, correspondendo contra títulos, descrições e conteúdo. O contador de artigos atualiza para mostrar a contagem filtrada (por exemplo, "8 / 24 articles" quando uma busca reduz o conjunto visível).

A busca lida tanto com termos técnicos específicos quanto com conceitos gerais. Buscar "OData" exibe artigos sobre consultas de dados C4C e integração S/4HANA. Buscar "deployment" retorna artigos sobre deployment de flows, runtime Camel K e prontidão para produção. Buscar "ABSL" encontra os artigos de geração de código na categoria R2-CX.

A implementação da busca é client-side, o que significa que resultados aparecem instantaneamente sem round trips de rede. Para 24 artigos esta é a escolha arquitetural correta -- busca server-side adicionaria latência sem fornecer benefício significativo neste volume de conteúdo.

Filtragem por Categoria

Abaixo da barra de busca, botões de filtro de categoria permitem estreitar a lista de artigos por tópico. Cada botão exibe o nome da categoria e contagem de artigos: JedIN Integration (13), R2-CX Autonomous Consultant (21) e MCP Ecosystem (8).

Categorias e busca funcionam juntas. Selecionar uma categoria e depois digitar uma consulta de busca filtra dentro daquela categoria. Limpar a categoria mostra todos os artigos correspondentes ao termo de busca em todas as categorias. Esta filtragem bidimensional (categoria mais texto) permite que usuários naveguem rapidamente até o conteúdo relevante independentemente de saberem o título exato do artigo ou estarem navegando por tópico.

As contagens de categoria são metadados estáticos -- refletem o total de artigos em cada categoria, não a contagem filtrada atual. A contagem filtrada aparece no contador principal de artigos acima da grade.

Dark Mode: Suporte Completo

O wiki suporta dark mode com uma implementação completa de tema. Cada elemento -- o fundo da página, cards de artigos, barra de busca, botões de categoria, navegação e texto -- adapta-se ao esquema de cores escuro.

Dark mode não é uma simples inversão CSS. Os cards de artigos usam cores de fundo apropriadas para legibilidade em ambos os temas. As taxas de contraste de texto são mantidas. A barra de busca e os botões de categoria usam bordas e estados hover adaptados ao tema. A barra de navegação adapta seu esquema de cores para combinar.

Dark mode é uma preferência do usuário disponível em toda a plataforma JedIN, não específica do wiki. Trocar de tema em qualquer página aplica a preferência globalmente, e o wiki respeita esta configuração imediatamente.

Contexto de Navegação

O wiki fica na seção pública da plataforma JedIN, acessível sem autenticação. A barra de navegação superior mostra seis seções: Products, Features, Integrations, Security, Pricing e Wiki. Este posicionamento posiciona o wiki tanto como recurso de documentação quanto como ativo de marketing -- usuários em potencial podem navegar pela base de conhecimento para entender as capacidades da plataforma antes de se cadastrar.

A estrutura de navegação reflete uma decisão deliberada de tornar a documentação um par da informação do produto em vez de uma seção subordinada. Muitas plataformas escondem sua documentação atrás de autenticação ou em um subdomínio separado. O JedIN a exibe no mesmo nível de navegação que pricing e features.

Estratégia de Conteúdo: Apenas Dados Verificados

Cada artigo no wiki segue o mesmo princípio editorial: apenas dados verificados de operações reais da plataforma. Contagens de ferramentas vêm dos registros dos servidores MCP. Números de desempenho vêm de execuções de teste cronometradas. Taxas de sucesso vêm de resultados de testes registrados. Descrições de arquitetura vêm do código implementado, não de documentos de design.

Isso significa que o conteúdo do wiki envelhece de forma diferente da documentação típica. Quando uma contagem de ferramentas muda porque uma nova ferramenta MCP é adicionada, os artigos relevantes são atualizados para refletir a nova contagem. Quando uma suíte de testes é reexecutada com resultados diferentes, os artigos de benchmark são atualizados ou um novo artigo é criado documentando a nova execução. O wiki é um registro vivo do estado da plataforma, não um documento estático escrito uma vez e esquecido.

Os 24 artigos representam o inventário de conteúdo atual. Conforme a plataforma evolui -- novos sistemas alvo alcançam status de produção, novos benchmarks de validação são concluídos, novos padrões de integração são documentados -- o wiki cresce. A estrutura de categorias e a funcionalidade de busca foram projetadas para escalar bem além dos 24 artigos atuais sem se tornar difícil de navegar.

Por Que um Wiki Integrado é Importante

Plataformas de integração empresarial são complexas. SAP CPI tem centenas de tipos de adapter. Salesforce tem milhares de endpoints de API. O JedIN sozinho tem 79 ferramentas em seu servidor MCP. Sem documentação centralizada e pesquisável, usuários gastam tempo buscando recursos externos, fazendo perguntas ao suporte e redescobrindo soluções para problemas previamente resolvidos.

O JedIN Wiki aborda isso colocando a base de conhecimento onde os usuários já estão -- dentro da plataforma, a um clique do dashboard. Os 24 artigos cobrindo 3 categorias com busca full-text e suporte a dark mode representam a fundação de um sistema de documentação projetado para crescer com a plataforma em vez de ficar para trás.