← Retour à l’accueil

PowerEduc · Démonstration locale synthétique

Guide du parcours local synthétique

Ce guide présente l’ordre précis d’enchaînement des fonctionnalités réellement livrées dans le socle local PowerEduc : de l’établissement initial jusqu’à l’inscription pédagogique locale et la consultation.

Langue de consultation. Choisir la langue d’affichage du guide et de son aide contextuelle. Une des cinq langues officielles du projet.. La sélection met à jour instantanément tous les libellés sans perte d’état et persiste le choix localement.

Ordre séquentiel obligatoire

Les modules livrés s’appuient sur des dépendances strictes : un programme exige un établissement préalablement enregistré, et une inscription pédagogique exige une classe et un apprenant existants. Suivez les étapes de 01 à 06 dans l’ordre indiqué.

Absence d’autorité commerciale ou financière

Ce guide et les écrans associés fonctionnent exclusivement en mode démonstration locale. Aucune admission scolaire administrative, aucun paiement, aucun droit financier ni aucune attestation officielle ne sont délivrés.

États explicites et données synthétiques

Aucune donnée n’est pré-enregistrée magiquement. Il convient de consulter l’existant via les actions de recherche et de relecture, puis de créer l’élément s’il est absent. Seuls des identifiants et données synthétiques préfixés "synthetic-" doivent être manipulés.

Résumé de l’enchaînement opérationnel

Le parcours local synthétique reproduit fidèlement la persistance serveur en 6 étapes ordonnées :

  • 1. Établissement : initialisation de l’entité racine du tenant dans PostgreSQL.
  • 2. Programme & Cohorte : définition pédagogique versionnée rattachée à l’établissement.
  • 3. Classe & Capacité : ouverture d’un groupe d’apprentissage avec effectif délimité.
  • 4. Apprenant : enregistrement de l’identité synthétique locale.
  • 5. Inscription pédagogique : affectation fictive de l’apprenant dans la classe (sans valeur d’admission scolaire ni contrat financier).
  • 6. Relecture : vérification de la persistance locale des données et rappel des contrôles d’isolation serveur distincts.

Étapes ordonnées du parcours

Chaque étape détaille le rôle requis, les prérequis techniques, l’état initial de la base, l’action concrète à opérer, l’état résultant et le contrôle de conformité à effectuer.

01Fondation requise

Authentification & Création / Relecture de l’établissement

Connectez-vous avec le compte d’administration locale dans l’espace "synthetic-demo-cm". Créez l’établissement fictif (ex. "Lycée de démonstration") ou cliquez sur "Retrouver l’établissement" pour relire une création existante.

Rôle autorisé

synthetic-demo-owner (administrateur local synthétique)

Prérequis

API NestJS locale et base PostgreSQL démarrées.

État initial (avant action)

Consulter l’existant à l’aide du bouton "Retrouver l’établissement" ; si aucun établissement n’est présent dans l’espace, procéder à sa création.

Action à effectuer

Saisir les identifiants locaux, valider la session, puis soumettre la création de l’établissement.

État résultant (après confirmation)

L’établissement est enregistré dans la table des structures avec son identifiant rattaché à l’espace.

Contrôle clé : Le bouton "Retrouver l’établissement" restitue l’entité enregistrée même après rafraîchissement complet.

Ouvrir /demo/etablissement
02Pédagogie — Étape 1

Programme pédagogique, Version & Cohorte

Sur l’interface pédagogique, connectez-vous avec la session locale. Indiquez l’identifiant de l’établissement créé, complétez les libellés multilingues (FR, EN, DE, RU, ES), l’objectif pédagogique et le nom de cohorte.

Rôle autorisé

synthetic-demo-owner (droits d’écriture)

Prérequis

Établissement créé et référencé à l’étape 01.

État initial (avant action)

Consulter les programmes rattachés à l’établissement ; si aucun programme ou cohorte n’existe, procéder à leur création. Une soumission sans établissement existant renvoie une erreur 404 explicite.

Action à effectuer

Cliquer sur "Créer le programme et la cohorte" en utilisant l’identifiant de requête idempotent.

État résultant (après confirmation)

PostgreSQL stocke le programme, sa version V1 et la cohorte liée explicitement à l’établissement.

Contrôle clé : La projection retournée par le serveur affiche le programme, sa version et la cohorte attachée.

