LogiTrain — Guide du formateur

Version 0.1 — septembre 2026 — InTech Solutions pour le CFA Sidi Mansour (ATFP)

Ce guide explique comment conduire un cours avec LogiTrain : préparer une promotion, créer et corriger des exercices, adapter les paramètres pédagogiques, suivre les résultats et remettre les données à zéro. Les écrans sont décrits dans le manuel utilisateur ; l'installation, les comptes et les bases de données dans le guide d'administration.

1. Le rôle du formateur dans LogiTrain

Un compte du groupe Formateur :

• voit les travaux de tous les apprenants (filtre Propriétaire ou regroupement par propriétaire dans les listes) ;
• gère les promotions, les exercices, les corrigés et la notation ;
• modifie les données de base et paramètres pédagogiques (règles de tournée, restrictions, contenants, barèmes, taux, coefficients, plans pneumatiques, réglementation, infractions, matrice ADR, catégories de stockage…) ;
• approuve les bons de sortie des missions, les demandes de réparation et les régularisations d'inventaire ;
• dispose des outils de simulation (lectures RFID, réalisation des tournées) et du menu Configuration de chaque module ;
• peut remettre en brouillon une tournée validée et réinitialiser les données d'exercice des apprenants.

Conseil : garder un compte formateur pour préparer et corriger, et un compte « apprenant test » pour vérifier ce que voient les apprenants.

2. Organisation d'une session

2.1 Une base par promotion

L'administrateur crée pour chaque promotion une base copiée de la base modèle (./cohort_db.sh create promo_2026a, guide d'administration § 7). Tout ce que vous préparez dans la base modèle (paramètres, exercices, comptes) se retrouve dans chaque nouvelle promotion.

Bonne pratique : préparer paramètres et exercices dans la base modèle en début d'année, puis demander la copie pour chaque groupe.

2.2 Créer la promotion

1. LogiTrain → Formation → Promotions → Nouveau.
2. Nom (ex. « Logistique & transport 2026-A »), Formateur, Début, Fin, Modules (texte libre : tour, loadplan, fleet, wms).
3. Onglet Apprenants : ajouter les comptes (créés par l'administrateur).
4. Onglet Exercices : les exercices rattachés à la promotion (création possible ici).
5. Onglet Notes : informations libres (planning, salles…).

Un apprenant ne voit que sa promotion et les exercices de sa promotion (plus les exercices sans promotion).

2.3 Vérifier les droits des apprenants

Chaque apprenant doit avoir LogiTrain = Apprenant et Inventaire = Utilisateur (guide d'administration § 6). Test rapide : se connecter avec un compte apprenant et vérifier que les menus Tournées, Plans de chargement, Parc, Entrepôt et RFID et Formation sont visibles.

3. Créer un exercice

LogiTrain → Formation → Exercices → Nouveau

Le bouton intelligent Remises ouvre toutes les remises de l'exercice.

3.1 Données de départ : partagées ou personnelles

Les enregistrements sans propriétaire (données de démonstration, exemples) sont partagés : tous les apprenants les voient et peuvent les modifier. Pour éviter que plusieurs apprenants travaillent sur le même objet :

Pour les exercices « à objet unique » (ex. une tournée déjà préparée), la solution la plus simple est de travailler en binômes à tour de rôle, ou de préparer un objet par apprenant et d'en changer le Propriétaire (champ visible des formateurs).

4. Indicateurs attendus et notation automatique

4.1 Principe

Quand l'apprenant clique Remettre sur sa remise, LogiTrain :

1. lit les indicateurs actuels de l'enregistrement remis (même calcul que l'onglet Indicateurs) et les fige dans le relevé des indicateurs ;
2. compare chaque indicateur numérique de l'objet JSON Indicateurs attendus à la valeur de l'apprenant ;
3. donne 1 point si l'écart relatif est ≤ 10 %, sinon 1 − écart (0 au-delà de 100 % d'écart) ; l'écart relatif est |valeur − attendu| ÷ max(|attendu|, 1) ;
4. calcule la note sur 100 = moyenne des points × 100.

Les clés absentes du relevé ou non numériques sont ignorées. Si l'objet JSON est vide, la note vaut 0 : corriger alors à la main (§ 6).

4.2 Écrire l'objet JSON

Format : {"clé": valeur, "clé": valeur} — guillemets doubles, point décimal, pas de virgule finale. Une erreur de syntaxe est refusée à l'enregistrement (« Les indicateurs attendus doivent être un JSON valide »).

Exemples :

