Wiki - Schémas Draw.io

Édition, versioning et partage de schémas Draw.io intégrés au wiki ISI-APP.

Description

Le module permet à chaque utilisateur de créer et maintenir des schémas graphiques (diagrammes réseau, processus, architectures…) directement dans ISI-APP, sans outil externe. Les schémas s'insèrent dans le même écosystème que le wiki : droits, partages entre tenants, restrictions par profil/entité, Super Limits.

Accès

• Menu : Wiki → Schémas
• Module : Wiki (ID 14170101) — nécessite le droit d'accès correspondant
• URLs :
  • /schemas — liste
  • /schemas/{id}/edit — éditeur Draw.io (propriétaire)
  • /mod/14210101/update/{id} — fiche / modification (propriétaire)
  • /mod/14210101/see/{id} — fiche de consultation (schémas partagés / non-propriétaire)

Fonctionnalités

Création et édition

• Créer un schéma : bouton Nouveau schéma → formulaire de métadonnées (titre, description en éditeur riche, restrictions d'accès et partage) → éditeur Draw.io embarqué
• Description : champ optionnel en éditeur riche (mise en forme, liens, images), identique en création et en modification
• Éditer : l'éditeur sauvegarde automatiquement toutes les X secondes (autosave)
• Sauvegarder : génère une nouvelle version (PNG + SVG + PDF automatiques)
• Dupliquer : copie le schéma sans hériter de ses partages ni de sa Super Limit
• Supprimer / Archiver : soft delete via le bouton standard du sidebar generic-form (le schéma reste récupérable)

Fiche schéma

La fiche du schéma vit sur /mod/14210101/update/{id} (module generic-form). Elle propose :

• Sidebar : miniature PNG, statut Super Limit, boutons d'action (Éditer / Partages / Exporter PNG-SVG-PDF / Dupliquer), Archiver, historique d'activité.
• Onglet Modification : formulaire des métadonnées (auto-généré).
• Onglet Historique : tableau des versions avec restauration vers l'éditeur.

Pour les schémas partagés par un partenaire, l'utilisateur arrive sur /mod/14210101/see/{id} (fiche de consultation read-only avec exports PNG/SVG/PDF). La redirection est automatique côté ctlbefore.

Versioning

Chaque sauvegarde crée une nouvelle version avec son propre XML, sa miniature PNG, son SVG et son PDF. La version courante est celle affichée par défaut dans la liste et la fiche.

Affichage

• Vue cards (par défaut, 12 items/page) : miniatures PNG de la version courante
• Vue table (10 items/page) : colonnes ID, Aperçu, Nom, Auteur, Version, Date création, Date modification
• Filtres : recherche nom, version, auteur, plage de dates
• Tri : nom, date création, date modification

Aperçu rapide (preview)

Un clic sur le titre ou la miniature d'un schéma (vue cards ou table) ouvre un aperçu en modale : image PNG plein format, badge version, auteur, dates de création et de modification. La modale ne charge pas le XML du diagramme (payload léger).

Pour accéder à la fiche complète (/mod/14210101/update/{id} ou /mod/14210101/see/{id}), passer par le menu d'actions (⋮) → Voir le schéma.

Partages

• Partage public : activer blshare pour rendre le schéma visible par d'autres tenants
• Restriction de partage : limiter à une liste explicite de tenants (blshare_limit)
• Super Limits : restreindre aux entités / profils / groupes spécifiés

Export

Depuis la fiche d'un schéma, l'utilisateur peut télécharger le fichier dans les formats :

• PNG (image)
• SVG (vectoriel)
• PDF (document)

Droits

Intégration avec le wiki

Les schémas apparaissent en UNION avec les wikis classiques dans les listes transverses :

• Mes documents
• Documents partenaires
• Documents Isi-APP

Un schéma partagé par un partenaire est visible au même titre qu'un wiki partagé, avec sa miniature PNG en aperçu.

Documentation technique

Voir .claude/technical-docs/wiki/wiki-drawio.md pour l'architecture, les scopes Eloquent, les patterns et les points d'attention développeurs.