Cadastros: categorias, naipes e competições

Antes de cadastrar o primeiro atleta ou o primeiro jogo, vale conhecer os Cadastros. Eles são três listas de apoio do seu clube (Categorias, Naipes e Competições) que não aparecem sozinhas no site, mas alimentam os formulários do painel. Em vez de você digitar “Sub-15” toda vez que cadastra um atleta, você cria a categoria uma vez e depois só a escolhe numa lista pronta.

Pense neles como as “opções de menu” do seu painel. Onde um formulário pede a categoria, o naipe ou a competição, quem aparece nas opções é exatamente o que você cadastrou aqui. Por isso o próprio painel resume esse bloco assim: “Definem as opções que aparecem nos formulários.”

Onde ficam os cadastros

No painel do clube, procure na barra lateral o bloco Cadastros. Ao abrir, você encontra os três:

Cadastros → Categorias
Cadastros → Naipes
Cadastros → Competições

Cada um abre uma telinha simples de lista: os itens já cadastrados, um botão + Adicionar no topo para criar um novo, e, em cada item, um lápis (✎) para editar e um × para remover.

Se o seu clube é novo, boa parte dessas listas já vem pré-preenchida. Na primeira configuração do clube, você escolhe alguns presets (categorias e naipes iniciais) e o sistema já cria os primeiros itens pra você. A partir daí, é só ajustar: adicionar o que faltou, renomear ou remover o que não usa.

Categorias

A categoria é a divisão por faixa/nível do seu clube: sub-12, sub-15, adulto, master, e por aí vai. É como você separa os atletas por idade ou nível de competição.

Onde a categoria reaparece:

No cadastro de atleta, no campo Categoria (obrigatório). Ao cadastrar alguém, você escolhe a categoria dele numa lista, e essa lista é exatamente a daqui.
No cadastro de um jogo na Agenda, no campo Categoria (obrigatório). O título do jogo é montado pelo sistema juntando, entre outras coisas, a categoria escolhida.

Como criar uma categoria

Vá em Cadastros → Categorias, toque em + Adicionar e preencha:

Chave interna: um apelido curto que o sistema usa por baixo dos panos (só letras minúsculas, números e _), por exemplo sub12. Você quase nunca vê essa chave depois; ela existe só para o sistema ligar o atleta à categoria certa. Na dúvida, use algo simples e sem espaço.
Nome exibido: o nome bonito que aparece nas telas, por exemplo Sub-12. É esse que vai na lista de opções dos formulários.
Faixa etária (opcional): um texto livre para ajudar a identificar, por exemplo 11 a 12 anos. Pode deixar em branco.

Toque em Salvar e a categoria já passa a aparecer nos formulários de atleta e de jogo.

Como editar ou remover uma categoria

Para editar, toque no lápis (✎) do item, ajuste os campos e salve. Mudar o Nome exibido troca o texto em todos os lugares que usam aquela categoria, sem precisar mexer atleta por atleta.

Para remover, toque no ×. Aqui o sistema é cuidadoso, porque uma categoria pode ter atletas ligados a ela:

Se nenhum atleta usa a categoria, ela é removida na hora.
Se existem atletas usando a categoria, o sistema não deixa você removê-la e “largar” esses atletas sem categoria. Ele abre a tela “Mover atletas antes de remover”, mostrando quantos atletas estão vinculados e pedindo para qual categoria movê-los. Você escolhe o destino e confirma em Mover e remover: todos os atletas são reatribuídos e só então a categoria some.
Se essa é a última categoria do clube e ainda tem atletas, a remoção fica bloqueada (“é a última categoria”), porque todo atleta precisa de uma categoria. Para resolver, crie outra categoria primeiro e depois remova esta: o sistema vai pedir para mover os atletas para a nova.

Naipes

O naipe diz se a equipe/atleta é do masculino, feminino ou misto. É uma lista curtinha, geralmente com dois ou três itens.

Onde o naipe reaparece:

No cadastro de atleta, no campo Naipe (obrigatório).
No cadastro de um jogo na Agenda, no campo Naipe (obrigatório), e ele também entra no título do jogo montado pelo sistema.

Como criar um naipe

Vá em Cadastros → Naipes, toque em + Adicionar e preencha:

Chave: um código bem curto (até 3 caracteres), por exemplo M ou F. Assim como na categoria, é o identificador interno que o sistema usa.
Nome: o nome que aparece na tela, por exemplo Masculino.

Toque em Salvar.

Como editar ou remover um naipe

Funciona igualzinho à categoria. Editar pelo lápis (✎) troca o nome em todo lugar. Ao remover pelo ×:

