O RUFUS Race App é criado e gerenciado a partir do RUFUS Cloud. Cada instância do Race App se comporta como um dispositivo virtual, com seu próprio ID de aplicativo, token de acesso, janela de expiração e histórico de sessão.
Este artigo explica como lançar um novo aplicativo Race, gerenciar seu acesso e entender como as sessões e a rotação de tokens funcionam.
Onde criar um aplicativo de corrida
Os aplicativos de corrida são criados a partir de:
RUFUS Cloud → Painel de dispositivos
Na visualização Dispositivos, você encontrará a seção Iniciar o aplicativo Race.
O lançamento de um aplicativo de corrida cria:
- Um registro de dispositivo virtual
- Um ID de aplicativo exclusivo
- Um token de acesso
- Um token de expiração (TTL)
- Um registro de auditoria em nível de nuvem
Lançamento de um novo aplicativo de corrida
Para criar um aplicativo de corrida:
- Clique em Iniciar o aplicativo da corrida
- Insira um nome amigável (nome do dispositivo)
- Selecione o TTL do token de acesso (janela de expiração)
Uma vez criado, o Cloud gera:
- ID do aplicativo
race-app.runonrufus.com/<AppId> - Token de acesso (formato
JUDGE-XXXXX-YYYYY) - Tempo de expiração (
race_app_token_until)
O Race App agora aparece na sua lista de Dispositivos como um dispositivo virtual do Race App.
Compreendendo o TTL do Token de Acesso
O TTL do token de acesso define por quanto tempo o token permanece válido.
Quando o TTL expira:
- O token para de funcionar
- Os juízes não conseguem mais fazer login
- Um novo token deve ser gerado
Melhor prática:
Defina o TTL com um tempo suficiente para cobrir:
- Tempo de configuração
- Janela de corrida completa
- Margem de segurança pós-corrida
Se necessário, você pode atualizar (regerar) o token a qualquer momento.
Compartilhando o acesso com os juízes
Para dar acesso a um juiz, você deve fornecer:
- O link do aplicativo (
race-app.runonrufus.com/<AppId>) - O token de acesso
Ambos são necessários.
Ao fazer o login, o juiz também deve inserir:
- O nome deles (usado para identificação e auditoria)
Importante:
Apenas um juiz ativo pode usar o token por vez. Se outro juiz fizer login usando o mesmo token, ele assume a sessão.
Detalhes do dispositivo (Cartão do dispositivo do aplicativo de corrida)
Ao abrir o cartão do dispositivo do Race App na nuvem, você pode ver:
- ID do aplicativo
- Link direto para o aplicativo
- Token de Acesso Atual
- Tempo de expiração do token
- Sessões associadas a este token
- Falecimentos registrados
- Ações de corrida registradas
- Localização atual do aplicativo (se a localização estiver ativada no celular)
Isso fornece uma visão de auditoria administrativa no nível da nuvem.
Lembre-se:
A nuvem é a camada de controle administrativo. As operações da corrida são gerenciadas no Race Manager.
Sessões Explicadas
Uma sessão está vinculada ao token de acesso ativo.
Uma sessão torna-se ativa quando:
- O token do aplicativo Race é usado
- O dispositivo está atribuído a um evento no Race Manager
Comportamentos importantes:
- Apenas um juiz ativo por token
- Sair da sessão não apaga o histórico de navegação
- A Atividade ao Vivo e o Chat da Equipe continuam disponíveis com o mesmo token
- Uma sessão completamente nova é criada apenas quando o token é atualizado.
Se outro juiz fizer login com o mesmo token:
- O juiz anterior é automaticamente desconectado
- O novo juiz continua na mesma sessão de token
Rotação de Tokens (Reinicialização Completa)
O botão Atualizar token de acesso gera um token completamente novo.
Ao girar o token:
- O token anterior é imediatamente invalidado
- Qualquer sessão ativa do juiz é encerrada
- Um novo ciclo de vida da sessão começa
Use a rotação de tokens quando:
- O acesso foi compartilhado incorretamente
- Um juiz não deve mais ter acesso
- Você precisa de uma reinicialização operacional completa.
Após a rotação:
Você deve comunicar o novo token ao juiz. O antigo deixará de funcionar imediatamente.
Atribuindo o aplicativo de corrida a um evento
Ao iniciar o aplicativo Race no Cloud, ele não se conecta automaticamente a um evento.
Dentro de RUFUS Race Manager:
- Abra o evento
- Acesse Dispositivos
- Atribua o dispositivo Race App a: * O evento * Um ou mais pontos de controle
Uma vez atribuído:
- O aplicativo da corrida pode enviar passagens de cronometragem manual
- As Ações de Corrida aparecerão nas Notificações de Corrida
- A sessão torna-se operacionalmente ativa
Sessões, Passagens e Ações de Corrida (Visualização em Nuvem)
No cartão do dispositivo na nuvem, você pode auditar:
Sessões
Sessões operacionais vinculadas a eventos e associadas ao token.
Falecimentos
Gerado a partir da temporização manual.
Ações de Corrida
Gerado a partir de:
- Penalidade e Bônus
- Alterações de status
- Alertas de Corrida
- Bate-papo da equipe
A nuvem atua como plano de controle e camada de auditoria, enquanto o Race Manager lida com as operações de corrida ao vivo.
Melhores Práticas Operacionais
Antes do dia da corrida:
- Inicie o aplicativo da corrida com antecedência.
- Defina um TTL apropriado.
- Atribua o dispositivo aos pontos de controle no Gerenciador de Corridas.
- Compartilhe o link e o token com os juízes.
No dia da corrida:
- Monitore as sessões na nuvem.
- Gire o token se o acesso precisar ser redefinido.
- Verifique a atribuição do dispositivo no Race Manager.
Após o dia da corrida:
- Se necessário, revise o histórico de auditoria.
- Gire o token se o dispositivo não precisar mais ser acessível.
Resumo
O lançamento de um aplicativo de corrida em RUFUS Cloud cria um dispositivo virtual controlado e baseado em token que os juízes usam durante as operações da corrida.
O token de acesso define quem pode fazer login, o TTL define por quanto tempo ele permanece válido e a rotação de tokens fornece um mecanismo de redefinição seguro.
A nuvem gerencia o acesso e a auditoria. O Race Manager cuida da execução operacional.