Annexe – Installation et maintenance

Cette annexe s'adresse à la personne qui administre le serveur.

  • Application PHP 8.1 ou supérieur, sans dépendance externe ; base SQLite (par défaut) ou MySQL / MariaDB.
  • Configuration : copier config.dist.php en config.php (base de données, fuseau horaire, nombre de tâches par jour et délai d'échéance par défaut).
  • Installation de la base et du premier compte enseignant (administrateur) : php bin/install.php prof motdepasse Prénom Nom.
  • Les comptes des autres enseignants se créent ensuite dans l'application (Administration › Enseignants) ; la même commande reste possible en ligne de commande.
  • Moteur quotidien (cron) : 45 6 * * * php /var/www/bacagora/bin/tick.php.
  • Après une mise à jour du code, la base est mise à niveau automatiquement au premier accès (ou par php bin/migrate.php).
  • Sauvegarde cohérente de la base SQLite, même pendant l'utilisation : php bin/backup.php fichier.sqlite.
  • Vérification après une modification : php bin/test-simulation.php 30.
  • Export du référentiel en JSON : php bin/referentiel-json.php [--sans-exercices] [fichier.json].

Simulateur DPAE : le serveur télécharge la liste des services de santé au travail depuis l'open data de l'Urssaf (jeu sst_dpae) et la conserve 7 jours dans var/sst_dpae.json (nouvel essai 6 heures après un échec) ; le dossier var/ doit donc être accessible en écriture. Si le serveur n'a pas accès à open.urssaf.fr, téléchargez le fichier CSV ou JSON (data.gouv.fr, « Services de prévention et de santé au travail (SPST) ») et indiquez son chemin dans config.php : 'sst_url' => 'var/sst_dpae.csv'. Avec 'sst_urssaf' => false, aucun appel réseau n'est fait (services fictifs, un par département).

Plusieurs établissements : un même code peut servir de nombreux établissements, chacun avec sa propre base et ses comptes, à l'adresse https://\<etab>.\<domaine>/. Les scripts de création, de mise à jour et de sauvegarde sont dans deploy/multi-instance (voir MULTI-INSTANCE.md).

Le fichier README fourni avec l'application détaille l'installation dans un conteneur LXD et l'ajout d'une nouvelle organisation.

Connexion par l'ENT et console d'administration. La connexion par l'ENT (Authentik : groupes \<code>:bacagora:eleve|prof|admin, liens d'inscription) est décrite dans deploy/authentik/SSO.md. La console d'administration (création des lycées et des pools, suivi des établissements et des serveurs) a son propre LISEZMOI.md.


← Conseils pédagogiques et questions fréquentes · Sommaire