# Pacotes

Pacotes são agrupadores lógicos dentro do TunnelHub. Eles ajudam a organizar integrações e recursos relacionados por domínio, projeto ou contexto de negócio.

## O que um pacote organiza

Um pacote normalmente concentra:

* automações relacionadas;
* systems usados por essas automações;
* tabelas de conversão e sequências associadas;
* APIs ou recursos operacionais do mesmo contexto.

## Quando criar um novo pacote

Crie um pacote novo quando houver necessidade de separar:

* uma iniciativa ou módulo de negócio;
* um cliente ou vertical específica;
* responsabilidade entre equipes;
* ciclo de vida de deploy e governança.

## Campos principais

* **Nome**: identificação amigável.
* **Descrição**: contexto funcional do pacote.
* **Ambiente**: escopo onde o pacote existe.

## Pela CLI

Você também pode criar pacotes pela CLI:

```bash
tunnelhub create-package --env DEV
```

## Boas práticas

* use nomes orientados a domínio, não a tecnologia;
* evite pacotes grandes demais sem critério funcional;
* alinhe pacote com responsabilidade e contexto de manutenção.