Alinhamento espacial
A comparação usa distância e lapPct para preservar a correspondência entre as regiões da pista quando os tempos das voltas são diferentes.
← Voltar aos projetos
Estudo técnico · Repositório público
ApexLap Coach: telemetria transformada em orientação de pilotagem
Aplicativo para iRacing que compara telemetria de uma volta com uma referência compatível e organiza feedback de voz após as curvas.
Visão geral
Da volta registrada ao feedback de voz
O ApexLap Coach usa a telemetria disponível no iRacing para comparar a volta atual com uma referência do mesmo carro, pista e layout. A análise alinha os pontos por distância ou posição na pista, segmenta setores e curvas e transforma diferenças observadas em feedback de voz e histórico para consulta.
Diagrama conceitual
- Telemetria
- Normalização
- Referência compatível
- Setores e curvas
- Regras de feedback
- Voz
Contexto técnico
Comparar voltas sem perder o contexto da pista
Voltas com tempos diferentes não mantêm os mesmos eventos no mesmo instante. A documentação do projeto evita essa dependência de tempo absoluto: os pontos são normalizados por distância e lapPct, permitindo relacionar as mesmas regiões da pista antes de comparar fases da curva e eventos de freio, acelerador, volante, marcha e dinâmica do carro.
Fluxo documentado
Pipeline de análise
Coleta
Recebe ou importa telemetria.
Normalização
Organiza os pontos por distância e posição na pista.
Referência
Carrega uma volta compatível.
Segmentação
Identifica setores e curvas.
Comparação
Avalia diferenças por fase da curva.
Classificação
Identifica eventos e aplica regras de confiança.
Persistência
Registra volta, setores, curvas e evidências no armazenamento local.
Voz
Enfileira a mensagem respeitando prioridade e intervalo entre feedbacks.
Arquitetura
Decisões técnicas documentadas
Domínio separado da interface
O guia de desenvolvimento define que o domínio decide o coaching sem depender de infraestrutura, Electron ou renderer. A interface React apresenta os dados e não deve calcular a telemetria crítica.
Feedback fora do momento crítico
O feedback principal ocorre depois da curva. Mensagens de técnica recebem prioridade, e a fila de voz considera prioridade e intervalo para não sobrepor orientações.
Voz preparada localmente
O projeto mantém frases e áudios por locale e documenta o uso de áudio pré-gerado, sem chamada de síntese de voz durante a execução do aplicativo.
Verificação antes do empacotamento
O workflow público executa typecheck e testes antes de gerar os executáveis Windows e atualizar a release.
Estado público
O que está disponível
O código e a documentação podem ser consultados no GitHub. O repositório registra a versão 0.6.2 e oferece uma release pública com artefatos para Windows. As fontes auditadas não apresentam demonstração web, galeria aprovada ou licença identificada pela API do GitHub.