Elenco

TL;DR

Elenco é o módulo onde a comissão técnica mantém a lista de atletas da organização: cadastro e edição, foto, equipe, número, estado esportivo, histórico de lesões e convite ao portal do jogador. É o ponto de entrada do resto do sistema — sem um jogador cadastrado aqui, nenhum outro módulo o vê. É usado principalmente pelo HoP e pelo Diretor Esportivo; o restante do staff lê e edita o que é da sua área a partir do perfil individual.

Para comercial

• Problema que resolve: unificar em um único lugar o master do elenco que normalmente vive em planilhas soltas (Excel do PF, contatos do médico, fotos no WhatsApp do roupeiro).
• Casos de uso típicos: cadastro do elenco no início da temporada, baixas e altas no meio do ano, transferências entre sub-equipes (time principal / reservas / juvenis), convite em massa ao portal do jogador.
• Planos que incluem: todos. O plano essencial limita o elenco a 40 atletas; pro e enterprise são ilimitados. Veja Planos e features.

Como a comissão técnica usa

Acesso e permissões

Todos os papéis do staff veem Elenco e podem abrir o perfil individual de um jogador. O que muda entre papéis é quais sub-abas do perfil veem e quais ações têm habilitadas:

• Head of Performance / Diretor Esportivo: tudo. Cadastro, edição, foto, transferência entre equipes, exclusão e restauração em massa, convite ao portal, configuração de abas visíveis em Settings.
• Médico / Especialista em RTP: além disso, podem mudar o estado esportivo de um jogador (disponível / lesionado / em recuperação / suspenso / inativo).
• S&C / Sport Scientist / Fisio / Nutricionista / Psicólogo: leitura do elenco, escrita restrita à sua área dentro do perfil individual.

Veja o detalhe por papel em Papéis do staff.

As abas do perfil do jogador (geral, tático, físico, médica, mental, mensagens) podem ser exibidas ou ocultadas em Settings → Abas visíveis.

Card hero do perfil individual

Ao abrir o perfil de um jogador, o hero exibe a foto, o nome com número de camisa, nacionalidade e sub-equipe. O seletor de estado (disponível, lesionado, etc.) aparece diretamente ao lado do chip Lesão ativa — assim a comissão técnica vê de relance a contradição clínica, se existir (ex.: marcado “Disponível” mas com lesão ativa grave).

As ações sobre o jogador (Editar, Relatório de transferência, Mover para outro elenco) estão agrupadas no menu ··· (canto superior esquerdo do hero). Visível apenas para HoP e Diretor Esportivo.

Fluxos passo a passo

• Cadastro de um jogador: Elenco → “Adicionar jogador” → preencher nome, posição, número, data de nascimento, sub-equipe. O número é validado contra conflitos dentro da mesma sub-equipe (jogadores inativos não bloqueiam).
• Carregar foto: a partir do perfil do jogador, painel esquerdo → enviar JPG, PNG ou WebP de até 10 MB. URLs de scrapers (Sofascore, Transfermarkt, etc.) estão bloqueadas para evitar problemas legais.
• Mudar estado esportivo: seletor visível no hero do perfil, ao lado do chip de lesão ativa. Também acessível na grade do elenco. Apenas HoP, Diretor Esportivo, Médico e RTP podem alterar.
• Editar dados do jogador: menu ··· no hero → “Editar jogador”. Somente HoP e Diretor Esportivo.
• Excluir / restaurar em massa: selecionar vários jogadores da grade → excluir (fica inativo e fecha automaticamente as lesões abertas) ou restaurar. Máximo 100 por operação. Apenas HoP e Diretor Esportivo.
• Mover para outra sub-equipe (individual): menu ··· no hero → “Mover para outro elenco”. Gera um registro histórico com data e notas opcionais.
• Transferir entre equipes (em massa): modal de multi-transferência na grade, move um conjunto de jogadores.
• Gerar relatório de transferência: menu ··· no hero → “Relatório de transferência”. Gera um PDF exportável.
• Convidar ao portal (individual, legacy): perfil → “Convidar” → o sistema gera um link de ativação e envia por email para o jogador.
• Onboarding em massa (recomendado): o cadastro em massa do elenco no portal é feito a partir do Onboarding link grupal, não a partir de Elenco. Requer que o email do jogador esteja pré-cadastrado pela comissão técnica.

Configuração relacionada

• Sub-equipes: Settings → Equipes define as sub-equipes que aparecem ao atribuir um jogador. O plano essencial permite até 2 sub-equipes.
• Abas visíveis no perfil: Settings → Abas visíveis. Um clube que não usa psicologia pode ocultar a aba mental para todo o staff.
• Cores e logo: o branding da organização aplica também aqui. Veja Settings.

FAQ / casos-limite

• Número repetido: dois jogadores podem compartilhar número se estão em sub-equipes diferentes. Dentro da mesma sub-equipe, um jogador inativo não bloqueia o cadastro de outro com o mesmo número.
• Excluir apaga dados históricos: não. A exclusão é uma desativação reversível: o jogador fica inativo e pode ser restaurado. As lesões ativas do jogador são fechadas automaticamente com a data do dia para não ficarem órfãs em Médico.

Como o jogador vê

Player surface: N/A. Elenco é um módulo administrativo apenas do staff. O jogador não vê esta tela. O mais próximo no seu portal é “Meu perfil”, onde ele lê seus dados pessoais mas não gerencia a lista do elenco nem edita seu próprio estado esportivo.

Dados e métricas

Elenco é um módulo CRUD — não calcula métricas próprias. As métricas que aparecem no perfil (ACWR, %MD, Hooper, risco) são agregados consumidos de outros módulos. Para fórmulas, veja o Glossário.

Integrações

Elenco é a fonte da verdade da lista de atletas, então praticamente todos os módulos o consomem:

• Calendário — convocações e ausências.
• Wellness — registros por jogador.
• Carga — ACWR e %MD por jogador.
• Risco — snapshots diários.
• Fisio e Médico — lesões, consultas, sessões de fisio, fases de retorno ao jogo.
• Nutrição e Psicologia — registros e objetivos por jogador.
• Performance — stats de partida e análise tática.
• Mensageria — chat staff ↔ jogador, push notifications.
• Usuários — link grupal de self-onboarding que dá acesso ao portal do jogador.

Limitações

• Mudança de organização de um jogador: não suportada. A transferência entre sub-equipes funciona apenas dentro da mesma org.
• Exclusão definitiva: não existe. A exclusão é sempre reversível (preserva histórico de carga, lesões e relatórios).
• Wellness links legacy: os links tokenizados por jogador seguem disponíveis por retrocompatibilidade. Para clubes novos, o fluxo recomendado é PWA + push.