# Guia da entidade e staff

> Orbit help — markdown twin of `/docs/entidade` for LLM agents (llmstxt.org). Human UI: /docs/entidade

Para quem organiza a prova pelo clube/entidade: o que configurar, o que divulgar e o que acompanhar no dia.

## Checklist da entidade

1. Cadastrar a entidade e convidar a equipe (staff).

2. Criar a prova e definir divisões, pistas, squads e ROs.

3. Abrir inscrição (link público e/ou prazo) e divulgar para os atletas.

4. No dia: garantir login dos ROs, check e lançamento de scores.

5. Publicar hub e resultados; acompanhar campeonato se houver.

## 1. Acesso e equipe

- Login staff (SSO ou e-mail/senha, conforme o ambiente).

- Área principal: **Dashboard da entidade** → **Provas**.

- Convide usuários (owner/manager) em **Usuários** —
      o convidado recebe um link e entra com SSO.

- Em **Perfil** ajuste dados e idioma da interface.

- Defina quais campos o atleta precisa informar — veja
      **"Campos obrigatórios e customização"** logo abaixo.

## 1.0. Quando o clube tem mais de um esporte

  Se o seu clube usa o tiro prático **e** o tiro ao prato,
  o sistema trabalha com um produto por vez: o menu, as provas e os resultados
  são sempre os do esporte em que você está. Trocar de esporte é um clique no
  topo da tela, e nada do que você deixou aberto se perde.

- **Quem liga cada esporte no clube** é você mesmo, em
      **Dados do clube**: marque *"Usar o tiro ao prato neste
      clube"* e salve. Desligar depois não apaga nada — as provas de prato
      continuam guardadas e voltam quando você religar; o que some é o menu.
      Se essa opção não aparecer na sua tela, a modalidade não está disponível
      nesta instalação do sistema: fale com o suporte antes de qualquer outra
      coisa.

- **Quem vê cada esporte dentro do clube** é decisão do
      owner ou do manager, em **Usuários**: dá para tirar o tiro ao
      prato do menu de quem só cuida do tiro prático, e vice-versa. Ninguém perde
      o que já lançou — só o menu fica mais curto.

- **Por onde você entra** é escolha sua, em
      **Perfil → Módulo padrão**. Deixando em
      *"Perguntar ao entrar"*, o sistema mostra a tela de escolha depois do
      login, como sempre fez.

- O clube inteiro também pode ter um esporte padrão, em
      **Dados do clube**. A sua escolha no perfil sempre vale mais
      que a do clube.

  **Atalho útil:** o link de entrada do tiro ao prato já abre
  no esporte certo, independentemente do padrão configurado — mande esse link para
  quem só trabalha com prato.

## 1.1. Campos obrigatórios e customização

  **Você decide quais dados são obrigatórios** no cadastro do
  atleta e na inscrição — o sistema não impõe uma lista fixa. Os campos padrão
  (documentais, telefone, nascimento, endereço e e-mail) ficam em
  **Dados do clube**; os campos próprios da entidade, em
  **Atletas da entidade → Configurar campos**. A configuração vale para
  toda a entidade (interface, inscrição pública e API).

- **Campos documentais** (CPF, RG, CR e validade do CR):
      para cada um você escolhe se *aparece*, se é *obrigatório* e se é
      *único* (dois atletas ativos não podem repetir o mesmo valor).

- **Telefone e data de nascimento**: entram na mesma tabela
      de exibir/obrigatório (sem "único"). Por padrão aparecem no cadastro mas são
      *opcionais* — só viram obrigatórios se o clube marcar.

- **Endereço do atleta**: desligado por padrão. Ao ligar
      "exibir", o bloco de endereço (logradouro, número, bairro, cidade, UF, CEP)
      aparece na inscrição pela entidade e no portal do atleta; "obrigatório" exige
      logradouro, cidade, UF e CEP. O endereço fica no perfil global do atleta.

