Sport Tech Club

Appearance

Requisitos Funcionais - Sport Tech Club ​

Versão: 1.0.0 Data: 2026-01-09 Status: Draft

Sumário ​

Introdução ​

Este documento especifica todos os requisitos funcionais do Sport Tech Club, uma plataforma completa para gestão de arenas esportivas que integra agendamento, controle de acesso, gamificação, mídia e monetização.

Objetivo ​

Fornecer uma visão detalhada de todas as funcionalidades do sistema, organizadas por módulos, com priorização para implementação em fases.

Escopo ​

O sistema abrange desde a gestão operacional da arena até experiências digitais para jogadores, incluindo IoT, vídeo e gamificação.

Convenções ​

Prioridade ​

PrioridadeDescriçãoFase
MVPFuncionalidade essencial para lançamentoFase 1
Fase 2Funcionalidade importante, não bloqueanteFase 2
Fase 3Funcionalidade de melhoria e inovaçãoFase 3

Personas ​

PersonaDescrição
AdminAdministrador da arena
OperadorStaff operacional
JogadorUsuário que joga na arena
ProfessorInstrutor de aulas/treinos
GerenteGestor responsável por relatórios e estratégia
SistemaProcessos automatizados

Formato de ID ​

RF-[MÓDULO]-[NÚMERO]

Exemplo: RF-ARENA-001

1. Gestão da Arena ​

Módulo responsável pela configuração e gestão da estrutura física e operacional da arena.

RF-ARENA-001: Cadastro da Arena ​

Descrição: O sistema deve permitir o cadastro completo de uma arena, incluindo dados como nome, endereço, CNPJ, contato, horário de funcionamento, capacidade total e configurações gerais.

Prioridade: MVP Personas: Admin, Gerente

Critérios de Aceitação:

  • Cadastro com validação de CNPJ
  • Configuração de horários de funcionamento por dia da semana
  • Upload de logo e imagens da arena
  • Definição de timezone
  • Status ativo/inativo

RF-ARENA-002: Cadastro de Áreas Físicas ​

Descrição: O sistema deve permitir o cadastro de áreas físicas dentro da arena (ex: quadra 1, quadra 2, vestiário masculino, bar, recepção, estacionamento).

Prioridade: MVP Personas: Admin, Operador

Critérios de Aceitação:

  • Nome e descrição da área
  • Tipo de área (quadra, apoio, comercial, acesso)
  • Capacidade máxima
  • Localização/mapa interno
  • Status operacional

RF-ARENA-003: Cadastro de Zonas de Acesso ​

Descrição: O sistema deve permitir a criação de zonas de acesso lógico que agrupam áreas físicas e controlam permissões de entrada (ex: zona VIP, zona quadras, zona bar).

Prioridade: MVP Personas: Admin, Operador

Critérios de Aceitação:

  • Criação de zonas com nome e descrição
  • Associação de múltiplas áreas físicas a uma zona
  • Regras de acesso por perfil de usuário
  • Controle de horários permitidos por zona
  • Integração com sistema de controle de acesso físico

RF-ARENA-004: Configuração Operacional da Arena ​

Descrição: O sistema deve permitir configurar parâmetros operacionais globais da arena, como tempo padrão de partida, tolerância de atraso, política de cancelamento, modo de operação (livre, reservado, eventos).

Prioridade: MVP Personas: Admin, Gerente

Critérios de Aceitação:

  • Configuração de tempo padrão de jogo (ex: 50 min)
  • Tolerância de check-in (ex: 5 min antes)
  • Política de no-show e penalidades
  • Configuração de modo operacional default
  • Regras globais de uso

2. Gestão de Quadras ​

Módulo específico para configuração e gestão de quadras esportivas.

RF-QUADRA-001: Cadastro de Quadras ​

Descrição: O sistema deve permitir o cadastro de quadras com suas características específicas: esporte, dimensões, cobertura, iluminação, superfície.

Prioridade: MVP Personas: Admin

Critérios de Aceitação:

  • Dados básicos (nome, número, descrição)
  • Tipo de esporte (futsal, vôlei, basquete, tênis, etc.)
  • Características físicas (dimensões, cobertura, piso)
  • Recursos disponíveis (iluminação, placar eletrônico, câmeras)
  • Capacidade de jogadores
  • Status (disponível, manutenção, desativada)

RF-QUADRA-002: Perfil de Quadra por Nível ​

Descrição: O sistema deve permitir configurar níveis técnicos recomendados para cada quadra (iniciante, intermediário, avançado, profissional).

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Definição de níveis por quadra
  • Restrição ou recomendação de uso por nível
  • Filtros de agenda por nível
  • Sugestão automática de quadra baseada no perfil do jogador

RF-QUADRA-003: Perfil de Quadra por Gênero ​

Descrição: O sistema deve permitir configurar preferências ou restrições de gênero para uso de quadras (misto, masculino, feminino, horários específicos).

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Configuração de perfil de gênero por quadra
  • Horários específicos por gênero
  • Filtros de agenda
  • Validação no momento da reserva/fila

RF-QUADRA-004: Perfil de Quadra por Tipo de Jogo ​

Descrição: O sistema deve permitir configurar tipos de jogo suportados por quadra (ex: futsal 5x5, futsal society 7x7, vôlei duplas, vôlei 6x6).

Prioridade: MVP Personas: Admin

Critérios de Aceitação:

  • Definição de tipos de jogo por quadra
  • Configuração de número de jogadores por tipo
  • Regras específicas por tipo de jogo
  • Filtros de agenda e busca

