{ "nbformat": 4, "nbformat_minor": 5, "metadata": { "kernelspec": { "name": "python3", "display_name": "Python 3", "language": "python" }, "language_info": { "name": "python" }, "colab": { "name": "module-1.ipynb", "provenance": [] }, "orbit": { "missionId": "module-1", "moduleId": 1, "minutes": 30, "audience": "student", "state": "prepared-not-executed" } }, "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Module 1 — Geste, état et rendu\n", "\n", "**Objectif :** Expliquer quelle donnée le geste modifie, puis distinguer relâchement et annulation.\n", "\n", "Activité de **30 minutes**, incluse dans les **3 heures solo** : **2 h lecture guidée → 30 min Colab → 30 min bilan**. Le webinaire de **1 heure** a lieu après la préparation autonome. Formation complète : **10 h accompagnées + 30 h solo = 40 h**.\n", "\n", "CPU gratuit, sans GPU, API payante ou IA Colab obligatoire. Rien à installer. Les sorties JS sont exécutées par votre navigateur. Three.js, lorsque nécessaire, est chargé depuis un CDN à version fixée; l’alternative HTML reste disponible si le réseau ou WebGL est indisponible.\n", "\n", "Faites une copie personnelle dans Drive. Vos productions sont conservables et réutilisables. Le partage du notebook peut partager son code, ses textes et ses sorties. Ni votre journal ni vos fichiers ne sont envoyés dans Sanity automatiquement.\n", "\n", "**Trois petites étapes :** prédire (5 min), changer/observer (15 min), expliquer/exporter (10 min). Vous pouvez demander une réponse à votre assistant; indiquez l’aide reçue et vérifiez son application." ], "id": "m1-0" }, { "cell_type": "code", "metadata": {}, "source": [ "import base64, hashlib, html, io, json, math, re, time, zipfile\n", "from pathlib import Path\n", "from IPython.display import HTML, display\n", "\n", "# CPU standard; rien à installer. Les sorties HTML s'exécutent dans votre navigateur.\n", "MODULE_ID = 1\n", "MISSION_ID = 'module-' + str(MODULE_ID)\n", "reflection = {\n", " 'prediction': '', 'observations': [], 'explanation': '',\n", " 'assistance': '', 'limitations': '', 'openQuestion': ''\n", "}\n", "parameters = {}\n", "print('Préparation prête. Votre notebook appartient à votre compte Google; le partager peut partager code et sorties.')" ], "outputs": [], "execution_count": null, "id": "m1-1" }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 1. Prédire — 5 min\n", "Après deux pressions vers la droite, quelle position attendez-vous ? Que devient la capture après une annulation ?\n", "\n", "Notez votre prédiction avant de voir l’effet. Une prédiction imparfaite est une trace utile." ], "id": "m1-2" }, { "cell_type": "code", "metadata": {}, "source": [ "reflection['prediction'] = '' # Votre hypothèse AVANT l’essai\n", "parameters = {} # Notez la valeur initiale, la valeur testée et les conditions conservées." ], "outputs": [], "execution_count": null, "id": "m1-3" }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 2. Modifier et observer — 15 min\n", "Dans interactionOptions, comparez keyboardStep 0.04 puis 0.08. Gardez la zone et le même nombre de pressions.\n", "\n", "Le fichier est une chaîne Python contenant du JavaScript/Astro réel. L’aperçu et l’export utilisent **la même** variable `student_files`. Conservez les exports nommés et les signatures; un changement hors contrat doit être examiné plutôt que remplacé silencieusement." ], "id": "m1-4" }, { "cell_type": "code", "metadata": {}, "source": [ "student_files = {}\n", "student_files['interaction-state.js'] = r'''/** Module 1: input changes state; rendering is supplied by the host. */\n", "export const interactionOptions = { keyboardStep: 0.04 }; // STUDENT: compare 0.04 and 0.08.\n", "export function createInteraction(element, onChange, options = interactionOptions) {\n", " if (!(options.keyboardStep > 0 && options.keyboardStep <= 0.25)) throw new Error('Keyboard step outside the learning limits.');\n", " const lifetime = new AbortController();\n", " let state = { id: 'element-1', phase: 'idle', position: { x: 0.5, y: 0.5 }, lastEvent: 'ready', pointerId: null };\n", " const copy = () => ({ ...state, position: { ...state.position } });\n", " const publish = (event) => { state.lastEvent = event; onChange(copy()); };\n", " const position = (event) => {\n", " const rect = element.getBoundingClientRect();\n", " return { x: Math.max(0, Math.min(1, (event.clientX - rect.left) / Math.max(1, rect.width))),\n", " y: Math.max(0, Math.min(1, (event.clientY - rect.top) / Math.max(1, rect.height))) };\n", " };\n", " const listen = (name, run) => element.addEventListener(name, run, { signal: lifetime.signal });\n", " listen('pointerdown', (event) => {\n", " if (event.button !== 0 || state.pointerId !== null) return;\n", " // Native buttons remain clickable. The host can put them outside this area.\n", " if (event.target.closest?.('a,button,input,select,textarea')) return;\n", " state = { ...state, phase: 'held', pointerId: event.pointerId, position: position(event) };\n", " element.setPointerCapture(event.pointerId); element.focus({ preventScroll: true }); publish('pointerdown');\n", " });\n", " listen('pointermove', (event) => {\n", " if (state.pointerId !== event.pointerId) return; // Crossing an airborne item does not stop it.\n", " state.position = position(event); publish('pointermove');\n", " });\n", " const finish = (event, cancelled) => {\n", " if (state.pointerId !== event.pointerId) return;\n", " const pointerId = state.pointerId;\n", " state.phase = cancelled ? 'cancelled' : 'released'; state.pointerId = null;\n", " if (element.hasPointerCapture(pointerId)) element.releasePointerCapture(pointerId);\n", " publish(cancelled ? 'pointercancel' : 'pointerup');\n", " };\n", " listen('pointerup', (event) => finish(event, false));\n", " listen('pointercancel', (event) => finish(event, true));\n", " listen('lostpointercapture', (event) => finish(event, true));\n", " listen('keydown', (event) => {\n", " const directions = { ArrowLeft: [-1, 0], ArrowRight: [1, 0], ArrowUp: [0, -1], ArrowDown: [0, 1] };\n", " if (directions[event.key]) {\n", " event.preventDefault(); const [dx, dy] = directions[event.key];\n", " state.position = { x: Math.max(0, Math.min(1, state.position.x + dx * options.keyboardStep)),\n", " y: Math.max(0, Math.min(1, state.position.y + dy * options.keyboardStep)) };\n", " state.phase = 'keyboard'; publish(event.key);\n", " } else if (event.key === 'Escape') {\n", " if (state.pointerId !== null) finish({ pointerId: state.pointerId }, true);\n", " }\n", " });\n", " return { snapshot: copy, dispose() { lifetime.abort(); if (state.pointerId !== null && element.hasPointerCapture(state.pointerId)) element.releasePointerCapture(state.pointerId); state.pointerId = null; } };\n", "}\n", "'''\n", "# Modifiez le texte ci-dessus, puis réexécutez cette cellule et l’aperçu." ], "outputs": [], "execution_count": null, "id": "m1-5" }, { "cell_type": "code", "metadata": {}, "source": [ "PREVIEW_TEMPLATE = '\\n\\n