{"distance_km": 118.5, "violations": 0, "on_time_rate_pct": 100}
{"boxes_placed": 72, "fill_volume_pct": 85}
{"read_accuracy_pct": 90, "missing_tags": 2}

Attention aux cibles 0 : pour une cible 0, l'écart est calculé sur une base de 1 ; une seule infraction (valeur 1) donne 0 point. C'est voulu pour « zéro infraction ».

4.3 Clés disponibles par type de travail

Les documents réglementaires, incidents, pleins, pneus et opérations de stock n'ont pas d'indicateurs de notation : les corriger à la main (commentaire + note), ou faire remettre l'objet de synthèse (mission, réparation…).

Pour trouver la bonne valeur attendue : réaliser l'exercice soi-même (compte formateur), ouvrir l'onglet Indicateurs de l'enregistrement et recopier les valeurs utiles.

4.4 Plans de chargement : correction par rapport à la solution optimale du logiciel

En plus de la note JSON, chaque plan de chargement peut être comparé à la solution de référence calculée par LogiTrain avec les mêmes articles et paramètres (bouton Solution de référence, calculée automatiquement à la validation) :

• Unités vs référence (%) et Remplissage vs référence (%) (plafonnés à 100 %) ;
• Score vs référence (/100) = 50 % remplissage + 50 % unités, moins 5 points par position invalide.

Mettre par exemple {"score_vs_reference": 100} dans les indicateurs attendus : un plan au moins aussi bon que la référence obtient 100, un plan à 80 % de la référence obtient 80.

La solution de référence est une heuristique (placement par points extrêmes, meilleur ajustement décroissant, plusieurs variantes) : elle est bonne et reproductible, mais pas garantie optimale. Un apprenant peut la battre — c'est un bon sujet de discussion.

5. Paramètres modifiables par le formateur

Toutes les valeurs livrées sont des exemples (signalés « placeholder » dans certains libellés). Les remplacer par les valeurs tunisiennes en vigueur avant le premier cours, idéalement dans la base modèle.

5.1 Tournées

Tournées → Règles (une ou plusieurs fiches de règles ; chaque plan / tournée choisit ses règles) :

Pédagogie des interrupteurs : dupliquer la fiche de règles (ex. « Règles sans créneaux »), couper une règle, faire recalculer la même tournée avec chacune des deux fiches, puis comparer les instantanés : les apprenants voient l'impact de la contrainte sur la distance, l'amplitude et le coût.

