O Circuit é o primeiro módulo do Nexo: permite que empresas criem e gerenciem campeonatos virtuais de corrida para seus clientes, com contabilização automática via webhook do Strava.
Este é o primeiro post sobre o Nexo (https://www.nexosync.com.br/), uma nova plataforma que estou desenvolvendo.
O Nexo é uma plataforma que reúne diversos módulos (subsistemas) independentes, cada um responsável por uma capacidade específica do negócio. Os módulos compartilham autenticação, permissões, infraestrutura e componentes comuns, mas podem evoluir de forma independente — cada um com seu próprio ritmo de release, sem travar os demais.
A stack por trás do Nexo combina NodeJS, PHP, Laravel, Docker e DDD como abordagem de organização de domínio.
O Circuit (https://circuit.nexosync.com.br/) é o primeiro módulo do Nexo e está atualmente em fase de validação.
Ele permite que uma empresa gerencie campeonatos virtuais de corrida com seus próprios clientes, sem depender de planilhas ou processos manuais para acompanhar quem está cumprindo as metas.
Na tela administrativa, o gestor do campeonato pode configurar:
Essa combinação de regras permite montar desde desafios simples de distância acumulada até campeonatos mais elaborados, segmentados por perfil de atleta.
O Circuit não pede que o usuário informe manualmente seus resultados. A contabilização acontece de forma automática, através do webhook do Strava:
Atleta finaliza uma corrida
│
▼
Strava dispara o webhook
│
▼
Circuit consulta os detalhes da atividade
│
▼
Atividade é validada contra as regras do campeonato
│
▼
Resultado é contabilizado
Assim que a pessoa termina uma corrida, o webhook é enviado ao sistema e uma consulta sobre a atividade é realizada para validar se ela atende às regras do campeonato (região, pace mínimo, KM mínimo).
Toda a integração segue fielmente as regras definidas pelo Strava, tanto as diretrizes de marca e uso quanto a política da API.
O Strava impõe limites diários de requisições, e buscar os detalhes de cada atividade consome essa cota. Para evitar que o limite seja atingido, o Circuit conta com guardrails dedicados e uma estratégia inteligente de busca, que equilibra dois objetivos que competem entre si:
O sistema deixa claro para o usuário quais dados são coletados e como eles são exibidos. Para os participantes de um mesmo desafio, fica visível apenas o valor sumarizado de cada concorrente — não o histórico bruto de atividades.
Outros pontos importantes da política de dados:
A área administrativa é protegida por autenticação JWT, e o login exige 2FA — uma camada adicional para proteger o sistema mesmo em cenários de vazamento de senha.
O Circuit ainda está em fase de validação, mas já reúne as peças centrais para operar campeonatos de corrida de ponta a ponta: configuração flexível de regras, contabilização automática via Strava, guardrails de limite de API e uma política de dados transparente para os usuários.
Como primeiro módulo do Nexo, ele também serve de referência para os próximos: mesma base de autenticação, permissões e infraestrutura, evoluindo de forma independente conforme a necessidade de cada negócio.