Ouvrir /demo/pedagogie
03Pédagogie — Étape 2

Offre de formation & Classe associée

Dès que la cohorte est confirmée, le volet "Offre et classe" s’active. Définissez l’intitulé de l’offre, le libellé de la classe (ex. "Classe de 6ème A"), les dates de l’intervalle et la capacité d’accueil.

Rôle autorisé

synthetic-demo-owner

Prérequis

Cohorte pédagogique confirmée par le serveur (étape 02).

État initial (avant action)

Consulter les classes existantes de la cohorte ; si aucune classe n’est configurée pour accueillir des apprenants, procéder à la création de l’offre et de la classe.

Action à effectuer

Remplir les caractéristiques de l’offre et de la classe puis enregistrer.

État résultant (après confirmation)

L’offre et la classe sont persistées dans PostgreSQL avec leur capacité maximale et leur rattachement à la cohorte.

Contrôle clé : La classe apparaît désormais dans le sélecteur du module d’inscription avec sa capacité configurée.

Accéder au volet Classe
04Apprenant — Étape 1

Fiche apprenant fictif

Dans le volet "Apprenant fictif", renseignez un nom synthétique (ex. "Kouamé Synthetique") et une date de référence. Ne saisissez aucune donnée à caractère personnel réelle.

Rôle autorisé

synthetic-demo-owner

Prérequis

Établissement actif et session ouverte.

État initial (avant action)

Consulter les apprenants enregistrés ; si la fiche recherchée est absente de la base locale, procéder à la création de l’apprenant fictif.

Action à effectuer

Soumettre le formulaire de création de l’apprenant avec un identifiant d’idempotence dédié.

État résultant (après confirmation)

L’apprenant est créé avec un identifiant unique "synthetic-learner-..." conservé dans PostgreSQL.

Contrôle clé : L’identifiant d’apprenant généré est automatiquement reporté dans le module d’inscription pédagogique suivant.

Accéder au volet Apprenant
05Inscription pédagogique

Inscription pédagogique & Affectation en classe (fictive)

Associez l’apprenant fictif à la classe créée. Cette étape enregistre une inscription pédagogique locale fictive, sans valeur d’admission administrative, de paiement, de droit financier ni d’attestation scolaire.

Rôle autorisé

synthetic-demo-owner

Prérequis

Classe créée (étape 03) et apprenant créé (étape 04).

État initial (avant action)

Vérifier les affectations existantes ; si aucune inscription pédagogique n’associe l’apprenant fictif à la classe, procéder à l’enregistrement de l’inscription locale.

Action à effectuer

Sélectionner la classe, vérifier l’identifiant de l’apprenant fictif et enregistrer l’inscription pédagogique locale.

État résultant (après confirmation)

L’inscription pédagogique locale est enregistrée avec l’état technique "confirmed" dans la base PostgreSQL (sans constituer une admission officielle).

Contrôle clé : L’état confirme l’inscription pédagogique locale avec son identifiant synthétique et sa date d’effet, distincte de toute admission administrative.

Accéder au volet Inscription
06Vérification finale

Consultation, Relecture & Persistance locale

Rechargez les structures, puis conservez les identifiants fictifs de l’apprenant et de l’inscription pour les retrouver dans leurs volets respectifs après redémarrage de l’API. L’isolation inter-tenants est un contrôle serveur distinct.

Rôle autorisé

Tout compte authentifié (y compris profil lecteur en consultation seule)

Prérequis

Étapes 01 à 05 exécutées.

État initial (avant action)

L’état en mémoire navigateur doit être confronté à la vérité transactionnelle de la base de données.

Action à effectuer

Cliquez sur "Recharger" dans /demo/pedagogie et "Retrouver" dans /demo/etablissement, puis recherchez l’apprenant et l’inscription avec leurs identifiants conservés.

État résultant (après confirmation)

Les structures sont rechargées depuis PostgreSQL ; les volets dédiés retrouvent l’apprenant fictif et l’inscription pédagogique avec leurs identifiants.

Contrôle clé : Les boutons confirment la persistance locale des enregistrements. L’étanchéité et le rejet des accès inter-tenants sont assurés côté serveur par des contrôles d’autorisation distincts.

Relire la projection consolidée

Garanties d’états explicites

Afin d’assurer la transparence totale du comportement logiciel, chaque écran distingue trois états fondamentaux :

