Expand the compiled next-steps doc back into the full delivery history, cross-reference plan statuses, and sync AGENTS.md, PRODUCT.md, and the Núcleos project notebook.
4.2 KiB
4.2 KiB
Reset de senha self-service + foto de perfil
Status: implementado Atualizado em: 2026-07-19 Item do roadmap: docs/roadmap.md (Fill-ins — UX adiada do ciclo 1) Responsável: —
Contexto
O MVP de Núcleos (ciclo 1) entregou login por e-mail ou celular e recuperação de acesso via convite WhatsApp login pelo coordenador, mas adiou explicitamente o link “Esqueceu?” no login e a foto de perfil no shell mobile (plano MVP). Hoje campaignUser tem colunas Payload de reset (resetPasswordToken, …) sem UI; não há email adapter; não há /campanha/perfil nem campo avatar. Media + Vercel Blob já existem para uploads.
Objetivos
- Trocar senha já autenticado em
/campanha/perfil. - Forgot por e-mail (Payload
forgotPassword/resetPassword+ Resend) com resposta anti-enumeration. - Quem acessa só com celular (
liderancasem e-mail) continua pelo convitelogin— copy explícita no login e em/campanha/esqueci-senha. - Foto de perfil opcional (
avatar→media) com upload/remoção no perfil e exibição no shell. - Sem
Consentnovo; sem SMS/WhatsApp para token.
Decisões travadas
- 1C (produto 2026-07-19): trocar senha logado + forgot por e-mail + fallback convite para sem e-mail.
- Adapter Resend (
@payloadcms/email-resend), indicado para Vercel. - Self-update de
campaignUserliberado para o titular com hook que bloqueia alteração derole,name,email,username,phone(sóavatarvia UI neste MVP; senha via actions dedicadas). - Após reset por e-mail: login automático (cookie
campaign-token), mesmo padrão do convitelogin. - Avatar: jpeg/png/webp, ≤ 2 MB;
alt= nome do usuário. - i18n: identificadores em inglês; strings visíveis em pt-BR.
Questões em aberto
- Perfil na bottom nav mobile? Recomendação: link “Meu perfil” no rodapé da sidebar com avatar; não adicionar 5º item na bottom nav (evita poluição). Validar com produto.
- Apagar
mediaórfã ao trocar avatar? Recomendação: sim, deletar documento anterior após commit bem-sucedido. Validar com produto se volume justificar fila.
Abordagem proposta
flowchart LR
Login["/campanha/login"]
Forgot["/campanha/esqueci-senha"]
Reset["/campanha/redefinir-senha"]
Perfil["/campanha/perfil"]
Resend["Resend"]
Invite["Convite login"]
Login --> Forgot
Login -.-> Invite
Forgot --> Resend
Resend --> Reset
Reset --> Perfil
Perfil --> Perfil
Componentes:
src/utilities/campaignPasswordReset.ts:buildCampaignPasswordResetUrl,isCampaignEmailConfigured, constantes de copy.src/lib/schemas/campaignPassword.ts: Zod para forgot / reset / change.src/app/(campaign)/campanha/actions/password.ts:requestCampaignPasswordReset,resetCampaignPassword,changeCampaignPassword+ form actions.src/app/(campaign)/campanha/actions/profile.ts:updateCampaignAvatar,removeCampaignAvatar.src/collections/CampaignUser.ts:auth.forgotPasswordHTML/subject; campoavatar; hookpreventSelfServicePrivilegedFields; access self-update.- Rotas públicas:
/campanha/esqueci-senha,/campanha/redefinir-senha(noindex). /campanha/(app)/perfil: senha + avatar; shell com avatar/iniciais.
Migration: add_campaign_user_avatar — FK campaign_user.avatar_id → media.
Dependências
- Nenhuma de outro plano. Reusa
campaignAuth,campaignInviteOrigin.getCampaignInviteBaseURL,Media+ Blob,mapCampaignFormActionError.
Não escopo
- Forgot por SMS/WhatsApp Business.
- Edição de nome/telefone/e-mail no perfil.
- Forgot para collection
users(admin Payload). - Sino de notificações (notifications.md).
- E-mail obrigatório para
lideranca.
Referências
docs/roadmap.md(Fill-ins)- escala-dry-pos-reset-senha-perfil.md — débitos de escala/DRY pós-
/simplify(RS+) src/collections/CampaignUser.tssrc/app/(campaign)/campanha/actions/auth.tssrc/utilities/campaignInviteOrigin.ts- AGENTS.md — Campaign auth, migrations, naming