> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orquena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estrutura do monorepo

> Organização planejada de aplicações, packages, plugins, verticais e infraestrutura.

# Estrutura do monorepo

A Nuvexa será organizada como um monorepo com **pnpm** e **Nx**. O objetivo é compartilhar contratos e automação sem permitir dependências arbitrárias entre módulos.

```text theme={null}
apps/
  web/
  api/
  worker/
  realtime/
  ai-runtime/
  platform-admin/
  docs-site/

packages/
  kernel/
  plugin-sdk/
  contracts/
  database/
  auth/
  tenancy/
  permissions/
  events/
  jobs/
  config/
  files/
  billing/
  observability/
  ui/
  testing/
  shared/

plugins/
  first-party/
  ai-packs/
  providers/
  external-apps/

verticals/
infra/
docs/
.ai/
```

## `apps`

Contém processos executáveis com lifecycle e deployment próprios. Apps hospedam capacidades, mas não são donos das regras de domínio.

## `packages`

Contém fundações técnicas reutilizáveis. Packages devem ser pequenos, intencionais e possuir limites de dependência verificáveis.

## `plugins`

Contém capacidades de negócio, pacotes de agentes, providers substituíveis e conectores para aplicações externas.

## `verticals`

Combina plugins e configurações em experiências específicas para segmentos. Um vertical não duplica o domínio; ele organiza capacidades existentes.

## `docs` e `.ai`

`docs/` é a fonte canônica de produto, arquitetura e operação. `.ai/` orienta os agentes de programação responsáveis por futuras alterações.

## Regra de dependência

Providers não devem ser importados por regras de domínio. Apps não devem duplicar entidades. O AI Runtime não acessa Prisma diretamente. Dependências proibidas serão verificadas pelo grafo do Nx.