Documentação do Projeto

Esta pasta concentra a documentação-base do produto.

O objetivo não é criar um page builder ou um "WordPress de ecommerce". A proposta é construir uma base de loja padronizada, com arquitetura fixa e identidade visual configurável por cliente.

Ordem de leitura recomendada

1. docs/01-visao-do-produto.md
2. docs/02-arquitetura.md
3. docs/03-design-system.md
4. docs/04-paginas-e-secoes.md
5. docs/05-frontend-nuxt.md
6. docs/06-backend-medusa.md
7. docs/07-integracao-front-back.md
8. docs/08-padroes-de-desenvolvimento.md
9. docs/09-roadmap.md
10. docs/10-git-e-versionamento.md
11. docs/11-regras-de-ui.md

Princípios centrais

• A estrutura da loja é fixa.
• O branding da loja e configuravel por instalacao e por codigo no frontend.
• O Medusa é o motor de comércio.
• O Nuxt é a camada de storefront.
• Componentes consomem tokens semânticos, nunca valores visuais hardcoded.
• O banco guarda settings e conteúdo operacional, não guarda HTML ou CSS arbitrário.
• A base de layout e comportamento visual está definida em docs/11-regras-de-ui.md.

Stack atual

• Backend: api/ com Medusa
• Frontend: client/ com Nuxt 4
• Banco: Postgres

Status desta documentação

Esta é a primeira versão da base documental. Ela serve para alinhar direção de produto, arquitetura, design system, integração e roadmap antes da implementação maior.