Une variable à la fois. Gardez votre prédiction visible dans le notebook.

\\n\\n
\\n

\\n

\\n'\n",
        "PREVIEW_CODE_TEXT = 'if not reflection[\\'prediction\\'].strip():\\n    raise ValueError(\\'Écrivez votre prédiction avant l’essai, puis exécutez cette cellule à nouveau.\\')\\nfor name, source in student_files.items():\\n    if not isinstance(source, str) or len(source.encode(\\'utf-8\\')) > 200_000:\\n        raise ValueError(\\'Fichier élève trop gros ou non textuel.\\')\\npreview_document = PREVIEW_TEMPLATE.replace(\\'__STUDENT_FILES__\\', json.dumps(student_files, ensure_ascii=False).replace(\\'<\\', r\\'\\\\u003c\\'))\\nencoded = base64.b64encode(preview_document.encode(\\'utf-8\\')).decode(\\'ascii\\')\\ndisplay(HTML(\\'\\'))\\nprint(\\'Aperçu navigateur du code dans student_files. Ce résultat n’est pas une compilation Astro ni un appel WebMCP certifié.\\')\\n'\n",
        "INTEGRATION_TEXT = '# Raccordement — module 1\\n\\n- `src/learning/module-1/interaction-state.js`\\n\\nCes fichiers proviennent de votre variable student_files; aucun corrigé ne remplace le code à l’export.\\nConservez identifiants, coordonnées normalisées, dt en secondes et fonctions de nettoyage.\\nL’aperçu n’est pas une compilation Astro, un appel WebMCP réel ni une mesure de performance Three.js.\\nLa remise reste sélectionnée par vous. Sanity ne reçoit rien de ce notebook.\\nLe notebook.ipynb exporté conserve le code et le bilan pour reprise, sans prétendre capturer l’exécution indépendante.\\n\\nTransfert : Réutilisez les états dans une carte déplaçable, avec clavier et annulation.\\n'"
      ],
      "outputs": [],
      "execution_count": null,
      "id": "m1-6"
    },
    {
      "cell_type": "code",
      "metadata": {},
      "source": [
        "if not reflection['prediction'].strip():\n",
        "    raise ValueError('Écrivez votre prédiction avant l’essai, puis exécutez cette cellule à nouveau.')\n",
        "for name, source in student_files.items():\n",
        "    if not isinstance(source, str) or len(source.encode('utf-8')) > 200_000:\n",
        "        raise ValueError('Fichier élève trop gros ou non textuel.')\n",
        "preview_document = PREVIEW_TEMPLATE.replace('__STUDENT_FILES__', json.dumps(student_files, ensure_ascii=False).replace('<', r'\\u003c'))\n",
        "encoded = base64.b64encode(preview_document.encode('utf-8')).decode('ascii')\n",
        "display(HTML(''))\n",
        "print('Aperçu navigateur du code dans student_files. Ce résultat n’est pas une compilation Astro ni un appel WebMCP certifié.')"
      ],
      "outputs": [],
      "execution_count": null,
      "id": "m1-7"
    },
    {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
        "## 3. Expliquer et exporter — 10 min\n",
        "Comparez prédiction et observation. Expliquez une ligne ou une décision avec vos mots. Indiquez votre aide reçue, une limite et une prochaine question.\n",
        "\n",
        "**Transfert proposé :** Réutilisez les états dans une carte déplaçable, avec clavier et annulation.\n",
        "\n",
        "Le bilan de 30 minutes qui suit cette activité sert à choisir ce que vous remettez à l’enseignant et à préparer sa revue. Un ZIP valide ou une empreinte ne prouve pas une maîtrise."
      ],
      "id": "m1-8"
    },
    {
      "cell_type": "code",
      "metadata": {},
      "source": [
        "reflection['observations'] = []\n",
        "reflection['explanation'] = ''\n",
        "reflection['assistance'] = ''  # Écrivez aussi « aucune » si pertinent.\n",
        "reflection['limitations'] = ''\n",
        "reflection['openQuestion'] = ''"
      ],
      "outputs": [],
      "execution_count": null,
      "id": "m1-9"
    },
    {
      "cell_type": "code",
      "metadata": {},
      "source": [
        "# Faites votre bilan avant de rendre. Les observations sont déclarées par vous.\n",
        "required = ['prediction', 'explanation', 'assistance', 'limitations']\n",
        "if any(not isinstance(reflection.get(key), str) or not reflection[key].strip() for key in required):\n",
        "    raise ValueError('Complétez prédiction, explication, aide reçue (ou aucune) et limite avant le rendu.')\n",
        "if not reflection.get('observations'):\n",
        "    raise ValueError('Conservez au moins une observation sélectionnée.')\n",
        "if any(len(str(value)) > 12000 for value in reflection.values()):\n",
        "    raise ValueError('Le bilan est trop long; sélectionnez les éléments utiles, pas toute la conversation.')\n",
        "attempt_id = 'module-' + str(MODULE_ID) + '-' + str(time.time_ns())\n",
        "artifacts = []\n",
        "export_files = {}\n",
        "for name, source in student_files.items():\n",
        "    if not re.fullmatch(r'[A-Za-z0-9_.-]+\\.(js|astro)', name):\n",
        "        raise ValueError('Chemin frontend non autorisé : ' + name)\n",
        "    raw = source.encode('utf-8')\n",
        "    if len(raw) > 200_000:\n",
        "        raise ValueError('Brique trop volumineuse.')\n",
        "    path = 'frontend/' + name\n",
        "    export_files[path] = raw\n",
        "    artifacts.append({'id': 'module-' + str(MODULE_ID) + '-' + name, 'path': path, 'content': source,\n",
        "                      'mediaType': 'text/plain', 'sha256': hashlib.sha256(raw).hexdigest()})\n",
        "result = {'schemaVersion': 'orbit-learning-colab-v1', 'missionId': MISSION_ID, 'moduleId': MODULE_ID,\n",
        "          'attemptId': attempt_id, 'parameters': parameters, **reflection,\n",
        "          'status': 'external-declared', 'artifacts': artifacts,\n",
        "          'verification': {'sourceCaptured': True, 'independentExecutionVerified': False,\n",
        "                           'humanApproval': False, 'masteryCertified': False}}\n",
        "export_files['orbit-learning-result.json'] = json.dumps(result, ensure_ascii=False, indent=2, allow_nan=False).encode('utf-8')\n",
        "export_files['INTEGRATION.md'] = INTEGRATION_TEXT.encode('utf-8')\n",
        "\n",
        "# Copie rejouable de votre code effectif, non une capture certifiée des sorties du navigateur.\n",
        "def cell(kind, source):\n",
        "    value = {'cell_type': kind, 'metadata': {}, 'source': source.splitlines(True)}\n",
        "    if kind == 'code': value.update(outputs=[], execution_count=None)\n",
        "    return value\n",
        "record = {'nbformat': 4, 'nbformat_minor': 5,\n",
        "          'metadata': {'kernelspec': {'display_name': 'Python 3', 'language': 'python', 'name': 'python3'},\n",
        "                       'orbit': {'kind': 'source-capture-replay', 'notIndependentExecutionProof': True}},\n",
        "          'cells': [cell('markdown', '# Mon rendu — module ' + str(MODULE_ID) + '\\nCode capturé depuis student_files; observations déclarées. Les sorties navigateur ne sont pas archivées automatiquement.'),\n",
        "                    cell('code', 'from IPython.display import HTML, display\\nimport base64, json\\nstudent_files = ' + repr(student_files) + '\\nreflection = ' + repr(reflection) + '\\nparameters = ' + repr(parameters)),\n",
        "                    cell('code', 'PREVIEW_TEMPLATE = ' + repr(PREVIEW_TEMPLATE) + '\\n' + PREVIEW_CODE_TEXT),\n",
        "                    cell('markdown', 'Revue : reformuler une décision, refaire un essai et tenter un transfert.') ]}\n",
        "export_files['notebook.ipynb'] = json.dumps(record, ensure_ascii=False, indent=2).encode('utf-8')\n",
        "manifest = {'schemaVersion': 'orbit-learning-artifact-bundle-v1', 'missionId': MISSION_ID,\n",
        "            'attemptId': attempt_id, 'status': 'external-declared',\n",
        "            'files': [{'path': path, 'sha256': hashlib.sha256(raw).hexdigest()} for path, raw in sorted(export_files.items())]}\n",
        "export_files['manifest.json'] = json.dumps(manifest, ensure_ascii=False, indent=2).encode('utf-8')\n",
        "archive_buffer = io.BytesIO()\n",
        "# ZIP_STORED makes the bounded browser import possible without an extra decompression dependency.\n",
        "with zipfile.ZipFile(archive_buffer, 'w', compression=zipfile.ZIP_STORED) as archive:\n",
        "    for path, raw in sorted(export_files.items()):\n",
        "        archive.writestr(path, raw)\n",
        "filename = 'orbit-module-' + str(MODULE_ID) + '-' + attempt_id + '.zip'\n",
        "Path(filename).write_bytes(archive_buffer.getvalue())\n",
        "try:\n",
        "    from google.colab import files\n",
        "    files.download(filename)\n",
        "except ImportError:\n",
        "    print('Fichier prêt dans le répertoire du notebook :', filename)\n",
        "print(json.dumps({'state': 'EXPORTED_DECLARED_WORK', 'moduleId': MODULE_ID,\n",
        "                  'files': len(export_files), 'sha256': hashlib.sha256(archive_buffer.getvalue()).hexdigest()}))"
      ],
      "outputs": [],
      "execution_count": null,
      "id": "m1-10"
    }
  ]
}