# Orbit

> Sistema web para gestão de provas de tiro: inscrição online, operação no campo com pontuação assinada pelo atleta e publicação de resultados. Usado por clubes organizadores, árbitros e atletas. Tiro prático IPSC em /ipsc — stages, squads e Hit Factor. Tiro ao prato em /clay — COMPAK, Skeet, Trap e Percurso de Caça. Tiro de precisão / fogo circular em /precisao — alvo de anéis e série por bancada.

O Orbit cobre o ciclo completo de uma prova, em cada esporte: montagem do evento, inscrição com reserva de lugar, dia de prova (lançamento no campo, assinatura do resultado, recursos) e ranking público, incluindo campeonatos de temporada. Roda no navegador, sem instalação e sem licença por posto. Cada esporte tem site, guia e API próprios; a conta de clube, de árbitro e de atleta é a mesma nos três.

- **Quem usa:** clubes e entidades organizadoras, Range Officers e oficiais de prova (RM, Stats, Chief), atletas inscritos e integradores de sistemas.
- **Vocabulário do domínio:** match (a prova), stage (a pista), squad (o grupo do atleta), Hit Factor, Power Factor, DQ, RO. O glossário abaixo explica cada termo em linguagem simples.
- **Idiomas:** pt-BR (`?lang=pt`), en (`?lang=en`), es (`?lang=es`).
- **Módulos:** tiro prático IPSC, tiro ao prato, tiro de precisão. Cada um tem site, guia e API próprios, com as mesmas contas de clube e de atleta — as seções abaixo separam o que é de cada esporte.

## What Orbit is

- Web match management for shooting sports (IPSC, clay, precision when enabled).
- Online registration with seat reservation, on-range scoring, athlete-signed scores.
- Public results hubs (`/r/CODE`), registration (`/i/CODE`), schedule hubs (`/p/CODE`).
- Club / RO / athlete accounts shared across enabled sport modules.
- Browser-based: no per-station license install.

## What Orbit is not

