# Documentation Raceware

> Prise en main, lexique endurance, connexion du chronométrage, construction des dashboards et détail des modules : la référence complète de Raceware.

Source: https://www.raceware.dev/fr/docs · Language: fr · Updated: 2026-09-17

La référence complète : ce qu'est Raceware, le vocabulaire de l'endurance et de l'EWC, comment brancher le chronométrage, comment composer un dashboard, et comment chaque module se comporte pendant un week-end de course.

## Découvrir

### Qu'est-ce que Raceware ?

Raceware est un ERP (système de gestion intégré) dédié aux sports mécaniques. Il rassemble en un seul endroit la télémétrie live, la stratégie de course, la météo piste et l'analyse de performance — pour les écuries du club au semi-professionnel.

L'idée part d'un constat : l'écart entre les outils du sport automobile professionnel (ATLAS, MoTec, plus de 100 000 € par an) et la réalité du terrain, où une équipe au budget de 50 000 € pilote encore sa stratégie sur Excel et des notes papier. Raceware remplace ce patchwork par un poste de commande unique, temps réel.

Premier terrain d'application concret : l'endurance moto (FIM EWC, championnats nationaux, courses club). La même logique s'étend ensuite au circuit, au rallye et à d'autres disciplines.

### Glossaire (lexique endurance & EWC)

Pour une première approche de l'endurance, voici les termes utilisés dans Raceware et dans toute cette documentation.

| Terme | Définition |
| --- | --- |
| EWC | Endurance World Championship — le championnat du monde d'endurance moto de la FIM (épreuves de 8 à 24 h). |
| Stint / Relais | Période de pilotage entre deux passages au stand, par un seul pilote. |
| Pit / Arrêt | Passage au stand (ravitaillement, changement de pilote, pneus, réparation). |
| Pit window | Fenêtre de tours optimale pour s'arrêter sans perdre de temps ni manquer de carburant. |
| S1 / S2 / S3 | Les trois secteurs qui découpent un tour, chronométrés séparément. |
| Tour idéal | Somme des meilleurs secteurs S1+S2+S3, même réalisés sur des tours différents. |
| Delta | Écart de temps entre deux références (deux pilotes, ou réel vs objectif). |
| Dégradation | Perte de rythme au fil d'un relais (usure pneus, baisse de carburant…). |
| FCY | Full Course Yellow — neutralisation : tout le monde ralentit à allure imposée. |
| SC | Safety Car — voiture/moto de sécurité qui regroupe le peloton à allure réduite. |
| Drapeau rouge | Course interrompue (conditions dangereuses, gros incident). |
| Damier | Drapeau à damier — fin de la session / de la course. |
| Out lap / In lap | Tour de sortie des stands / tour d'entrée aux stands. |

### Concepts clés

#### Weekend, Session, Course

Un Weekend regroupe les sessions d'une épreuve (essais, qualifs, warm-up, course). Chaque Session a ses propres tours et données. La Course est la session principale pilotée en temps réel.

#### Tour & Secteurs

Chaque tour est découpé en S1, S2, S3. Raceware suit les temps secteur par secteur pour détecter immédiatement une perte de rythme ou un secteur manquant. Meilleur tour, tour idéal et moyenne sont calculés en continu.

#### Relais & Pilotes

Un relais relie deux arrêts. Raceware l'associe à un pilote et calcule sa dégradation, sa moyenne, son meilleur tour et sa consommation.

#### Équipe & Espace

Chaque écurie a son espace isolé, avec des rôles et permissions par module. Les données restent la propriété de l'écurie.

## Prise en main

### Démarrer en Free (saisie manuelle)

Le plan Free fonctionne sans connexion live : les données se saisissent à la main. C'est le bon moyen d'apprendre l'outil et de piloter une course en autonomie.

1. Créer un compte et nommer l'écurie — l'espace est généré automatiquement.
2. Créer un Weekend, puis une Session (durée, circuit, type de véhicule).
3. Ajouter les pilotes (nom, rythme de référence).
4. Pendant la course, saisir chaque tour : temps, carburant restant, état des pneus.
5. Composer un dashboard avec Historique des tours, Carburant et Stratégie.
6. À la fin, exporter les données en CSV / Excel pour le débrief.