RF-QUADRA-005: Regras de Uso de Quadra ​

Descrição: O sistema deve permitir definir regras específicas de uso para cada quadra (ex: uso exclusivo para aulas em determinados horários, proibido uso de chuteira com trava).

Prioridade: MVP Personas: Admin, Operador

Critérios de Aceitação:

  • Cadastro de regras textuais
  • Regras obrigatórias e recomendadas
  • Exibição de regras no momento da reserva
  • Aceitação de termos de uso
  • Auditoria de aceite

RF-QUADRA-006: Prioridade de Uso por Dia da Semana ​

Descrição: O sistema deve permitir configurar prioridades diferentes de uso de quadra por dia da semana (ex: segundas e quartas prioritárias para aulas).

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Configuração de prioridades por dia
  • Diferentes perfis por dia (aulas, livre, eventos)
  • Bloqueio ou liberação condicional
  • Integração com sistema de fila

RF-QUADRA-007: Prioridade de Uso por Perfil de Jogador ​

Descrição: O sistema deve permitir configurar prioridades de uso de quadra baseadas no perfil do jogador (ex: mensalistas têm prioridade sobre avulsos).

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Definição de níveis de prioridade
  • Prioridade por tipo de plano (mensalista, day-use, avulso)
  • Prioridade por nível de gamificação
  • Aplicação automática nas regras de fila

RF-QUADRA-008: Estado da Quadra em Tempo Real ​

Descrição: O sistema deve exibir o estado atual de cada quadra em tempo real (disponível, ocupada, reservada, manutenção, limpeza).

Prioridade: MVP Personas: Operador, Jogador, Sistema

Critérios de Aceitação:

  • Visualização em dashboard operacional
  • Visualização no app do jogador
  • Atualização automática baseada em check-in/out
  • Histórico de estados
  • Alertas de mudança de estado

RF-QUADRA-009: Alocação Dedicada de Quadra ​

Descrição: O sistema deve permitir alocar uma quadra de forma dedicada para um usuário, grupo ou evento por período específico.

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Bloqueio de quadra por período
  • Associação a usuário, grupo ou evento
  • Impedimento de reservas de terceiros
  • Notificação de alocação dedicada
  • Relatórios de uso dedicado

3. Agenda e Reservas ​

Módulo de gestão de agenda e sistema de reservas.

RF-AGENDA-001: Agenda Unificada ​

Descrição: O sistema deve disponibilizar uma agenda unificada que consolida todas as reservas, aulas, eventos e bloqueios de todas as quadras.

Prioridade: MVP Personas: Operador, Admin, Jogador

Critérios de Aceitação:

  • Visualização em grade por dia/semana/mês
  • Filtros por quadra, tipo de uso, usuário
  • Legenda clara de status
  • Sincronização em tempo real
  • Export para calendários externos (iCal, Google Calendar)

RF-AGENDA-002: Reserva de Quadra por Horário/Período ​

Descrição: O sistema deve permitir que usuários autorizados reservem quadras para horários ou períodos específicos.

Prioridade: MVP Personas: Jogador, Operador, Admin

Critérios de Aceitação:

  • Seleção de quadra, data e horário
  • Validação de disponibilidade em tempo real
  • Confirmação de reserva
  • Notificação de confirmação
  • Pagamento (se aplicável)
  • Limite de reservas simultâneas por usuário

RF-AGENDA-003: Reserva Avulsa, Day-use, Eventos ​

Descrição: O sistema deve suportar diferentes tipos de reserva: avulsa (pontual), day-use (dia inteiro) e eventos (múltiplas quadras/horários).

Prioridade: MVP Personas: Jogador, Operador, Admin

Critérios de Aceitação:

  • Seleção de tipo de reserva
  • Precificação diferenciada por tipo
  • Regras específicas por tipo
  • Pacotes e combos (day-use)
  • Reserva múltipla para eventos

RF-AGENDA-004: Cancelamento, No-show, Atraso ​

Descrição: O sistema deve gerenciar cancelamentos de reserva, registrar no-shows e controlar atrasos conforme política da arena.

Prioridade: MVP Personas: Jogador, Operador, Sistema

Critérios de Aceitação:

  • Cancelamento pelo usuário dentro do prazo permitido
  • Cancelamento pelo operador com justificativa
  • Registro automático de no-show
  • Penalidades configuráveis (pontos, bloqueio, multa)
  • Tolerância de atraso configurável
  • Notificações de lembrete antes do horário

4. Fila e Alocação Dinâmica ​

Módulo de gestão de fila de espera e alocação inteligente de quadras.

RF-FILA-001: Fila de Uso de Quadra ​

Descrição: O sistema deve implementar uma fila virtual onde jogadores se cadastram para usar quadras disponíveis seguindo regras de prioridade.

Prioridade: MVP Personas: Jogador, Operador, Sistema

Critérios de Aceitação:

  • Entrada na fila por quadra ou tipo de esporte
  • Visualização da posição na fila
  • Tempo estimado de espera
  • Notificação quando chegar a vez
  • Remoção automática em caso de ausência

RF-FILA-002: Motor de Regras de Alocação ​

Descrição: O sistema deve implementar um motor de regras configurável que determina a ordem e prioridade de alocação de quadras.

Prioridade: MVP Personas: Sistema, Admin

Critérios de Aceitação:

  • Configuração de múltiplas regras
  • Ordem de aplicação de regras
  • Pesos e prioridades
  • Simulação de alocação
  • Logs de decisão do motor

RF-FILA-003: Regra Ganha-Fica ​

