> 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/construir/portal/projetos.md).

# Projetos

Referência da área Projetos do portal: o que é um projeto, o que ele contém e as operações disponíveis.

## O que é

O agrupador de mais alto nível. Um projeto reúne os environments, os workloads e os acessos de uma iniciativa, produto ou domínio (`faturamento`, `logistica`, `portal-cliente`). É a fronteira de organização e de visibilidade: quem tem acesso ao projeto enxerga seus environments e workloads.

## Identidade

O nome cadastrado no portal. Único na organização. Não aparece nas variáveis do runtime nem na API HTTP: a identidade técnica é do environment (namespace e chave) e do workload (`nome:versao`).

## Conteúdo

| Contém       | Descrição                                                                                 | Referência                                        |
| ------------ | ----------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Environments | Estágios do ciclo de vida (`dev`, `hml`, `prod`), cada um com chave, namespace e URL base | [Environments](/construir/portal/environments.md) |
| Workloads    | Aplicações publicadas em cada environment, por `nome:versao`                              | [Workloads](/construir/portal/workloads.md)       |

## Operações

| Operação      | Onde                                                                       | Observação                                                             |
| ------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Criar projeto | [app.skailhq.com/projects](https://app.skailhq.com/projects), Novo projeto | Escolha um nome que identifique a iniciativa; é o que aparece na lista |
| Abrir projeto | Lista de projetos                                                          | Dá acesso aos environments e workloads                                 |

## Como organizar

Um projeto por produto ou domínio de negócio, não por time nem por repositório. Dentro dele, os environments padrão (`dev`, `hml`, `prod`) e um workload por aplicação que hospeda functions. Uma iniciativa com três serviços .NET que participam do mesmo fluxo vira um projeto com três workloads por environment.

## Veja também

[Projetos, environments, namespaces e workloads](/aprender/arquitetura/projetos-environments-namespaces-e-workloads.md), [Portal](/aprender/arquitetura/portal.md), [Quickstart](/aprender/readme.md) (passo 1).