LFS-Ayats

Documentació de LFS-Ayats

Benvingut a la documentació completa del sistema de telemetria LFS-Ayats per Live for Speed.

🚀 Començar Ràpidament

Per Usuaris Nous

Per Desenvolupadors

📚 Tutorials Interactius

Aprèn pas a pas amb els nostres tutorials detallats:

Tutorial Descripció Temps Nivell
01 - Primera Sessió Recull i exporta telemetria bàsica 30 min Principiant
02 - Anàlisi de Voltes Compara voltes i troba millores 45 min Intermedi
03 - Dashboard Temps Real Crea dashboard web interactiu 30 min Intermedi
04 - Anàlisi Avançada Machine learning i prediccions 60 min Avançat
05 - Base de Dades Emmagatzema històrics 45 min Avançat

🏗️ Documentació Tècnica

Arquitectura i Disseny

APIs i Referències

Mòduls Específics

💡 Casos d’Ús Pràctics

Aprèn com utilitzar LFS-Ayats en escenaris reals:

🏆 Carreres de Lliga

Configuració completa per gestionar telemetria en lligues amb múltiples pilots:

📈 Driver Coaching

Data-driven coaching system to improve performance:

👨‍💻 Guies per Desenvolupadors

Contribuir al Projecte

❓ Preguntes Freqüents

FAQ Completa - Respostes a les preguntes més comunes

Categories

📖 Referències Ràpides

Comandes Útils

# Instal·lació
pip install -r requirements.txt
pip install -e .

# Tests
pytest                           # Tots els tests
pytest --cov=src                # Amb cobertura
pytest -m unit                  # Només unitaris

# Qualitat de codi
black src/ tests/               # Formatació
flake8 src/ tests/              # Linting
mypy src/                       # Type checking

# Executar sistema
python examples/basic_connection.py
python examples/telemetry_monitor.py
python examples/dashboard_example.py

# API
uvicorn src.api.main:app --reload

Configuració Ràpida

# config.yaml
insim:
  host: "127.0.0.1"
  port: 29999
  interval: 100

telemetry:
  max_history: 10000
  
export:
  output_directory: "./data"
  
api:
  port: 8000
  
dashboard:
  port: 8050
  update_interval: 100

Python Ràpid

from src.connection import InSimClient
from src.telemetry import TelemetryCollector

# Connectar
client = InSimClient(host="127.0.0.1", port=29999)
client.connect()
client.initialize()

# Recollir telemetria
collector = TelemetryCollector(client)
collector.start()

# Obtenir dades
data = collector.get_latest_telemetry()
history = collector.get_telemetry_history(limit=100)

# Aturar
collector.stop()
client.disconnect()

🔗 Recursos Externs

Live for Speed

Python i Eines

Desenvolupament

📝 Índex de Documentació

Nivell Principiant

  1. Guia d’Inici Ràpid
  2. Tutorial 1: Primera Sessió
  3. FAQ: Instal·lació
  4. FAQ: Connexió

Nivell Intermedi

  1. Tutorial 2: Anàlisi de Voltes
  2. Tutorial 3: Dashboard
  3. Visualització
  4. API Quickstart

Nivell Avançat

  1. Tutorial 4: Anàlisi Avançada
  2. Tutorial 5: Base de Dades
  3. Arquitectura
  4. Protocol InSim

Per Desenvolupadors

  1. Development Setup
  2. Coding Standards
  3. Testing Guide
  4. CONTRIBUTING.md

🆘 Suport

Reportar Problemes

Si trobes un bug o tens un problema:

  1. Consulta la FAQ
  2. Busca a Issues existents
  3. Obre un nou issue

Preguntes i Discussions

Per preguntes generals o discussions:

Contribuir

Vols millorar la documentació o el codi?

  1. Llegeix CONTRIBUTING.md
  2. Consulta Development Setup
  3. Obre un Pull Request

📅 Actualitzacions

La documentació s’actualitza regularment. Última actualització: 2024

Per veure canvis recents:

🎯 Pròxims Passos Recomanats

Si ets nou:

  1. ✅ Llegeix la Guia d’Inici Ràpid
  2. ✅ Completa el Tutorial 1
  3. ✅ Explora la FAQ

Si vols aprofundir:

  1. ✅ Completa tots els Tutorials
  2. ✅ Revisa un Cas d’Ús
  3. ✅ Explora l’Arquitectura

Si vols contribuir:

  1. ✅ Configura Entorn de Desenvolupament
  2. ✅ Llegeix Estàndards de Codi
  3. ✅ Escriu tests (Testing Guide)

Gaudeix utilitzant LFS-Ayats! 🏎️ 💨

Per qualsevol dubte, no dubtis en contactar a través de GitHub.

This site is open source. Improve this page.