Especificação Técnica
Catálogo público e versionado dos requisitos funcionais e não-funcionais da plataforma Torneyo, citável em estudos técnicos e termos de referência.
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 — 14 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
- Três tipos de grupo, que ajustam a nomenclatura e as telas: escolinha (escola esportiva com turmas, faixas etárias e responsáveis), turma avulsa e pelada; conversão de turma avulsa ou pelada em escolinha completa sem perda de alunos nem de histórico.
- Turmas com professor, faixa etária, limite de vagas e horário próprio para cada dia da semana; vínculo opcional da turma a uma equipe de competição.
- Convite por link (link aberto ou convites individuais por e-mail, com validade e número máximo de usos, revogáveis): quem entra é matriculado na hora, se houver vaga, ou vai para a fila de espera, com a posição informada.
- Fila de espera com promoção automática: ao vagar uma matrícula, o primeiro da fila é matriculado e avisado; promoção e retirada manuais pelo gestor.
- Configuração de matrícula: validade em meses, aviso prévio de vencimento, tolerância em dias antes do bloqueio de participação, limite de atividades por aluno e exigência opcional de PAR-Q aprovado para matricular.
- Chamada eletrônica de presença, inclusive offline no aplicativo móvel (registro local com sincronização automática ao restabelecer a conexão).
- Encontros com confirmação de presença por link: o gestor abre o encontro (data, horário e prazo de resposta) e os participantes respondem “vou” ou “não vou” por um link público, sem precisar entrar na conta.
- Rankings da turma por mês, ano ou todo o período: presença (dias de chamada com comparecimento) e cumprimento da confirmação (confirmou e compareceu / confirmou e faltou).
- Na turma avulsa e na pelada: avaliação entre participantes (nota de 1 a 5, um voto por colega por mês), sorteio de times equilibrados a partir das avaliações e da frequência recente, com histórico dos sorteios, e rateio de custo avulso dividido entre os presentes, com controle de quem pagou.
- Ficha de inscrição do aluno em PDF; avaliações técnicas do aluno; suspensão de aula por dia, com o motivo registrado.
- Área do atleta: o participante matriculado consulta as próprias turmas, os próximos encontros, os sorteios, os rankings e as próprias mensalidades.
- Mensalidades, bolsas de desconto e lembretes de cobrança (ver Financeiro).
Formulários, PAR-Q e ficha médica
- Questionário PAR-Q (Physical Activity Readiness Questionnaire) com as 7 perguntas oficiais, complementável com até 10 perguntas próprias da organização.
- Ficha médica padrão (tipo sanguíneo, alergias, medicamentos de uso contínuo, condições de saúde, plano de saúde e contato de emergência) e formulários personalizados, com perguntas de resposta Sim/Não ou texto livre, obrigatórias ou opcionais.
- Respostas registradas no cadastro do aluno e vinculadas ao atleta, aplicáveis à matrícula em turmas; exigência configurável de PAR-Q aprovado e vigente para matricular e para promover da fila de espera.
- Controle de validade das respostas, com aviso de vencimento por e-mail.
- Anexo do formulário assinado (digitalizado) e fluxo de aprovação ou rejeição motivada pela organização.
- Ficha médica aprovada e vigente incluída, com o contato de emergência em destaque, na ficha de inscrição do aluno em PDF.
Reserva de espaços
- Cadastro de locais e espaços (quadras, campos, salas) com fotos, modalidades, horário de funcionamento por dia da semana e página pública.
- Preço por período (duração do período configurável), antecedência mínima e máxima, limite de reservas ativas por usuário e reserva gratuita quando não há preço.
- Autoatendimento no site, sem cadastro: escolha do dia e do horário livre e confirmação por código de verificação enviado por e-mail; também pela plataforma web e pelo aplicativo, com acompanhamento das próprias reservas.
- Aprovação manual ou automática das reservas gratuitas, conforme configuração da organização; pagamento online por cartão no ato para espaços pagos, com prazo de pagamento e liberação automática do horário não pago.
- Reserva lançada pelo gestor, inclusive reserva fixa semanal; recusa automática de reservas fora do horário de funcionamento, fora da antecedência permitida ou em conflito com jogo, aula ou outra reserva.
- Cancelamento por quem reservou (até a antecedência configurada) ou pelo gestor, com estorno automático do valor pago; avisos por e-mail e lembrete antes do horário reservado.
- Ficha de reserva em PDF com QR code, validável na portaria pela leitura do código no aplicativo móvel.
Agenda institucional
- Eventos institucionais (competição, reunião, capacitação, evento público, manutenção e outros), com dia inteiro ou horário, duração de vários dias e vínculo opcional a local, campeonato e turma.
- Visão consolidada num só calendário de eventos, jogos agendados, reservas confirmadas e aulas das turmas, nas visões mês e lista, com filtros por origem e por tipo de evento e busca.
- Calendário público no site da organização, com os eventos marcados para publicação e os campeonatos públicos.
- Exportação em iCalendar (.ics) do mês, para importação no Google Agenda, no Outlook e em outros aplicativos de calendário.
Almoxarifado
- Cadastro de materiais com categoria, unidade de medida, tamanho, cor, marca, modelo, SKU e estoque mínimo, e de locais de estoque com responsável.
- Movimentações (entrada, saída, transferência, ajuste, perda, empréstimo e devolução), com saldo calculado a partir delas, bloqueio de saldo negativo e locais bloqueados para retirada.
- Empréstimos a atletas com data prevista de devolução e indicação de atraso.
- Controle por número de série, com a condição e o local de cada unidade.
- Cadastro de fornecedores, com nota/empenho e valor nas entradas.
- 4 relatórios: inventário por local, movimentações, empréstimos por pessoa e entradas por fornecedor.
Financeiro
- Cobrança de inscrições de equipes e atletas.
- Mensalidades por escolinha: geração das mensalidades do mês (uma por aluno ativo, sem duplicar), atualização automática da situação (pendente, atrasada, vencida) e multa, juros diários e desconto por pontualidade aplicados conforme a data do pagamento.
- Bolsas de desconto por aluno (integral, parcial, percentual ou valor fixo), com período de validade; segunda via do link de pagamento; lembretes de cobrança ao responsável antes e depois do vencimento; portal do responsável para consulta e pagamento online; painel de inadimplência com exportação para planilha.
- Pagamentos online via gateway com repasse direto para a conta conectada da organização (a plataforma não retém valores de terceiros), além de registro manual de pagamentos.
- Controle de transações, assinaturas de planos e limites por plano contratado.
Bolsa Atleta
- Cadastro de bolsas pagas pela organização ao atleta: programa, modalidade, valor mensal, vigência e frequência mínima exigida.
- Prestação de contas mensal com frequência apurada automaticamente pela chamada das turmas do próprio atleta (ou informada manualmente) e comprovante anexo, com aprovação ou rejeição motivada.
- Registro e confirmação de pagamentos por competência, com fila de aprovação e separação entre quem registra e quem aprova.
- Suspensão automática da bolsa por frequência abaixo da mínima, aviso de fim de vigência e expiração automática.
- Relatório de prestação de contas mensal por bolsista, com totais.
Relatórios
- 18 modelos prontos: artilharia, melhor defesa, classificação, equipes cadastradas, atletas por categoria/equipe/campeonato, cartões, resumo do campeonato, jogos, agenda de jogos, demografia, prestação de contas da Bolsa Atleta, os 4 relatórios do almoxarifado 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.
- Portabilidade: exportação integral dos dados da organização, solicitada pelo proprietário a qualquer momento, em formato aberto (CSV, JSON e XML, com dicionário de dados).
- 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 de acesso por organização: proprietário, administrador, gestor, operador e financeiro, com permissões definidas por perfil — ver Organizações, membros e permissões.
- API de dados com chaves de acesso por escopo (organização, campeonatos, artilharia e estatísticas, equipes e atletas, escolinhas e agenda), criadas e revogadas pela 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.10.06. 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.10.06.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 (o da versão 2026.08.18 continua em /downloads/especificacao-tecnica-v2026.08.18.pdf).
Histórico de revisões
| Versão | Data | Mudanças |
|---|---|---|
| 2026.10.06 | 06/10/2026 | Novos grupos Agenda institucional, Almoxarifado e Bolsa Atleta. Escolinhas e turmas: tipos (escolinha, turma avulsa, pelada), convite por link, horário por dia da semana, encontros com confirmação, rankings, sorteio de times, avaliação entre participantes, rateio e área do atleta. Mensalidades: multa, juros e desconto por pontualidade, bolsas, segunda via, lembretes e portal do responsável. Reserva de espaços: autoatendimento sem cadastro, aprovação e estorno. Formulários: corrige tipos de resposta (Sim/Não e texto livre) e aplicação (matrícula em turmas) e inclui a ficha médica. Relatórios: 18 modelos. Não-funcionais: perfis de acesso, exportação integral e API com chaves por escopo. |
| 2026.08.18 | 18/08/2026 | Versão inicial do documento. |