teqo-backup/docs/plans/corte-pagina-publica-design.md
Francisco Solla 4e9b11d991 docs(plan): C172–C178 + OPS122 — acervo/cortes, player e launch do worktree
Planos de intenção + designs hi-fi do gate para o lote pós-teste do dono:
- C178 #1081 player do YouTube sem parede de signin (defect, P1)
- C172 #1082 player/link no ponto certo da fala (defect, P1)
- C173 #1083 pré-visualizar o trecho selecionado (P2)
- C174 #1084 encontrar cortes (nav, fala, busca) (P2)
- C175 #1085 preview do trecho na listagem (P2)
- C176 #1086 página pública do corte — design (P2)
- C177 #1087 'Abrir fonte' só com fonte oficial (chore, P3)
- OPS122 #1088 launch do worktree honra modelo e --auto (defect, P2)

Related #1081, #1082, #1083, #1084, #1085, #1086, #1087, #1088
2026-09-16 10:44:57 -03:00

8.4 KiB
Raw Permalink Blame History

Página pública do corte: revisão de design

Status: rascunho Atualizado em: 2026-09-16 Issue: #1086 Priority: P2 Impeccable: C — superfície pública existente redesenhada (a página /corte/<id>) Design UI: docs/plans/corte-pagina-publica-design-ui-design.html Appetite: ~1–1,5 dia eng; um outcome verificável — a página pública do corte passa a ser bonita e compartilhável, e o conteúdo não fica sobre um fundo colorido incômodo. Responsável: —

Intenção

"A página pública do corte não está bonita; revise o design da página pública de corte. Uma coisa que me incomodou foi o fundo colorido do conteúdo." O link /corte/<id> é a ponta do compartilhamento WhatsApp-first do acervo: é o que um cidadão abre no celular depois de receber o link. Hoje a página funciona (player, título, descrição, share) mas não parece uma peça cuidada — e o conteúdo parece assentar sobre uma superfície colorida que incomoda. Esta fatia redesenha SÓ essa página para que o vídeo seja o herói, a leitura seja confortável e o resultado dê orgulho de repassar, sem tocar no contrato (rota, unlisted/noindex, metadata). A origem do "fundo colorido" será investigada e eliminada como requisito explícito de design.

Persona e fluxo

  • Persona / contexto: quem recebe o link no WhatsApp — cidadão/eleitor no celular, com pressa e distração; secundariamente a assessoria que envia e quer um link apresentável.
  • Job principal: assistir ao trecho e, se gostar, repassar ou baixar, percebendo na hora que é peça oficial do mandato.
  • Fluxo desejado: abre o link → capa do player (vídeo como herói) → dá play e assiste → lê título, meta e descrição com conforto → "Compartilhar no WhatsApp" (primário) ou "Baixar arquivo (MP4)" → vê o crédito CC BY e a nota de não listagem.
  • Anti-goals de produto: não vira galeria/índice público; não vira embed de YouTube; não expõe transcrição/internals; não promete o que a campanha não pode verificar; não muda rota nem indexação.

Esboço de fluxo (C)

[link no WhatsApp] → /corte/<id> (unlisted, noindex)
→ capa do player (herói) → play e assiste
→ título + meta (tipo · data · duração) + descrição
→ Compartilhar no WhatsApp (primário) · Copiar link · Baixar arquivo (MP4)
→ crédito CC BY + nota "página não listada"
[despublicado/id inexistente] → mesma tela "Este corte não está disponível"

Design UI (C)

  • Design UI (gate): docs/plans/corte-pagina-publica-design-ui-design.html — cenas desktop (~1280), mobile (~390) e indisponível/despublicado; no fundo do conteúdo, nenhuma superfície tintada.

Objetivo e aceite

  • A página lê como peça cuidada e compartilhável: o vídeo é o herói, com hierarquia clara título → meta → descrição → ações.
  • O conteúdo textual assenta em superfície neutra do site público; nenhum fundo colorido/tintado atrás do texto (sem faixa, card colorido ou gradiente sob título/descrição).
  • Compartilhar é WhatsApp-first e mobile-first: ação primária evidente acima da dobra no celular; download do MP4 ao lado.
  • Leitura confortável: medida de prosa controlada, contraste AA, tamanho/entrelinha adequados no celular.
  • Publicado (com e sem link de sessão no YouTube) e indisponível/despublicado — ambos coerentes e bonitos.
  • Guardrails: unlisted/noindex preservado; rota /corte/<id> e contrato inalterados; sem transcrição/internals; crédito Fonte: Câmara dos Deputados · CC BY 4.0 visível; sem galeria indexável.

Dados (intenção)

  • Vou apresentar dados? Não — superfície de assistir/ler/compartilhar; nenhum KPI/gráfico novo.
  • Decisões desbloqueadas: quem recebe decide assistir/repassar; a assessoria decide se o link está apresentável para enviar. Sem decisão nomeável → nada a medir.
  • Forma: N/A — sem dado agregado nem visualização a definir.

