Conceitos principais

Esta página resume as entidades mais importantes do TunnelHub e como elas se relacionam.

Estrutura base

• Tenant/empresa: unidade principal de conta e isolamento de dados.
• Usuário: pessoa com acesso ao portal, à CLI ou a fluxos relacionados à autenticação.
• Ambiente: recorte operacional dentro da empresa. É comum existir DEV, QAS e PRD.
• Pacote: agrupador funcional usado para organizar automações, systems e outros recursos.

Recursos de integração

• System: conexão reutilizável com banco, HTTP, FTP/SFTP, LDAP, mail, SOAP, SAP RFC, SMB e outros tipos suportados.
• Automação: integração executável criada no produto e implementada com o SDK.
• Deploy: versão publicada da automação, com histórico e opção de transporte entre ambientes.
• Trigger: forma de disparo de uma automação, como webhook, agenda ou inbound email.

Recursos de dados

• Tabela De/Para: conjunto de dados configurável no produto, usado para mapeamentos e regras de negócio.
• Tabela de conversão: caso comum de uma Tabela De/Para com pares fromValue e toValue.
• Sequência: gerador sequencial usado para números de negócio ou identificadores.
• Parâmetro: valor configurável associado a automações e systems, evitando valores fixos no código.

Recursos operacionais

• Execução: uma execução de automação com status, período, logs e traces.
• Processing logs: resultado por item processado, baseado nos metadados definidos pelo SDK.
• Traces: logs técnicos e eventos auxiliares da execução.
• Notificações: alertas enviados quando a automação falha ou requer atenção.
• Transport: fluxo para promover configurações e versões entre ambientes quando aplicável.

Gestão de APIs

• API: definição publicada via API Gateway.
• Plano de uso: política de consumo aplicada a clientes e chaves de API.
• Chave de API: credencial de consumo para cenários controlados por plano.
• Servidor de recursos: conjunto de escopos OAuth usados para proteger endpoints.
• Cliente: aplicação consumidora autenticada para fluxos OAuth e machine-to-machine.

Ferramentas de desenvolvimento

• CLI: usada para login, listagem de recursos, bootstrap de automações e deploy.
• SDK: base de desenvolvimento das automações.
• MCP: interface operacional orientada à leitura para suporte, análise e investigação.

Fluxo típico

1. criar ou selecionar um ambiente;
2. criar um pacote;
3. cadastrar systems e parâmetros necessários;
4. criar Tabelas De/Para e Sequências quando fizer sentido;
5. criar uma automação a partir de um template;
6. implementar a integração com o SDK;
7. gerar artefato, fazer deploy e executar;
8. monitorar logs, traces, consumo e falhas.