# Modelando uma automação no produto

Boa parte da qualidade de uma automação no TunnelHub vem da modelagem no produto, não apenas do código.

## Ordem recomendada

Um fluxo prático costuma seguir esta sequência:

1. escolher o ambiente;
2. criar ou selecionar um pacote;
3. cadastrar systems;
4. definir parâmetros;
5. criar Tabelas De/Para e Sequências, quando fizer sentido;
6. criar a automação;
7. associar os recursos necessários;
8. configurar triggers e notificações.

## Pacote

Use o pacote como agrupador funcional. Ele deve refletir domínio, cliente, iniciativa ou contexto de manutenção.

## Systems

Cadastre um system quando a automação depender de uma conexão externa reutilizável.

Exemplos comuns:

* API HTTP;
* FTP/SFTP;
* banco de dados;
* SOAP;
* SAP RFC.

Boas práticas:

* usar `internalName` estável;
* separar credenciais por ambiente;
* evitar um mesmo system para contextos sem relação.

## Parâmetros

Use parâmetros para valores variáveis e pequenos estados controlados pela automação.

Exemplos:

* feature flags;
* datas de corte;
* nomes de tabela;
* cursores de sincronização.

Não use parâmetro para tudo. Quando o dado representa conexão, prefira `System`. Quando representa mapeamento de negócio, prefira uma Tabela De/Para.

## Tabelas De/Para

Use Tabelas De/Para quando o negócio precisa manter mapeamentos e listas de referência sem alterar código.

Casos típicos:

* de/para de status;
* códigos de filial;
* mapeamento de categorias;
* IDs legados para IDs externos.

## Sequências

Use Sequências quando a plataforma precisa gerar identificadores centralizados e atômicos.

Casos típicos:

* número de lote;
* identificador incremental;
* chave de negócio controlada.

## Associação com a automação

Uma automação só recebe em runtime os recursos explicitamente associados a ela.

Revise antes do deploy:

* systems corretos associados;
* parâmetros esperados cadastrados;
* Tabelas De/Para corretas disponíveis;
* Sequências corretas criadas.

## Triggers

Hoje, a modelagem pública mais comum inclui:

* webhook;
* scheduled;
* inbound email.

Escolha o trigger conforme a forma de disparo do processo, não conforme a tecnologia da origem.

## Notificações e retenção

Antes de publicar em produção, revise:

* retenção de logs;
* notificações de falha;
* quem precisa operar essa automação;
* se usuários limitados precisam enxergar a execução.

## Pergunta prática de modelagem

Quando estiver em dúvida sobre onde colocar uma configuração, use esta regra:

* conexão externa: `System`;
* valor variável da automação: `Parameter`;
* regra de negócio configurável: Tabela De/Para;
* contador centralizado: Sequência.