Skip to main content

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.

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.