Installation et contribution

Prérequis

Le dépôt privé est fourni aux contributeurs autorisés. Utiliser Node dans une version compatible avec engines de package.json et installer les dépendances avec npm ci. Le verrou npm fait foi. Les dépendances SQLite natives doivent correspondre à l’OS et à Node.

Démarrage local

Lire AGENTS.md, README.md et les fiches des domaines concernés. Travailler dans une branche et un dossier distincts. Préparer une configuration privée à partir du modèle sans reprendre les secrets d’un serveur. Le dépôt de code ne contient pas les documents pédagogiques réels ; utiliser des fixtures de catalogue.

npm ci
npm run catalogue:refresh
npm run dev

Choisir un port libre lorsqu’un autre chantier tourne. Ne pas arrêter son serveur pour libérer un port. Le catalogue se reconstruit depuis les fiches et documents de Ressources/. Une base vide est possible ; les tests fonctionnels doivent disposer de fixtures explicites.

Tests et compilation

Exécuter les tests du domaine modifié, les contrôles de droits, puis npm run build. Le build génère également la documentation publique et les fichiers de l’espace élève. Vérifier les pages au navigateur sur ordinateur et petit écran. Les simulations ne remplacent pas une recette sur appareils réels pour les fonctions qui en dépendent.

Livrer

Fournir commit, tests exécutés, limites, migrations et documentation. La bêta et la production sont deux installations avec données et secrets distincts. Publier demande une autorisation pour l’environnement concerné. Préparer sauvegarde et retour arrière, conserver les données courantes, puis vérifier après activation. Un redémarrage peut interrompre les parties en mémoire.

Documentation et versions

Les fiches publiques sont choisies explicitement dans src/data/public-documentation.mjs. scripts/build-public-documentation.mjs fabrique leurs versions lisibles et remappe les liens connus. Ne jamais ajouter de journal privé, de procédure contenant des identifiants de serveur ou de secret à cette liste.

src/data/site-releases.mjs sépare publications publiques et travaux en cours. Une publication sur preview ne crée aucune entrée de mise à jour. Après validation puis publication sur le domaine public, ajouter la date réelle, un résumé destiné aux utilisateurs et une référence interne de preuve. Ne pas déduire une date de mise en ligne de la date d’un commit.