teqo-backup/docs/plans/cards-personalizados-ajustes.md

8.9 KiB
Raw Permalink Blame History

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 card sai 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, fonte Brexter 700, mesma relação de tamanho/cap height e cor #ffec01, com SEU NOME como exemplo.
  • A seção é reposicionada na ordem da home: imediatamente antes de Receba as novidades da campanha e depois de Acompanhe 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; /cards e 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, fonte Brexter 700.
  • Tokens de contraste: --campaign-muted: #6c615e, --campaign-ink: #000000.
  • Rota canônica preservada: /cards e deep-link /cards?model=<id>.
  • Seção na home: id="cards", data-home-section="cards", título Mostre que você está com Solla; o CTA Criar 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 em src/components/cards/, geometria/render em src/lib/card*, tokens em src/app/(frontend)/styles.css.
  • Precedente a olhar: o próprio S13 (docs/plans/cards-personalizados-campanha.md + -impl.md); CardsStudio/CardComposer para reusar a ilha na home sem duplicar editor; CardModelTile/NAME_CARD_SLOT para a fidelidade do tile.
  • Risco de acoplamento: o vão do modal nasce da classe base sm:p-8 sobrevivendo ao override p-0 (twMerge só remove a variante sem breakpoint); o contraste da ajuda vem de DialogDescription/DrawerDescription usarem text-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 /cards ou 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 campanha e depois de Acompanhe de perto — mantém a captura de contato como último bloco de conversão.
  • O que faz o CTA Criar meu card da 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.
  • /cards continua 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.md e docs/plans/cards-personalizados-campanha-impl.md
  • docs/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.tsx
  • src/components/cards/{CardsStudio,CardComposer,CardModelGallery,CardModelTile}.tsx, src/lib/{cardModels,cardNameFit,cardRender}.ts
  • src/app/(frontend)/styles.css e src/app/(frontend)/fonts.ts
  • AGENTS.md e AGENTS-public.md