8.6 KiB
Card "Time de você": harmonizar as cores da foto do visitante com o time
Status: rascunho Atualizado em: 2026-09-19 Issue: #1196 Priority: P2 Impeccable: C — novo controle em estados já existentes de um funil público Design UI: docs/plans/cards-time-de-voce-harmonizar-cores-ui-design.html Appetite: ~0,5–1 dia eng; um toggle que deixa a foto do visitante com o tom do time Responsável: —
Intenção
O "Time de você" (S15, #1161, entregue em 2026-09-18) deixou o visitante entrar no card com a própria cara — mas quase sempre com uma selfie de celular ao lado de candidatos fotografados por profissional. O recorte fica bom e a foto ainda assim "destoa" do resto: luz mais quente ou fria, contraste e saturação em outra faixa. O pedido do humano foi literal: "Seria possivel fazer automaticamente algum balanceamento de cores na foto do usuario para encaixar melhor com as fotos dos candidatos que são profissionais? Talvez possa ser um 'filtro' ativavel ou não, um toggle que o usuario seleciona ou não."
A S15 listou "correção automática de foto" como rabbit hole e não a entregou; agora o humano pede isso de propósito. É item novo (S15 não é editado), com escopo pequeno e explícito: um toggle que ajusta a foto, não um editor.
Persona e fluxo
- Persona / contexto: militante no celular, escolheu uma selfie razoável; vê a prévia e sente que a foto "não parece do time" ao lado dos candidatos.
- Job principal: o card ficar harmônico sem virar edição de imagem e sem perder a cara dele.
- Fluxo desejado: foto recortada e prévia prontas → vê o controle "Harmonizar cores" ligado por padrão → desliga e a foto original volta na hora → baixa o PNG com a escolha que deixou na tela.
- Anti-goals de produto: editor de imagem (slider de cor/curvas/presets), filtro "instagramável", promessa de "parecer profissional", retoque de pele, alterar os 3 modelos existentes, upload/serviço/rede, analytics, persistência, segundo fluxo.
Esboço de fluxo (C)
[estado pronto do Time de você] → [controle "Harmonizar cores" LIGADO por padrão]
→ [desligar = foto original | religar] → [PNG com a escolha atual]
Design UI (C)
- Design UI (gate):
docs/plans/cards-time-de-voce-harmonizar-cores-ui-design.html— cenas: controle no estado pronto (ligado/desligado), prévia antes/depois e card baixado, desktop e mobile. Design tier: DEGRADED— o frontieropenai/gpt-5.6-solbateu quota; o artefato saiu dodesigner-degradede não certifica: exige sign-off humano no gate/PR.
Objetivo e aceite
- No estado em que a foto já está pronta, o visitante vê "Harmonizar cores" com ajuda curta em pt-BR; funciona por toque e teclado (alvo ≥44px).
- Padrão ligado: a prévia abre harmonizada; desligar devolve a foto original instantaneamente e religar reaplica.
- A escolha vale para a prévia e para o PNG baixado; nada é persistido — sair e voltar volta ao padrão ligado.
- O ajuste é automático, suave e limitado ao tom das fotos oficiais dos candidatos (referência: arte-mestre
public/cards/team-card-base.png); não é retoque de beleza (nada de pele, forma ou imperfeições) e nunca altera o recorte. - 100% no aparelho: sem upload, sem analytics de PII, sem nova dependência de rede; vale só para
time-de-voce(os 3 modelos existentes intocados). - A nota de privacidade existente (
CARD_PRIVACY_NOTE/CARD_PHOTO_PRIVACY_NOTE) continua visível e verdadeira.
Dados (intenção)
- Vou apresentar dados? Não.
- Decisões desbloqueadas: N/A — nenhum dado novo é apresentado; a escolha do toggle é local e não gera métrica.
- Forma: adiada ao plano de implementação — medir "quantos ligam" seria analytics de interação, fora deste item.
Dados da decisão (literais)
- ID
S17; slugcards-time-de-voce-harmonizar-cores(arquivodocs/plans/cards-time-de-voce-harmonizar-cores.md); tipofeature; PriorityP2; ImpeccableC — novo controle em estados já existentes de um funil público; Design UIdocs/plans/cards-time-de-voce-harmonizar-cores-ui-design.html. - Rótulo do controle:
Harmonizar cores; ajuda curta em pt-BR (ex.: "Ajusta o brilho e as cores da sua foto para combinar com as fotos do card."). - Padrão LIGADO; desligar devolve a foto original instantaneamente; a escolha vale para a prévia e para o PNG baixado; nada é persistido.
- Ajuste automático, suave e limitado: aproxima brilho, contraste e saturação da foto do visitante do tom das fotos oficiais dos candidatos; referência: arte-mestre
public/cards/team-card-base.png; não é retoque de beleza (sem suavizar pele, sem mudar forma, sem remover imperfeições); nunca altera o recorte. - 100% no aparelho, sem upload, sem analytics de PII, sem nova dependência de rede; vale só para o modelo
time-de-voce(os 3 modelos existentes intocados). - Sem pin de modelo de execução (roda no modelo padrão da sessão; provider
openaié reservado ao design). - A nota de privacidade existente continua visível e verdadeira (o ajuste não muda o que ela promete).
Direção no codebase (hipótese)
- Áreas prováveis: processamento de pixel local no recorte (
src/components/cards/cardCutout.ts/useCardCutout.ts) ou no render puro (src/lib/cardRender.ts), via contexto estrutural; estado do toggle noCardComposer.tsx(controles do estado pronto). - Precedente a olhar:
src/components/CampaignNewsletterForm.tsx(forms/controles) e tokens do temacampaign-siteemsrc/app/(frontend)/styles.css(--pt-red,--campaign-line,--campaign-ink,--campaign-muted,--field-border,--team-blue);src/components/uinão tem shadcn Switch — o app usa radixToggle/Checkboxe botõesaria-pressed. - Risco de acoplamento: o recorte (
composeCutout/máscara) não pode ser alterado; os 3 modelos existentes não podem mudar; sem rede/dependência nova; testes de unidade (se o ajuste nascer no recorte, specs próprios; semprecardRender.unit.spec.ts) e e2etests/e2e/frontend.e2e.spec.ts(describe Time de você, stub do motor viaNEXT_PUBLIC_CARDS_CUTOUT_STUB=1) — o e2e falha em qualquer console error.
Dependências
- S15 (#1161) entregue em 2026-09-18 — é o fluxo onde o controle entra.
- Sem dependência dura de S16/S18.
Fora de escopo
- Editor de imagem: slider de cor, curvas, presets, ajuste manual.
- Filtro "instagramável", promessa de "parecer profissional" e retoque de beleza (pele, forma, imperfeições).
- Alterar os 3 modelos existentes ou as artes-mestre.
- Upload/serviço/rede, analytics, persistência, segundo fluxo.
Rabbit holes de produto
- O toggle virar editor. Se alguém "só completar": nascem sliders de cor/curvas, presets e pack de filtros "de marca". Corte neste item: um controle binário, sem ajuste manual.
- Escorregar para retoque de beleza. Se alguém "só completar": suaviza pele e "melhora" o rosto. Corte neste item: só brilho/contraste/saturação, nada de forma ou pele.
- Processar no servidor ou baixar modelo pesado. Se alguém "só completar": quebra a promessa de 100% no aparelho. Corte neste item: local, sem rede, sem dependência nova.
Questões em aberto (produto)
- Padrão ligado ou desligado? Opções: ligado | desligado. Recomendação: ligado — é o pedido literal do humano e o card fica bom sem exigir decisão. (decidido nos literais; confirmar no gate)
- Referência de tom medida na arte dos candidatos ou perfil fixo calibrado? Opções: medir a arte-mestre
team-card-base.png| perfil fixo (números calibrados uma vez). Recomendação: medir a arte como referência, com limites fixos de intensidade — segue o tom real do card sem virar "filtro da casa". (assumido — validar com produto) - Toggle só no estado pronto ou também no estado vazio? Opções: só no estado pronto | também antes da foto. Recomendação: só no estado pronto — sem foto não há o que harmonizar, e o estado vazio já tem carga própria. (assumido — validar com produto)
Referências
- GitHub Issue #1196
- Design UI (gate):
docs/plans/cards-time-de-voce-harmonizar-cores-ui-design.html(+ assets emcards-time-de-voce-harmonizar-cores-ui-design-assets/) docs/plans/cards-time-de-voce.md/cards-time-de-voce-impl.md(S15) — o fluxo onde o controle entrapublic/cards/team-card-base.png— arte-mestre usada como referência de tomsrc/components/cards/cardCutout.ts,useCardCutout.ts,CardComposer.tsx,src/lib/cardRender.ts,cardCopy.tssrc/components/CampaignNewsletterForm.tsx;src/app/(frontend)/styles.css;tests/e2e/frontend.e2e.spec.ts;AGENTS.md(provideropenaireservado ao design)