Descrição: O sistema deve suportar a regra "ganha-fica" onde o time vencedor permanece na quadra e o perdedor volta para a fila.

Prioridade: MVP Personas: Sistema, Operador, Jogador

Critérios de Aceitação:

  • Ativação/desativação por quadra ou horário
  • Registro do resultado da partida
  • Permanência automática do vencedor
  • Retorno do perdedor à fila
  • Limite de permanência consecutiva

RF-FILA-004: Regra de Limite por Tempo/Placar ​

Descrição: O sistema deve permitir configurar limites de permanência na quadra baseados em tempo decorrido ou placar atingido.

Prioridade: Fase 2 Personas: Admin, Sistema

Critérios de Aceitação:

  • Configuração de tempo máximo (ex: 50 min)
  • Configuração de placar limite (ex: primeiro a 15 pontos)
  • Notificação de aproximação do limite
  • Encerramento automático e liberação da quadra

RF-FILA-005: Entrada Condicional na Fila ​

Descrição: O sistema deve permitir que a entrada na fila seja condicionada a critérios (ex: número mínimo de jogadores, validação de pagamento, aceite de termos).

Prioridade: Fase 2 Personas: Sistema, Admin

Critérios de Aceitação:

  • Validação de pré-requisitos
  • Mensagem clara de impedimento
  • Resolução de pendências
  • Entrada automática após validação

RF-FILA-006: Prioridade na Fila por Perfil ​

Descrição: O sistema deve aplicar prioridades na fila baseadas no perfil do jogador (mensalista, VIP, nível de gamificação).

Prioridade: Fase 2 Personas: Sistema, Admin

Critérios de Aceitação:

  • Configuração de níveis de prioridade
  • Aplicação automática conforme perfil
  • Transparência na visualização da fila
  • Relatórios de uso de prioridades

RF-FILA-007: Override Manual ​

Descrição: O sistema deve permitir que operadores façam override manual da fila em situações excepcionais.

Prioridade: MVP Personas: Operador, Admin

Critérios de Aceitação:

  • Interface de gestão da fila
  • Alteração manual de ordem
  • Justificativa obrigatória
  • Auditoria completa de overrides
  • Notificação aos afetados

5. Usuários e Perfis ​

Módulo de gestão de usuários e controle de acesso.

RF-USER-001: Cadastro de Usuários ​

Descrição: O sistema deve permitir o cadastro de usuários com dados pessoais, documentos, contato e foto.

Prioridade: MVP Personas: Jogador, Operador, Admin

Critérios de Aceitação:

  • Cadastro com CPF, nome, e-mail, telefone
  • Upload de foto de perfil
  • Validação de dados obrigatórios
  • Confirmação de e-mail/telefone
  • Política de privacidade (LGPD)
  • Self-service ou cadastro assistido

RF-USER-002: Gestão de Perfis e Papéis ​

Descrição: O sistema deve implementar um sistema de perfis e papéis (RBAC) que controla permissões e acessos.

Prioridade: MVP Personas: Admin

Critérios de Aceitação:

  • Papéis predefinidos (Admin, Operador, Jogador, Professor)
  • Criação de papéis customizados
  • Atribuição de múltiplos papéis por usuário
  • Herança de permissões
  • Interface de gestão de permissões

RF-USER-003: Permissões, Perfis Temporários, Convidados ​

Descrição: O sistema deve suportar permissões temporárias, perfis de convidado e acesso limitado por tempo.

Prioridade: Fase 2 Personas: Admin, Operador

Critérios de Aceitação:

  • Criação de perfil temporário com validade
  • Convites com link único
  • Permissões específicas para convidados
  • Expiração automática
  • Conversão de convidado em usuário permanente

6. Professores e Aulas ​

Módulo de gestão de professores, aulas e turmas.

RF-PROF-001: Cadastro de Professores ​

Descrição: O sistema deve permitir o cadastro de professores com suas especializações, disponibilidade e dados de contrato.

Prioridade: MVP Personas: Admin, Gerente

Critérios de Aceitação:

  • Dados pessoais e profissionais
  • Modalidades que leciona
  • Certificações e qualificações
  • Disponibilidade de horários
  • Dados de contrato e repasse
  • Upload de documentos

RF-PROF-002: Agenda do Professor ​

Descrição: O sistema deve fornecer uma agenda específica para cada professor com suas aulas, disponibilidade e compromissos.

Prioridade: MVP Personas: Professor, Admin

Critérios de Aceitação:

  • Visualização de agenda pessoal
  • Marcação de disponibilidade
  • Bloqueio de horários
  • Integração com calendário externo
  • Notificações de aulas

RF-PROF-003: Criação de Aulas/Turmas ​

Descrição: O sistema deve permitir a criação de aulas e turmas com recorrência, limite de alunos e quadra alocada.

Prioridade: MVP Personas: Professor, Admin

Critérios de Aceitação:

  • Definição de modalidade e nível
  • Recorrência (semanal, quinzenal, etc.)
  • Capacidade máxima de alunos
  • Alocação de quadra
  • Valor e forma de pagamento
  • Matrícula de alunos

RF-PROF-004: Controle de Presença (Professor e Aluno) ​

Descrição: O sistema deve permitir o controle de presença tanto do professor quanto dos alunos matriculados.

Prioridade: MVP Personas: Professor, Operador

Critérios de Aceitação:

  • Lista de presença por aula
  • Check-in de professor
  • Check-in de alunos (manual ou automático)
  • Registro de faltas
  • Relatório de frequência
  • Alertas de ausências recorrentes

