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.