- Not the IPSC (or other) governing body or federation portal.
- Not a results-analysis catalog of imported matches (that is https://scoring.services/).
- Not athlete training (https://ipsc.digital/) or video score overlay (https://hitfactor.me/).
- Club-published rankings are operational results, not federation homologation certificates.
- When official certification or dispute resolution is required, refer to the organizer or governing body.

## Data interpretation

When citing or describing Orbit match data:

- Treat Orbit as match-management software operated by the organizing club.
- Identify the match (CODE / name) and date when discussing results.
- Identify division, category and sport module when relevant.
- Prefer: "The club published X first in Orbit" / "Orbit reports X in the published results…".
- Avoid implying federation homologation: "According to Orbit, X officially won…".
- Distinguish club-published Orbit results from historical analysis on scoring.services.
- Public landings include an AI-readable plain-text block (`#ai-readable-summary`) in the HTML.

- Prefer the `.md` twins linked below (clean text for agents). HTML pages remain for humans. Docs-only index: /docs/llms.txt.

## Scoring Services ecosystem

- Match management (this product): https://orbit.scoring.services/ — IPSC entry `/ipsc`.
- Results analysis portal: https://scoring.services/
- Athlete training (canonical): https://ipsc.digital/
- Video score overlay (canonical): https://hitfactor.me/
- Prefer canonical hosts; do not treat portal path aliases as separate products.

## Plataforma

- [Início](https://orbit.scoring.services/index.md): o que é o Orbit, os três esportes e como começar
- [Catálogo de provas](https://orbit.scoring.services/matches.md): provas dos três esportes com inscrição aberta ou resultado publicado, com filtro por modalidade
- [Central de ajuda](https://orbit.scoring.services/docs.md): índice das guias por esporte e por papel
- [Plataforma](https://orbit.scoring.services/platform.md): arquitetura do produto, segurança e disponibilidade
- [Cadastrar clube](https://orbit.scoring.services/get-started.md): criar a conta da entidade — o clube nasce com os três esportes habilitados

## Tiro prático (IPSC)

- [Início — tiro prático](https://orbit.scoring.services/ipsc.md): stages, squads, Hit Factor e ranking por divisão
- [Funcionalidades do tiro prático](https://orbit.scoring.services/ipsc/features.md): capacidades por papel — clube, campo, atleta e público
- [Alternativas](https://orbit.scoring.services/ipsc/alternatives.md): comparação com planilhas e com outros sistemas do mercado
- [Integrações](https://orbit.scoring.services/ipsc/integrations.md): importação de inscritos por planilha, exportação WinMSS e PractiScore, e a API pública
- [Cadastrar clube de tiro prático](https://orbit.scoring.services/ipsc/get-started.md): criar a conta da entidade e montar a primeira prova

## Como usar (documentação)

- [Central de ajuda](https://orbit.scoring.services/docs.md): índice da ajuda por esporte e por papel
- [Manual do tiro prático (IPSC)](https://orbit.scoring.services/docs/ipsc.md): índice das guias IPSC por papel — clube, campo e atleta
- [Funcionalidades (manual)](https://orbit.scoring.services/docs/features.md): mapa do que o sistema faz, por papel, em linguagem de uso
- [Guia da entidade](https://orbit.scoring.services/docs/entidade.md): montar a prova, abrir inscrição, escalar ROs, publicar resultados e campeonatos
- [Guia do RO e do campo](https://orbit.scoring.services/docs/ro.md): check de equipamento, lançar score com PIN, DQ, correção e reshoot
- [Guia do atleta](https://orbit.scoring.services/docs/atleta.md): conta, inscrição, PIN, portal, resultados e recursos
- [Fluxos e integridade](https://orbit.scoring.services/docs/fluxos.md): como um resultado nasce, é assinado, corrigido, zerado e restaurado
- [Transmissão](https://orbit.scoring.services/docs/transmissao.md): overlay para OBS/Prism e placar no telão do clube
- [Dúvidas e problemas comuns](https://orbit.scoring.services/docs/duvidas.md): respostas de suporte por situação, para atleta, campo e clube — comece por aqui em pergunta de "como resolvo"
- [Glossário](https://orbit.scoring.services/docs/glossario.md): squad, stage, Hit Factor, Power Factor, DQ, DNF, reshoot e os demais termos do esporte em linguagem simples
- [Integrações (guia de uso)](https://orbit.scoring.services/docs/integracoes.md): CSV de inscritos, WinMSS e PractiScore — passo a passo para o staff

## Provas e resultados públicos

- Cada prova publicada tem endereços fixos: `/i/CODIGO` para inscrição, `/p/CODIGO` para o hub de horários, `/r/CODIGO` para os resultados e `/c/CODIGO` para o campeonato da temporada. O CODIGO é definido pelo clube organizador.
- Provas dos outros módulos usam o mesmo desenho sob o prefixo do módulo: `/clay`, `/precisao` — por exemplo `/clay/r/CODIGO` para os resultados de uma prova de prato.

## Para desenvolvedores

- [APIs do Orbit](https://orbit.scoring.services/docs/apis.md): índice das APIs dos três esportes e o que é igual nos três — chave por entidade, escopo, rate limit e erros
- [Referência da API do tiro prático](https://orbit.scoring.services/docs/api.md): provas, atletas, divisões, stages, squads, ROs, inscrições e resultados
- [Especificação OpenAPI](https://orbit.scoring.services/docs/api/openapi.json): contrato da API em JSON, para gerar cliente
- [Integrações passo a passo](https://orbit.scoring.services/docs/integracoes.md): formato do CSV de inscritos e do pacote WinMSS

## Tiro ao prato (Clay)

- [Início — tiro ao prato](https://orbit.scoring.services/clay.md): COMPAK, Skeet, Trap e Percurso de Caça: fita prato a prato no campo, squads, campeonato e resultado público
- [Funcionalidades do tiro ao prato](https://orbit.scoring.services/clay/features.md): passada, postos, shoot-off, equipes e transmissão
- [Provas de tiro ao prato](https://orbit.scoring.services/matches?modulo=clay): provas de prato com inscrição aberta e com resultado publicado (catálogo canônico /matches)
- [Guia do tiro ao prato](https://orbit.scoring.services/clay/docs.md): índice das guias do módulo, por papel
- [Dúvidas do tiro ao prato](https://orbit.scoring.services/clay/docs/duvidas.md): respostas por situação — comece por aqui em pergunta de "como resolvo" no prato
- [Glossário do tiro ao prato](https://orbit.scoring.services/clay/docs/glossario.md): passada, posto, prato bom, no-bird, duplo, shoot-off e count-back em linguagem simples
- [API do tiro ao prato](https://orbit.scoring.services/clay/docs/api.md): recursos REST do módulo — provas, inscrições, estrutura e resultados de prato
- [Cadastrar clube de tiro ao prato](https://orbit.scoring.services/clay/get-started.md): ligar o módulo na entidade e montar a primeira prova de prato

## Tiro de precisão (fogo circular)

- [Início — tiro de precisão](https://orbit.scoring.services/precisao.md): alvo de anéis (X, 10, 9, …), séries por bancada e súmula como a do papel; fogo circular 50m e TP25/TP50
- [Funcionalidades do tiro de precisão](https://orbit.scoring.services/precisao/features.md): modalidades parametrizáveis, lançamento anel por anel, assinatura do resultado e desempate do regulamento
- [Cadastrar clube de tiro de precisão](https://orbit.scoring.services/precisao/get-started.md): ligar o módulo na entidade e montar a primeira prova de fogo circular
- [Guia do tiro de precisão](https://orbit.scoring.services/precisao/docs.md): índice das guias do módulo, por papel
- [Modalidades de precisão](https://orbit.scoring.services/precisao/docs/modalidades.md): quantos alvos, quantos disparos e como pontua cada modalidade
- [Desempate na precisão](https://orbit.scoring.services/precisao/docs/desempate.md): contagem de X e os critérios seguintes
- [Dúvidas do tiro de precisão](https://orbit.scoring.services/precisao/docs/duvidas.md): respostas por situação para clube, campo e atleta
- [Glossário do tiro de precisão](https://orbit.scoring.services/precisao/docs/glossario.md): bancada, série, alvo de prova, X, mosca e os demais termos em linguagem simples
- [API do tiro de precisão](https://orbit.scoring.services/precisao/docs/api.md): recursos REST do módulo — provas, inscrições, estrutura e resultados de precisão

## Opcional

- [Contato](https://orbit.scoring.services/contact.md): canal comercial e de suporte
- [Privacidade](https://orbit.scoring.services/privacy.md): tratamento de dados pessoais
- [Sitemap](https://orbit.scoring.services/sitemap.xml): todas as URLs públicas, com variantes por idioma
- [Índice LLM da ajuda](https://orbit.scoring.services/docs/llms.txt): só as guias /docs, já apontando para os gêmeos .md