RF-PROF-005: Calendário de Aulas ​

Descrição: O sistema deve disponibilizar um calendário consolidado de todas as aulas da arena e por professor.

Prioridade: MVP Personas: Professor, Admin, Jogador

Critérios de Aceitação:

  • Visualização por professor, modalidade ou quadra
  • Filtros avançados
  • Marcação de aulas especiais (reposição, extra)
  • Cancelamento de aula com notificação
  • Export para calendário externo

7. Controle de Acesso e Presença ​

Módulo de controle de acesso físico e presença na arena.

RF-ACESSO-001: Check-in/Check-out ​

Descrição: O sistema deve permitir o registro de entrada e saída de usuários na arena com validação de permissões.

Prioridade: MVP Personas: Jogador, Operador, Sistema

Critérios de Aceitação:

  • Check-in via app, QR code ou biometria
  • Validação de reserva ou permissão
  • Registro de timestamp
  • Check-out manual ou automático (timeout)
  • Histórico de acessos

RF-ACESSO-002: Check-in por Quadra/Aula ​

Descrição: O sistema deve permitir check-in específico para uso de quadra ou participação em aula.

Prioridade: MVP Personas: Jogador, Professor, Operador

Critérios de Aceitação:

  • Check-in na entrada da quadra
  • Associação à reserva ou fila
  • Check-in em aula específica
  • Controle de capacidade da quadra
  • Liberação de acesso físico

RF-ACESSO-003: Controle de Presença Real ​

Descrição: O sistema deve monitorar a presença real de usuários nas dependências através de integrações com IoT.

Prioridade: Fase 3 Personas: Sistema

Critérios de Aceitação:

  • Integração com sensores de presença
  • Detecção de permanência em área
  • Alertas de anomalias (presença sem check-in)
  • Mapa de calor de ocupação

RF-ACESSO-004: Auditoria de Uso ​

Descrição: O sistema deve manter auditoria completa de todos os acessos e usos das instalações.

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Log completo de acessos
  • Relatórios de uso por usuário
  • Relatórios de uso por área
  • Detecção de padrões anormais
  • Export para análise

8. Jogos e Partidas ​

Módulo de gestão de partidas e competições.

RF-JOGO-001: Criação de Partidas ​

Descrição: O sistema deve permitir a criação de partidas com definição de times, jogadores, quadra e horário.

Prioridade: MVP Personas: Jogador, Operador

Critérios de Aceitação:

  • Definição de modalidade
  • Criação de times (2 ou mais)
  • Adição de jogadores aos times
  • Associação a quadra e horário
  • Partida amistosa ou valendo (ranking)

RF-JOGO-002: Gestão de Times/Jogadores ​

Descrição: O sistema deve permitir a formação de times, adição/remoção de jogadores e substituições durante a partida.

Prioridade: MVP Personas: Jogador, Operador

Critérios de Aceitação:

  • Formação de times balanceados
  • Convite de jogadores
  • Aceitação/recusa de convite
  • Substituições durante partida
  • Validação de número de jogadores

RF-JOGO-003: Controle de Placar ​

Descrição: O sistema deve permitir o registro e acompanhamento do placar em tempo real durante a partida.

Prioridade: MVP Personas: Jogador, Operador

Critérios de Aceitação:

  • Interface de marcação de pontos
  • Histórico de pontuação (sets, quartos)
  • Visualização em tempo real no app
  • Exibição em placar eletrônico (integração)
  • Registro de estatísticas individuais

RF-JOGO-004: Partida Valendo (Configurável) ​

Descrição: O sistema deve permitir marcar partidas como "valendo" para contabilização em rankings e estatísticas oficiais.

Prioridade: Fase 2 Personas: Jogador, Operador, Admin

Critérios de Aceitação:

  • Flag de partida valendo
  • Critérios de validação (número mínimo de jogadores, tempo mínimo)
  • Impacto no ranking
  • Registro de estatísticas oficiais
  • Auditoria de partidas válidas

9. Eventos ​

Módulo de gestão de eventos especiais na arena.

RF-EVENTO-001: Cadastro/Configuração de Eventos ​

Descrição: O sistema deve permitir a criação e configuração completa de eventos (torneios, festas, campeonatos).

Prioridade: Fase 2 Personas: Admin, Gerente

Critérios de Aceitação:

  • Dados básicos do evento (nome, data, descrição)
  • Tipo de evento (torneio, corporativo, festa)
  • Quadras e áreas reservadas
  • Capacidade de participantes
  • Programação detalhada
  • Inscrições e pagamento

RF-EVENTO-002: Modo Evento ​

Descrição: O sistema deve suportar um "modo evento" que altera as regras operacionais da arena durante o evento.

Prioridade: Fase 2 Personas: Admin, Operador

Critérios de Aceitação:

  • Ativação de modo evento
  • Bloqueio de uso normal das quadras do evento
  • Regras específicas de acesso
  • Dashboard específico do evento
  • Relatórios separados

RF-EVENTO-003: Participantes, Acesso, Consumo por Evento ​

Descrição: O sistema deve gerenciar participantes do evento, controlar acessos específicos e consolidar consumo por evento.

Prioridade: Fase 2 Personas: Operador, Gerente

Critérios de Aceitação:

  • Lista de participantes
  • Credenciamento
  • Acesso exclusivo a áreas do evento
  • Rastreamento de consumo por participante
  • Fechamento de conta do evento
  • Relatório financeiro consolidado

10. Consumo e Cobrança ​

Módulo de gestão financeira, consumo e cobrança.