- **E-mail obrigatório**: ligado por padrão. Desligue para
      cadastro rápido sem e-mail (o sistema usa o documento ou o nome como identidade
      provisória); o e-mail pode ser adicionado depois.

- **Campos adicionais**: crie campos próprios da entidade
      (texto, número, seleção, checkbox…), cada um podendo ser obrigatório e/ou único —
      ex.: número de sócio, matrícula.

- **Tags de inscrição, Classes IPSC e Categorias de gestão**:
      catálogos que você mantém e que ficam disponíveis na inscrição.

  Usa um sistema próprio integrado ao Orbit? Essa mesma configuração é publicada
  para a integração, então o outro sistema sabe exatamente o que é obrigatório e o que não
  pode repetir antes de cadastrar atletas ou inscrições — sem ninguém precisar avisar por
  fora quando o clube muda uma regra.
  [Ver a API pública →](/docs/api)

## 2. Montar a prova

1.
    **Criar a prova** — nome, datas, código público (vai nos links),
    status e prazo de inscrição, se quiser encerrar automaticamente.

2.
    **Inscrição** — uma ou várias divisões por sessão;
    se o atleta fica no mesmo squad em todas as divisões ou escolhe por match.
    Marque se a prova exige dados completos do perfil/clube antes do wizard.

3.
    **Inscrição pública** — a prova nasce com o link de inscrição
    **fechado**. Ligue **"Permitir inscrição pública"** (aba
    Inscrição, wizard ou card de publicação nos detalhes) quando quiser abrir; junto,
    defina o prazo. Fechado, a equipe continua inscrevendo por dentro normalmente.
    Fechar não atrapalha quem já se inscreveu: o atleta sem PIN define o PIN
    **no campo** — no check de equipamento (se a prova usa check) ou,
    em prova sem check, no primeiro lançamento.

4.
    **Check de equipamento** — sem check, na primeira pista do squad,
    ou antes da prova por RO autorizado.

5.
    **Modalidades e divisões** — Open, Production, etc., com fator
    Major/Minor quando couber.

6.
    **Áreas, pistas e Main Matches** — estrutura do campo e do schedule.

7.
    **Squads** — limite de vagas; vincule a área/Main Match conforme o desenho.

8.
    **Schedule** — grade horário × pistas (live interno para a equipe).

9.
    **ROs** — vincule à prova, defina a senha da prova e as pistas que cobre.
    Marque quem pode fazer check, se a política for “antes da prova”.

10.
    **Oficiais** (opcional) — Range Master, Stats, Area Chief para andamento,
    DQ e autorização de correção de score.

11.
    **Equipes / times** (opcional) — se a prova competir em time,
    configure tamanho e vincule atletas inscritos.

  Use o **assistente de prova** (wizard) quando disponível:
  ele guia as etapas principais na ordem certa antes de abrir as inscrições.

    A lista de stages calcula sozinha os pontos e o peso de cada um no match, e mostra
    o total de pontos e de disparos da prova no cabeçalho. O botão **Resumo das pistas**
    gera o caderno de briefings — diagrama e especificação de cada stage, mais a tabela de Course of
    Fire por área, com a classificação Short/Medium/Long no padrão IPSC.

## 3. Inscrições

Formas que podem coexistir:

-
    **Link público** —
    /i/CODIGO —
    o atleta entra no portal, escolhe divisões, reserva squad e, se a prova pedir, cria o PIN.

-
    **Wizard da equipe** — pela gestão de inscrições da prova
    (quem não se autoinscreveu).

-
    **Importação CSV** — para trazer inscritos em lote
    (atualiza ou cria conforme o modelo do sistema).

