Especificação Técnica

Este documento descreve, de forma pública, aberta e versionada, as capacidades funcionais e não-funcionais da plataforma Torneyo (torneyo.com e app.torneyo.com). Ele pode ser citado em estudos técnicos preliminares, termos de referência, pesquisas de mercado e processos de contratação: qualquer interessado tem acesso ao mesmo conteúdo, nas mesmas condições, sem cadastro. Cada versão publicada possui um PDF imutável em URL permanente (ver Versionamento).

Visão geral da solução

• Software como serviço (SaaS) 100% web, hospedado em nuvem, sem instalação local, acessível por navegador em computadores, tablets e smartphones (interface responsiva).
• Aplicativo móvel (Android e iOS) para operação em campo: agenda, súmula, chamada de presença — inclusive offline, com sincronização automática — mensalidades, turmas e validação de reservas.
• Multi-tenant por organização: cada organização possui seus próprios dados, membros, perfis e permissões de acesso; um mesmo usuário pode participar de várias organizações.
• Interface nas três frentes (web de gestão, site público e aplicativo) disponível em português, inglês e espanhol.

Requisitos funcionais

Gestão de competições

• Criação e gestão de campeonatos em múltiplas modalidades esportivas (esportes coletivos, individuais, provas de tempo/marca e esportes eletrônicos), com categorias por sexo e faixa etária.
• Formatos de disputa: fase de grupos, pontos corridos, eliminatória simples, eliminatória dupla, sistema suíço, formato GSL, divisões dentro de uma mesma fase (ex.: Ouro/Prata/Bronze) e torneio relâmpago (criação rápida em um dia).
• Sorteio e chaveamento: sorteio de grupos e alocação de equipes, geração automática de chaves e brackets, com possibilidade de reinício do sorteio antes do início da disputa.
• Tabela automática: geração de rodadas e jogos, grade de horários por local e detecção de conflitos de agenda.
• Classificação em tempo real, com critérios de desempate configuráveis por fase — 11 critérios ordenáveis por prioridade (pontos, vitórias, saldo, gols pró, confronto direto, disciplina, sorteio, entre outros).
• Súmula digital com modelos configuráveis (súmula de eventos, placar simples e formulário em branco para preenchimento manual), registro de gols, cartões, substituições e escalações; upload da súmula assinada digitalizada, com download disponível na página pública do jogo.
• Artilharia, ranking de cartões e estatísticas por atleta e por equipe.
• Punições e suspensões: registro de punições disciplinares e suspensão automática por acúmulo de cartões ou expulsão, com bloqueio do atleta suspenso na escalação.
• Simulador de resultados: projeção da classificação a partir de placares hipotéticos, sem alterar os resultados oficiais — disponível também na página pública.
• Arbitragem: cadastro de árbitros e escala de arbitragem por jogo.
• Transmissões: vínculo de transmissões ao vivo aos jogos (YouTube, Twitch, Kick, Instagram e Facebook) e galeria de vídeos.
• Provas de tempo e marca (atletismo, natação e afins): provas com baterias e raias, inscrição por prova, registro de resultados por raia, detecção automática de quebra de recordes (tempo, distância, peso e pontos) e classificação por prova.
• Quadro de medalhas calculado automaticamente por categoria e por prova, com pódio e premiações (troféus, medalhas e outras).

Cadastros e inscrições

• Cadastro centralizado de atletas com documento de identificação único, foto, histórico de participação e perfil consultável.
• Documentos do atleta com fluxo de aprovação (envio, análise e deferimento/indeferimento por tipo de documento).
• Cadastro de equipes com elenco por categoria, comissão técnica com funções e escudo.
• Inscrição online de equipes e atletas com fluxo de deferimento (aprovação ou recusa pela organização) e convites de inscrição.
• Credencial (carteirinha) com QR code por atleta e check-in de jogo pela plataforma web, com verificação pública da credencial.

Escolinhas e turmas

• Gestão de escolinhas esportivas: turmas com professor, faixa etária e limite de vagas.
• Chamada eletrônica de presença, inclusive offline no aplicativo móvel (registro local com sincronização automática ao restabelecer a conexão).
• Fila de espera com promoção automática: ao vagar uma matrícula, o próximo da fila é promovido e o responsável é notificado.
• Configuração de matrícula: validade em meses, aviso prévio de vencimento, tolerância em dias antes do bloqueio de participação e limite de atividades por aluno.
• Ficha de inscrição do aluno em PDF.
• Avaliações técnicas do aluno e suspensões de turma.
• Mensalidades com recorrência configurável, bolsas e descontos (ver Financeiro).

Formulários e PAR-Q

