> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Ambiente de desenvolvimento

## Repositórios

| Projeto                          | Responsabilidade                                         |
| -------------------------------- | -------------------------------------------------------- |
| `hub/nexxo.work`                 | Backend ASP.NET, domínio, persistência e contratos HTTP. |
| `hub/frontend/nexxo.work-web`    | Frontend React standalone e federado.                    |
| `hub/developers/nexxo.work-mcp`  | Servidor MCP e adapters de conexão.                      |
| `hub/developers/frameworks/docs` | Framework Nexxo Docs reutilizado por estes portais.      |

## Frontend

No checkout do frontend, siga o README para preparar `.env.local` e os serviços reais. Os comandos existentes são:

```bash
pnpm install
cp .env.example .env.local
pnpm dev
pnpm typecheck
pnpm test
pnpm build
```

O README usa a porta `5184`. A interface não substitui falhas da API por dados demonstrativos.

## Backend e contratos

O backend usa PostgreSQL, migrações EF Core, autenticação Nexxo.Auth/Keycloak e integrações de mensageria. A suíte usa serviços isolados; siga as instruções do repositório antes de executar `dotnet test Tests`.

OpenAPI e Scalar são mapeados pelo `Program.cs` em ambiente Development. O documento automático completo não é exposto em produção por esse código e inclui mais contratos do que a referência pública deste portal.

## Documentação

Os dois portais consomem versões publicadas do Nexxo Docs. Conteúdo e configuração pertencem ao consumidor; alterações no framework são distribuídas por versão. Páginas comuns usam Markdown com front matter, e componentes React ficam em módulos registrados.