-
    **Exportação** — planilha/listagens para conferência e organização.

  Divulgue /i/CODIGO no site, WhatsApp ou e-mail.
  Peça aos atletas para cadastrarem equipamentos **antes** de confirmar.
  Se houver prazo de inscrição, avise com clareza — após o prazo o portal não aceita nova inscrição.

  **Prazo limite para inscrições**: obrigatório quando o link público
  está ativo. Não pode ser depois da data de término da prova — o sistema valida ao salvar e
  já avisa na tela antes de você confirmar.

  **Exigir perfil e dados adicionais do clube para se inscrever**: liga
  uma checagem extra, só para essa prova. Antes de entrar no wizard de inscrição (link público),
  o atleta precisa ter nome, sobrenome e telefone completos no perfil (telefone só se o clube
  não tiver marcado como opcional — ver 1.1) e, se a entidade usa vínculo, os campos
  documentais que o clube exige. Falhando algum, ele é redirecionado para completar antes de
  escolher divisão e squad. Útil para provas que exigem cadastro pronto (federadas, com
  verificação de documento) antes de liberar a inscrição.

### O que a listagem de inscritos mostra

  Sob o nome de cada inscrito aparecem as etiquetas do que já foi cumprido —
  categoria e classe e, quando a prova usa esses recursos,
  **Check feito / Check em aberto** e **Crono feito / Crono em aberto**.
  É a leitura rápida de quem já pode atirar sem passar por nenhuma outra tela.

### Reiniciar o PIN de um atleta

  Atleta que esqueceu o PIN de 4 dígitos no meio da prova se resolve na própria
  listagem de inscritos: **Reiniciar PIN** (gestor, RM ou Stats). O botão só
  aparece para quem **já tem** PIN — o primeiro PIN continua nascendo na
  inscrição, no check de equipamento ou no primeiro resultado.

| Opção | O que acontece | Quando usar |

|
      Definir no próximo lançamento |
      O PIN atual é apagado e o atleta cria o novo na próxima vez que assinar um
          score, no aparelho do RO — **mesmo que o check de equipamento já tenha sido
          feito**. |
      O atleta não está na secretaria; já está na fila da pista. |

|
      O atleta define agora |
      Ele digita o PIN novo na hora, no aparelho da gestão (criar + confirmar).
          O número continua sendo segredo dele — ninguém do clube vê. |
      O atleta está na sua frente, no balcão. |

  A redefinição fica registrada na auditoria da prova. Ninguém — nem o clube —
  consegue ler o PIN de um atleta: o sistema guarda só a verificação, nunca o número.

### Nome na prova

  O nome que aparece nas listas, no ranking e no resultado público é o
  **nome na prova** — editável na inscrição, tanto pelo atleta (no wizard do
  portal) quanto pela gestão. Alterá-lo **não renomeia** o cadastro do atleta
  nem o vínculo dele com o clube, e vale para todas as divisões daquele atleta na mesma
  prova.

## 4. Extras úteis

-
    **Fast Pass** — squad virtual para quem passa direto em uma pista;
    ative na prova se for usar.

-
    **E-mails** — configure SMTP da entidade para confirmações;
    convites de staff podem usar o e-mail global do sistema.

-
    **Relatório de ROs** — conferência de vínculo RO × pistas.

-
    **Anotações no atleta** — registros internos visíveis à equipe da prova.

## 5. Publicar para o público

| O quê | URL | Quando aparece |

|
      Inscrição |
      /i/CODIGO |
      “Permitir inscrição pública” ligado + status Aberta + dentro do prazo |

|
      Hub (schedule / links) |
      /p/CODIGO |
      Hub público ligado na prova |

|
      Resultados |
      /r/CODIGO |
      Resultados públicos ligados na prova |

|
      Detalhe do atleta (Verify) |
      Nos rankings |
      Verify público + resultados públicos |

|
      Campeonatos |
      /c/CODIGO |
      Campeonatos habilitados e publicados no hub |

|
      Recursos decididos |
      /p/CODIGO/recursos |
      Hub público + “Publicar recursos decididos” na prova |

  Ative as opções na edição ou nos detalhes da prova. Sem a publicação ligada, o link não fica disponível para o público.

