16 KiB
Home — escolher o estadual da dobradinha, montar e compartilhar a colinha
Status: rascunho Atualizado em: 2026-10-01 Issue: #1404 Priority: P1 Impeccable: B — seção nova na home com seletor próprio e reuso da folha de compartilhamento Design UI: docs/plans/home-colinha-estadual-ui-design.html Appetite: ~1,5–2 dias eng; um outcome verificável (o visitante sai da home com a colinha do estadual — PNG e mensagem — e o link reabre a mesma colinha) Responsável: —
Intenção
Na reta final até 04/10, quem já está com Solla no grupo de WhatsApp precisa da colinha certa: o número do deputado estadual da dobradinha do seu território. A colinha já existe dentro do estúdio de cards (modelo Minha colinha, S31/S34) e a escolha do estadual vive dentro do composer — quem chega pela home não descobre que isso existe nem tem um caminho de um toque até o estadual dele. Este item dá à home uma seção própria: a lista dos estaduais com busca e card (foto, nome, número), a colinha montada no mesmo editor e o compartilhamento no mesmo idioma da Central de Conteúdos. É uma porta de entrada nova para o mesmo produto, não um segundo estúdio.
A campanha tem as dobradinhas na plataforma (stateDeputy) e o material de divulgação da Plenária da Vitória (54 dobradinhas, foto + card). A home mostra só quem casa nas duas pontas — quem não tem número/foto não aparece (fail-closed), porque a base não tem número de urna e nada é inventado.
Persona e fluxo
- Persona / contexto: militante/eleitor no celular, grupo de WhatsApp aberto, já decidido no 1313, querendo o número do estadual da dobradinha do seu município — chegou pela home ou recebeu um link.
- Job principal: achar o seu estadual, sair com a colinha pronta (PNG + mensagem) e mandar para o grupo sem cadastro, sem digitar e sem errar o número.
- Fluxo desejado: rola a home até a seção nova (ou abre o link direto recebido) → a prévia da colinha já aparece na própria seção com
BaixareCompartilharsempre disponíveis → digita o nome na busca e escolhe o estadual (desktop: rolagem vertical da lista; mobile: carrossel horizontal de uma linha) → a prévia atualiza na hora com a linha do estadual preenchida → baixa o PNG 1080×1920 → compartilha no WhatsApp (mensagem editável + link) ou manda o PNG pela folha do aparelho (Instagram e afins) → quem recebe o link cai na mesma seção com a colinha daquele estadual. Sem escolha, a colinha é válida: sai só com as cinco linhas fixas e o link sem?estadual=. - Anti-goals de produto: segundo estúdio/editor; diálogo de montagem separado (a prévia é embutida); mini-CMS de dobradinhas; ranking/placar de estaduais; paginação/“carregar mais”; página por estadual nesta fatia; PII, cadastro, upload ou foto do visitante; envio automático ou destinatário; qualquer métrica nova.
Esboço de fluxo (B)
[home: nova seção (ou link direto /?estadual=<slug>#colinha)]
→ prévia da colinha SEMPRE visível na seção + Baixar/Compartilhar SEMPRE habilitados
→ busca "meu estadual" → lista com cards (foto · nome · número)
desktop: grade em rolagem vertical (sem paginação) · mobile: carrossel horizontal de uma linha
→ escolhe (opcional) → a prévia atualiza na hora com a linha do estadual preenchida
→ baixa o PNG 1080×1920 (sem escolha: só as cinco linhas fixas)
→ compartilha: WhatsApp (mensagem editável + link) · folha nativa com o PNG (senão baixa) · copiar link
→ quem recebe o link cai na mesma seção com a colinha daquele estadual
[candidato sem material oficial / slug desconhecido] → não aparece na lista / cai no estado normal (fail-closed)
Design UI (B)
- Design UI (gate):
docs/plans/home-colinha-estadual-ui-design.html(+ assets emhome-colinha-estadual-ui-design-assets/) — cenas: seção com busca, lista (desktop em rolagem vertical; mobile em carrossel horizontal de uma linha) e a prévia da colinha embutida nos dois estados (sem estadual = cinco linhas fixas; com estadual = linha preenchida), busca ativa/estado vazio, chegada pelo link direto (prévia já preenchida, sem diálogo), folha de compartilhamento e o recorte de candidato sem material (não aparece na lista); ~390 e ~1280. Posição da seção na home (sugestão: logo depois da seção#cards, antes da Central) entra na cena do fluxo para validação no gate.
Objetivo e aceite
- A home ganha a seção âncora (
#colinha) com busca de estadual; cada card mostra foto, nome e número; a lista é a interseção plataforma × material — sem material oficial, o estadual não aparece, nunca com número/foto inventados. - A prévia da colinha vive na própria seção e é o estado inicial: sem nenhum estadual escolhido ela mostra só as cinco linhas fixas; escolhido um card, a linha
DEPUTADO ESTADUALpreenche na hora e as cinco linhas fixas ficam intocadas. Não há diálogo de montagem separado. Baixar o PNGeCompartilharficam sempre habilitados, com ou sem estadual escolhido; sem escolha, o PNG sai com as cinco linhas fixas e o compartilhamento usa a mensagem/link sem o estadual.- O download é o mesmo PNG 1080×1920 do estúdio — mesmo render, um só editor; nenhuma segunda via de geração.
- Navegação da lista sem paginação: no desktop os cards rolam verticalmente (grade na própria página, todos alcançáveis); no mobile são um carrossel de uma linha com rolagem horizontal — nenhum botão de página/“carregar mais”.
- Compartilhar usa a mesma folha/vocabulário: WhatsApp com mensagem editável + link, folha nativa do aparelho com o PNG gerado (fallback: baixar o PNG) e copiar link; sem destinatário e sem envio automático.
- O link direto
/?estadual=<slug>#colinhareabre a seção com aquele estadual pré-selecionado e a prévia já preenchida; sem?estadualo link abre a seção no estado sem escolha; slug desconhecido ou sem material cai no estado normal, sem erro. - Sem PII, sem login, sem upload e sem
Consentnovo; a nota de privacidade do estúdio continua verdadeira e a foto do visitante não entra aqui. - Sem candidato com material, a seção continua útil: a lista mostra o estado vazio e a colinha (sem estadual) segue baixável/compartilhável; sem overflow horizontal fora do carrossel mobile.
Dados (intenção)
- Vou apresentar dados? Não.
- Decisões desbloqueadas: N/A — nenhuma decisão nova; a leitura de uso segue sendo a do contador anônimo existente (S32) se o download for o mesmo, sem evento novo.
- Forma: adiada ao plano de implementação — restrição de produto: nenhuma métrica/superfície de dados nasce aqui.
Dados da decisão (literais)
- Item
S43; slughome-colinha-estadual(arquivodocs/plans/home-colinha-estadual.md); tipofeature; PriorityP1; ImpeccableB — seção nova na home com seletor próprio e reuso da folha de compartilhamento; Design UIdocs/plans/home-colinha-estadual-ui-design.html. - Fonte da lista: dobradinhas da plataforma (
stateDeputy), excluindo registros cujo nome contenha "apagar" (case-insensitive; convenção da equipe para marcar registros a remover); a lista exibida é a interseção com quem tem material oficial (foto + número). - Material da Plenária da Vitória (origem fora do repo; o repo recebe só derivativos otimizados, convenção S30):
/home/fsolla/Downloads/CARDS-PLENARIA-DA-VITORIA/<Nome> - card.png,/home/fsolla/Downloads/DOBRADINHAS-ORGANIZADAS/<Nome>/foto.pnge a lista/home/fsolla/Downloads/DOBRADINHAS-ORGANIZADAS/LISTA-DOBRADINHAS.txt— 54 dobradinhas. - Descompasso conhecido a resolver no cruzamento (mapa explícito e versionado, nunca casamento por semelhança em tempo de render):
Dr. Armandotem material e não tem entrada no catálogo S30;Marlenne(material) ≠Marlene do Sindicato(catálogo);Radiovaldo Costa(material) ≠Radiovaldo(catálogo). - Colinha: model id
minha-colinha; saída PNG 1080×1920; as cinco linhas fixas já contratadas (S31/S34) ficam intocadas — só a linhaDEPUTADO ESTADUAL <nome de urna> — <5 dígitos>é preenchida. Dois estados válidos: sem estadual (a prévia/PNG sai só com as cinco linhas fixas) e com estadual (linha preenchida). - Navegação da lista: desktop = rolagem vertical (grade que flui na página; sem paginação); mobile = carrossel horizontal de uma linha (todos os estaduais alcançáveis por rolagem lateral); nunca paginação/“carregar mais”.
- Link direto:
/?estadual=<slug>#colinha(com estadual) e/#colinha(sem estadual); sem rota nova nesta fatia; slug desconhecido/sem material cai no estado normal da seção, sem erro. - Copy da mensagem (assumida — validar com produto): com estadual
Montei minha colinha: [NOME] [NÚMERO] para deputado estadual, com Jorge Solla 1313. Monte a sua: [link]; sem estadualMontei minha colinha de votação com Jorge Solla 1313. Monte a sua: [link]; alternativa com estadualColinha pronta: 1313 para deputado federal e [NÚMERO] para estadual. Monte a sua: [link]. - Share: WhatsApp com a mensagem editável + link; Instagram/outros pela folha nativa do aparelho com o PNG gerado (fallback: baixar o PNG); copiar link — sem destinatário e sem envio automático; nenhum canal novo.
- Sem PII, sem login, sem upload, sem
Consentnovo; a foto do card é do candidato (asset do site), a do visitante não entra neste fluxo.
Direção no codebase (hipótese)
- Áreas prováveis: nova seção na home (
src/app/(frontend)/(home)/page.tsx) no padrão server → ilha client da S39/S42 (ContentPieceHomeSection→ContentPieceHomeBoard); o funil de cards emsrc/components/cards/(CardComposer,StateDeputySelect,cardCanvas); a folha de share emsrc/components/conteudos/ContentPieceShareSheet.tsx; catálogo no formato desrc/lib/stateDeputyCatalog.ts(pista, não necessariamente o dono da nova lista); geração do cruzamento com precedentesscripts/build-state-deputy-card-assets.mjsescripts/regenerate-municipality-catalog-snapshot.mjs. - Precedente a olhar: S39/S42 (seção na home + folha de compartilhar), S27 (
ContentPieceShareSheet), S30/S31/S34 (catálogo, seletor e colinha), S32/C213 (contador anônimo). - Risco de acoplamento: o estúdio tem UM editor — a seção só abre o mesmo fluxo, nunca um render/download paralelo; a folha é o único mecanismo de share; diretório novo sem entrada no
scripts/lib/e2e-affected-manifest.mjsfalha fechado (unmapped-risk).
Dependências
- S30 (#1271), S31 (#1272) e S34 (#1298) entregues — catálogo, seletor e colinha reusados.
- Material da Plenária da Vitória disponível fora do repo (paths acima); sem ele não há foto/número novos.
- Design hi-fi aprovado no gate. Soft: S32/C213 (contador anônimo) — se o download for o mesmo, nada muda.
Fora de escopo
- Segundo editor/estúdio; diálogo/step separado para montar a colinha (a prévia é embutida na seção e atualiza na escolha); mudar os modelos existentes ou o conteúdo das cinco linhas fixas; mexer na seção
#cardsou em/cards. - Paginação, “carregar mais” ou qualquer corte da lista; rota/página por estadual com metadata própria (
/colinha/<slug>) — item próprio se o preview social do link medir. - Mini-CMS/collection/toggle novo para dobradinhas (salvo se a Questão 1 mudar).
- Ranking, força, prioridade, contagem por estadual ou qualquer métrica nova; A4/impressão.
- PII/cadastro/foto do visitante/upload; novos canais de compartilhamento.
Rabbit holes de produto
- "Já que tem seção, mostra o estúdio inteiro". Se alguém "só completar": galeria dos seis modelos e busca de tudo na home. Corte neste item: só a colinha; a lista e a prévia vivem na seção.
- "Escolher o estadual vira obrigatório". Se alguém "só completar":
Baixar/Compartilhardesabilitados até escolher. Corte neste item: sem estadual é estado válido — a colinha sai com as cinco linhas fixas e o link sem?estadual=. - "A lista vira mini-CMS/ranking". Se alguém "só completar": prioridade, força eleitoral, ordenação por votos. Corte neste item: ordem estável do material, sem métrica; curadoria continua na plataforma.
- "Lista longa pede paginação". Se alguém "só completar": páginas ou “carregar mais” cortam os 54. Corte neste item: rolagem vertical no desktop e carrossel horizontal no mobile — a lista inteira sempre alcançável.
- "Completar quem não tem material". Se alguém "só completar": aproximar número de outra fonte ou usar foto genérica. Corte neste item: fail-closed — sem foto+número oficiais, o estadual não aparece.
- "Segundo mecanismo de compartilhar". Se alguém "só completar": folha própria com mensagem divergente. Corte neste item: a folha existente é o único mecanismo.
- "Prometer anexo no WhatsApp". Se alguém "só completar": dizer que o PNG vai junto no
wa.me(não vai). Corte neste item: WhatsApp = mensagem + link; o PNG vai pela folha nativa ou pelo download.
Questões em aberto (produto)
- Qual a fonte da verdade da lista cruzada? Opções: A) a plataforma segue a fonte de quem é dobradinha (filtro "apagar") e foto/número vêm do material, com o cruzamento gerado e versionado | B) número e foto viram campos preenchidos na plataforma (+ publicação para o site) | C) lista digitada à mão no site. Recomendação: A — ninguém cadastra duas vezes e a curadoria fica no mapa versionado; B vira item próprio se a equipe quiser operar a lista sem deploy. (assumido — validar com produto)
- Link direto nesta fatia? Opções: A)
/?estadual=<slug>#colinhana home, sem rota nova | B)/colinha/<slug>com título/descrição por estadual (preview melhor no link compartilhado, nova URL pública). Recomendação: A agora; B vira item próprio se o preview social do link for pedido. (assumido — validar com produto) - Qual copy da mensagem? Opções: A) com estadual
Montei minha colinha: [NOME] [NÚMERO] para deputado estadual, com Jorge Solla 1313. Monte a sua: [link](sem estadual cai no literal sem nome/número) | B)Colinha pronta: 1313 para deputado federal e [NÚMERO] para estadual. Monte a sua: [link]. Recomendação: A — nomeia o estadual e chama a montagem. (assumido — validar com produto) - Se a lista cruzada vier vazia, a seção aparece? Opções: A) sim — busca com estado vazio e a colinha (sem estadual) seguem baixável/compartilhável | B) não aparece (kill switch do rascunho anterior). Recomendação: A — “Baixar/Compartilhar sempre disponíveis” e a colinha sem estadual é estado válido. (assumido — validar com produto)
Referências
- GitHub Issue: #1404.
- Design UI (gate):
docs/plans/home-colinha-estadual-ui-design.html(+ assets emhome-colinha-estadual-ui-design-assets/). docs/plans/cards-estadual-dobradinha.md(S30),cards-colinha.md(S31),cards-colinha-arte-exata.md(S34),cards-analytics.md(S32);central-conteudos-secao-home-share-filtro.md(S42 — seção na home + folha de share).src/components/cards/StateDeputySelect.tsx,CardComposer.tsx,cardCanvas.ts,src/lib/stateDeputyCatalog.ts,cardRender.ts/cardColinha.ts;src/components/conteudos/ContentPieceShareSheet.tsx,ContentPieceHomeSection.tsx;src/app/(frontend)/(home)/page.tsx;scripts/lib/e2e-affected-manifest.mjs.- Material externo:
/home/fsolla/Downloads/CARDS-PLENARIA-DA-VITORIA/,/home/fsolla/Downloads/DOBRADINHAS-ORGANIZADAS/(54 dobradinhas;LISTA-DOBRADINHAS.txt).
Self-score (shaping)
- Fatia = um outcome verificável? 5/5 — o visitante escolhe o estadual na home e sai com a colinha (PNG + share); o link reabre a mesma colinha.
- Appetite declarado e a intenção cabe nele? 4/5 — ~1,5–2 dias: seção nova + lista cruzada versionada, reusando editor e folha existentes; o cruzamento plataforma×material é o delta.
- Persona + job + aceite claros (sem jargão de stack)? 5/5 — fluxo em linguagem de eleitor, reta final de eleição.
- Direção no codebase é hipótese (não contrato técnico)? 5/5 — arquivos e paths são pista do estado atual; nenhuma schema/signature prescrita.
- Zero decisões duras de engenharia no plano? 4/5 — materialização do cruzamento e forma do link direto ficam nas questões abertas; a escolha final é da implementação.
Média: 4,6/5 — ≥4/5.