Sistema de Resultados de Campeonatos (Chronosat): Jornadas dos Atores

Documentos da família

• DRS (resultados-chronosat), o que o sistema faz.
• Roadmap de Implementação (resultados-chronosat-roadmap), em que ordem construir e como verificar.
• Inventário de Artefatos (resultados-chronosat-inventario), tudo que precisa existir e como cada item deve ser.
• Plano de Testes (resultados-chronosat-tests), o que validar antes de entregar.
• Questionário de Elicitação (resultados-chronosat-questionario), as decisões de negócio; já reconciliado no DRS (bloco 9).

Este documento descreve como cada papel opera o sistema, função por função, do ponto de vista de quem senta na cadeira. Complementa o bloco 2 do DRS (que define os atores e o resumo das jornadas) com a visão de operação. É escrito por papel, não por pessoa: trocar quem ocupa o papel não muda nada aqui.

Como ler

Cada seção é um papel. Cada função do papel tem três linhas: Como entra (o gatilho, quando a função começa), Onde entra (a tela, o funil, o canal) e O que faz (as ações e o resultado). A linguagem é genérica para servir qualquer pessoa que ocupe o papel, mas aponta as telas e funis reais deste sistema.

Atores em uma linha

Público / fã do esporte

Acompanhar a classificação ao vivo

• Como entra: durante ou após uma prova, quer saber quem está na frente.
• Onde entra: o site da vertical do esporte (cada vertical, série, Petrobras, MTB ou kitesurf, parece um site próprio, com identidade, cor e marca próprias), acessado a partir do site do Sertões, na maioria das vezes pelo celular.
• O que faz: abre a página do evento dentro do site da vertical, vê o cabeçalho com o selo "Ao Vivo" e a classificação já organizada (posição, numeral, tripulação, equipe e veículo, categoria, penalidades, tempo total e diferença para o líder). A página se atualiza sozinha a cada cerca de 30 segundos enquanto o evento está ao vivo, sem precisar recarregar. Encerrada a prova, a página congela com o resultado final e permanece consultável, mesmo depois de a fonte de cronometragem sair do ar.

Trocar de modalidade

• Como entra: quer ver uma modalidade específica do evento.
• Onde entra: as abas de modalidade no hero da página.
• O que faz: toca a aba da modalidade que o evento tiver (as modalidades disponíveis variam por evento) e a classificação, o pódio e os trechos passam a mostrar aquela modalidade, cada aba com o número de competidores.

Ver o pódio

• Como entra: quer saber os primeiros colocados de um recorte.
• Onde entra: o pódio no topo da página, abaixo do hero.
• O que faz: vê os cinco primeiros do recorte selecionado (geral, categoria ou etapa), em ordem sequencial de 1º a 5º. Os nomes aparecem conforme o esporte da vertical: no rally, piloto em destaque e navegador; na bike, a dupla com os dois nomes em negrito; no kitesurf, o atleta solo. Cada lugar mostra posição, numeral, tripulação, equipe, tempo total e diferença.

Filtrar por categoria ou trecho e buscar um competidor

• Como entra: quer focar numa categoria, num trecho específico, ou achar um competidor.
• Onde entra: a área de filtros e a faixa de etapas.
• O que faz: seleciona uma categoria e a lista mostra o ranking recalculado dentro daquela categoria, com as posições renumeradas de 1 em diante; seleciona um trecho na faixa de etapas e a tabela passa a mostrar os tempos e posições daquele trecho (ao escolher Geral, volta ao acumulado); busca pelo numeral e o competidor é destacado. O contador mostra quantos competidores há no recorte.

Conhecer os sites das verticais

• Como entra: quer ver os esportes que a Sertões organiza, sem saber ainda qual vertical procura.
• Onde entra: a home global, na raiz do subdomínio de resultados.
• O que faz: vê a lista enxuta dos sites das verticais (nome, marca e cor de cada uma) e escolhe um para ser levado à home daquele esporte; essa home global não mistura classificações nem eventos de esportes diferentes, apenas apresenta os sites.