## 6. Campeonatos (temporada)

  Use quando a entidade organiza várias etapas no ano e quer um ranking único.

1.
    Em **Clube**, permita campeonatos e salve — o menu passa a aparecer.

2.
    Crie o campeonato (nome, ano, modalidade) e configure etapas previstas, mínimo e descartes.

3.
    Defina o padrão de modalidades e divisões antes de vincular provas.

4.
    Vincule as provas compatíveis com esse padrão. No próprio vínculo dá para marcar
    a etapa como **peso 2** (conta em dobro) — e mudar depois, pela lista de
    etapas.

5.
    Gere o hub público e marque cada campeonato como **publicado**.

6.
    Divulgue /c/CODIGO para lista, etapas e ranking.

  O ranking da temporada usa os pontos de cada prova com resultados públicos.
  Publique o /r de cada etapa para o campeonato atualizar.

  **Etapa de peso 2**: use para a final da temporada ou a etapa
  principal do ano. O ranking marca a coluna com **×2** e o valor exibido
  continua sendo o resultado cru do atleta — quem dobra é a etapa, não o que ele fez. O peso
  também entra no **descarte**: descartar uma etapa que vale 2 custa o dobro,
  então ela só cai se for mesmo a pior contribuição. Desvincular a prova zera o peso.

## 7. No dia e depois

- Confirme que os ROs entram com usuário + código do clube + senha (a prova é escolhida depois do login).

- Acompanhe andamento, presença, DQ e fila de recursos pelos oficiais (RM/Stats).

- DNF: ordem de tiro ou inscrição; restauração só RM/gestor (remove scores zero de DNF).

- Se publicar recursos no hub, o público vê só pedidos procedentes/improcedentes e a resposta.

- Prazo para abrir recursos: configure na prova (fuso da entidade); após o prazo só se decide o que já estava aberto.

- Após o match, revise scores incompletos e mantenha resultados públicos atualizados.

- Se houver campeonato, publique cada etapa para o ranking da temporada acompanhar.

### Finalizar a prova

  Quando todo atleta ativo tem resultado em todo stage ativo, a visão geral da prova
  convida a **finalizar**. Finalizar congela a prova: ela vira consulta, e ninguém
  edita cadastro, move atleta de squad ou reabre score já divulgado por engano.

| Continua disponível | Sai do ar até reabrir |

|

        Visão geral, dashboard, fluxo do match, quadro de squads (sem mover),
        ranking, scores lançados (só leitura, com o **Imprimir**) e auditoria.
        Os gates de publicação — hub, Verify e resultados públicos — continuam ajustáveis, e
        clonar a prova segue funcionando.
       |

        Cadastro da prova, inscrições, edição de resultado, matches, schedule,
        transmissão e Check & Crono. O RO de campo também não entra: a sessão dele é
        encerrada, então nem link salvo no celular lança score.
       |

  **Reabrir** exige um motivo (o campo é obrigatório) e fica gravado na
  auditoria com quem reabriu e por quê — reabrir mexe em resultado que já foi divulgado. O aviso
  no topo da prova mostra o motivo da última reabertura e leva direto à auditoria.

  No mesmo modal de finalizar, a opção **Enviar resultados ao scoring.services**
  já vem marcada: a classificação por divisão e o detalhe de cada atleta vão para o portal
  **scoring.services** com origem Orbit. Dá para atualizar ou remover depois pela
  visão geral da prova. Só IPSC.