Tournées → Restrictions routières : créer des zones (cercle cliqué sur la carte ou polygone) de hauteur, poids, faibles émissions, interdiction poids lourds, ou des péages avec leur coût. Catalogue → Profils de véhicules : hauteur, PTAC, classe Euro, poids lourd, consommation, coûts, capacité (via l'espace de chargement), nombre max. d'arrêts, compétences, coefficient de vitesse. Catalogue → Compétences : frigorifique, hayon, ADR… Secteur de livraison : onglet Carte des clients.

5.2 Plans de chargement

La bibliothèque livrée contient les porteurs et semi-remorques courants, les conteneurs ISO 20', 40', 40' HC, 45' HC, open top, flat rack et reefer, les palettes EUR et industrielle. Ajouter les véhicules du parc des entreprises partenaires et les conteneurs traités aux ports de Radès, Sfax et Bizerte selon vos besoins. Les limites de charge par essieu et de gabarit routier doivent être saisies selon la réglementation tunisienne (valeurs non fournies).

5.3 Parc

Parc → Configuration :

Sur chaque véhicule : consommation de référence (le seuil de surconsommation est fixé à +25 % de cette référence), coût d'immobilisation par jour, durée de vie prévue. Sur les produits : case Pièce de rechange véhicule. Circuits de validation existants : bon de sortie (mission), demande de réparation.

5.4 Entrepôt et RFID

À faire avant les exercices FEFO : vérifier que la catégorie des produits frais (« Frais (FEFO) ») a bien la stratégie d'enlèvement Premier expiré, premier sorti (FEFO) ; sinon la régler.

5.5 Adapter les fiches, les rapports et les tableaux de bord

• Tableaux de bord : toutes les analyses (pivot / graphique) se personnalisent (mesures, regroupements, filtres) et s'enregistrent en Favoris (menu de la barre de recherche → Enregistrer la recherche actuelle, option Partager avec tous les utilisateurs).
• Champs supplémentaires pour un exercice : en mode développeur (Paramètres → Activer le mode développeur), menu Paramètres → Technique → Modèles → ouvrir le modèle → onglet Champs → ajouter un champ (nom commençant par x_), puis l'afficher avec l'icône de débogage → Modifier la vue : Formulaire. Réservé aux formateurs à l'aise avec Odoo ; tester dans une base de test.
• Règles de calcul : les formules (consommation, amortissement, coût d'une tournée, notation) sont fixes dans le code ; leurs paramètres (taux, coefficients, seuils, prix, pondérations) sont modifiables comme décrit ci-dessus.

6. Suivre et corriger

6.1 Remises

Formation → Remises : liste de toutes les remises (exercice, apprenant, enregistrement lié, date, note, état). Filtres Remis, Noté ; regroupements par exercice, apprenant, promotion, module.

Pour corriger une remise :

1. Ouvrir la remise : Relevé des indicateurs (valeurs au moment de la remise) et Note automatique.
2. Cliquer le champ Enregistrement pour ouvrir le travail de l'apprenant (carte, vue 3D…).
3. Ajuster la Note si besoin, rédiger le Commentaire du formateur.
4. Marquer comme noté. Remettre en brouillon permet à l'apprenant de refaire et de remettre à nouveau.

6.2 Analyse des résultats

Formation → Analyse des résultats : tableau croisé apprenants × exercices (note moyenne), graphique en barres par exercice. Regrouper par promotion ou module ; télécharger en Excel pour le bulletin.

6.3 Tableaux de bord métier

7. Parcours d'exercices progressifs (proposition)

Le jeu de démonstration contient des exercices de départ (menu Exercices) et des objets d'exemple (plans de tournées, plans de chargement, missions, réparations, campagne d'inventaire…). Le parcours ci-dessous, du plus simple au plus complet, utilise uniquement des fonctions disponibles ; adaptez les valeurs attendues à vos propres données.

7.1 Tournées (Technicien en transport routier / multimodal)

7.2 Plans de chargement

7.3 Parc

7.4 Entrepôt et RFID (Agent d'entrepôt, Magasinier)

8. Remettre les données à zéro

8.1 Assistant « Réinitialiser les données d'exercice »

LogiTrain → Formation → Réinitialiser les données d'exercice :

1. Portée : Mes données d'exercice, Apprenants sélectionnés (choisir les comptes) ou Apprenants d'une promotion (choisir la promotion).
2. Types d'enregistrements : par défaut tous les types d'exercice (tournées, plans de tournées, plans récurrents, plans de chargement, scénarios, missions, réparations, incidents, heures de conduite, tableaux d'amortissement, documents, sessions RFID, campagnes d'inventaire…) ; retirer ceux à conserver.
3. Supprimer aussi les remises d'exercice : cocher en fin de module seulement.
4. Lire l'aperçu (nombre d'enregistrements par type), puis Supprimer ces enregistrements et confirmer.

Seuls les enregistrements appartenant aux apprenants ciblés sont supprimés. Les données de base, les paramètres et les données partagées ne sont jamais touchés. Un apprenant ne peut réinitialiser que ses propres données.

8.2 Remise à zéro complète

Les mouvements de stock validés, les pleins de carburant, les pneus, les véhicules et produits créés n'ont pas de propriétaire : pour revenir exactement à l'état initial, demander à l'administrateur ./cohort_db.sh reset <base> (recopie de la base modèle ; les travaux de la promotion sont perdus — prévoir une sauvegarde).

9. Conseils pédagogiques

• Heuristiques, pas miracles : l'optimisation des tournées (VROOM ou heuristique) et le calcul de chargement donnent de très bonnes solutions, pas forcément l'optimum mathématique. L'essentiel du cours est la comparaison (manuel vs optimisé, scénario A vs B) et la justification des écarts.
• Mode approché : sans OSRM, distances et durées sont estimées (vol d'oiseau × 1,3). Les comparaisons restent valables ; les valeurs absolues sont indicatives. Vérifier le bandeau du moteur avant de fixer des indicateurs attendus, et fixer les indicateurs avec le même moteur que celui des apprenants.
• Reproductibilité : imposer les graines (solveur précis, simulation RFID, simulation du réalisé) pour que tous les apprenants aient les mêmes données.
• Valeurs réglementaires : les temps de conduite, barèmes, taux et coefficients livrés sont des exemples ; les faire rechercher par les apprenants est en soi un exercice.
• Langue : un apprenant peut basculer en arabe à tout moment ; les consignes des exercices restent dans la langue où vous les avez rédigées.
• Matériel RFID : tout se fait avec le simulateur ; avec un lecteur USB en émulation clavier, la console de scan reçoit directement les EPC.