Visão do ecossistema

O App Hub é um monólito modular Next.js 15. Os módulos compartilham deploy e infraestrutura, mas mantêm fronteiras de domínio em `src/features` e contratos de rota em `src/app`.

Recorte da seçãoReferência do sistema

Consulte contratos, decisões e comportamentos atuais do sistema com caminhos diretos para os detalhes relacionados.

Atualizado18 de jul. de 2026

Seções4

Tags3

arquiteturanextjsmodulos

Nesta página · 4 tópicos

Camadas

mermaid

Módulos principais

Módulo	Responsabilidade	Entrada
Institucional	Artmeta, CV, MOTD e demonstrações	`/`, `/cv`, `/motd`, `/web-demos/*`
Storefront	navegação, catálogo, carrinho, checkout e conta	`/e-commerce`
EcommPanel	administração e governança	`/ecommpanel/admin`
Documentação	acervo técnico e comercial	`/docs`
API pública	leitura cacheável e contratos públicos	`/api/v1`
Integração	acesso autenticado por cliente e escopo	`/api/integration/v1`

Fronteiras no código

src/app: rotas, layouts e endpoints;
src/features: domínio, componentes, stores, tipos e serviços;
src/components: elementos compartilhados fora de um domínio específico;
src/data: defaults e projeções versionadas, nunca segredos;
public: assets estáticos versionados;
docs/content: documentação canônica;
scripts: migração, exportação e operação assistida.

Decisões estruturais

PostgreSQL é a autoridade dos domínios administrativos em produção;
runtime mutável deve ficar fora do repositório;
snapshots são projeções recuperáveis, não bancos alternativos;
páginas administrativas são dinâmicas e verificam sessão por requisição;
o build não deve depender de banco nem gravar estado operacional;
integrações externas entram por adaptadores, não dentro dos componentes de UI.