Documentation — Schémathèque plomberie

Schémathèque plomberie PRO

Documentation par l'exemple — parcours utilisateur

Outil: rubrique-PB/schemateque.php — Bâti'Tools (compte PRO)
Ce que l'outil propose: Une bibliothèque de schémas de principe plomberie commentés, présentée comme une suite de cartes empilées (titre, image pleine largeur, texte d'explication), maintenue par l'administrateur du site

Contrairement aux autres outils de Bâti'Tools, la schémathèque n'effectue aucun calcul : c'est une ressource documentaire. Tout compte PRO peut la consulter : faire défiler les cartes, chacune montrant un schéma en pleine largeur d'écran (pour rester lisible sans zoomer, même sur un schéma détaillé) accompagné de son titre et d'un texte explicatif. Seul le compte administrateur du site peut ajouter, modifier, réordonner ou supprimer une carte ; les outils d'édition n'apparaissent tout simplement pas pour les autres comptes PRO.

O1 — Consultation (compte PRO standard)

Ce que voit un compte PRO qui n'est pas administrateur.

Comportement observé

Affichage: Une suite de cartes, chacune avec son titre, son image en pleine largeur, et son texte d'explication (si renseigné)
Carte sans image: Un bandeau « Image absente » remplace l'image si aucun fichier n'est associé à la carte, ou si le fichier référencé n'existe plus sur le serveur
Carte sans texte: Le bloc de texte d'explication n'apparaît simplement pas si aucun texte n'a été saisi pour cette carte
Aucune carte publiée: « Aucun schéma pour le moment. »
Outils d'édition: Absents : ni bouton d'ajout, ni bouton de modification, de déplacement ou de suppression

O2 — Ajout d'une carte (compte administrateur)

Un volet « Ajouter une carte », dépliable, apparaît en haut de page pour l'administrateur seul.

Données saisies

Titre: Champ obligatoire (ex. : « Piquage bouclage ECS — stockage primaire »)
Image: Fichier optionnel — formats acceptés : jpg, jpeg, png, webp, gif, svg — 8 Mo maximum
Texte d'explication: Zone de texte libre, optionnelle

Résultat

Nouvelle carte: Ajoutée en dernière position de la liste

✓ « Carte « … » ajoutée. »

O3 — Réorganisation et suppression (compte administrateur)

Chaque carte affiche, pour l'administrateur, une petite barre d'outils sous son texte.

Actions disponibles

▲ Monter: Échange la carte avec celle qui la précède immédiatement dans l'ordre d'affichage — désactivé sur la première carte
▼ Descendre: Échange la carte avec celle qui la suit — désactivé sur la dernière carte
Modifier cette carte: Volet dépliable permettant de changer le titre, le texte, et de remplacer l'image (en laissant le champ vide, l'image actuelle est conservée)
Supprimer: Retire la carte après confirmation (« Supprimer définitivement la carte « … » ? L'image sera effacée du serveur. »)
Repère de position: Chaque carte affiche son numéro d'ordre sur le total (« n^o 3 / 12 »)

✓ « Carte déplacée. » / « Carte « … » modifiée. » / « Carte « … » supprimée. »

Messages d'alerte et d'erreur

Titre manquant: « Le titre est obligatoire. »
Image trop volumineuse: « Image trop volumineuse (maximum 8 Mo). » (ou, selon la configuration du serveur : « Image trop volumineuse pour la configuration du serveur. »)
Format de fichier refusé: « Format refusé. Formats acceptés : jpg, jpeg, png, webp, gif, svg. »
Fichier illisible comme image: « Ce fichier n'est pas une image exploitable. » (ou, pour un SVG : « Ce fichier n'est pas un SVG valide. »)
Échec de l'envoi du fichier: « Échec du transfert de l'image (code …). »
Carte introuvable: « Carte introuvable. » (lors d'une modification, suppression ou déplacement portant sur une carte qui n'existe plus)
Déjà en première ou dernière position: « Carte déjà en première position. » / « Carte déjà en dernière position. »
Action non autorisée: « Action réservée à l'administrateur. » — pour tout compte PRO non-administrateur qui tenterait une action d'édition
Jeton de sécurité invalide: « Échec du contrôle CSRF : action refusée. » — se produit si le formulaire a été soumis depuis une session expirée
Liste momentanément indisponible: « La liste des schémas est momentanément indisponible. » — en cas d'incident de connexion à la base de données