Chapitre 11

Environnement de démonstration

Installer une plateforme de démonstration avec des données fictives, la remettre à zéro, et ce qu'il ne faut jamais faire sur une plateforme réelle.

Concerne :Équipe technique

Une plateforme de démonstration s'installe exactement comme une plateforme réelle (Installation), avec trois réglages en plus. Elle sert aux présentations et aux formations.

Données de démonstration#

Avec DEMO_DONNEES=true et un DEMO_MOT_DE_PASSE, l'application charge au démarrage un jeu de données entièrement fictif : organisations, écoles, subventions, micro-projets, environ 300 activités sur l'année en cours, environ 200 rapports, évaluations, indicateurs, messages, bonnes pratiques et ressources. Les statuts (activités en retard, rapports en attente) sont calculés par rapport au jour du chargement.

Le chargement n'a lieu que si la base ne contient encore aucune organisation. Le journal de l'application le signale par un avertissement Données de démonstration FICTIVES chargées.

Comptes de démonstration (mot de passe DEMO_MOT_DE_PASSE, sauf l'administrateur) :

Compte	Rôle
`ADMIN_EMAIL` (par exemple `admin@demo.read`)	Administrateur initial, mot de passe `ADMIN_MOT_DE_PASSE` (créé comme sur une plateforme réelle)
`gestion@demo.read`	Équipe projet (gestion)
`odr@demo.read`	Organisation
`comite@demo.read`	Comité communal
`partenaire@demo.read`	Partenaire institutionnel

Réglages propres à la démonstration dans /opt/read/.env :

Variable	Valeur
`DEMO_DONNEES`	`true`
`DEMO_MOT_DE_PASSE`	8 caractères au moins, dont un chiffre
`DEMO_AFFICHER`	`true` : bandeau « Données de démonstration fictives » sur toutes les pages
`DEMO_COMPTES_PROTEGES`	`true` : un visiteur ne peut ni changer le mot de passe d'un compte `…@demo.read` (profil, mot de passe oublié, administrateur), ni le modifier, ni le désactiver
`ADMIN_CHANGEMENT_OBLIGATOIRE`	`false` : les comptes partagés ne doivent pas exiger un changement de mot de passe

Conseil

Lisez le mot de passe de démonstration sur le serveur sans l'afficher à l'écran d'une présentation, par exemple dans une variable : MDP=$(grep '^DEMO_MOT_DE_PASSE=' /opt/read/.env | cut -d= -f2-).

Remettre la démonstration à zéro#

Après une présentation ou des essais, remettez les données dans leur état de départ :

/opt/read/code/deploy/reinitialiser-demo.sh --confirmer

Le script arrête l'application, recrée une base vide, efface les fichiers déposés et redémarre : le schéma, les référentiels, les comptes et les données fictives sont rechargés (une minute environ). Il refuse de s'exécuter si DEMO_DONNEES ne vaut pas true.

Remarque

Après une remise à zéro, les dates sont recalculées par rapport au jour même : les retards et les échéances restent réalistes.

Ce qu'il ne faut jamais faire sur une plateforme réelle#

Danger

Ne réglez jamais DEMO_DONNEES=true sur une plateforme réelle : sur une base encore vide, des données fictives s'y mêleraient aux vraies.
Ne copiez jamais le fichier .env d'une démonstration vers un serveur réel (mots de passe partagés, bandeau, changement de mot de passe non exigé).
Ne lancez jamais reinitialiser-demo.sh en dehors d'une démonstration : il efface toutes les données.
Ne restaurez jamais une sauvegarde de démonstration sur une plateforme réelle, ni l'inverse.

Une démonstration et une plateforme réelle doivent tourner sur des serveurs distincts (le projet Compose a toujours le même nom, read-plateforme).