• Questionário PAR-Q (Physical Activity Readiness Questionnaire) com as perguntas oficiais, complementável com perguntas próprias da organização.
• Formulários personalizados com tipos de resposta variados, aplicáveis à matrícula e à inscrição.
• Controle de validade das respostas e exigência configurável (ex.: PAR-Q obrigatório na matrícula).
• Anexo do formulário assinado (digitalizado) com fluxo de aprovação pela organização.

Reserva de espaços

• Cadastro de locais e espaços (quadras, campos, salas) com fotos, horários de funcionamento e página pública.
• Agenda integrada com prevenção de conflitos entre reservas, jogos e demais compromissos do espaço.
• Autoatendimento: reserva online pelo próprio interessado, com pagamento online no ato (ver gateways em Financeiro) ou reserva gratuita, conforme configuração.
• Ficha de reserva em PDF com QR code, validável na portaria pela leitura do código no aplicativo móvel.

Portal público e divulgação

• Site público de resultados por campeonato e por organização, com URL personalizada (slug) verificável, sem exigência de login para consulta.
• Tabela, classificação, artilharia, estatísticas, quadro de medalhas e recordes publicados automaticamente a partir da operação.
• Notícias, galeria de fotos e vídeos e enquetes com votação pública.
• Cards para redes sociais gerados automaticamente (rodada, resultado, classificação, inscrições abertas, campeão, agenda, equipes), prontos para publicação.
• API pública em JSON para consulta de campeonatos, classificação, jogos, artilharia e estatísticas; widgets de incorporação (embed) de classificação, jogos e artilharia com código de incorporação gerado pela plataforma; API autenticada por chave com escopos de acesso para integrações externas.
• Metadados de compartilhamento (Open Graph) nas páginas públicas.

Financeiro

• Cobrança de inscrições de equipes e atletas.
• Mensalidades com recorrência configurável, bolsas e descontos por aluno.
• Pagamentos online via gateway com repasse à organização (conta conectada) ou recebimento pela conta da plataforma, além de registro manual de pagamentos.
• Controle de transações, assinaturas de planos e limites por plano contratado.

Relatórios

• 12 modelos prontos: artilharia, melhor defesa, classificação, equipes cadastradas, atletas por categoria/equipe/campeonato, cartões, resumo do campeonato, jogos, agenda de jogos e relatório personalizado (construtor com seleção livre de campos).
• Exportação em PDF, CSV, XLSX, HTML e PNG.

Requisitos não-funcionais

• Nível de serviço: SLA formal público com classificação de severidades (S1–S4), prazos de resposta e de solução — ver Acordo de Nível de Serviço.
• Disponibilidade-alvo de 99,0% ao mês, medida por monitoramento externo independente com histórico público e auditável na página de status: torneyo.com/status.
• LGPD: tratamento de dados pessoais ao longo do ciclo de vida, com inativação lógica de registros (soft delete) — nenhum dado é destruído de forma irrecuperável por operação comum de exclusão — e registro de datas de criação e atualização em todos os cadastros.
• Autenticação e segurança: autenticação por token JWT; login social OAuth2 (Google); duplo fator de autenticação por aplicativo autenticador (TOTP) ou código por e-mail, com códigos de backup; perfis e permissões por organização.
• Trilha de auditoria: registro de eventos de auditoria (criação, alteração, inativação, exportação, login/logout) com consulta por administradores.
• Backups periódicos da base de dados e armazenamento de arquivos em serviço de objetos redundante.
• Documentação de API aberta (OpenAPI/Swagger): app.torneyo.com/swagger-ui.html.
• Infraestrutura em nuvem com publicação contínua de atualizações, sem janela de parada para atualizações rotineiras.
• Notificações multicanal: e-mail, push no aplicativo, notificações no sistema e WhatsApp (API oficial), conforme configuração da organização.

Versionamento deste documento

Este documento segue versionamento editorial no formato AAAA.MM.DD — a data de publicação da revisão do documento. A versão vigente é a 2026.08.18. A plataforma evolui continuamente (lançamentos frequentes); esta especificação descreve o conjunto de capacidades garantido na data da revisão, e novas revisões são publicadas quando há mudança relevante de escopo. Cada versão publicada gera um PDF imutável em URL permanente — o arquivo desta versão fica em /downloads/especificacao-tecnica-v2026.08.18.pdf e não é alterado após a publicação, o que permite citar a versão exata consultada em um estudo técnico ou termo de referência. Alterações de conteúdo geram uma nova versão, registrada no histórico abaixo, sem remover os PDFs anteriores.

Histórico de revisões

Versão	Data	Mudanças
2026.08.18	18/08/2026	Versão inicial do documento.