Consultar edições passadas

• Como entra: quer ver o resultado de um evento de uma vertical em um ano anterior.
• Onde entra: a home do site da vertical escolhida, que funciona como a página de arquivo de um blog daquele esporte, listando as edições por ano.
• O que faz: abre a home da vertical, vê a capa com a identidade do esporte, o evento ao vivo sinalizado em destaque quando houver, escolhe o evento e o ano, e é levado à página fixa daquela edição (endereço permanente no padrão vertical, ano e evento), com o resultado final congelado.

Ver o detalhe de um competidor

• Como entra: quer o desempenho completo de um competidor.
• Onde entra: o modal de detalhe, ao tocar a linha do competidor na tabela.
• O que faz: abre o modal e vê equipe, veículo, categoria, posição, penalidades, tempo total e o tempo por especial (SS1 a SSN); quando há um trecho selecionado, vê também as passagens intermediárias I1 a I7 daquele trecho com seus deltas e posições. Fecha o modal sem recarregar a página.

Baixar um documento oficial

• Como entra: quer o resultado acumulado, as penalidades ou a ordem de largada em PDF.
• Onde entra: a Central de Documentos Oficiais na página.
• O que faz: vê os documentos disponíveis como botões e baixa o que precisa; se ainda não há documentos, a central mostra um estado vazio, sem erro.

Acompanhar quando a origem oscila

• Como entra: a fonte de dados fica indisponível durante a prova.
• Onde entra: a mesma página pública.
• O que faz: continua vendo o último resultado válido conhecido, com um aviso de que a atualização está temporariamente suspensa; a página não quebra nem fica em branco, porque cada leitura já foi salva no banco antes.

Operador da Sertões

O operador entra no painel com a sua conta nominal (login e senha própria). O administrador (equipe Modulareasy) faz tudo o que está abaixo e mais a gestão de contas e a auditoria, na seção seguinte.

Preparar um novo campeonato

• Como entra: recebe da Chronosat o conjunto de URLs do evento, antes da prova.
• Onde entra: o painel único, após autenticar com a sua conta.
• O que faz: abre o painel (o mesmo painel administra as quatro verticais, série, Petrobras, MTB e kitesurf) e inicia um novo campeonato pelo assistente de três passos.

Passo 1, escolher a vertical e nomear

• Como entra: começou um novo campeonato.
• Onde entra: o passo 1 do assistente.
• O que faz: seleciona a vertical entre as cadastradas (série, Petrobras, MTB, kitesurf, ou uma nova que já exista no painel) e dá um nome ao campeonato; segue para o passo 2.

Passo 2, colar as URLs e testar a conexão

• Como entra: tem o documento com o bloco de URLs que a Chronosat entregou para o evento.
• Onde entra: o passo 2 do assistente.
• O que faz: cola o bloco inteiro de uma vez, sem separar campo a campo; o painel reconhece e classifica cada arquivo sozinho pelo nome (modalidade, tipo e trecho) e aciona "testar conexão", que busca os arquivos e mostra uma pré-visualização com a contagem encontrada (achei N modalidades, N trechos, N competidores). Se uma URL estiver inválida ou inacessível, o painel aponta qual falhou, sem publicar.

Passo 3, publicar

• Como entra: o teste de conexão passou.
• Onde entra: o passo 3 do assistente.
• O que faz: confere o resumo e publica; o evento passa a aparecer no site da vertical correspondente, no estado inicial configurado.

Controlar o estado durante e depois da prova

• Como entra: a prova começa, avança e termina.
• Onde entra: o controle de estado do campeonato, na lista de campeonatos.
• O que faz: mantém o evento ao vivo durante a prova (a página se atualiza sozinha) e o marca como encerrado quando acaba, o que para a atualização automática e muda o indicador para o público. Encerrar é apenas parar de buscar a fonte de cronometragem: o resultado já está salvo no banco a cada leitura desde o início, então nada se perde mesmo que o operador esqueça de encerrar ou encerre alguns dias depois; o evento fica no ar, no seu endereço, com o último estado salvo.