### Export external (federação)

  No ranking interno (oficiais), o botão **Export
  external** gera o CSV no layout que sistemas externos de federação
  importam (**CSV Model 1**): uma linha por atleta, com
  classificação, CPF, nome, classe, divisão, categoria, o percentual do
  atleta na divisão dele e os match points. DQ fica de fora e a
  classificação reinicia por divisão — é a posição real do ranking em que
  o atleta compete.

    O **Overview** mostra quanto da prova já foi concluída e o progresso de
    cada stage. O percentual conta *resultado aprovado* (stages ativos × atletas ativos), não
    stage fechado — por isso ele se move desde o primeiro score, e não só quando um stage inteiro
    termina.

    **Fluxo do match** reúne os painéis do dia: progresso geral, células
    concluídas e o alerta de espera alta entre squads no mesmo stage — o gargalo aparece antes de
    virar atraso.

    **Match Progress**: a grade squad × stage com mínimo, máximo e média de
    tempo, duração e espera. Verde é squad completo; vermelho é resultado faltando ou edição
    pendente.

    **Squads — ocupação**: arraste o atleta para outro squad no desktop, ou
    use o botão Mover no celular. Cada troca pede confirmação e fica registrada na auditoria da
    prova.

  O PIN do atleta é criado por ele (portal, check ou primeiro score) — a equipe
  **não escolhe** o PIN de ninguém, nem pela tela de editar inscrição. Esqueceu?
  Use **Reiniciar PIN** na listagem de inscritos: ou o atleta digita o novo na
  hora, no aparelho da gestão, ou cria no próximo lançamento.

## 8. Timer Bluetooth: preparar os tablets

  Se a prova vai usar o timer Bluetooth na tela de lançar, prepare os tablets
  **antes do dia da prova** — a configuração é feita uma vez por aparelho e vale
  para sempre.

1. Use **Chrome atualizado** (Android ou computador). iPhone/iPad não
      funcionam com o timer — é limitação dos navegadores da Apple.

2. Em cada tablet, abra a tela de lançar, toque em **Add Timer** e
      siga a instrução da janela: toque em **Copiar** ao lado do endereço de
      configuração, cole na barra do Chrome, marque **Enabled** e toque em
      **Relaunch**.

3. Pareie o timer uma vez (toque em **Add Timer** → escolha o
      aparelho, nome tipo **SP M1A2**). Pronto: desse ponto em diante o tablet
      reconecta sozinho, mesmo depois de recarregar a página.

  **Como saber se está conectado:** o botão do timer na tela de lançar
  fica **verde**. Ao trocar de atleta ou recarregar, basta olhar a cor — verde,
  siga em frente; cinza, um toque no botão reconecta. Oriente os ROs a conferir a cor antes de
  cada atleta.

  **A reconexão leva alguns segundos — é normal.** O tablet e o timer
  precisam "se encontrar" pelo rádio, e ambos economizam bateria entre transmissões. Timer perto
  do tablet e tela ligada encurtam a espera. Uma vez conectado, os disparos chegam
  instantaneamente.

  Disparos ocorridos com o timer desconectado não são recuperados. Se a conexão cair
  no meio de uma série, o RO pode digitar o tempo normalmente — nada trava o lançamento.

  O passo a passo com telas está no
  ****[Guia do RO](/docs/ro).
  **Timers suportados hoje:** Special Pie (SP M1A2 e M1A2-F) e
  Shooters Global (SG Timer, SG Timer 2 e SG Timer GO), identificados automaticamente ao
  conectar — para integrar outro modelo,
  [fale com a gente](/contact?de=ipsc).

  [← Todas as guias](/docs/)
  [Guia do atleta →](/docs/atleta)
  [Guia do RO →](/docs/ro)

    **[Ajuda dos outros esportes](/docs/)

Conheça o Orbit

    [Início](/?to_index=1)
    ·
    [Provas e resultados](/matches)

    ·
    [Tiro prático (IPSC)](/ipsc/)
    ·
    [Recursos](/ipsc/features)
    ·
    [Integrações](/ipsc/integrations)

    ·
    [Cadastre seu clube](/get-started)
    ·
    [Contato](/contact?de=ipsc)

---

HTML: /docs/entidade
Index: /llms.txt · Docs index: /docs/llms.txt