Referência de manutenção

Manual técnico

Inventário funcional e orientações para sustentação do CBTM Game Results legado.

Funcionalidades existentes

  • Consulta: listagem de eventos e partidas vinculadas.
  • Painéis: chamadas automáticas dos próximos jogos em uma ou duas colunas, com paginação e atualização configuráveis.
  • Operação: lançamento ponto a ponto, sets, sacador e encerramento de partidas.
  • Tempo real: placar para navegador/TV alimentado pelas APIs e métodos WebForms.
  • Configuração: manutenção de data e atraso da programação do evento.

Fluxo de identificadores

A central envia EventoId à lista de jogos; a lista envia eventoId e eveJogoId ao lançador, e eveJogoId ao Placar TV. O painel recebe o evento em e. Preserve maiúsculas e nomes ao criar integrações.

Banco de dados

Consulte o inventário de stored procedures e conexões para contratos, parâmetros, valores forçados, páginas consumidoras e comportamento esperado das 17 procedures ativas.

TODOs

  • Unificar nomes de parâmetros (e, EventoId e eventoId) em contratos claros e retrocompatíveis.
  • Adicionar autenticação e autorização por perfil às telas operacionais.
  • Centralizar validação e mensagens para parâmetros inválidos.
  • Criar testes automatizados para regras de pontuação, troca de serviço, encerramento e URLs.
  • Documentar e versionar formalmente os endpoints de placar.

Known issues

  • Há páginas legadas e versões paralelas de painéis/placares; links diretos antigos podem ter comportamento visual diferente.
  • Algumas telas possuem valores padrão históricos para evento quando a query string não é enviada, podendo mostrar dados não pretendidos.
  • Os formatos de data e hora dos filtros não são uniformemente validados pela interface.
  • A atualização em tempo real depende da conexão do navegador e não indica detalhadamente todas as falhas de rede.
  • Abertura simultânea de mais de um lançador para a mesma partida pode gerar conflito operacional.

Melhorias futuras

  • Migrar gradualmente WebForms e consultas acopladas à página para serviços testáveis.
  • Adotar canal push (SignalR/WebSocket) para reduzir polling dos placares.
  • Oferecer pesquisa, filtros persistentes e favoritos por evento/mesa.
  • Adicionar auditoria de alterações, desfazer operação e recuperação de sessão.
  • Ampliar acessibilidade, telemetria, observabilidade e testes em dispositivos de telão.