Dados da decisão (literais)

  • Copy pt-BR fixada: primário Compartilhar no WhatsApp; secundárias Copiar link e Baixar arquivo (MP4); crédito Fonte: Câmara dos Deputados · CC BY 4.0; nota Página não listada — o link circula, mas não é indexada nem aparece em buscas.; link opcional Ver sessão no YouTube ↗.
  • Título de indisponível: Este corte não está disponível (id inexistente e despublicado usam a MESMA tela — não revela existência).
  • Meta linha: <tipo> · <data da fala> · <duração> (ex.: Discurso · 12/08/2026 · 2:14).
  • Rota /corte/<id> inalterada; robots: { index: false, follow: false } inalterado.
  • Requisito explícito: zero fundo tintado atrás do conteúdo — fundo = superfície neutra do site público (background/card, conforme DESIGN.md), jamais scope/support-*/editorial-bg/gradiente sob o texto.
  • Fonte do vídeo: o MP4 armazenado (media.url) — nunca YouTube/VOD como player.

Direção no codebase (hipótese)

  • Áreas prováveis: src/app/(frontend)/corte/[id]/page.tsx; src/components/SpeechCutShareActions.tsx; src/components/SiteHeader.tsx; superfícies/tokens públicos em src/app/(frontend)/**.
  • Precedente a olhar: páginas públicas de artigo [type]/[category]/[slug]/page.tsx (superfície de prosa); DESIGN.md (themes editorial/petition, "Public header: Header Crimson").
  • Risco de acoplamento: não tocar metadata/OG nem a resolução do id (C167); o card do acervo reusa SpeechCutShareActions (prop primary) — acabamento visual não pode quebrar esse uso.

Dependências

  • C167 entregue — a página pública e a rota já existem. Nenhuma dependência nova.

Fora de escopo

  • Qualquer mudança de rota, metadata/Open Graph, indexação ou contrato de compartilhamento (C167 congelado).
  • Galeria/listagem pública de cortes, busca, perfil (unlisted por desenho).
  • Transcrição, legendas, player custom, fundo alternativo de download.
  • Redesign do header do site ou da paleta global — apenas a superfície desta página.

Rabbit holes de produto

  • Redesign do site inteiro ("já que estou aqui"). Se alguém "só completar": mexer no SiteHeader, na home, na paleta. Corte neste item: só a página /corte/<id> (no máximo, o acabamento da share kit dentro dela).
  • Player custom/branded. Se alguém "só completar": controles próprios, autoplay, capa animada. Corte: <video controls> com poster, só acabamento visual.
  • Inventar contexto/claims sobre a fala. Se alguém "só completar": biografia, números, "assista e compartilhe" com promessa. Corte: título/descrição reais de C167 + meta mínima; nada não verificável.

Questões em aberto (produto)

  • Quanto contexto da fala mostrar? Opções: A) só o corte + crédito | B) meta mínima (tipo · data · duração) + link do YouTube quando houver | C) bloco de contexto maior. Recomendação: B — dá credibilidade e data sem virar verbete. (assumido — validar com produto)
  • Onde fica a share kit? Opções: A) logo abaixo do player (acima da descrição) | B) abaixo da descrição | C) CTA fixo no rodapé mobile. Recomendação: A — WhatsApp primário visível acima da dobra mobile; sem CTA fixo nesta fatia.
  • Tratar a origem do "fundo colorido"? Opções: A) só garantir superfície neutra no redesign | B) investigar e remover o token tintado que a produção aparenta usar. Recomendação: B fail-safe — investigar a origem (theme/editorial-bg/gradiente do body) e forçar superfície neutra local. (assumido — validar com produto)

Referências

  • GitHub Issue #1086
  • Design UI (gate): docs/plans/corte-pagina-publica-design-ui-design.html (+ assets em corte-pagina-publica-design-ui-design-assets/ se houver)
  • DESIGN.md — "The Field Desk", themes editorial/petition, Signal Red Rule, header público.
  • AGENTS-public.md — convenções do site público (corta quando toca (frontend)).
  • Planos C167: docs/plans/c167-cortar-trecho-publicar.md e ...-impl.md (rota, anti-goals, unlisted/noindex).
  • Arquivo pivô: src/app/(frontend)/corte/[id]/page.tsx.
  • Doutrina do design hi-fi: .agents/skills/plan-issue/ui-design-html.md.

Self-score (shaping)

5/5 — (1) fatia = um outcome verificável (página bonita, compartilhável, sem fundo tintado); (2) appetite ~1–1,5 dia cabe com design hi-fi + port da página; (3) persona/job/aceite em linguagem de produto; (4) direção no codebase é hipótese; (5) zero decisão dura de engenharia.