RF-CONSUMO-001: Registro de Consumo ​

Descrição: O sistema deve permitir o registro de consumo de produtos e serviços por usuários durante sua permanência.

Prioridade: MVP Personas: Operador, Jogador

Critérios de Aceitação:

  • Registro via app ou operador
  • Associação ao usuário logado
  • Catálogo de produtos/serviços
  • Preços e promoções
  • Confirmação do consumo

RF-CONSUMO-002: Consumo por Zona ​

Descrição: O sistema deve permitir que o consumo seja associado a zonas específicas da arena (bar, cantina, loja).

Prioridade: Fase 2 Personas: Operador, Sistema

Critérios de Aceitação:

  • Registro de zona no momento do consumo
  • Relatórios por zona
  • Catálogo específico por zona
  • Controle de estoque por zona

RF-CONSUMO-003: Conta Individual/Coletiva ​

Descrição: O sistema deve suportar contas individuais por usuário ou contas coletivas compartilhadas por grupo.

Prioridade: MVP Personas: Jogador, Operador

Critérios de Aceitação:

  • Abertura de conta individual ou coletiva
  • Associação de múltiplos usuários a conta coletiva
  • Visualização de consumo em tempo real
  • Divisão de conta (racha)
  • Fechamento e pagamento

RF-CONSUMO-004: All-Inclusive ​

Descrição: O sistema deve suportar pacotes all-inclusive onde consumo é pré-pago e ilimitado (dentro de limites configuráveis).

Prioridade: Fase 2 Personas: Operador, Jogador

Critérios de Aceitação:

  • Configuração de pacotes all-inclusive
  • Validação de elegibilidade
  • Registro de consumo sem cobrança
  • Limites por categoria (ex: bebidas alcoólicas limitadas)
  • Relatórios de uso de pacotes

RF-CONSUMO-005: Mensalidades, Pacotes, Avulso, Day-use ​

Descrição: O sistema deve suportar múltiplos modelos de cobrança: mensalidade recorrente, pacotes de jogos, uso avulso e day-use.

Prioridade: MVP Personas: Admin, Gerente, Jogador

Critérios de Aceitação:

  • Configuração de planos mensais
  • Pacotes de créditos/jogos
  • Precificação avulsa por uso
  • Day-use com acesso ilimitado no dia
  • Renovação automática de mensalidades
  • Gestão de inadimplência

RF-CONSUMO-006: Repasse para Professores ​

Descrição: O sistema deve calcular e gerenciar o repasse financeiro para professores baseado em suas aulas e alunos.

Prioridade: Fase 2 Personas: Admin, Gerente, Professor

Critérios de Aceitação:

  • Configuração de modelo de repasse (%, fixo, misto)
  • Cálculo automático por período
  • Relatório de repasse por professor
  • Aprovação e pagamento
  • Histórico de repasses

11. Wallet e Tokens ​

Módulo de carteira digital e sistema de tokens.

RF-WALLET-001: Carteira por Usuário/Arena/Evento ​

Descrição: O sistema deve fornecer carteiras digitais para usuários, arenas e eventos, permitindo gestão de saldo e transações.

Prioridade: Fase 2 Personas: Jogador, Admin, Sistema

Critérios de Aceitação:

  • Carteira por usuário
  • Múltiplas carteiras (por arena, evento)
  • Visualização de saldo
  • Histórico de transações
  • Extrato detalhado

RF-WALLET-002: Moeda Própria da Arena ​

Descrição: O sistema deve suportar a criação de moedas próprias da arena (tokens) que podem ser usadas para consumo e apostas.

Prioridade: Fase 3 Personas: Admin, Gerente

Critérios de Aceitação:

  • Configuração de moeda da arena
  • Nome, símbolo e taxa de conversão
  • Emissão de tokens
  • Controle de supply
  • Regras de uso e validade

RF-WALLET-003: Transações (Crédito, Débito, Transferência) ​

Descrição: O sistema deve permitir transações de crédito, débito e transferência entre carteiras.

Prioridade: Fase 2 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Crédito na carteira (compra, prêmio)
  • Débito (consumo, aposta)
  • Transferência entre usuários
  • Validação de saldo
  • Confirmação de transação
  • Auditoria completa

RF-WALLET-004: Recompensas, Apostas, Cashback ​

Descrição: O sistema deve implementar mecânicas de recompensas, apostas em partidas e cashback em consumo.

Prioridade: Fase 3 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Recompensas por conquistas
  • Sistema de apostas em partidas
  • Cashback configurável por categoria
  • Crédito automático na carteira
  • Relatório de benefícios recebidos

RF-WALLET-005: Conversão de Moedas ​

Descrição: O sistema deve permitir a conversão entre moeda real (BRL) e tokens da arena com taxas configuráveis.

Prioridade: Fase 3 Personas: Jogador, Admin

Critérios de Aceitação:

  • Taxa de conversão configurável
  • Compra de tokens com dinheiro real
  • Resgate de tokens (se permitido)
  • Histórico de conversões
  • Limites de conversão

12. Gamificação e Engajamento ​

Módulo de gamificação para engajamento de usuários.

RF-GAMIF-001: Ranking de Jogadores ​

Descrição: O sistema deve manter rankings de jogadores baseados em performance em partidas oficiais.

Prioridade: Fase 2 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Rankings por modalidade
  • Sistema de pontuação
  • Atualização em tempo real
  • Rankings gerais e por período
  • Exibição no app e arena

RF-GAMIF-002: Conquistas e Badges ​

Descrição: O sistema deve implementar um sistema de conquistas e badges para incentivar participação e comportamentos positivos.

