> For the complete documentation index, see [llms.txt](https://docs.skail.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skail.dev/aprender/arquitetura/portal.md).

# Portal

O portal ([app.skailhq.com](https://app.skailhq.com/)) é onde você organiza o que roda no skail e enxerga o que está acontecendo. Uma tela sobre cada área; a referência detalhada de cada uma está na aba Construir.

## Projetos

O agrupador de mais alto nível. Um projeto reúne os environments e workloads de uma iniciativa ou produto (`faturamento`, `logistica`, `portal-cliente`). É a fronteira de organização e de acesso. Ver [Projetos](/construir/portal/projetos.md).

## Environments

Dentro de um projeto, os estágios do ciclo de vida: `dev`, `hml`, `prod`. Cada environment tem a própria chave (`SKAIL_KEY`), o próprio namespace (`SKAIL_NAMESPACE`, no formato `tenant/environment`) e a própria URL base da API. Execuções e eventos não cruzam environments. É aqui que você pega os três valores para configurar a aplicação e quem dispara. Ver [Environments](/construir/portal/environments.md).

## Workloads

A sua aplicação vista pelo skail: um nome e uma versão (`faturamento:v1.2.3`), publicados em um environment. O par precisa ser igual ao `SKAIL_WORKLOAD` da aplicação e aparece no caminho do trigger. Uma nova versão da aplicação é um novo workload com o mesmo nome; as duas podem coexistir enquanto execuções antigas terminam. Ver [Workloads](/construir/portal/workloads.md).

## Monitor

Cada execução, com o TaskId, a function, o estado (em execução, aguardando evento, aguardando prazo, concluída, falha), e a linha do tempo: um item por passo, com argumentos, resultados, tempos e retentativas. É onde você descobre por que uma execução está parada (o nome e o id do evento esperado estão lá), onde ela falhou (a exceção está lá), e de onde você retoma manualmente uma execução falha depois de corrigir a causa. Ver [Monitor](/construir/portal/monitor.md).

## Time Travel Debug

A partir de uma execução no Monitor, você exporta uma captura da execução e a reproduz na sua IDE com o runtime local em modo de depuração: a function é reexecutada com os argumentos e os resultados de command originais, sem tocar nos sistemas externos, e você depura passo a passo o que aconteceu em produção. Ver [Como depurar com Time Travel Debug](/construir/testar-depurar-e-observar/como-depurar-com-time-travel-debug.md).

## O que o portal não é

Não é onde o código roda: a aplicação roda na sua infraestrutura. Não é onde você configura variáveis da aplicação: isso é no seu host. Não é onde você dispara execuções em produção: isso é pela API HTTP, a partir dos seus sistemas.

## Próximos passos

[Projetos, environments, namespaces e workloads](/aprender/arquitetura/projetos-environments-namespaces-e-workloads.md) explica a relação entre os quatro e as variáveis do runtime. [Quickstart](/aprender/readme.md) passa pelo portal no primeiro passo.
