Portail d'enseignement

E Suong
E Suong

Explorer les ressources

Accueil

Documentation technique

Tests et maintenance

Fiche de référence du code : fonctionnement, formats et limites. La disponibilité publique dépend de la version publiée.

Sommaire de la fiche

État public de référence au 29 octobre 2026 : 3acbb8d, neuf jeux de stratégie publiés, dont Shogi et Mini Shogi. Les bilans de tests datés à sept ou huit jeux restent historiques. La phase 1 comptes/barème n’est pas déclarée publiée par cette fiche ; les fonctions élèves/classes et nouveaux jeux restent bêta.

Choisir les vérifications

Changement Vérifications pertinentes
Catalogue et fichiers catalogue.test, resource-files.test, unavailable-resource.test
Composition et tags page-blocks.test, resource-tags.test, recasages.test
Descriptions et mathématiques description.test puis aperçu navigateur
Actualités home-news.test
Sécurité security.test ; recettes HTTP sur une copie isolée
Juniper Green juniper-green.test puis aide verte, annulation et victoire au navigateur
Méta Morpion meta-morpion.test puis contrainte de grille, clôture, annulation et clavier au navigateur
Jeu du moulin morris.test puis pose, capture, annulation, déplacement, limite et clavier au navigateur
Service 1v1 des neuf jeux de la branche online-rooms.test et online-games.test ; tests/online-all-http-smoke.mjs sur instance de test ; recette à deux appareils du guide de déploiement (DEPLOIEMENT_JEUX.md)
Reversi reversi.test et online-rooms.test ; recette locale habituelle, puis deux onglets : invitation, réglages hôte, coups, consentement, reconnexion et fermeture. Recette HTTP dédiée : tests/online-http-smoke.mjs sur une instance de test
Petits carrés dots-and-boxes.test puis fermeture double, rejouer et annulation au navigateur
Hex hex.test puis partie navigateur, échange et chemin gagnant
Escape Game Compilation et recette du prototype (outils/ESCAPE_GAME.md) : dossiers, lecteurs, carte, aide, sauvegarde et import invalide ; escape-game.test.mjs pour chemins, commandes, découverte et sauvegardes
L Game l-game.test puis partie dans le navigateur
Empilement de caisses crane.test, crane-extra.test et ln*.test puis convoyeurs, caisse_dessous, jeter, pause/pas à pas, arrêt/reprise et saisie au navigateur
Labyrinthe spirale spiral.test et ln*.test ; capteurs, sortie, pause/pas à pas et nouveau labyrinthe et vitesses ×5/×10 au navigateur
LN ln.test, ln-highlight.test, ln-stylo.test
Barème bareme.test, bareme-grid.test
Transfert/statistiques des boîtes boxplot-state.test
Gestion du stockage local-data.test
Rekasator rekasator.test

Ces fichiers sont dans tests (../tests), avec suffixe .mjs. Lancer par exemple :

node --test tests/resource-tags.test.mjs
npm test
npm run build

npm test exécute les fichiers *.test.mjs, pas toutes les recettes HTTP. Les tests de catalogue utilisent des dossiers temporaires ; d’autres tests, notamment ceux de sécurité, font des calculs plus coûteux. Lire le test avant de le lancer contre un état utilisé.

tests/http-smoke.mjs attend un serveur et TEST_ADMIN_PASSWORD ; TEST_URL change l’adresse. tests/production-smoke.mjs démarre un serveur compilé distinct sur 4322 avec sa propre configuration de sécurité. Ne pas conclure que toutes les données sont isolées pour autant : lire la recette sélectionnée, notamment avant les contrôles upload/composition/sécurité qui peuvent écrire.

Contrôles manuels

Tester bureau et mobile, navigation au clavier, niveau public et niveau requis, messages d’erreur et rechargement. Pour une application : vérifier le calcul ou l’interaction, pas seulement HTTP 200. Pour un export PDF : inspecter le document obtenu. Pour un lien externe : vérifier le fichier cible, pas seulement l’existence du partage.

