Prumo — loja demo do nicho de moda masculina

Cópia do starter ecomplus/store tematizada para moda masculina (alfaiataria e camisaria). É a segunda metade do par de moda, junto com store-alinhavo.

Este nicho ainda não existe no site institucional. Não há marca em src/config/brands.ts nem página em /segmentos/. O posicionamento foi proposto, não portado. Nome, logo e domínio são placeholders.

Por que duas lojas de moda, e não uma

A diferença entre as duas não é a foto: é o eixo de compra, e é isso que justifica ter as duas como demos separadas.

	Alinhavo (feminina)	Prumo (masculina)
Eixo	Descoberta	Repetição
Navegação	Por ocasião (trabalho, festa, praia)	Por medida (colarinho 39, manga 62)
Problema central	Achar a peça certa e acertar a grade	Repor o mesmo item sem refazer a pesquisa
Bloco de fecho	Primeira troca de tamanho grátis	Repetir o último pedido em um clique
Ciclo	Muda a cada estação	Camisa branca não muda de estação

O bloco de recompra do Prumo é aplicação direta do "repetir último pedido" que a auditoria de recursos lista como parte do smart shelves da Atlas Parafusos — hoje construído sob medida em uma loja só, marcado como PARCIAL, ainda fora do template padrão.

O que foi customizado em relação ao starter

Arquivo	O que mudou
functions/ssr/content/settings.json	Nome, descrição, domínio, logo/ícone, primaryColor verde-loden + secondaryColor latão, 5% no Pix, 6x sem juros, frete grátis a partir de R$ 349
functions/ssr/tailwind.config.js	Escala neutra levemente esverdeada, canto quase reto
functions/ssr/content/layout.json	Pitch bar (medida, frete, Pix), listas do rodapé, ogImage
functions/ssr/content/pages/home.json	Hero de 2 slides, 3 vitrines, grade de 3 banners e a seção de nicho
functions/ssr/src/sections/NichoModaMasculinaSection.astro	Novo. Régua de medidas em cm, três caimentos declarados e chamada de recompra
functions/ssr/src/sections/_Sections.astro	Registro da seção c:nicho-moda-masculina
functions/ssr/content/extra-pages/	Contato, trocas e termos em PT-BR
functions/ssr/public/img/uploads/	Banners do Unsplash; imagens do starter removidas. Créditos em CREDITOS.md

Por que loden e não azul-marinho

Azul-marinho é o lugar-comum da categoria, e o azul-aço já está ocupado pela variante de clubes de tiro. O verde-loden com latão vem do vestuário masculino de herança (militar/utilitário), que é o campo de referência do nicho — e é o que a foto de banner (arara de peças em terrosos e mostarda) já entrega.

Por que a seção de nicho é um componente, e não HTML no CMS

O UnoCSS/Tailwind desta stack varre apenas ./src/** — classe utilitária escrita dentro de content/pages/*.json (seção custom-html) não gera CSS. Por isso a vitrine do nicho é um .astro em src/sections/, registrado pela convenção c: que o _Sections.astro já previa.

Rodando

npm i
npm run dev     # http://localhost:3000
npm run build

O catálogo é remoto: sem uma loja E-Com Plus configurada (npm run setup), as vitrines de produto vêm vazias — o hero, os banners e a seção de nicho renderizam normalmente.

Pendências conhecidas

• A régua de medidas é maquete estática. Não vem do cadastro de produto.
• O "repetir pedido" é copy, não recurso. O link vai para /app/account, que existe no starter, mas o fluxo de um clique descrito na seção depende do smart shelves ser produtizado. Está marcado no componente.
• Logo e ícone são wordmarks placeholder rasterizados. Ao fechar a identidade, vetorizar o texto.
• As rotas (/s/camisaria, /p/medidas…) só respondem depois que o catálogo tiver as categorias correspondentes.
• Se a hipótese avançar, vale criar a marca em brands.ts e a rota /demo/prumo no site, como já existe para as três primeiras variantes.

Como atualizar a base da plataforma

Este repositório é uma casca fina. O storefront, os componentes e a lógica de loja moram nos pacotes @cloudcommerce/*, não aqui. Atualizar o tema para uma versão nova da plataforma não é fazer merge com o starter ecomplus/store — é subir a versão das dependências, exatamente como as lojas em produção fazem: a tiasonia tem mais de 260 commits Update to v no próprio repositório e nenhum merge com o starter.

Todos os pacotes @cloudcommerce/* andam na mesma versão, na raiz e em cada grupo de functions (ssr, many, with-apps):

# 1. ver a versão mais recente e o changelog
npm view @cloudcommerce/cli version
# https://github.com/ecomplus/cloud-commerce/releases

V=2.61.4   # troque pela versão alvo

# 2. raiz
npm i -D @cloudcommerce/cli@$V @cloudcommerce/eslint@$V

# 3. cada grupo de functions
(cd functions/ssr && npm i \
  @cloudcommerce/api@$V @cloudcommerce/firebase@$V @cloudcommerce/ssr@$V \
  @cloudcommerce/i18n@$V @cloudcommerce/storefront@$V @cloudcommerce/types@$V)
(cd functions/many && npm i \
  @cloudcommerce/feeds@$V @cloudcommerce/firebase@$V @cloudcommerce/passport@$V)
(cd functions/with-apps && npm i \
  @cloudcommerce/events@$V @cloudcommerce/firebase@$V @cloudcommerce/modules@$V)

# 4. validar antes de commitar
npm run build

# 5. commitar no padrão das lojas em produção
git commit -am "Update to v$V"

Se o build quebrar depois de atualizar, a correção pertence ao cloud-commerce, não a este repositório. Aqui só entra o que é do tema: functions/ssr/src/, functions/ssr/content/ e functions/ssr/public/.

Este repositório é um template

Use "Use this template" no GitHub para começar uma loja a partir deste tema. O repositório gerado é independente: não existe upstream para puxar, e a manutenção segue o fluxo de versão acima.

Antes de ir ao ar, troque o que é placeholder:

• functions/ssr/content/settings.json — nome, domínio, logo, cores, contato
• functions/ssr/public/img/uploads/ — logo, ícone e banners (as fotos atuais vêm do Unsplash; créditos em CREDITOS.md)
• functions/ssr/content/extra-pages/ — contato, trocas e termos
• functions/ssr/public/robots.txt — hoje bloqueia tudo, porque a demo é noindex
• functions/*/config.json — storeId e projeto Firebase (npm run setup)

Demo publicada: tema-prumo.web.app — noindex, com catálogo compartilhado de demonstração.

---

Documentação do starter: SETUP.pt-BR.md · Cloud Commerce