Criar a página de uma edição passada (retroativo)

• Como entra: quer trazer para o sistema o resultado de um evento de um ano anterior, de antes de o sistema existir.
• Onde entra: o mesmo assistente de cadastro, indicado como retroativo.
• O que faz: cadastra o evento com os dados históricos disponíveis pelo assistente, marcando-o como já encerrado; o sistema gera a página arquivada daquela edição, publicada no endereço por vertical e ano e listada na home da vertical junto às demais. É o mesmo princípio de um blog: cada evento publicado vira uma página fixa e permanente, então o histórico normalmente se forma sozinho conforme as provas acontecem; o retroativo serve só para trazer as edições anteriores ao início do sistema, quando há dados guardados para elas.

Gerir os PDFs oficiais

• Como entra: os documentos oficiais do evento (penalidades, acumulado final) ficam disponíveis.
• Onde entra: a gestão de PDFs do campeonato no painel.
• O que faz: adiciona cada documento por link ou por upload de arquivo, dá um título, e ele aparece na Central de Documentos Oficiais da página pública; remove um documento e ele deixa de aparecer.

Gerir a relação com a equipe da Chronosat

• Como entra: antes e durante o evento, ao tratar do recebimento das URLs, de ajustes de configuração ou de uma instabilidade na fonte de dados.
• Onde entra: o canal direto do operador com a equipe da Chronosat, fora do sistema.
• O que faz: mantém o contato com a equipe da Chronosat para receber as URLs de cada evento, tratar variações de modalidades, categorias e etapas, e acionar esse canal se a fonte oscilar durante a prova; essa relação é do operador, não da sustentação.

Ocultar um competidor

• Como entra: precisa tirar um competidor da exibição pública.
• Onde entra: a função de ocultar competidor no painel.
• O que faz: busca pelo numeral e oculta o competidor, que deixa de aparecer na página pública; pode reexibi-lo depois (a ação é reversível).

Gerir o perfil do site de cada vertical

• Como entra: quer ajustar a identidade de uma vertical existente ou dar vida a um site de esporte novo (por exemplo a Petrobras, ao lado da série).
• Onde entra: o cadastro de verticais no painel único.
• O que faz: edita o perfil completo do site daquela vertical (cor de destaque, marca, capa da home com título, subtítulo e imagem, rótulos da hierarquia como modalidade, categoria e trecho, a regra de como a tripulação aparece, piloto e navegador, dupla com os dois nomes em negrito, ou solo, e a ordem em que a vertical aparece na home global), ou cadastra uma vertical nova do zero com o seu próprio perfil; nenhuma das duas ações depende de desenvolvimento, e a mudança se reflete no site daquela vertical na hora.

Administrador (equipe Modulareasy)

O administrador é a equipe da Modulareasy, que opera o sistema para a Sertões. Entra no painel com a sua conta nominal e faz tudo o que o operador faz (as jornadas acima), com estas jornadas adicionais de administração, todas declaradas e registradas no log de auditoria.

Entrar no painel com a própria conta

• Como entra: precisa administrar o sistema.
• Onde entra: a tela de login do painel único.
• O que faz: entra com a sua conta nominal (login e senha própria); a sessão fica associada ao seu usuário e ao papel de administrador, o que libera, além das telas de gestão de campeonatos, as telas de gestão de contas e de auditoria. Entrar (e cada tentativa negada) fica registrado no log de auditoria.

Criar uma conta de usuário

• Como entra: uma nova pessoa (da equipe Sertões ou da Modulareasy) precisa acessar o painel.
• Onde entra: a tela de gestão de contas.
• O que faz: cria a conta informando o login, o papel (administrador ou operador) e uma senha inicial; a partir daí a pessoa entra com essa conta. Não existe autocadastro: só o administrador cria contas. A senha nunca aparece nem é guardada em texto puro.

