- Compile docs/roadmap.md into a next-steps document (277→206 lines): R0–R5/M1–M5 tables and the delivered map/list item paragraphs compressed into 'Já entregue'; janelas, grafo and cortes list only open IDs; C10/C11/C8 fill-ins keep their original triggers; C5 moved under 'A validar'. - Record the production deploy of the destructive remodel chain (2026-07-23 Vercel builds) across roadmap, AGENTS.md, the project notebook and plans — supersedes every 'deploy pendente'; smoke pós-deploy + onboarding remain the open blockers. - Fix AGENTS.md internal contradictions: Município locked-decisions bullet (435, Camaçari whole, candidate role), campaignUser role enum, deploy-checklist item 7 as historical, access/* structure note, election-aggregates artifact + election-tse revalidate runbook. - Sync open plans to real identifiers (plaza*/nucleus* → municipality*): the intelligence program (master + E8–E15/B13/C12 with artifact/caching context and satisfied deps), B8 rescoped to Salvador ZE 1–19 only, WhatsApp D3–D5, D2, A6 (now the insight layer over stateDeputy), RS+, onda-0 smoke step. - Close items verified done in code: C8 F4 (DRY de forms) complete, filtros-auto shared pending shell, petition generateStaticParams select/depth; ledger the surviving user-visible 'Praça' copy in src as new P2 debt. - Banner delivered praça-era plans (production note + rename pointer); mark remodelagem-pracas.md superseded and remodelagem-municipios.md delivered. - TECH-DEBT smell statuses, TESTING RBAC row, README quality gates, campanha UI rules updated to current component names.
11 KiB
Escala e DRY pós-reset de senha + foto de perfil
Status: registrado no roadmap (fases pendentes)
Atualizado em: 2026-07-19 (Fase 3 parcial: polish /campanha/login + simplify; absorção capture-review-debts 2026-07-19)
Item do roadmap: docs/roadmap.md (RS+, fill-in de engenharia pós-MVP)
Responsável: —
Contexto
O fill-in Reset de senha self-service + foto de perfil (reset-senha-foto-perfil.md) entregou: adapter Resend + forgotPassword/resetPassword, /campanha/esqueci-senha e /campanha/redefinir-senha, troca de senha logada e upload/remoção de avatar em /campanha/perfil, shell com avatar/iniciais e migration 20260719_061302_add_campaign_user_avatar. Duas passagens /simplify (2026-07-19) aplicaram cleanup pontual; os revisores (quality / performance / reuse) deixaram débitos maiores que cleanup — registrados aqui.
Já resolvido no simplify (não reabrir): CampaignFormActionState compartilhado; constantes de copy (CAMPAIGN_PASSWORD_RESET_*, CAMPAIGN_LEADERSHIP_FORGOT_PASSWORD_MESSAGE, CAMPAIGN_SESSION_EXPIRED_MESSAGE); campaignUserShellView / CampaignUserShellView; canUpdateCampaignUserAvatar delegando para canUpdateCampaignUser; fieldError nos forms; FormActionStatus no perfil; remoção de wrappers passwordFormError/profileFormError; exports internos de resetCampaignPassword/changeCampaignPassword; teste int renomeado para login com senha errada.
Já resolvido na Fase 3 parcial (merge main 2026-07-19, 246ca85 — não reabrir): CampaignAuthPageShell em login / esqueci-senha / redefinir-senha (incl. card de token inválido); campaignAuthHeadingClassName + copy compartilhada (CAMPAIGN_LEADERSHIP_LOGIN_RECOVERY_HINT, CAMPAIGN_LEADERSHIP_PHONE_ACCESS_HINT); login com inputMode dinâmico tel/email, aria-invalid/aria-describedby nos dois campos, w-full no submit.
Já resolvido no polish + /simplify de /campanha/login (2026-07-19 — não reabrir): critique Impeccable P1–P3 fechados (alinhamento título/subtítulo !text-center, ritmo gap-2 + leading-snug, CampaignLogo no shell, <details> para primeiro acesso); CampaignAuthCardHeader, CampaignAuthBackToLoginLink; tokens campaignAuthDescriptionClassName, campaignAuthMutedTextClassName, campaignAuthTextLinkClassName; CAMPAIGN_LOGIN_SUBTITLE (conta individual); fieldError sem dupla chamada em forgot/reset. Snapshot: .impeccable/critique/2026-07-19T21-47-04Z__src-app-campaign-campanha-login.md.
Objetivos
- Auth hot path sem join de
mediaem rotas que não exibem avatar (municípios, apoiadores, planos, etc.). - Upload de avatar sem segurar transação Postgres aberta durante I/O de blob/sharp.
- Shell compartilhado das páginas públicas de auth (
login,esqueci-senha,redefinir-senha) — parcial ✓ (shell + card header + logo + critique login fechados; pendem password fields + login state — Fase 3). - Um único módulo de validação/campos de senha reutilizado por convite, reset e perfil.
- Login alinhado ao shape
CampaignFormActionState+mapCampaignFormActionErrordas demais actions de campanha. - Guardrails: sem novo
Consent; sem SMS/WhatsApp para token; comportamento de produto 1C inalterado salvo bugs encontrados.
Decisões travadas
- Um plano RS+, cinco fases ordenadas. Mesmo racional de VR+/O0+/C8: um registro no roadmap, PRs por fase. Ordem: auth read perf → transação/revalidate avatar → DRY UI/senha/login → consolidação forms avatar → opcionais.
- Dependência suave do fill-in Reset senha + perfil ✓. Não bloqueia uso do MVP; melhora I/O, consistência visual e manutenção.
- Sem migration nova salvo índice/campo não previsto — escopo é refactor de leitura/escrita e componentes.
- Cortável: Fases 3–5 até outra vertical de auth ganhar terceiro consumidor; Fase 1 (auth read) é a mais valiosa se
/campanhaficar lento com muitos usuários simultâneos. - i18n e naming (AGENTS.md): identificadores em inglês (
getCampaignUserWithAvatar,CampaignAuthPageShell,CampaignPasswordFields), strings visíveis em pt-BR.
Questões em aberto
depth: 0+getCampaignUserWithAvatar()vsselectparcial emauthenticateCampaignToken? Hojedepth: 1populaavatarem todo request autenticado. Recomendação:depth: 0no gate + helpergetCampaignUserWithAvatar()só no layout(app)e/perfil; páginas públicas usam check de sessão leve (payload.authsemfindByIDcompleto).- Upload fora da transação: apagar
mediaórfão em falha? Recomendação: upload/commit blob primeiro; TX curta paracampaignUser.avatar+ delete do anterior; em falha pós-blob, job best-effort de limpeza (log + delete órfão) — documentar no plano de produto se volume crescer. - Unificar schemas de senha com
invite.tsagora? Três surfaces (convite login, reset, perfil). Recomendação: Fase 3 — extraircampaignPasswordFields.ts(schema +refineMatchingPasswords) consumido porcampaignPassword.tseinvite.ts; não bloqueia RS+ Fase 1–2. - Migrar
LoginFormparaCampaignFormActionState? Login é outlier com{ error?: string }. Recomendação: Fase 3 junto comCampaignAuthPageShell; baixo risco, alto alinhamento com forgot/reset/perfil.
Abordagem proposta
flowchart TD
RS["Reset senha + perfil MVP ✓"] --> F1
F1["Fase 1 — Auth read perf<br/>depth 0 + getCampaignUserWithAvatar<br/>sessão leve em rotas públicas"]
F1 --> F2["Fase 2 — Avatar write perf<br/>blob fora da TX + revalidate estreito"]
F2 --> F3["Fase 3 — DRY auth UI/senha<br/>shell/card ✓ parcial · password fields + login state"]
F3 --> F4["Fase 4 — DRY copy/role + actions<br/>campaignRoleOptions + getCampaignActionContext"]
F4 --> F5["Fase 5 — Opcional<br/>avatar intent único + int change password"]
Fase 1 — Auth read performance
src/utilities/campaignAuth.ts:authenticateCampaignTokenvolta adepth: 0comselectmínimo (name,role,email,username,id); novogetCampaignUserWithAvatar()(oupopulateCampaignUserAvatar) comdepth: 1só onde necessário.src/app/(campaign)/campanha/(app)/layout.tsx: trocargetCampaignUser()por leitura com avatar para o shell.src/app/(campaign)/campanha/esqueci-senha/page.tsx,redefinir-senha/page.tsx: substituirgetCampaignUser()por check leve de sessão (redirect se já autenticado sem carregarmedia).- Atualizar
tests/int/campaignAuth.int.spec.ts(depth: 0no gate; teste separado para layout avatar se necessário).
Fase 2 — Avatar write performance
src/app/(campaign)/campanha/actions/profile.ts: criarmedia(blob) antes dewithPayloadTransaction; TX curta só paracampaignUser.update+media.deletedo anterior.- Trocar
revalidatePath('/campanha', 'layout')por tag/path mais estreito (/campanha/perfil+ invalidação do layout só quando sidebar precisar — avaliarrevalidateTagpor usuário). - Paralelizar
getPayload+getCampaignUseronde aplicável (Promise.allougetCampaignActionContextna Fase 4).
Fase 3 — DRY UI e senha
Entregue parcialmente (2026-07-19): CampaignAuthPageShell, CampaignAuthCardHeader, CampaignAuthBackToLoginLink, tokens de copy/classes em campaignAuthCopy.ts, CampaignLogo no shell, polish Impeccable /campanha/login (ver Contexto).
Pendente nesta fase:
- Extrair
CampaignPasswordFields(ouCampaignNewPasswordFieldGroup): campospassword+passwordConfirmationcomerrorProps— reuso emResetPasswordForm, bloco de senha do perfil eCampaignInviteForm(kind === 'login'). src/lib/schemas/campaignPassword.ts+invite.ts: factory compartilhadarefineMatchingPasswords/passwordSchema(substituir check manual no convite).LoginForm.tsx+actions/auth.ts: migrar paraCampaignFormActionState+mapCampaignFormActionError.
Fase 4 — DRY copy, role e action context
- Consolidar strings de liderança/convite (
CAMPAIGN_LEADERSHIP_*,CAMPAIGN_FIRST_ACCESS_HINT,CAMPAIGN_LOGIN_SUBTITLE+ mensagem server emcampaignPasswordReset.ts) numa fonte única com variantes por contexto. campaignRoleLabels↔ opções do camporoleemCampaignUser.ts(fonte únicacampaignRoleOptions).- Propagar para
MunicipalityUpdateFeed.tsx(ex-NucleusUpdateFeed) e outrosroleLabelslocais quando esses arquivos forem tocados. password.ts/profile.ts: adotargetCampaignActionContext()(src/utilities/campaignActionContext.ts) comosupporter.ts/actionPlan.ts.
Fase 5 — Opcional / cortável
CampaignProfileSettings: umuseActionStatecomintent(upload|remove) em vez de dois hooks de avatar.- Validador de avatar retornando
Resultem vez dethrow+safeMessages. - Teste int de
changeCampaignPasswordcom cookie de sessão simulado (hoje só cobrepayload.logincom senha errada). - Fila assíncrona para e-mail de forgot-password (cold path; só se latência Resend incomodar).
Dependências
- Reset senha + perfil MVP ✓ (reset-senha-foto-perfil.md; engenharia pronta em branch local).
- Reusa
campaignAuth.ts,campaignPasswordReset.ts,campaignUserProfile.ts,campaignFormActionError.ts,campaignFormFields.ts,campaignActionContext.ts. - Sem migration, sem
Consentnovo.
Não escopo
- Forgot por SMS/WhatsApp → permanece convite
login(reset-senha-foto-perfil.md). - Edição de nome/telefone/e-mail no perfil → item futuro separado.
- RBAC em
users(admin Payload) → roadmap Admin Payload. - Unificar todo o ciclo 1 de auth (convite + login + admin) num único mega-refactor — RS+ cobre só o fill-in entregue e vizinhos diretos.
Explicitamente fora (critique/simplify desta sessão — não reabrir)
- Split-screen login com publicações ou painel motivacional (decisão produto 2026-07-19; critique recomendou não).
- Link de saída para o site público na tela de login (heurística 3, score 2).
- Placeholder longo dual-format no identificador; submit helper global (
Spinner+aria-live); constantes de rota auth;flat-type-hierarchydo detector runtime no body. - Comentário em
styles.csspara auth — workaround com tokens/componentes já suficiente.
Referências
- reset-senha-foto-perfil.md — MVP entregue
- escala-dry-pos-visitados-recentemente.md — precedente RS+/VR+
src/utilities/campaignAuth.ts,src/app/(campaign)/campanha/actions/password.ts,profile.tssrc/components/campaign/CampaignProfileSettings.tsx,CampaignSidebar.tsx,CampaignUserAvatar.tsxsrc/components/campaign/CampaignAuthPageShell.tsx,CampaignAuthCardHeader.tsx,CampaignAuthBackToLoginLink.tsxsrc/lib/campaignAuthCopy.tssrc/app/(campaign)/campanha/login/,esqueci-senha/,redefinir-senha/src/lib/schemas/campaignPassword.ts,src/lib/schemas/invite.tssrc/collections/CampaignUser.tstests/int/campaignPasswordReset.int.spec.ts,tests/int/campaignAuth.int.spec.tsdocs/roadmap.md(fill-ins RS+)- AGENTS.md — Campaign auth, naming,
overrideAccess: false, transações