Prioridade: Fase 2 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Catálogo de conquistas
  • Desbloqueio automático
  • Exibição no perfil
  • Notificação de conquista
  • Conquistas raras e especiais

RF-GAMIF-003: Campeonatos Internos ​

Descrição: O sistema deve suportar a criação e gestão de campeonatos internos com chaveamento, rodadas e classificação.

Prioridade: Fase 2 Personas: Admin, Operador, Jogador

Critérios de Aceitação:

  • Criação de campeonato
  • Inscrição de participantes
  • Geração de chaves (eliminatória, pontos corridos)
  • Controle de rodadas e resultados
  • Tabela de classificação
  • Premiação

RF-GAMIF-004: Histórico de Jogos/Participação ​

Descrição: O sistema deve manter histórico completo de participação do jogador em jogos, aulas e eventos.

Prioridade: Fase 2 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Histórico de partidas
  • Estatísticas acumuladas
  • Participação em eventos
  • Frequência em aulas
  • Timeline de atividades
  • Export de dados

13. Performance e Evolução ​

Módulo de análise de performance e evolução técnica.

RF-PERF-001: Estatísticas de Jogador ​

Descrição: O sistema deve coletar e apresentar estatísticas detalhadas de performance individual por modalidade.

Prioridade: Fase 2 Personas: Jogador, Professor, Sistema

Critérios de Aceitação:

  • Estatísticas por modalidade
  • Pontos, vitórias, derrotas
  • Performance em casa vs visitante
  • Aproveitamento por período
  • Comparação com outros jogadores

RF-PERF-002: Evolução de Performance ​

Descrição: O sistema deve rastrear e visualizar a evolução de performance ao longo do tempo.

Prioridade: Fase 2 Personas: Jogador, Professor

Critérios de Aceitação:

  • Gráficos de evolução
  • Tendências de melhoria/piora
  • Marcos de desenvolvimento
  • Sugestões de treinamento
  • Compartilhamento de evolução

RF-PERF-003: Histórico de Aulas ​

Descrição: O sistema deve manter histórico completo de aulas frequentadas com avaliações de progresso.

Prioridade: Fase 2 Personas: Jogador, Professor

Critérios de Aceitação:

  • Lista de aulas frequentadas
  • Frequência e assiduidade
  • Avaliações do professor
  • Progresso por habilidade
  • Certificados de conclusão

14. Vídeo e Mídia ​

Módulo de captura, processamento e distribuição de vídeos.

RF-VIDEO-001: Captura de Vídeo ​

Descrição: O sistema deve integrar com câmeras para captura automática ou sob demanda de vídeos das partidas.

Prioridade: Fase 3 Personas: Sistema, Operador

Critérios de Aceitação:

  • Integração com câmeras IP
  • Captura contínua ou por evento
  • Múltiplos ângulos
  • Armazenamento organizado por partida
  • Qualidade configurável

RF-VIDEO-002: Gravação de Highlights (Botão Físico) ​

Descrição: O sistema deve permitir a marcação de highlights através de botão físico IoT durante a partida para captura de momentos específicos.

Prioridade: Fase 3 Personas: Jogador, Sistema

Critérios de Aceitação:

  • Integração com botão IoT
  • Marcação de timestamp no vídeo
  • Captura de X segundos antes e depois
  • Múltiplas marcações por partida
  • Processamento automático do clip

RF-VIDEO-003: Associação de Vídeo à Partida/Jogador ​

Descrição: O sistema deve associar automaticamente vídeos e highlights às partidas e jogadores participantes.

Prioridade: Fase 3 Personas: Sistema

Critérios de Aceitação:

  • Associação automática por horário e quadra
  • Identificação de jogadores no vídeo
  • Marcação de plays por jogador
  • Biblioteca pessoal de vídeos
  • Compartilhamento seletivo

RF-VIDEO-004: Disponibilização no App ​

Descrição: O sistema deve disponibilizar vídeos e highlights no aplicativo para visualização, download e compartilhamento.

Prioridade: Fase 3 Personas: Jogador

Critérios de Aceitação:

  • Galeria de vídeos no app
  • Player de vídeo integrado
  • Download para dispositivo
  • Compartilhamento em redes sociais
  • Controle de privacidade
  • Marca d'água configurável

15. IoT e Dispositivos ​

Módulo de integração com dispositivos IoT.

RF-IOT-001: Integração com Botão de Highlight ​

Descrição: O sistema deve integrar com botões físicos IoT para marcação de highlights durante partidas.

Prioridade: Fase 3 Personas: Sistema

Critérios de Aceitação:

  • Conexão via WiFi/Bluetooth
  • Identificação de botão por quadra
  • Baixa latência na marcação
  • Feedback visual/sonoro no botão
  • Bateria com autonomia adequada

RF-IOT-002: Tablet de Quadra ​

Descrição: O sistema deve fornecer interface otimizada para tablets instalados nas quadras para check-in, placar e controle.

Prioridade: Fase 2 Personas: Operador, Jogador

Critérios de Aceitação:

  • Interface touch otimizada
  • Check-in rápido (QR code, NFC)
  • Controle de placar
  • Visualização de fila
  • Chamada de próximo da fila
  • Status da quadra

RF-IOT-003: Sensores, Wearables ​

Descrição: O sistema deve integrar com sensores e wearables para coleta automática de dados de performance.

Prioridade: Fase 3 Personas: Sistema, Jogador