En Free : 1 membre, pas de données live, pas de météo, pas d'analytics avancés. Mais toute la configuration et la saisie manuelle sont illimitées dans le temps.

### Démarrer en Pro (données live)

Le plan Pro débloque le temps réel : le chronométrage, la météo et les analytics alimentent le dashboard automatiquement.

1. Depuis l'espace de l'écurie, activer le plan Pro pour la course concernée.
2. Connecter la source de données live (voir « Intégration Chronelec »).
3. Activer la météo : renseigner le circuit / les coordonnées pour les prévisions.
4. Inviter les coéquipiers (jusqu'à 5 membres) et attribuer leurs rôles.
5. Ajouter les widgets live : Classement, Track map, Météo, Delta pilotes.
6. En course, les recommandations de pit window guident les arrêts.

Régler les seuils d'alerte AVANT la course (carburant mini, dégradation max) pour être prévenu au bon moment.

### Démarrer en Studio (intégrations)

Le plan Studio ajoute l'intégration des systèmes de l'écurie et des dashboards 100 % sur-mesure.

1. Activer le plan Studio et générer la clé d'API proxy (voir « API proxy »).
2. Brancher les sources : timing custom, capteurs maison, télémétrie tierce.
3. Créer des widgets JSX personnalisés (voir « Widgets custom »).
4. Ajouter autant de membres que nécessaire (illimité sur demande).
5. Le support prioritaire et l'accompagnement intégration sont inclus.

### Interactions & raccourcis

- Double-clic sur un widget : ouvre son panneau de réglages latéral.
- Clic long sur un widget : mode déplacement pour réorganiser la grille (relâche pour valider).
- Bouton plein écran : ouvre un widget dans une fenêtre dédiée (idéal second écran).
- Glisser-déposer depuis la barre latérale (mode édition) pour ajouter un widget.

## Le Dashboard

### Composer son dashboard

Le Dashboard est le poste de commande personnalisable : widgets en glisser-déposer, redimensionnables. Plusieurs dashboards peuvent coexister (mur des stands, ingénieur, direction de course) ; chaque membre a sa disposition, sauvegardée automatiquement.

### Référence des widgets

Chaque widget consomme une source de données précise. Voici le détail de ce que chacun affiche et requiert.

| Widget | Affiche | Requiert |
| --- | --- | --- |
| Statut de course | Drapeau, temps écoulé, temps restant | Session active |
| Chrono relais | Durée du relais courant, compte à rebours | Relais en cours |
| Historique des tours | Temps, secteurs, condition, n° de relais | Tours (saisis ou live) |
| Carburant | Autonomie estimée, plan vs réel, conso/tour | Capacité réservoir + conso configurées |
| Pneus & freins | Usure et durée de vie par train | Profils d'usure configurés |
| Classement live | Positions, écarts, tours, n° véhicule | Données live (Pro/Studio) |
| Track map | Position de chaque moto sur le circuit | Données live + secteurs |
| Météo | Air/piste, vent, humidité, pluie, radar, 12 h | Météo activée (Pro/Studio) |
| Delta pilotes | Écart tour par tour entre 2 pilotes | 2 pilotes avec tours |
| Comparaison relais | Moyenne, meilleur, dégradation par relais | Plusieurs relais |
| Moyenne mobile | Tendance lissée des temps au tour | Tours |
| Notifications | Historique des alertes + journal | — |
| Widget custom | Tout dataset via le builder | Configuration builder |

### Widget Builder — guide pas à pas

Le builder visuel compose un bloc d'analyse selon une formule simple, en 4 étapes.

DATASET + MÉTRIQUE + DIMENSION (regroupement) + FILTRES + VISUALISATION

#### Étape 1 — Dataset

Choisir la source : tours (tous / hors pit), relais, pilotes, arrêts, carburant, consommables, télémétrie live, secteurs, incidents, méta-course, référence circuit.

#### Étape 2 — Métrique & dimension

Sélectionner un champ numérique (ex. temps au tour) et une agrégation (somme, moyenne, min, max, comptage). Puis une dimension de regroupement : par pilote, par relais, par condition, pit vs normal, par tranche de tours, par véhicule.

#### Étape 3 — Filtres

Ajouter des conditions qui se cumulent (toutes doivent être vraies). Opérateurs disponibles :

| Opérateur | Sens | Exemple |
| --- | --- | --- |
| égal | champ = valeur | condition = wet |
| différent | champ ≠ valeur | pilote ≠ Alex |
| supérieur | champ > valeur | tour > 20 |
| inférieur | champ < valeur | temps < 145000 |
| contient | la valeur est incluse | note contient "SC" |

Plusieurs filtres = ET logique. Pour un OU, créer deux widgets ou élargir la dimension.

#### Étape 4 — Visualisation

Choisir le rendu : Stat unique, Comparaison, Barres, Ligne, Multi-lignes, Nuage de points, Tableau, Jauge. Puis le titre et la taille.

#### Exemple concret

Temps moyen par pilote sur piste sèche : dataset « Tours hors pit » → métrique « temps au tour » / moyenne → dimension « par pilote » → filtre « condition = dry » → visualisation « Barres ».

## Données live

### Télémétrie live

En Pro/Studio, Raceware ingère le chronométrage en direct : positions, secteurs, écarts, tours, drapeaux. La latence typique est d'environ 10 secondes — adaptée à la stratégie (pas besoin de la milliseconde, besoin de fiabilité).

### Intégration Chronelec

Chronelec est le système de chronométrage officiel de nombreux événements français et européens. C'est le connecteur live de référence de Raceware.

#### Mise en place

1. Dans l'espace de l'écurie, ouvrir Réglages → Intégrations → Chronelec.
2. Renseigner l'identifiant de l'événement (fourni par l'organisation / le timing).
3. Coller la clé d'accès Chronelec, puis « Tester la connexion ».
4. Une fois la connexion verte, l'ingestion démarre automatiquement.

| Paramètre | Valeur attendue |
| --- | --- |
| Latence | ~10 s entre le franchissement réel et l'affichage |
| Fréquence de poll | Toutes les ~8 s |
| Données fournies | Positions, S1/S2/S3, écarts, tours, drapeaux |

Limites connues : pas de données par moins de ~8 s ; certains événements ne diffusent pas tous les secteurs (Raceware le détecte et alerte).

### Track map — fonctionnement & précision

La track map place chaque moto sur le circuit à partir des temps au secteur et des écarts au leader. Entre deux franchissements, la position est interpolée (estimée) selon le rythme moyen du véhicule.

- Précision : exacte aux frontières de secteur, approchée entre les deux.
- La couleur du circuit suit le drapeau (jaune sous SC, rouge sous drapeau rouge).
- La moto de l'écurie est mise en avant ; le leader est identifié.

Cas limites : un véhicule à l'arrêt (chute, stand) reste figé à sa dernière position connue jusqu'à la prochaine donnée. Un secteur manquant gèle l'interpolation et déclenche une alerte.

### Alertes — liste exhaustive

Toutes les alertes remontent dans le centre de notifications (icône cloche). Voici les types, leurs conditions et leur réglage.

| Type | Déclenchement | Réglable |
| --- | --- | --- |
| Secteur manquant | Un S1/S2/S3 attendu n'arrive pas dans le délai prévu | Marge (s) après la moyenne |
| Attente prolongée | Le secteur manque toujours après le délai | Auto (suit l'attente) |
| Erreur API | Le chronométrage ne répond plus / renvoie une erreur | Non |
| Reconnexion | La connexion live est rétablie | Non |
| Carburant bas | Autonomie estimée sous le seuil | Seuil (litres / tours) |
| Dégradation | Perte de rythme au-delà du seuil sur un relais | Seuil (%) |
| Stock bas | Un consommable tracké passe sous son seuil | Seuil par consommable |
| Drapeau / SC | Changement d'état de course (SC, FCY, rouge…) | Activable |

Ignorer une alerte (croix) la fait taire pour l'événement courant. Les seuils se configurent dans Réglages → Alertes, idéalement avant la course.

## Stratégie

### Stratégie & carburant

Raceware planifie et ajuste les arrêts. La timeline compare en continu le plan prévu au déroulé réel.

#### Configuration

- Capacité du réservoir (litres) : dans Réglages → Véhicule.
- Consommation de référence (litres/tour) : saisie ou calculée automatiquement à partir des tours.
- Rythme de référence par pilote : utilisé pour estimer les fenêtres de pit.
- Seuils d'alerte : carburant mini, dégradation max.

#### En course

- Autonomie carburant recalculée selon le rythme réel.
- Recommandation de fenêtre de pit optimale (Pro/Studio).
- Suivi de l'usure pneus & freins par relais.
- Comparaison plan vs réel, mise à jour à chaque tour.

### Scénario type — un 8 h à deux pilotes

Exemple concret de course de 8 heures, 2 pilotes (A et B), 3 arrêts, avec une alerte météo à mi-course.

1. Avant la course : réservoir 24 L, conso ~0,8 L/tour → autonomie ~30 tours. Plan : 4 relais de ~30 tours, 3 arrêts.
2. Relais 1 (Pilote A) : Raceware suit la conso réelle. À 25 tours, alerte « carburant bas » → pit window ouverte.
3. Arrêt 1 : plein + passage au Pilote B. La timeline confirme qu'on est dans la fenêtre prévue.
4. Mi-course : alerte météo « pluie dans 20 min » (prévisions 12 h). Décision : avancer l'arrêt 2 pour monter des pneers pluie.
5. Arrêt 2 (anticipé) : pneus pluie + Pilote A. Le delta montre que les concurrents restés en slicks perdent du temps.
6. Relais 3-4 : la dégradation reste sous le seuil ; le dernier arrêt se cale sur la fin de course.
7. Après : débrief — comparaison des relais, moyenne mobile, export pour les pilotes.

Bonnes pratiques : pitter en début de fenêtre si une neutralisation est probable ; sous FCY/SC, un arrêt « coûte » moins cher (tout le monde ralentit) — c'est souvent le bon moment.

### Météo — modèle & limites

La météo (via OpenWeatherMap en Pro) affiche les conditions et les corrèle au grip, à la consommation et au rythme.

- Corrélation grip : la baisse de température piste et la pluie réduisent l'adhérence estimée, ce qui influe sur le rythme attendu.
- Corrélation conso : un air plus froid/dense peut légèrement modifier la consommation.
- Prévisions 12 h : température, risque de pluie, vent — pour anticiper un changement de pneus.

Limites du modèle : les estimations grip/conso sont des indications, pas des garanties. La météo locale d'un circuit peut différer des prévisions générales ; recoupe toujours avec l'observation terrain.

### Export de données

Toutes les données sont exportables, sur tous les plans.

| Format | Contenu | Disponibilité |
| --- | --- | --- |
| CSV | Tours, relais, arrêts, consommables | Tous plans |
| Excel (.xlsx) | Mêmes données, mises en forme | Tous plans |
| Export débrief | Synthèse de session (moyennes, meilleurs, dégradation) | Tous plans |

Champs exportés : numéro de tour, pilote, temps, secteurs, condition, relais, carburant, notes. Fréquence : à la demande, sans limite.

## Dépannage

### Troubleshooting & erreurs fréquentes

Les réponses aux situations sous pression, en course. Section à garder en favori.

#### La connexion live tombe en pleine course

- Raceware affiche une alerte « Erreur API » et conserve les dernières données reçues.
- L'ingestion retente automatiquement ; dès le rétablissement, une alerte « Reconnexion » apparaît et les données reprennent.
- Si rien ne revient après 1-2 min : vérifier la connexion internet, puis la clé et l'identifiant dans Réglages → Intégrations.
- En dernier recours, basculer en saisie manuelle pour ne pas perdre le fil de la stratégie.

#### Un tour ou un secteur ne remonte pas

- Une alerte « secteur manquant » s'affiche (ex. « #14 pas de S1 reçu, en attente »).
- La track map gèle l'interpolation de ce véhicule jusqu'à la prochaine donnée.
- Si le secteur finit par arriver, la position se recale automatiquement.
- Si c'est récurrent sur tout le plateau : c'est probablement le timing de l'organisation, pas Raceware.

#### Des données aberrantes (temps impossibles, positions farfelues)

- Raceware filtre les valeurs hors plage évidentes, mais certaines passent.
- Vérifie le drapeau : un tour sous SC/FCY est légitimement beaucoup plus lent.
- Si une seule moto est concernée : souvent un problème de transpondeur côté timing.
- Un tour peut être ignoré ou corrigé manuellement dans l'historique.

#### Reconnexion en cours de course

Rafraîchir la page ou changer d'appareil ne perd rien : les données vivent côté serveur. L'état courant est retrouvé à la reconnexion. Plusieurs membres peuvent suivre la même course simultanément.

### FAQ

**Raceware fonctionne-t-il hors connexion ?**

Le plan Free fonctionne en saisie manuelle, sans dépendre du live. Les plans Pro/Studio nécessitent une connexion pour le temps réel.

**Mes données sont-elles isolées des autres équipes ?**

Oui, chaque écurie a son espace cloisonné. Personne en dehors de l'écurie n'y accède.

**Puis-je créer mes propres widgets ?**

Le builder visuel est inclus dès le plan Pro. Le plan Studio permet en plus des widgets JSX 100 % sur-mesure.

**Que se passe-t-il si Raceware est indisponible pendant ma course ?**

Voir la section Disponibilité (SLA). Les données sont conservées ; en cas d'incident, la saisie manuelle reste un filet de sécurité.

**Puis-je changer de plan en cours de saison ?**

Oui. La facturation étant à la course, le plan se choisit épreuve par épreuve.

## Studio & API

### API proxy (Studio)

L'API proxy du plan Studio permet de brancher des sources maison : timing custom, capteurs propres, télémétrie tierce. Raceware les reçoit et les traite comme une source live native.

#### Authentification

Chaque écurie dispose d'une clé d'API générée dans Réglages → Intégrations → API proxy. Elle s'envoie dans l'en-tête de chaque requête.

#### Endpoints principaux

| Méthode | Endpoint | Rôle |
| --- | --- | --- |
| POST | /v1/telemetry | Pousser un lot de télémétrie (positions, secteurs) |
| POST | /v1/laps | Pousser des tours complétés |
| POST | /v1/flags | Mettre à jour l'état de course (drapeau) |
| GET | /v1/status | Vérifier l'état de l'ingestion |

#### Format des données (exemple)

Limites : débit recommandé ≤ 1 requête/seconde par véhicule ; les temps sont attendus en millisecondes ; les numéros de véhicule en chaîne.

### Widgets custom JSX (Studio)

En Studio, des composants React (JSX) maison peuvent être fournis pour des visualisations totalement sur-mesure. Raceware donne accès aux données via un hook ; le rendu reste à la charge du composant.

Les widgets custom s'exécutent dans un cadre sécurisé. Le support Studio t'accompagne pour les développer et les déboguer.

### Custom Code Widget — données exposées

Cette section est la référence complète des données (« datasets ») qu'un Custom Code Widget peut consommer. Le code reçoit un objet de données déjà filtré et structuré : un dataset est choisi, un tableau de lignes (rows) est renvoyé, aux champs documentés ci-dessous. La base n'est jamais interrogée directement.

CHOISIS UN DATASET → REÇOIS DES ROWS TYPÉES → TRANSFORME → AFFICHE

#### Principe & règles d'unités

- Chaque dataset est un tableau d'objets (rows). Un dataset « méta » (course, circuit) renvoie une seule ligne.
- Tous les temps sont en millisecondes (champs suffixés _ms). Ex. 141820 = 2:21.820.
- Le carburant est en litres ; les pourcentages d'usure/restant sont des nombres de 0 à 100.
- Les numéros de véhicule sont des chaînes ("14"), pas des nombres.
- Un champ peut être null si la source ne le fournit pas (ex. carburant en télémétrie live EWC).
- Les datasets « live » (EWC) ne sont alimentés que pendant une course connectée ; sinon ils sont vides.

#### Catalogue des datasets

22 datasets disponibles. La colonne « Live » indique ceux qui nécessitent une course connectée en temps réel (EWC / API proxy).

| Clé dataset | Contenu | Live |
| --- | --- | --- |
| laps_raw | Tous les tours (y compris pit, SC) | — |
| laps_clean | Tours hors pit (rythme « propre ») | — |
| stints | Relais agrégés (moyenne, best, dégradation) | — |
| drivers | Statistiques par pilote | — |
| pit_stops | Arrêts au stand | — |
| fuel_plan | Carburant planifié vs réel par tour | — |
| consumables | Inventaire consommables | — |
| ewc_live | Télémétrie live (toutes voitures suivies) | Oui |
| ewc_laps | Tours live du véhicule suivi | Oui |
| ewc_sectors | Secteurs S1/S2/S3 live | Oui |
| ewc_events | Événements course (drapeaux, incidents) | Oui |
| race_meta | Méta de la course (1 ligne) | — |
| tires | État actuel des trains de pneus | — |
| driver_wear | Profils d'usure estimés par pilote | — |
| planned_pits | Arrêts planifiés (timeline) | — |
| tracked_consumables | Consommables trackés pour la course | — |
| session_reports | Bilans de sessions du weekend | — |
| incidents | Tours marqués d'un incident | — |
| circuit_ref | Référence circuit / weekend (1 ligne) | — |

#### Tours — laps_raw / laps_clean / incidents

laps_clean = laps_raw sans les tours de pit. incidents = laps_raw filtré sur les tours portant un incident_type.

| Champ | Type | Unité / valeurs |
| --- | --- | --- |
| lap_number | number | entier, n° du tour |
| driver_name | string | nom du pilote |
| lap_time_ms | number | ms |
| fuel_used | number | litres consommés sur le tour |
| is_pit_lap | boolean | true si tour de pit |
| condition | string | dry / wet / damp… |
| stint_number | number | n° de relais |
| incident_type | string\|null | type d'incident si présent |

#### Relais — stints

| Champ | Type | Unité |
| --- | --- | --- |
| stint_number | number | n° de relais |
| driver_name | string | pilote du relais |
| lap_count | number | nombre de tours |
| avg_lap_ms | number | ms (temps moyen) |
| best_lap_ms | number | ms (meilleur tour) |
| fuel_used_total | number | litres |
| degradation_pct | number | % de perte de rythme |

#### Pilotes — drivers

| Champ | Type | Unité |
| --- | --- | --- |
| driver_name | string | nom |
| total_laps | number | tours réalisés |
| best_lap_ms | number | ms |
| avg_lap_ms | number | ms |
| total_time_ms | number | ms cumulés (estimation) |
| stints_count | number | nombre de relais |

#### Arrêts — pit_stops

| Champ | Type | Unité |
| --- | --- | --- |
| lap_number | number | tour de l'arrêt |
| driver_name | string | pilote |
| pit_duration_ms | number | ms (durée arrêt) |
| fuel_added | number | litres ajoutés |

#### Carburant — fuel_plan

| Champ | Type | Unité |
| --- | --- | --- |
| lap_number | number | tour |
| planned_fuel_remaining | number | litres (plan) |
| actual_fuel_remaining | number | litres (réel) |
| delta_liters | number\|null | réel − plan (litres) |

#### Télémétrie live — ewc_live / ewc_laps / ewc_sectors

ewc_live liste toutes les voitures suivies à l'instant T. ewc_laps et ewc_sectors concernent le véhicule suivi. Disponibles uniquement course connectée.

| Champ | Type | Unité |
| --- | --- | --- |
| vehicle_number | string | n° véhicule |
| position | number | position classement |
| gap_to_leader_ms | number | ms (écart au leader) |
| last_lap_ms | number | ms (dernier tour) |
| pit_count | number | nombre d'arrêts |
| status | string | statut (en piste, stand…) |
| s1_ms / s2_ms / s3_ms | number\|null | ms (secteurs) |
| rider | string | pilote au volant |
| lap_number | number | tour (ewc_laps) |
| lap_time_ms | number | ms (ewc_laps) |
| gap_ms | number | ms (écart, ewc_laps) |

#### Événements — ewc_events

| Champ | Type | Unité / valeurs |
| --- | --- | --- |
| lap | number | tour de l'événement |
| event_type | string | flag / pit / incident… |
| vehicle_number | string | n° véhicule concerné |
| team | string | équipe |
| rider | string | pilote |
| detail | string | description libre |

#### Pneus & usure — tires / driver_wear

| Champ | Type | Unité |
| --- | --- | --- |
| position | string | position du train (AV/AR…) |
| label / type | string | libellé / type de pneu |
| state | number | % restant (0–100) |
| initial_state | number | % au montage |
| life_laps | number | tours de durée de vie |
| brake_life_laps | number | tours (freins) |
| tire_wear_per_lap | number | % usure pneu / tour |
| brake_wear_per_lap | number | % usure frein / tour |

#### Méta & circuit — race_meta / circuit_ref / planned_pits / tracked_consumables / session_reports

| Champ | Type | Unité |
| --- | --- | --- |
| name / team_name | string | libellés |
| duration_minutes | number | minutes (race_meta) |
| fuel_tank_capacity | number | litres (circuit_ref) |
| safety_car_lap_time_ms | number | ms (circuit_ref) |
| lap / fuel_to_add | number | tour / litres (planned_pits) |
| initial_value / current_value | number | tracked_consumables |
| pct_remaining | number | % restant (tracked_consumables) |
| best_lap_time_ms / avg_lap_time_ms | number | ms (session_reports) |

#### Contrat de la sandbox — ce que le code peut et ne peut pas faire

- PEUT : lire les rows du dataset choisi, les transformer (filter/map/reduce), et retourner du JSX pour l'affichage.
- PEUT : utiliser React et les helpers de formatage fournis (temps, litres, pourcentages).
- NE PEUT PAS : accéder au réseau (fetch, WebSocket) — toute sortie réseau est bloquée.
- NE PEUT PAS : lire les données d'une autre équipe — seuls les datasets de la course active de l'espace courant sont transmis.
- NE PEUT PAS : accéder au stockage du navigateur, aux cookies, ni au state global de l'application.
- NE PEUT PAS : interroger des datasets non listés ici par introspection — seul l'objet de données fourni est visible.

Cloisonnement : chaque écurie n'accède qu'à ses propres données. Les datasets live (EWC) restent limités au périmètre de la course connectée. Tout ce qui sort de ce contrat est rejeté à l'exécution.

Statut : la sandbox Custom Code Widget est en cours de durcissement sécurité (audit white-hat). Les widgets JSX custom sont accompagnés par le support Studio le temps de la phase alpha.

## Compte & équipe

### Rôles & permissions

Une écurie compte plusieurs membres, avec des rôles et des permissions par module.

#### Rôles

| Rôle | Peut faire |
| --- | --- |
| Propriétaire | Tout : équipe, facturation, intégrations, tous les modules |
| Admin | Gérer l'équipe et les modules (sauf facturation) |
| Éditeur | Modifier les modules autorisés (saisie, stratégie, dashboards) |
| Lecteur | Consultation seule, aucune modification |

#### Modules (permissions fines)

| Module | Contenu |
| --- | --- |
| Live / Course | Statut, classement, track map, saisie des tours |
| Stratégie | Timeline, carburant, fenêtres de pit |
| Consommables | Stocks, pneus, pièces, seuils |
| Débrief / Analyse | Comparaisons, exports |
| Équipe | Membres, rôles, invitations |
| Intégrations | Chronelec, API proxy, météo |

Concrètement : un Éditeur sur « Stratégie » peut modifier le plan de course mais pas inviter de membre ; un Lecteur voit tout en course sans rien changer.

Limites par formule — Free : 1 membre · Pro : jusqu'à 50 · Studio : illimité sur demande.

### Données, RGPD & sécurité

Les données appartiennent à l'écurie. Raceware ne les revend pas, ne les utilise pas pour entraîner des modèles, et ne les analyse pas sans autorisation.

#### RGPD

- Hébergement en datacenters européens.
- Collecte minimale : seules les données nécessaires au service.
- Droits respectés : accès, export, rectification, suppression sur demande.
- Cloisonnement strict entre écuries.

#### Sécurité

- Authentification protégée, expiration de session, double authentification (2FA) à venir.
- Mesures contre les injections, le credential stuffing et le brute-force.
- Toutes les autorisations sont vérifiées côté serveur, jamais seulement dans le navigateur.

## Produit

### Comparatif des formules

|  | Free | Pro | Studio |
| --- | --- | --- | --- |
| Prix | 0 € | 200 € HT/course | 500 € HT/course |
| Membres | 1 | Jusqu'à 50 | Illimité* |
| Saisie manuelle | Oui | Oui | Oui |
| Export CSV / Excel | Oui | Oui | Oui |
| Données live (Chronelec) | — | Oui | Oui |
| Météo intégrée | — | Oui | Oui |
| Analytics avancés | — | Oui | Oui |
| Recommandations pit window | — | Oui | Oui |
| API proxy (sources custom) | — | — | Oui |
| Widgets JSX custom | — | — | Oui |
| Support | — | Email (~24 h) | Prioritaire (2-4 h) |

*Illimité sur demande. Tarifs HT, facturés par course. Réduction de 25 % sur les forfaits saison (4 courses).

### Roadmap & limites connues

Par honnêteté, voici ce qui existe, ce qui arrive, et les limites actuelles.

#### Disponible

- Dashboard modulaire, builder visuel, saisie manuelle, export.
- Données live Chronelec, track map, météo, alertes.
- Stratégie carburant, débrief, gestion d'équipe.

#### Prévu / en cours

- Connecteurs MyLaps et autres systèmes de timing.
- Modules ERP étendus : finance, inventaire, logistique.
- Disciplines supplémentaires : circuit auto, rallye.
- Double authentification (2FA), changelog public.

#### Limites connues

- La latence live dépend du timing source (~10 s avec Chronelec).
- L'interpolation track map est approchée entre deux secteurs.
- Les estimations grip/conso météo sont indicatives.
- Certains événements ne diffusent pas tous les secteurs.

### Disponibilité (SLA)

Raceware vise une haute disponibilité, particulièrement pendant les week-ends de course.

- Objectif d'uptime : 99,5 % (hors maintenances planifiées, annoncées à l'avance).
- Les données vivent côté serveur : un rafraîchissement ou un changement d'appareil ne perd rien.
- En cas d'incident pendant une course, la saisie manuelle reste un filet de sécurité.
- Le statut du service et les incidents sont communiqués via le centre de notifications.

Les plans Studio bénéficient d'un support prioritaire (2-4 h) pendant les événements.

---

## Other pages

- [Le premier ERP des sports mécaniques](https://www.raceware.dev/fr/)
- [Tout ce qu'une écurie pilote, dans un seul outil](https://www.raceware.dev/fr/features)
- [Les données de course ne sortent pas de l'écurie](https://www.raceware.dev/fr/securite)
- [Les outils des grandes équipes, à la portée des petites structures](https://www.raceware.dev/fr/about)
- [Demander l'accès Pro](https://www.raceware.dev/fr/pro)
- [Mentions légales](https://www.raceware.dev/fr/mentions-legales)
- [Conditions générales](https://www.raceware.dev/fr/cgu-cgv)
- [Politique de confidentialité](https://www.raceware.dev/fr/confidentialite)
- [Politique cookies](https://www.raceware.dev/fr/cookies)
- [Crédits](https://www.raceware.dev/fr/credits)

## Other languages

- English: https://www.raceware.dev/docs
- Deutsch: https://www.raceware.dev/de/docs
- Italiano: https://www.raceware.dev/it/docs
- Español: https://www.raceware.dev/es/docs
- Nederlands: https://www.raceware.dev/nl/docs
- 日本語: https://www.raceware.dev/ja/docs