# matifl3/telemetria architecture

> Architecture diagram of the GitHub repository matifl3/telemetria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/matifl3/telemetria
- Repository: https://github.com/matifl3/telemetria

## Overview

AC Telemetry Lab es una aplicación de escritorio para analizar replays de Assetto Corsa junto con el archivo de pista fast_lane.ai. El flujo principal carga ambos archivos en una sesión en memoria, segmenta y proyecta las vueltas, y expone datos para selección y análisis visual. La interfaz ofrece pestañas de vuelta, mapa, conjunto, comparación y curvas. El README documenta la división entre UI, comandos Tauri y core; los enlaces de UI específicos son tentativos porque no se muestra aquí su cableado completo.

Main entry points: [`core/src/sesion.rs`](https://github.com/matifl3/telemetria/blob/main/core/src/sesion.rs) (Sesión de análisis), [`front/app/main.js`](https://github.com/matifl3/telemetria/blob/main/front/app/main.js) (Interfaz de escritorio), [`src-tauri/src/comandos.rs`](https://github.com/matifl3/telemetria/blob/main/src-tauri/src/comandos.rs) (Comandos), [`front/app/puente.js`](https://github.com/matifl3/telemetria/blob/main/front/app/puente.js) (Puente UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Interfaz"]
  node_ui["Interfaz de escritorio<br/>[main.js]"]
  node_loading["Carga de archivos<br/>[carga.js]"]
  node_bridge["Puente UI<br/>[puente.js]"]
end

subgraph group_bridge["Aplicación Tauri"]
  node_commands["Comandos<br/>[comandos.rs]"]
  node_appstate["Estado Tauri<br/>[estado_app.rs]"]
end

subgraph group_analysis["Análisis de replay"]
  node_session["Sesión de análisis<br/>[sesion.rs]"]
  node_replay["Parser replay<br/>[acreplay.rs]"]
  node_track["Parser de pista<br/>[pista.rs]"]
  node_reader["Lector binario<br/>[lector.rs]"]
  node_model["Modelo replay<br/>[modelo.rs]"]
  node_projection["Proyección pista<br/>[proyeccion.rs]"]
  node_laps["Vueltas<br/>[vuelta.rs]"]
  node_classification["Clasificación<br/>[clasificacion.rs]"]
  node_alignment["Alineación<br/>[alineado.rs]"]
  node_grid["Grilla común<br/>[grilla.rs]"]
  node_dto["DTO de salida<br/>[dto.rs]"]
  node_curves["Detección de curvas<br/>[curvas.rs]"]
  node_mapdata["Datos de mapa<br/>[mapa.rs]"]
  node_aggregates["Agregados<br/>[agregados.rs]"]
  node_sectors["Sectores<br/>[sectores.rs]"]
  node_comparison["Comparación A/B<br/>[comparacion.rs]"]
end

subgraph group_insights["Análisis visual"]
  node_lapview["Vista de vuelta<br/>[vuelta.js]"]
  node_mapview["Vista de mapa<br/>[mapa.js]"]
  node_setview["Vista de conjunto<br/>[conjunto.js]"]
  node_compareview["Vista comparativa<br/>[comparacion.js]"]
  node_curveview["Vista de curvas<br/>[curvas.js]"]
end

node_driver(("Analista"))

node_driver -->|"carga archivos"| node_loading
node_loading -.->|"envía archivos"| node_bridge
node_bridge -.->|"invoca comandos"| node_commands
node_commands -->|"solicita análisis"| node_session
node_commands -->|"usa estado"| node_appstate
node_session -->|"parsea replay"| node_replay
node_session -->|"parsea pista"| node_track
node_replay -->|"lee bytes"| node_reader
node_replay -->|"construye modelo"| node_model
node_track -->|"lee bytes"| node_reader
node_track -->|"detecta curvas"| node_curves
node_session -->|"proyecta muestras"| node_projection
node_session -->|"clasifica vueltas"| node_classification
node_classification -->|"usa proyección"| node_projection
node_classification -->|"clasifica vueltas"| node_laps
node_session -->|"consulta vueltas"| node_laps
node_dto -->|"construye conjunto"| node_aggregates
node_dto -->|"prepara métricas"| node_curves
node_alignment -->|"remuestrea canales"| node_grid
node_session -.->|"expone datos"| node_dto
node_commands -->|"devuelve DTOs"| node_bridge
node_bridge -.->|"actualiza interfaz"| node_ui
node_ui -.->|"muestra pestaña"| node_lapview
node_ui -.->|"muestra pestaña"| node_mapview
node_ui -.->|"muestra pestaña"| node_setview
node_ui -.->|"muestra pestaña"| node_compareview
node_ui -.->|"muestra pestaña"| node_curveview
node_mapview -.->|"visualiza trazadas"| node_mapdata
node_setview -.->|"visualiza estadísticas"| node_aggregates
node_setview -.->|"visualiza sectores"| node_sectors
node_compareview -.->|"visualiza diferencias"| node_comparison
node_curveview -.->|"visualiza curvas"| node_curves

click node_ui "https://github.com/matifl3/telemetria/blob/main/front/app/main.js"
click node_loading "https://github.com/matifl3/telemetria/blob/main/front/app/carga.js"
click node_bridge "https://github.com/matifl3/telemetria/blob/main/front/app/puente.js"
click node_commands "https://github.com/matifl3/telemetria/blob/main/src-tauri/src/comandos.rs"
click node_appstate "https://github.com/matifl3/telemetria/blob/main/src-tauri/src/estado_app.rs"
click node_session "https://github.com/matifl3/telemetria/blob/main/core/src/sesion.rs"
click node_replay "https://github.com/matifl3/telemetria/blob/main/core/src/acreplay.rs"
click node_track "https://github.com/matifl3/telemetria/blob/main/core/src/pista.rs"
click node_reader "https://github.com/matifl3/telemetria/blob/main/core/src/lector.rs"
click node_model "https://github.com/matifl3/telemetria/blob/main/core/src/modelo.rs"
click node_projection "https://github.com/matifl3/telemetria/blob/main/core/src/proyeccion.rs"
click node_laps "https://github.com/matifl3/telemetria/blob/main/core/src/vuelta.rs"
click node_classification "https://github.com/matifl3/telemetria/blob/main/core/src/clasificacion.rs"
click node_alignment "https://github.com/matifl3/telemetria/blob/main/core/src/alineado.rs"
click node_grid "https://github.com/matifl3/telemetria/blob/main/core/src/grilla.rs"
click node_dto "https://github.com/matifl3/telemetria/blob/main/core/src/dto.rs"
click node_lapview "https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/vuelta.js"
click node_mapview "https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/mapa.js"
click node_setview "https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/conjunto.js"
click node_compareview "https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/comparacion.js"
click node_curveview "https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/curvas.js"
click node_curves "https://github.com/matifl3/telemetria/blob/main/core/src/curvas.rs"
click node_mapdata "https://github.com/matifl3/telemetria/blob/main/core/src/mapa.rs"
click node_aggregates "https://github.com/matifl3/telemetria/blob/main/core/src/agregados.rs"
click node_sectors "https://github.com/matifl3/telemetria/blob/main/core/src/sectores.rs"
click node_comparison "https://github.com/matifl3/telemetria/blob/main/core/src/comparacion.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_loading,node_bridge toneBlue
class node_commands,node_appstate toneAmber
class node_session,node_replay,node_track,node_reader,node_model,node_projection,node_laps,node_classification,node_alignment,node_grid,node_dto,node_curves,node_mapdata,node_aggregates,node_sectors,node_comparison toneMint
class node_lapview,node_mapview,node_setview,node_compareview,node_curveview toneRose
class node_driver toneIndigo
```

## Components

### Interfaz

- [Interfaz de escritorio](https://github.com/matifl3/telemetria/blob/main/front/app/main.js): `front/app/main.js`
- [Carga de archivos](https://github.com/matifl3/telemetria/blob/main/front/app/carga.js): `front/app/carga.js`
- [Puente UI](https://github.com/matifl3/telemetria/blob/main/front/app/puente.js): `front/app/puente.js`

### Aplicación Tauri

- [Comandos](https://github.com/matifl3/telemetria/blob/main/src-tauri/src/comandos.rs): `src-tauri/src/comandos.rs`
- [Estado Tauri](https://github.com/matifl3/telemetria/blob/main/src-tauri/src/estado_app.rs): `src-tauri/src/estado_app.rs`

### Análisis de replay

- [Sesión de análisis](https://github.com/matifl3/telemetria/blob/main/core/src/sesion.rs): `core/src/sesion.rs`
- [Parser replay](https://github.com/matifl3/telemetria/blob/main/core/src/acreplay.rs): `core/src/acreplay.rs`
- [Parser de pista](https://github.com/matifl3/telemetria/blob/main/core/src/pista.rs): `core/src/pista.rs`
- [Lector binario](https://github.com/matifl3/telemetria/blob/main/core/src/lector.rs): `core/src/lector.rs`
- [Modelo replay](https://github.com/matifl3/telemetria/blob/main/core/src/modelo.rs): `core/src/modelo.rs`
- [Proyección pista](https://github.com/matifl3/telemetria/blob/main/core/src/proyeccion.rs): `core/src/proyeccion.rs`
- [Vueltas](https://github.com/matifl3/telemetria/blob/main/core/src/vuelta.rs): `core/src/vuelta.rs`
- [Clasificación](https://github.com/matifl3/telemetria/blob/main/core/src/clasificacion.rs): `core/src/clasificacion.rs`
- [Alineación](https://github.com/matifl3/telemetria/blob/main/core/src/alineado.rs): `core/src/alineado.rs`
- [Grilla común](https://github.com/matifl3/telemetria/blob/main/core/src/grilla.rs): `core/src/grilla.rs`
- [DTO de salida](https://github.com/matifl3/telemetria/blob/main/core/src/dto.rs): `core/src/dto.rs`
- [Detección de curvas](https://github.com/matifl3/telemetria/blob/main/core/src/curvas.rs): `core/src/curvas.rs`
- [Datos de mapa](https://github.com/matifl3/telemetria/blob/main/core/src/mapa.rs): `core/src/mapa.rs`
- [Agregados](https://github.com/matifl3/telemetria/blob/main/core/src/agregados.rs): `core/src/agregados.rs`
- [Sectores](https://github.com/matifl3/telemetria/blob/main/core/src/sectores.rs): `core/src/sectores.rs`
- [Comparación A/B](https://github.com/matifl3/telemetria/blob/main/core/src/comparacion.rs): `core/src/comparacion.rs`

### Análisis visual

- [Vista de vuelta](https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/vuelta.js): `front/app/pestanas/vuelta.js`
- [Vista de mapa](https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/mapa.js): `front/app/pestanas/mapa.js`
- [Vista de conjunto](https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/conjunto.js): `front/app/pestanas/conjunto.js`
- [Vista comparativa](https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/comparacion.js): `front/app/pestanas/comparacion.js`
- [Vista de curvas](https://github.com/matifl3/telemetria/blob/main/front/app/pestanas/curvas.js): `front/app/pestanas/curvas.js`

### Other components

- **Analista**

## Connections

- Analista → Carga de archivos: carga archivos (evidence: `README.md`)
- Carga de archivos → Puente UI: envía archivos
- Puente UI → Comandos: invoca comandos
- Comandos → Sesión de análisis: solicita análisis (evidence: `README.md`)
- Comandos → Estado Tauri: usa estado (evidence: `src-tauri/src/comandos.rs`)
- Sesión de análisis → Parser replay: parsea replay (evidence: `core/src/sesion.rs`)
- Sesión de análisis → Parser de pista: parsea pista (evidence: `core/src/sesion.rs`)
- Parser replay → Lector binario: lee bytes (evidence: `core/src/acreplay.rs`)
- Parser replay → Modelo replay: construye modelo (evidence: `core/src/acreplay.rs`)
- Parser de pista → Lector binario: lee bytes (evidence: `core/src/pista.rs`)
- Parser de pista → Detección de curvas: detecta curvas (evidence: `core/src/pista.rs`)
- Sesión de análisis → Proyección pista: proyecta muestras (evidence: `core/src/sesion.rs`)
- Sesión de análisis → Clasificación: clasifica vueltas (evidence: `core/src/sesion.rs`)
- Clasificación → Proyección pista: usa proyección (evidence: `core/src/clasificacion.rs`)
- Clasificación → Vueltas: clasifica vueltas (evidence: `core/src/clasificacion.rs`)
- Sesión de análisis → Vueltas: consulta vueltas (evidence: `core/src/sesion.rs`)
- DTO de salida → Agregados: construye conjunto (evidence: `core/src/dto.rs`)
- DTO de salida → Detección de curvas: prepara métricas (evidence: `core/src/dto.rs`)
- Alineación → Grilla común: remuestrea canales (evidence: `core/src/alineado.rs`)
- Sesión de análisis → DTO de salida: expone datos (evidence: `core/src/dto.rs`)
- Comandos → Puente UI: devuelve DTOs (evidence: `README.md`)
- Puente UI → Interfaz de escritorio: actualiza interfaz
- Interfaz de escritorio → Vista de vuelta: muestra pestaña
- Interfaz de escritorio → Vista de mapa: muestra pestaña
- Interfaz de escritorio → Vista de conjunto: muestra pestaña
- Interfaz de escritorio → Vista comparativa: muestra pestaña
- Interfaz de escritorio → Vista de curvas: muestra pestaña
- Vista de mapa → Datos de mapa: visualiza trazadas
- Vista de conjunto → Agregados: visualiza estadísticas
- Vista de conjunto → Sectores: visualiza sectores
- Vista comparativa → Comparación A/B: visualiza diferencias
- Vista de curvas → Detección de curvas: visualiza curvas
