Le Simulateur (Outils SLOXO → Simulateur) sert à mesurer concrètement la valeur de l'optimisation SLOXO. Il génère un volume de RDV fictifs (paramétrable, 20 par défaut) et compare deux scénarios :

  • Sans SLOXO : ordre chronologique brut, sans optimisation
  • Avec SLOXO : ordre optimisé via l'algo 2-opt
Le résultat te montre les km économisés, le carburant économisé, le temps économisé et le revenu équivalent.

⚠️ Attention : ce n'est PAS un outil pour tester des changements de config (horaires, prix, zone). Il s'appuie sur ta config actuelle + génère des clientes fictives.

Étape 1 — Accéder au Simulateur

Va dans Tableau de bord → Simulateur (icône fiole, accent violet dans le menu Outils SLOXO).

Tu vois un grand bouton "Lancer la simulation" avec un slider pour choisir le nombre de RDV à simuler (par défaut 20, jusqu'à plus selon le slider).

Étape 2 — Lancer une simulation

Clique sur Lancer. SLOXO appelle `/api/simulator/run` qui :

  • Génère X clientes fictives avec adresses dans ta zone
  • Pour chaque cliente, calcule :
    • - Le créneau sans optimisation (premier disponible chronologique) - Le créneau avec optimisation (via l'algo 2-opt)
  • Compare les deux pour évaluer le gain
  • Renvoie un résumé

    • Le compte-rendu apparaît avec un loader pendant que ça calcule.

    Étape 3 — Lire les résultats globaux

    En haut du résultat, des KPIs agrégés :

    • OK / Conflicts / No slot — combien de simulations ont abouti vs échoué
    • Km saved : km économisés cumulés
    • Fuel saved : économie carburant en € (basée sur ta config véhicule)
    • Time saved : temps gagné cumulé
    • Total gain : gain € global (carburant + temps × ton ticket moyen)
    • Optimized count : nombre de RDV où SLOXO a placé la cliente différemment

    Étape 4 — Détail RDV par RDV

    En dessous, la liste des RDV simulés avec pour chacun :

    • Cliente fictive + services
    • Without SLOXO : date/heure/distance/temps de trajet brut
    • With SLOXO : date/heure/score/raison/distance/optimisation
    • ROI : km saved, fuel saved, time saved, extra slot, revenue gain
    Tu peux expandre chaque ligne (icône chevron) pour voir le détail complet.

    Étape 5 — Effacer la simulation

    Bouton "Effacer". Au clic :

    • API `/api/simulator/clear` (DELETE) : supprime les RDV de simulation côté serveur
    • LocalStorage `sloxo_sim_results` purgé
    • L'UI revient à l'état initial
    ⚠️ Important : les RDV de simulation sont stockés en base avec un flag `is_demo` ou similaire — ils n'apparaissent pas dans tes vraies réservations ni dans ton ROI réel. L'effacement est propre.

    Questions fréquentes

    Le Simulateur impacte-t-il mes vrais RDV ? Non. Les RDV de simulation sont marqués `is_demo: true` côté base et exclus des vues classiques.

    Puis-je tester des changements d'horaires ou de prix ? Pas via le Simulateur. Il utilise ta config courante. Pour tester un changement, modifie ta config réelle, lance la simulation, compare aux runs précédents.

    Combien de fois lancer le Simulateur ? Une fois est utile pour valider que l'optimisation fonctionne sur ta config. À refaire après un changement majeur (zone, services, véhicule).

    Le LocalStorage stocke quoi exactement ? Le résultat brut de la dernière simulation, pour que tu puisses le ré-afficher après un refresh sans relancer le calcul.

    Y a-t-il un bouton "Appliquer ces changements" ? Non. Le Simulateur n'applique aucune modification à ta config. Il fait juste le bilan d'un scénario simulé.