Estrutura do código

Mapa para localizar mudanças sem criar dependência entre domínios.

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ções3

Tags3

codigoestruturamanutencao

Nesta página · 3 tópicos

Diretórios

Caminho	Responsabilidade
`src/app`	rotas Next.js, layouts, páginas e handlers HTTP
`src/features/ecommerce`	storefront, conta, OrderForm, logística e promoções
`src/features/ecommpanel`	UI administrativa, auth, Data Studio e configurações
`src/features/catalog`	store e contratos do catálogo
`src/features/blog`	publicação e interação editorial
`src/features/public-api`	serialização, referência e autenticação das APIs
`src/features/site-runtime`	leitura de conteúdo publicado
`src/features/docs`	parser e interface deste portal
`src/styles`	estilos globais e por módulo
`scripts`	migração, exportação e tarefas assistidas

Onde implementar

novo endpoint: src/app/api chamando serviço de domínio;
regra comercial: biblioteca ou store do domínio, nunca apenas no componente;
persistência: store server-only com contrato tipado;
painel: componente em ecommpanel/components e rota protegida;
storefront: componente em ecommerce/components consumindo contrato interno;
provedor externo: Commerce Bridge ou adaptador dedicado;
documentação: docs/content no mesmo commit.

Regras de dependência

Componentes não acessam PostgreSQL diretamente. Rotas validam requisição e delegam. Stores conhecem persistência. Tipos compartilhados descrevem contratos, sem importar UI. Segredos permanecem em arquivos server-only e ambiente.