1. Consultation de l’existant avant action

Il convient de consulter l’existant avant toute saisie et de créer les données requises si elles sont absentes. Si vous tentez de recharger un établissement ou un programme absent de la base, l’écran affiche un état vide explicite ou un code 404 circonstancié.

2. État après action (création confirmée)

Le succès n’est affiché qu’après validation effective et retour 201/200 de l’API NestJS. Les identifiants retournés sont générés par le serveur ou sécurisés par des UUID d’idempotence stables.

3. Persistance et relecture post-redémarrage

Toutes les structures et inscriptions pédagogiques sont stockées dans PostgreSQL. Les boutons de rechargement démontrent cette persistance locale, même après arrêt complet des processus.

4. Isolation stricte par espace (tenant)

L’isolation inter-espaces est appliquée côté serveur par des contrôles d’autorisation stricts. Les boutons de consultation démontrent la persistance locale mais ne constituent pas à eux seuls une preuve de rejet inter-tenant, qui est garanti par l’API.

Écran Établissement

Interface pour ouvrir une session administrative, créer la structure racine et relire le graphe d’établissement.

Ouvrir /demo/etablissement

Écran Pédagogie & Inscription locale

Console complète pour le programme, la version, la cohorte, la classe, l’apprenant fictif et l’inscription pédagogique locale.

Ouvrir /demo/pedagogie
Manuel d’utilisation du guide
  • 1. Objectif du guide : Le présent guide documente de façon exhaustive l’ordre d’utilisation et les interactions entre les capacités réelles livrées dans les modules /demo/etablissement et /demo/pedagogie. Il sert de référence pour comprendre la chaîne d’instanciation sans inventer d’automatismes inexistants.
  • 2. Rôles et autorisations : Deux profils synthétiques sont prévus : "synthetic-demo-owner" disposant des droits de création et d’écriture sur le tenant "synthetic-demo-cm", et un compte de consultation disposant des droits de relecture. Aucune autorisation externe ou commerciale n’est accordée.
  • 3. Prérequis d’exécution : L’environnement local doit avoir exécuté "npm ci" et démarré l’API NestJS ainsi que la base PostgreSQL selon la configuration locale du projet (variables d’environnement). Les identifiants doivent être extraits des informations de démonstration locales.
  • 4. Démarrage rapide : Rendez-vous d’abord sur /demo/etablissement pour créer l’établissement racine. Rendez-vous ensuite sur /demo/pedagogie pour dérouler successivement le programme, la cohorte, la classe, l’apprenant fictif et l’inscription pédagogique locale.
  • 5. Procédures détaillées pas à pas : Étape par étape : 1. Se connecter, vérifier l’existant ou enregistrer l’établissement s’il est absent. 2. Utiliser cet identifiant d’établissement sur /demo/pedagogie pour retrouver ou créer le programme et sa cohorte. 3. Consulter ou compléter l’offre et la classe dans le volet apparu. 4. Consulter ou créer l’apprenant fictif. 5. Vérifier ou enregistrer son inscription pédagogique locale dans la classe (fictive, sans admission scolaire). 6. Recharger l’affichage pour attester la persistance (l’isolation faisant l’objet d’un contrôle serveur distinct).
  • 6. Diagnostics et erreurs courantes : Code 401/403 : compte ou mot de passe invalide, session révoquée. Code 404 (missing establishment) : l’établissement n’a pas été créé au préalable sur /demo/etablissement. Code 409 : tentative de créer une structure avec un nom incompatible. Code 503 : service PostgreSQL ou API inaccessible.
  • 7. Périmètre et limites explicites : Ce parcours est une démonstration synthétique fermée. Il n’inclut aucune admission administrative, aucun paiement, aucun droit financier ni aucune attestation officielle. Le statut technique "confirmed" désigne un état d’enregistrement local et ne confère aucun diplôme d’État.
  • 8. Support et traçabilité : Les spécifications de référence sont consignées dans docs/requirements/HIERARCHIE.md, UX-AIDE-ET-FLUIDITE.md et MULTILINGUISME.md.
  • 9. Accessibilité et ergonomie (UX-001 à UX-005) : L’interface privilégie la lisibilité des contrastes, la navigation au clavier avec fermeture Échap des volets et des dimensions interactives adaptées aux écrans compacts, sans prétendre à une conformité auditée WCAG AA ni à une certification formelle.