Editar o papel de uma conta

• Como entra: uma conta precisa passar a poder mais ou menos (por exemplo, promover um operador a administrador).
• Onde entra: a tela de gestão de contas.
• O que faz: muda o papel da conta; o que aquela pessoa pode fazer no painel muda de acordo, a partir do próximo acesso.

Desativar ou reativar uma conta

• Como entra: alguém deixou de precisar de acesso, ou precisa voltar a ter.
• Onde entra: a tela de gestão de contas.
• O que faz: desativa a conta, revogando o acesso na hora, sem apagar a conta nem o histórico do que ela já fez; pode reativá-la depois. O histórico das ações passadas daquela conta continua no log de auditoria.

Redefinir a senha de uma conta

• Como entra: um usuário esqueceu a senha ou ela precisa ser trocada.
• Onde entra: a tela de gestão de contas.
• O que faz: define uma nova senha para a conta; a antiga deixa de valer e o usuário passa a entrar com a nova. O log de auditoria registra que a senha foi trocada, nunca o valor dela.

Consultar o log de auditoria

• Como entra: quer saber quem fez o quê e quando no painel.
• Onde entra: a tela de auditoria.
• O que faz: consulta a lista de ações sensíveis (entradas, criação e edição de contas, mudança de papel, desativação e reativação, redefinição de senha), do mais recente ao mais antigo, com quem fez, o que fez, sobre o que e quando. O log é só de leitura, não é editável.

Consultar o status das páginas

• Como entra: quer conferir de relance se as páginas principais do sistema e do site estão no ar ou dando erro.
• Onde entra: a tela de sitemap e monitor de status.
• O que faz: abre a tela e vê a lista curada das rotas principais (a home global, a home de cada vertical, o painel, a verificação de saúde e as âncoras do site), cada uma com o código de resposta do servidor: no ar (200) ou com erro (por exemplo 404 ou 503) sinalizado em destaque. Aciona "verificar de novo" para reconsultar quando quiser. A lista traz uma rota por área, não uma por evento.

Sustentação (Modulareasy)

Provisionar e manter o servidor

• Como entra: no início do projeto e sempre que a infraestrutura precisa de atenção.
• Onde entra: o servidor dedicado isolado e a borda.
• O que faz: provisiona o servidor separado dos demais produtos, configura a borda com SSL automático e cache, faz o deploy do aplicativo (um único deploy serve todos os sites das verticais) e mantém o ambiente saudável.

Monitorar a saúde do sistema

• Como entra: continuamente, com atenção especial durante as provas ao vivo.
• Onde entra: o monitoramento de saúde do sistema.
• O que faz: acompanha a disponibilidade de cada site de vertical, a saúde do intermediário de leitura, o sucesso das leituras da Chronosat, a gravação de cada leitura no banco de dados e o estado do cache.

Responder a incidente ao vivo

• Como entra: a fonte de dados cai ou o sistema apresenta um problema durante a prova.
• Onde entra: o servidor e os canais de operação.
• O que faz: garante que a página está degradando para o último estado salvo no banco (não quebrando) e restabelece o serviço; o contato com a equipe da Chronosat quando a origem cai é feito pelo operador do painel, que gere essa relação, não pela sustentação; não cadastra nem opera o conteúdo dos eventos.

Provisionar as contas iniciais de acesso

• Como entra: no início, o painel precisa das primeiras contas para que o sistema seja administrado.
• Onde entra: a configuração de acesso do sistema.
• O que faz: provisiona as contas de administrador iniciais (a equipe da Modulareasy que opera o sistema), cada uma com a sua senha própria; a partir daí, o próprio administrador cria e mantém as demais contas, inclusive as de operador, pela tela de gestão de contas, sem depender da sustentação. O público nunca tem acesso ao painel nem à origem da Chronosat diretamente.