Self-onboarding em massa

TL;DR

A comissão técnica gera um único link em grupo a partir de /dashboard/onboarding-link e distribui por WhatsApp, QR ou qualquer canal. Cada jogador abre o link, se reconhece na grade de fotos, confirma identidade, e recebe o email com o link para /auth/set-password para definir a senha.

É o fluxo recomendado para cadastro inicial do elenco completo.

Pré-requisito

Antes de gerar o link, cadastre os emails dos jogadores em Elenco. Se faltar email para algum jogador, ele poderá digitar na tela quando confirmar identidade — mas se o email estiver pré-cadastrado, o fluxo fica à prova de brincadeiras: o email cai apenas na caixa do titular real.

Para comercial

• Problema que resolve: mandar convites um a um para 30+ jogadores é trabalho manual caro. O link em grupo reduz isso a uma mensagem de WhatsApp para o grupo do elenco.
• Casos de uso típicos: cadastro inicial do elenco completo ao contratar o CÉNIT, cadastro de juvenis que sobem em bloco, renovação de credenciais rotacionando o token.
• Planos que incluem: todos.
• Diferencial: o anti-spoofing por email pré-cadastrado evita o cenário “alguém clica na foto de outro e fica com a conta dele” sem exigir verificação por SMS, documento ou OTP adicional.

Como a comissão técnica usa

Acesso e permissões

hop, dir e sc podem gerar e rotacionar o token. A grade pública em /onboarding/[token] não requer login e serve a qualquer visitante do link.

Fluxos passo a passo

Gerar o link

1. Staff entra em /dashboard/onboarding-link. Apenas hop, dir e sc podem entrar — o restante cai em /dashboard.
2. Click em “Gerar link”. Se ainda não existe um link, é gerado um; se já existe, mostra o mesmo (não é rotacionado automaticamente).
3. Compartilhar o link por WhatsApp, QR ou pelo canal que o clube usar.
4. Opcionalmente: revisar /dashboard/onboarding-status para ver quantos jogadores já ativaram a conta.

O que o jogador vê

1. Abre /onboarding/[token] → vê a grade de jogadores ativos do elenco que ainda não ativaram a conta.
2. Click na sua foto → tela de confirmação.
3. A confirmação mostra o email mascarado (ex.: p***********@example.com) se já estava pré-cadastrado no perfil, ou pede que o jogador digite se não.
4. Click em “Sou eu” → o sistema envia um email com o link de ativação para a caixa pré-cadastrada (não para o input).
5. O jogador recebe o email, abre o link, define a senha em /auth/set-password, e fica vinculado automaticamente.

Rotacionar o token

Se o link vazar ou já tiver passado o período de cadastro, regenerar o token a partir do mesmo painel invalida os links antigos. Os jogadores que já ativaram ficam intactos.

Configuração relacionada

• O email do jogador é pré-cadastrado a partir de Elenco. Se faltar, o jogador digita na confirmação.
• A foto sai do perfil do Elenco; se faltar, mostram-se as iniciais.

FAQ / casos-limite

• E se eu perder o link? Peça ao PF/HoP que reenvie; é o mesmo para todo o elenco.
• E se o email não chegar? Verifique o spam. Se não aparecer, confirme com o staff que o email cadastrado no seu perfil está correto.
• Jogador inativo: não aparece na grade.
• Jogador já ativado: some da grade.
• Anti-replay: se duas pessoas clicarem na mesma foto, vence o primeiro que terminar de definir a senha. A segunda tentativa rebate.

Como o jogador vê

• Grade pública: logo do clube e fotos do elenco com número e posição. Não precisa de login nem do app instalado.
• Confirmação: mostra o email mascarado ou pede que digite.
• Email de convite: assunto “Ative sua conta — [Org]”.

Integrações

O link é por organização; o email viaja para o endereço pré-cadastrado no perfil do jogador.

Limitações / roadmap

• A comissão técnica precisa pré-cadastrar o email de cada jogador em Elenco antes de gerar o link, ou aceitar que o jogador o digite manualmente (com menos garantia anti-spoofing).