8.9 KiB
Cards personalizados: ajustes de fidelidade e experiência (S14)
Status: rascunho Atualizado em: 2026-09-12 Issue: #959 Priority: P1 Model: composer-2.5 Impeccable: C — ajustes de fidelidade e interação no funil público de cards (home + compositor) Rascunho UI: docs/plans/cards-personalizados-ajustes-ui-draft.html Appetite: ~1–1,5 dia eng; seis ajustes verificáveis no funil já entregue, sem fluxo novo Responsável: —
Intenção
O S13 (#941) entregou o funil de cards e está em produção: a seção Mostre que você está com Solla na home e o compositor em /cards. O humano revisou o funil e pediu seis ajustes de fidelidade e experiência: o modelo da home deve abrir o compositor ali mesmo; o nome no card gerado deve alinhar à esquerda com a linha SOU; o tile do modelo de nome deve ser fiel ao resultado real; a seção precisa de uma posição melhor na home; a moldura do modal tem um vão interno grande demais; e o texto de ajuda está ilegível por baixo contraste.
É um refinamento do que já existe — nenhum modelo, rota ou mecanismo novo. A promessa ao visitante continua a mesma: mostrar apoio com a identidade oficial, sem conta e sem que nome ou foto saiam do aparelho.
Decisões do humano (2026-09-12, gate): a home passa a abrir o MESMO compositor de /cards (modal no desktop, drawer no mobile), mantendo a pessoa na homepage; o CTA Criar meu card da home é removido — os três modelos passam a ser o único gatilho. Isso reverte deliberadamente a decisão do gate do S13 de que /cards seria a única superfície de edição; o anti-goal "dois fluxos de criação" permanece — há um único editor, não dois.
Persona e fluxo
- Persona / contexto: visitante do site, geralmente no celular, que quer manifestar apoio e publicar uma imagem com a identidade da campanha.
- Job principal: criar um card pessoal com aparência oficial em poucos passos, sem sair de onde está nem entregar dados.
- Fluxo desejado: vê a seção na home → toca em um modelo → o compositor abre ali mesmo (modal no desktop, drawer no mobile) → personaliza e confere → gera e baixa o PNG → fecha e continua na home. Quem chega direto em
/cards(ou por link?model=) mantém o fluxo canônico. - Anti-goals de produto: virar editor gráfico completo, galeria, rede social, cadastro de apoiador, segundo editor ou novo canal de coleta de dados.
Esboço de fluxo (C)
[home: seção "Mostre que você está com Solla"]
→ [toca num modelo]
→ [modal desktop | drawer mobile — compositor aberto na home]
→ [personalizar + conferir] → [card pronto] → [baixar PNG] → [fechar → continua na home]
(caminho canônico preservado: /cards e /cards?model=<id>)
Rascunho UI (C)
- Rascunho UI (gate):
docs/plans/cards-personalizados-ajustes-ui-draft.html - Cenas: home com o compositor aberto em desktop e mobile, tile de nome fiel ao resultado, modal sem vão interno, ajuda legível e a nova ordem das seções.
Objetivo e aceite
- Tocar em um modelo na home abre o compositor ali mesmo, sem navegar; a pessoa permanece na homepage e, ao fechar, volta à seção.
- O CTA
Criar meu cardsai da seção da home: os três modelos são o único gatilho e abrem o compositor ali mesmo. - O nome no card gerado fica alinhado à esquerda com a linha
SOU(borda x≈213), em uma e duas linhas, sem cortar texto; o ajuste de tamanho/quebra atual permanece. - O tile do modelo de nome reproduz o resultado real: mesma borda esquerda do
SOU, fonteBrexter 700, mesma relação de tamanho/cap height e cor#ffec01, comSEU NOMEcomo exemplo. - A seção é reposicionada na ordem da home: imediatamente antes de
Receba as novidades da campanhae depois deAcompanhe de perto, mantendo a captura de contato como último bloco de conversão. - A moldura do modal do compositor encosta no conteúdo (sem o vão interno atual), preservando borda fina e raio.
- O texto de ajuda
Arraste para posicionar e use os controles para aproximar ou ajustar.fica legível nos dois shells (contraste ≥ 4.5:1 sobre branco). - Guardrails: nome e foto continuam 100% no aparelho (sem PII em rede/analytics, sem persistência); arte-mestre intocada;
/cardse o deep-link/cards?model=<id>seguem funcionando; um único editor; as demais seções da home não mudam.
Dados (intenção)
- Vou apresentar dados? Não.
- Decisões desbloqueadas: N/A — esta entrega não apresenta métricas nem dados para uma decisão operacional.
- Forma: adiada ao plano de implementação — nome e foto seguem insumos locais da imagem; nenhum conteúdo pessoal entra em analytics.
Dados da decisão (literais)
- ID reservado:
S14; Tipo:feature; Priority proposta:P1; Model:composer-2.5. - Frase de ajuda literal:
Arraste para posicionar e use os controles para aproximar ou ajustar. - Placeholder literal do tile:
SEU NOME. - Geometria-mestre do nome: borda esquerda x≈213 (canvas de 1080 de largura), tinta máxima 714px, cap height 106px, fill
#ffec01, fonteBrexter 700. - Tokens de contraste:
--campaign-muted: #6c615e,--campaign-ink: #000000. - Rota canônica preservada:
/cardse deep-link/cards?model=<id>. - Seção na home:
id="cards",data-home-section="cards", títuloMostre que você está com Solla; o CTACriar meu cardé removido da home (os modelos são o único gatilho). - Nova ordem da home (decidida no gate):
… → Acompanhe de perto → cards → Receba as novidades da campanha → rodapé. - Arquivos-mestre de referência:
/home/fsolla/Documentos/cards/eu-sou-solla/template-to-com-solla-site.jpg.jpeg(preenchido) e/home/fsolla/Documentos/cards/eu-sou-solla/template-to-com-solla-site-sem-o-nome.jpg.jpeg(base).
Direção no codebase (hipótese)
- Áreas prováveis: seção e ordem da home em
src/app/(frontend)/(home)/, componentes e catálogo emsrc/components/cards/, geometria/render emsrc/lib/card*, tokens emsrc/app/(frontend)/styles.css. - Precedente a olhar: o próprio S13 (
docs/plans/cards-personalizados-campanha.md+-impl.md);CardsStudio/CardComposerpara reusar a ilha na home sem duplicar editor;CardModelTile/NAME_CARD_SLOTpara a fidelidade do tile. - Risco de acoplamento: o vão do modal nasce da classe base
sm:p-8sobrevivendo ao overridep-0(twMerge só remove a variante sem breakpoint); o contraste da ajuda vem deDialogDescription/DrawerDescriptionusaremtext-muted-foreground, que[data-theme='campaign-site']não redefine (cai no near-white do:root). Resolver no menor blast radius, sem criar tema paralelo.
Dependências
- Nenhuma.
Fora de escopo
- Novos modelos, CMS de modelos ou métricas de uso.
- Redesenho das demais seções da home ou da página
/cards. - Remover
/cardsou quebrar o deep-link?model=. - Compartilhamento direto em redes sociais.
- Alterar as artes-mestre (compor por cima, nunca redesenhar).
Rabbit holes de produto
- Segundo editor na home. Se alguém "só completar": nasce um compositor próprio na home e os comportamentos divergem. Corte neste item: a home abre o mesmo compositor, com o mesmo estado e a mesma ilha de edição.
- Redesenhar o modal inteiro. Se alguém "só completar": vira repaginação do compositor. Corte neste item: corrigir o vão da moldura e o contraste da ajuda, sem mudar estrutura.
- Trocar a arte para "melhorar" a fidelidade. Se alguém "só completar": a arte oficial é reeditada. Corte neste item: o resultado segue a arte-mestre; o ajuste é do desenho/tile.
- Medir fidelidade "no olho". Se alguém "só completar": aproximação visual vira critério. Corte neste item: usar a geometria do mestre (borda x≈213, tinta 714, cap 106, Brexter 700,
#ffec01).
Questões em aberto (produto)
- Onde a seção entra na home? Decidido no gate (2026-09-12): antes de
Receba as novidades da campanhae depois deAcompanhe de perto— mantém a captura de contato como último bloco de conversão. - O que faz o CTA
Criar meu cardda home? Decidido no gate (2026-09-12): o CTA é removido da home — tocar num modelo já abre o compositor de criação; a seção fica só com os três modelos como gatilho. /cardscontinua existindo? Decidido no gate (2026-09-12): sim, como página canônica e deep-link; a mudança é só o comportamento da home.
Referências
- GitHub Issue #941 (S13, entregue)
docs/plans/cards-personalizados-campanha.mdedocs/plans/cards-personalizados-campanha-impl.mddocs/changelog/2026-09-12-s13-cards-personalizados.md- Rascunho UI (gate):
docs/plans/cards-personalizados-ajustes-ui-draft.html src/app/(frontend)/(home)/CampaignCardsSection.tsx,src/app/(frontend)/(home)/page.tsx,src/app/(frontend)/(home)/cards/page.tsxsrc/components/cards/{CardsStudio,CardComposer,CardModelGallery,CardModelTile}.tsx,src/lib/{cardModels,cardNameFit,cardRender}.tssrc/app/(frontend)/styles.cssesrc/app/(frontend)/fonts.tsAGENTS.mdeAGENTS-public.md