Sem atletas usando aquele naipe, ele sai na hora.
Com atletas vinculados, o sistema abre a tela “Mover atletas antes de remover” e pede para qual naipe transferi-los antes de apagar.
Se for o último naipe e ainda houver atletas, a remoção fica bloqueada até você criar outro.

Competições

A competição é o campeonato ou torneio em que o clube joga: uma liga estadual, uma copa da cidade, um amistoso. Diferente das outras duas listas, ela guarda também um nível, a abrangência.

Onde a competição reaparece:

No cadastro de um jogo na Agenda, no campo Competição. Ali você digita o nome e o painel sugere as competições que você já usou (autocomplete).
Nas Conquistas (os títulos do clube), que são amarradas a uma competição. A abrangência que você define na competição é herdada pela conquista, por isso não precisa preencher de novo.

Como criar uma competição

Você tem dois caminhos, e os dois levam ao mesmo lugar:

Pelo cadastro: vá em Cadastros → Competições, toque em + Adicionar e preencha:
- Nome da competição: por exemplo Liga Estadual Sub-17.
- Abrangência: o nível da competição, escolhido numa lista (Metropolitano, Estadual, Interestadual, Regional, Nacional ou Internacional). É opcional, mas preencher ajuda, porque as conquistas dessa competição herdam esse nível.
Direto na Agenda: ao cadastrar um jogo, se você digitar no campo Competição um nome que ainda não existe, o sistema cria a competição sozinho ao salvar o jogo. Prático para não ter que sair do fluxo. Depois, se quiser, você volta em Cadastros → Competições e ajusta a abrangência.

Como editar ou remover uma competição

Editar pelo lápis (✎) atualiza o nome e a abrangência em todos os jogos e conquistas que usam aquela competição.

A remoção pelo × tem uma trava importante, diferente das categorias e naipes:

Competição em uso não é removida. Se a competição estiver vinculada a algum jogo da Agenda ou a alguma conquista, o sistema mostra o aviso “está em uso” e não deixa apagar. Isso protege o histórico do clube: sumir com uma competição usada bagunçaria os jogos e títulos que apontam pra ela.

Como resolver: vá na Agenda (nos jogos) e em Conquistas, troque a competição desses itens por outra (ou remova os itens), e só então volte aqui e exclua a competição.

Repare que aqui não existe a opção de “mover” como nas categorias e naipes. Com competição, você mesmo troca os jogos e conquistas primeiro; o painel só libera a remoção quando ninguém mais estiver usando aquela competição.

Por que manter esses cadastros organizados

Esses três cadastros são a fundação do resto do painel. Mantê-los enxutos e com nomes claros facilita tudo o que vem depois:

Formulários mais rápidos de preencher: ao cadastrar um atleta ou um jogo, você só escolhe numa lista curta, sem digitar nem correr o risco de escrever “Sub 15”, “sub-15” e “SUB15” como se fossem coisas diferentes.
Consistência no site: como o nome vem de um lugar só, todos os atletas e jogos de uma mesma categoria aparecem escritos igual. Mudou o nome no cadastro, mudou em todo lugar.
Menos retrabalho: listas cheias de itens repetidos ou que o clube nem usa mais só atrapalham na hora de escolher. Vale limpar de tempos em tempos.

Dúvidas comuns

Criei a categoria/naipe, mas ela não aparece no formulário do atleta. Por quê? Depois de salvar, a nova opção entra na lista na hora. Se você já estava com o formulário de atleta aberto numa outra aba, feche e abra de novo para a lista recarregar.

Qual a diferença entre a “Chave” e o “Nome”? A chave (ou chave interna) é o identificador que o sistema usa por baixo dos panos para ligar as coisas; ela é curta e sem espaço. O nome (ou nome exibido) é o texto bonito que aparece nas telas. Você troca o nome à vontade; a chave é melhor definir com calma no começo e não ficar mexendo.

Não consigo remover uma competição, aparece “está em uso”. O que fazer? Isso é proposital. Existe pelo menos um jogo na Agenda ou uma conquista usando essa competição. Vá nesses itens, troque a competição deles por outra (ou remova os itens) e depois volte para excluir a competição.

Não consigo remover a última categoria (ou naipe). Se ela ainda tem atletas vinculados, o sistema bloqueia, porque todo atleta precisa de uma categoria e um naipe. Crie outra primeiro, aí o painel deixa você remover e oferece mover os atletas para a nova.

Preciso cadastrar a competição antes de lançar o jogo? Não. Você pode digitar o nome da competição direto no cadastro do jogo, na Agenda, e o sistema cria a competição automaticamente ao salvar. O cadastro avulso em Cadastros → Competições serve para quem prefere deixar tudo pronto antes ou quer definir a abrangência com antecedência.

Este capítulo faz parte do guia do gestor do painel Clubeiros.