SCORM Build

📦 Guide — SCORM Build

À destination des CDPs et devs Skillsday

🎯 Principe

L'outil prend un module web + quelques infos de config, et génère un paquet SCORM 2004 valide prêt à déposer sur n'importe quel LMS (360Learning, Teach on Mars, Beedeez…).

🔍 Étape 1 — Analyser la source

L'analyse vérifie que le module est compatible avant de générer le SCORM. Elle détecte automatiquement si le module est statique (HTML/JS simple) ou dynamique (Flask, Node, avec backend).

✅ Module statique — Packagé directement. Fonctionne hors connexion.

⚡ Module dynamique — Encapsulé dans une iframe SCORM. L'app doit rester accessible en ligne.

🔐 Outils avec page de connexion — Ce qui peut bloquer

⚠️ Problème fréquent : Quand un outil avec login est chargé dans une iframe SCORM, les navigateurs modernes (Chrome, Safari, Firefox) bloquent les cookies de session par défaut. Résultat : l'apprenant arrive sur la page de login, entre ses identifiants, et rien ne se passe — il ne peut pas se connecter.

Cause technique :

Le cookie de session de l'outil est bloqué en tant que cookie tiers dans l'iframe. C'est une protection des navigateurs contre le tracking cross-site.

Solution requise (côté développeur) :

Le cookie de session doit être configuré avec SameSite=None; Secure. C'est une modification dans le code de l'outil (app.py pour Flask, server.js pour Node).

# Flask
resp.set_cookie('token', value, samesite='None', secure=True, httponly=True)
// Express
res.cookie('token', value, { sameSite: 'None', secure: true, httpOnly: true })

⚠️ Prérequis :

SameSite=None exige HTTPS sur le domaine de l'outil. Sans HTTPS, le cookie reste bloqué même avec cette config.

📄 Guide complet pour les devs : tools-factory/docs/scorm-integration-guide.md

🎯 Modes de complétion

🖱️ Bouton "Terminer le module" — Recommandé pour les outils avec login. Une barre apparaît en bas de l'outil après connexion. L'apprenant clique quand il a terminé.

📄 Pages visitées — Nécessite que l'outil envoie des signaux postMessage à chaque écran. Demander au dev de l'implémenter (voir guide).

⏱ Durée — Le module est marqué complété après X minutes de session. Simple, mais ne garantit pas que l'apprenant a réellement utilisé l'outil.

📁 Mode ZIP — Ce que doit contenir le ZIP

Pour les modules statiques livrés par le dev :

index.html    ← point d'entrée obligatoire à la racine
assets/       ← images, fonts, médias
css/          ← styles
js/           ← scripts

⚠️ Zipper depuis l'intérieur du dossier build — sinon index.html se retrouve dans un sous-dossier.

🔁 Reprise de session — État d'avancement

Pour les modules ALF (statiques avec scorm-api.js), l'adaptateur sauvegarde automatiquement la progression dans cmi.suspend_data et la restaure à la reprise.

✅ Ce qui est sauvegardé automatiquement : prénom, profil, sections complétées, scores, position dans le module (slide courante).

⚠️ Condition : l'app doit stocker son état dans localStorage avec le préfixe alf_epp_. L'adaptateur capture uniquement ces clés pour rester sous la limite de 64 000 caractères du LMS.

ℹ️ Technique : la restauration s'exécute de façon synchrone, avant que le DOM soit prêt — ainsi localStorage est déjà peuplé quand l'app initialise ses composants.

⚠️ Bfcache (cache navigateur) : quand le navigateur restaure une page depuis son cache (bouton retour), la session SCORM est déjà close côté LMS. L'adaptateur détecte ce cas et force un rechargement pour repartir sur une session propre.

🤖 Simulateurs IA dans le module

Certains modules ALF intègrent des simulateurs de conversation (personnage IA jouant un rôle, ex : Camille dans l'EPP). Ces simulateurs appellent une API IA en arrière-plan.

⚠️ Problème dans un LMS tiers : le module appelle /api/anthropic en URL relative. Dans SCORM Cloud ou 360Learning, cette route n'existe pas → le simulateur affiche "Erreur de connexion".

✅ Correction automatique :

L'outil détecte automatiquement ces appels lors du build et les réécrit vers l'URL publique :

// Avant (relatif — cassé dans LMS tiers)
fetch('/api/anthropic', ...)
// Après (absolu — fonctionne partout)
fetch('https://epp-api.jess-skillsday.com/api/anthropic', ...)

Pour ajouter un autre endpoint IA à externaliser : modifier le tableau API_URL_MAP dans /opt/scorm-build/src/inject-adapter.js.

🔔 Ne pas oublier

⏱ Total Time toujours à 0s ?
Le cmi.session_time n'est remis au LMS que si le SCORM a été regénéré avec la dernière version de l'adaptateur. Si le paquet date d'avant le 24/06/2026, regénérer le SCORM — le Total Time sera désormais mis à jour toutes les 30 secondes et à la complétion.