# Lançamento de um novo aplicativo de corrida 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**. ![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_24b06de81c2c431a8aa7ec56ca107ef1/imported.png) _Cartão do aplicativo Launch 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: 1. Clique em **Iniciar o aplicativo da corrida** 2. Insira um nome amigável (nome do dispositivo) 3. Selecione o **TTL do token de acesso** (janela de expiração) ![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_34b8fec5ba5f4d9eba337af0de229431/imported.png) _Cartão de Informações de Acesso ao Aplicativo da Corrida_ Uma vez criado, o Cloud gera: * **ID do aplicativo** `race-app.runonrufus.com/` * **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. ![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_169e082abf0e4d34a2d51b2a67e39b82/imported.png) _Cartão do Aplicativo da Corrida_ ## 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/`) * 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) ![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_c5e2c8606b2047e9a7b07e36641b5fb4/imported.png) _Detalhes do aplicativo da 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**: 1. Abra o evento 2. Acesse Dispositivos 3. Atribua o dispositivo Race App a: * O evento * Um ou mais pontos de controle ![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_db216b2862794fbdbab829de421ed7c4/imported.png) _Caixa de diálogo Adicionar Dispositivo no RRM_ 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.