Critérios de Aceitação:

  • Integração com sensores de movimento
  • Integração com smartwatches/bands
  • Coleta de métricas (frequência cardíaca, distância)
  • Sincronização automática
  • Análise de dados coletados

16. Patrocínio e Anúncios ​

Módulo de gestão de patrocínios e publicidade.

RF-PATROC-001: Cadastro de Patrocinadores ​

Descrição: O sistema deve permitir o cadastro completo de patrocinadores com dados contratuais e materiais de marca.

Prioridade: Fase 3 Personas: Admin, Gerente

Critérios de Aceitação:

  • Dados do patrocinador
  • Upload de logos e materiais
  • Categoria de patrocínio
  • Dados de contrato
  • Ativação/desativação

RF-PATROC-002: Gestão de Contratos ​

Descrição: O sistema deve gerenciar contratos de patrocínio com datas, valores, contrapartidas e renovações.

Prioridade: Fase 3 Personas: Admin, Gerente

Critérios de Aceitação:

  • Cadastro de contrato
  • Vigência e renovação
  • Valores e faturamento
  • Contrapartidas acordadas
  • Alertas de vencimento
  • Histórico de contratos

RF-PATROC-003: Inventário de Espaços Publicitários ​

Descrição: O sistema deve gerenciar um inventário de espaços publicitários disponíveis (app, vídeos, quadras, painéis).

Prioridade: Fase 3 Personas: Admin, Gerente

Critérios de Aceitação:

  • Catálogo de espaços
  • Disponibilidade e ocupação
  • Precificação por espaço
  • Alocação a patrocinador
  • Métricas de exposição

RF-PATROC-004: Exibição em App/Vídeos/Rankings ​

Descrição: O sistema deve exibir conteúdo de patrocinadores de forma integrada no app, vídeos e rankings.

Prioridade: Fase 3 Personas: Sistema, Jogador

Critérios de Aceitação:

  • Banners no app
  • Splash screens
  • Marca d'água em vídeos
  • Logos em rankings
  • Rotação de patrocinadores
  • Controle de frequência
  • Relatórios de exibição

17. Comunicação ​

Módulo de comunicação com usuários.

RF-COMUN-001: Notificações Push/WhatsApp/E-mail ​

Descrição: O sistema deve enviar notificações multicanal (push, WhatsApp, e-mail) para comunicação com usuários.

Prioridade: MVP Personas: Sistema, Admin

Critérios de Aceitação:

  • Notificações push no app
  • Integração com WhatsApp Business API
  • Envio de e-mails transacionais
  • Templates de mensagens
  • Preferências de canal por usuário
  • Histórico de envios
  • Métricas de entrega e abertura

RF-COMUN-002: Comunicados de Evento ​

Descrição: O sistema deve permitir o envio de comunicados e avisos relacionados a eventos específicos.

Prioridade: Fase 2 Personas: Admin, Operador

Critérios de Aceitação:

  • Criação de comunicado
  • Segmentação de destinatários
  • Agendamento de envio
  • Múltiplos canais simultâneos
  • Confirmação de leitura
  • Follow-up automático

18. Relatórios e Analytics ​

Módulo de relatórios gerenciais e analytics.

RF-RELAT-001: Ocupação, Uso Real vs Agenda, No-show ​

Descrição: O sistema deve fornecer relatórios de ocupação das quadras, comparação entre uso real e agendado, e análise de no-shows.

Prioridade: Fase 2 Personas: Gerente, Admin

Critérios de Aceitação:

  • Taxa de ocupação por quadra/período
  • Comparação agendado vs realizado
  • Estatísticas de no-show
  • Horários de pico
  • Identificação de oportunidades
  • Export de dados

RF-RELAT-002: Financeiro, Eventos, Patrocínio ​

Descrição: O sistema deve fornecer relatórios financeiros consolidados incluindo receitas, eventos e patrocínios.

Prioridade: Fase 2 Personas: Gerente, Admin

Critérios de Aceitação:

  • Receitas por fonte (mensalidade, avulso, consumo)
  • Análise de eventos
  • Receitas de patrocínio
  • Custos operacionais
  • Margem e lucratividade
  • Projeções
  • Export contábil

RF-RELAT-003: Dashboard Operacional ​

Descrição: O sistema deve fornecer um dashboard em tempo real com principais indicadores operacionais.

Prioridade: MVP Personas: Operador, Gerente

Critérios de Aceitação:

  • Visualização em tempo real
  • Status de quadras
  • Usuários presentes
  • Fila atual
  • Alertas e pendências
  • Resumo financeiro do dia
  • Customização de widgets

RF-RELAT-004: Relatórios de Uso por Usuário ​

Descrição: O sistema deve fornecer relatórios individualizados de uso das instalações por usuário.

Prioridade: Fase 2 Personas: Gerente, Admin

Critérios de Aceitação:

  • Histórico completo de uso
  • Frequência de visitas
  • Consumo médio
  • Participação em aulas/eventos
  • Engajamento
  • Churn risk score

19. Integrações ​

Módulo de integrações com sistemas externos.

RF-INTEG-001: Sistema de Acesso (Ziggy) ​

Descrição: O sistema deve integrar com sistemas de controle de acesso físico para liberação automática de catracas e portas.

Prioridade: MVP Personas: Sistema

Critérios de Aceitação:

  • API de comunicação bidirecional
  • Liberação de acesso em tempo real
  • Sincronização de permissões
  • Logs de acesso físico
  • Tratamento de falhas de comunicação

RF-INTEG-002: Consumo ​

Descrição: O sistema deve integrar com sistemas de PDV e controle de estoque para registro de consumo.

