Convite do staff

TL;DR

hop ou dir convidam um novo membro do staff a partir de /dashboard/settings → Usuários. O sistema monta um link de ativação, envia por email e cria a membership ativa na org. O usuário cai em /auth/set-password?next=/dashboard.

Para comercial

• Problema que resolve: dar acesso a membros da comissão técnica (S&C, fisio, médico, nutricionista, etc.) com escopo correto conforme o papel, sem exigir setup manual.
• Casos de uso típicos: cadastro inicial do staff ao contratar, incorporação de um fisio novo, mudança de papel de um usuário existente (com confirmação explícita).
• Planos que incluem: todos. Essencial: até 5 colaboradores; Profissional e Enterprise: sem limite.

Como a comissão técnica usa

Acesso e permissões

Apenas hop e dir veem a seção “Usuários” em Settings.

Fluxos passo a passo

Convidar um usuário novo

1. Settings → tab “Usuários” → botão “Convidar”.
2. Modal pede email e papel (um dos: hop, dir, coord_form, sc, ss, rtp, fisio, med, nut, psi, entrenador).
3. Se o email já existe em outra org ou com outro papel, aparece um aviso pedindo confirmação antes de continuar. Caso contrário, o sistema cria a membership e envia o email com o link de ativação.
4. O usuário recebe o email, define a senha em /auth/set-password, e cai em /dashboard com o papel atribuído.

Mudança de papel de um usuário já ativo

Se a UI mostrar “Este usuário já tem o papel X — confirme se quer mudá-lo para Y”, o usuário clica em “Confirmar” no modal para aplicar a mudança. Isso evita degradações silenciosas de privilégios que aconteciam em versões anteriores.

Configuração relacionada

• O plano atribuído por padrão ao novo usuário é o plano da org.
• O branding do email (logo, nome do clube) sai da configuração da org.

FAQ / casos-limite

• Papel inválido: a action rejeita com “Papel inválido” se não bater com a lista oficial.
• O email não chega: a membership fica criada mesmo assim, mas o usuário não recebe o link. Se isso acontecer com frequência, entre em contato com o suporte.
• Revogação: revogar baixa o acesso mas não apaga a conta. Você não pode revogar o último HoP/Diretor ativo da org.

Como o jogador vê

Player surface: N/A. Este fluxo é só para staff.

Limitações / roadmap

• Não há UI para “reenviar convite” se o link expirou. O workaround é convidar novamente o mesmo email — o sistema reusa a conta e gera um link novo.
• Sem auditoria visível de mudanças de papel — só fica registro interno.