Diagnostic courant

  • Changement de dossier invisible : titre déclaré dans _rubrique.json ou index non actualisé.
  • Édition refusée : fiche invalide, révision périmée, URL incorrecte ou conflit d’écriture.
  • Fichier inaccessible : niveau/date, unavailable, fichier absent, catalogue périmé.
  • Connexion impossible : vérifier la présence de .env et les noms des variables, sans afficher les secrets.
  • Sauvegarde navigateur absente : origine/profil/appareil différent ou stockage bloqué.
  • Page Python en erreur de rendu : vérifier les accolades interprétées par Astro.
  • Iframe vide : diagnostiquer la cible externe, pas uniquement la page locale.

Limites et travaux ouverts au 26 octobre 2026

  • Exerciseurs, QCM et Jeu d’enquête sont des pages d’attente. Escape Game dispose d’un prototype interactif (outils/ESCAPE_GAME.md), sans énigmes complètes ni dénouement. Les neuf jeux de stratégie, dont Reversi, Shogi et Mini Shogi, et les deux défis algorithmiques sont disponibles : voir l’état des jeux (JEUX.md).
  • Les intégrations GeoGebra restent à vérifier visuellement après les erreurs de l’audit.
  • Des contenus Lycée référencent encore les outils/images/notebooks de l’ancien site.
  • Les liens externes publics ne sont pas rendus privés par le contrôle du portail.
  • Le gestionnaire de données locales ne couvre pas encore LN.
  • Le runner Python et Basthon dépendent de téléchargements externes.
  • Aucun mécanisme multi-instance ni synchronisation des feuilles de barème par compte.
  • La validité HTTP des programmes scolaires ne garantit pas leur actualité pédagogique.

Les rapports AUDIT_..., CORRECTIONS_... et RAPPORT_IMPORT_... à la racine sont datés. Ne pas utiliser un rapport ancien comme preuve qu’un problème persiste ou est résolu aujourd’hui.

Mettre la documentation à jour

Lorsqu’une fonctionnalité change, mettre à jour sa fiche avec les formats, conventions, limites et tests. Mettre à jour l’index si un outil apparaît/disparaît. Signaler un état « à venir » ou « non vérifié » explicitement. Les agents doivent lire ces documents avant d’intervenir ; voir AGENTS.md (../AGENTS.md).

Sept jeux à distance — 27 octobre 2026

Voir la fiche du service pour configuration, tests et limites. Les neuf jeux ont également un mode distant. Le serveur public et son proxy, une charge simultanée réelle et la reprise durable après redémarrage ne sont pas validés/implémentés par cette livraison.

Extension aux six autres jeux : 191 tests réussis et compilation réussie. Les recettes HTTP/SSE des sept jeux passent sur le développement et le serveur compilé, y compris avec des en-têtes HTTPS simulés. Recettes navigateur décrites dans la fiche distante. Les variables de capacité/délais se lisent au démarrage ; redémarrer termine toutes les parties.

Alternance des revanches (27 octobre 2026) : 200 tests passent, dont 23 dans online-games.test.mjs ; compilation réussie. La recette HTTP/SSE des sept jeux vérifie deux revanches et le camp autorisé, sur développement et serveur compilé isolé. Reversi et Hex contrôlés aussi dans deux onglets. Détails et distinction rôle/camp dans Jeu à distance.

Shogi (chantier isolé) : tests/shogi.test.mjs, tests/shogi-migration.test.mjs et extension des tests de salons aux huit jeux. Avant livraison, suivre la recette Shogi et migration ciblée ; ne pas recopier Ressources depuis le worktree. Les préférences visuelles du Shogi sont personnelles, contrairement aux aides partagées de Reversi/Juniper.

Mini Shogi (bilan historique de préparation, depuis publié) : 236 tests réussis, compilation réussie ; mini-shogi.test.mjs, mini-shogi-migration.test.mjs et tests communs de salons étendus. Refactoring partagé : les 15 tests du Shogi classique restent indispensables. Recette et limites : livraison Mini Shogi (LIVRAISON_MINI_SHOGI.md).

← Retour à la documentation