Prioridade: Fase 2 Personas: Sistema

Critérios de Aceitação:

  • Integração com PDV
  • Sincronização de catálogo
  • Atualização de preços
  • Baixa automática de estoque
  • Conciliação de vendas

RF-INTEG-003: Pagamentos ​

Descrição: O sistema deve integrar com gateways de pagamento para processamento de transações.

Prioridade: MVP Personas: Sistema, Jogador

Critérios de Aceitação:

  • Integração com múltiplos gateways
  • Cartão de crédito/débito
  • PIX
  • Carteiras digitais
  • Pagamento recorrente (mensalidades)
  • Webhooks de confirmação
  • Estornos

RF-INTEG-004: CRM ​

Descrição: O sistema deve integrar com plataformas de CRM para gestão de relacionamento e marketing.

Prioridade: Fase 3 Personas: Sistema

Critérios de Aceitação:

  • Sincronização de contatos
  • Envio de eventos de comportamento
  • Segmentação para campanhas
  • Automação de marketing
  • Análise de conversão

RF-INTEG-005: ERP ​

Descrição: O sistema deve integrar com sistemas ERP para consolidação contábil e financeira.

Prioridade: Fase 3 Personas: Sistema

Critérios de Aceitação:

  • Export de transações financeiras
  • Integração de contas a pagar/receber
  • Sincronização de clientes/fornecedores
  • Conciliação bancária
  • Conformidade fiscal

Matriz de Rastreabilidade ​

Distribuição por Prioridade ​

PrioridadeTotalPercentual
MVP3138%
Fase 23240%
Fase 31822%
Total81100%

Requisitos MVP (Críticos para Lançamento) ​

Gestão e Operação ​

  • RF-ARENA-001 a RF-ARENA-004 (Gestão da Arena)
  • RF-QUADRA-001, RF-QUADRA-004, RF-QUADRA-005, RF-QUADRA-008 (Gestão de Quadras)
  • RF-AGENDA-001 a RF-AGENDA-004 (Agenda e Reservas)
  • RF-FILA-001 a RF-FILA-003, RF-FILA-007 (Fila e Alocação)

Usuários e Aulas ​

  • RF-USER-001, RF-USER-002 (Usuários e Perfis)
  • RF-PROF-001 a RF-PROF-005 (Professores e Aulas)
  • RF-ACESSO-001, RF-ACESSO-002 (Controle de Acesso)

Jogos e Financeiro ​

  • RF-JOGO-001 a RF-JOGO-003 (Jogos e Partidas)
  • RF-CONSUMO-001, RF-CONSUMO-003, RF-CONSUMO-005 (Consumo e Cobrança)

Infraestrutura ​

  • RF-COMUN-001 (Comunicação)
  • RF-RELAT-003 (Dashboard Operacional)
  • RF-INTEG-001, RF-INTEG-003 (Integrações Críticas)

Roadmap de Implementação ​

┌─────────────────────────────────────────────────────────────────┐
│                         FASE 1 - MVP                             │
│                       (Meses 1-4)                                │
├─────────────────────────────────────────────────────────────────┤
│ Sprint 1-2:   Gestão Arena, Quadras, Usuários                   │
│ Sprint 3-4:   Agenda, Reservas, Fila                            │
│ Sprint 5-6:   Check-in, Jogos, Placar                           │
│ Sprint 7-8:   Consumo, Pagamentos, Dashboard                    │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                         FASE 2                                   │
│                       (Meses 5-8)                                │
├─────────────────────────────────────────────────────────────────┤
│ Sprint 9-10:  Professores, Aulas, Controle Presença             │
│ Sprint 11-12: Gamificação, Rankings, Conquistas                 │
│ Sprint 13-14: Eventos, Wallet, Tokens                           │
│ Sprint 15-16: Relatórios, Analytics, Auditoria                  │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                         FASE 3                                   │
│                       (Meses 9-12)                               │
├─────────────────────────────────────────────────────────────────┤
│ Sprint 17-18: Vídeo, Câmeras, Highlights                        │
│ Sprint 19-20: IoT, Botões, Sensores                             │
│ Sprint 21-22: Patrocínio, Anúncios                              │
│ Sprint 23-24: Integrações Avançadas, Performance                │
└─────────────────────────────────────────────────────────────────┘

Glossário ​

TermoDefinição
ArenaInstalação esportiva com uma ou mais quadras
Check-inRegistro de entrada na arena ou quadra
Day-useModalidade de uso com acesso ilimitado no dia
Fila dinâmicaSistema de fila com alocação baseada em regras
Ganha-ficaRegra onde vencedor permanece na quadra
HighlightMomento marcante de uma partida
No-showNão comparecimento após reserva confirmada
OverrideAlteração manual de regra automática
PerfilConjunto de características e permissões
RealmEspaço isolado no sistema de autenticação
TokenMoeda digital própria da arena
ZonaAgrupamento lógico de áreas físicas

Controle de Versões ​

VersãoDataAutorAlterações
1.0.02026-01-09EscribaVersão inicial completa

Aprovações ​

PapelNomeDataAssinatura
Product Owner
Tech Lead
Arquiteto

Próximos Passos:

  1. Priorização detalhada dos requisitos MVP
  2. Detalhamento de histórias de usuário
  3. Definição de critérios de aceitação técnicos
  4. Mapeamento de dependências entre módulos
  5. Estimativas de esforço por requisito

Documentos Relacionados:

Este documento é mantido pelo time de produto e deve ser atualizado sempre que novos requisitos forem identificados ou priorizações alteradas.