📝 Versionnage de documents dans Brainframe

"Suivez chaque changement, gardez l’historique complet."
Du brouillon à la version approuvée, Brainframe enregistre tout.

Tous les documents nouvellement créés commencent en mode Brouillon. À chaque sauvegarde, Brainframe enregistre une entrée d’historique horodatée.

1️⃣ Attribuer une version

Convertissez un brouillon en document versionné :

1. Ouvrez le document dans la Vue Document.
2. Cliquez sur Attribuer une version dans la barre supérieure.
3. Saisissez le nouveau numéro de version en utilisant le format x.y.z (ex. : 1.2.0) et enregistrez.

2️⃣ Règles de versionnage (SemVer)

Brainframe utilise le versionnage sémantique :

• x – MAJEUR : Premières versions finalisées ou réécritures complètes.
• y – MINEUR : Mises à jour rétrocompatibles (ajouts d’explications, petites fonctionnalités).
• z – PATCH : Corrections mineures (fautes de frappe, liens, mise en forme).

3️⃣ Marquer comme relu (sans changement de contenu)

Suivez une relecture sans créer de nouvelle version :

1. Ouvrez l’onglet Activités.
2. Activez Marquer cette version du document comme relue.
3. Enregistrez.

📌 Cela met à jour la date de relecture/suivi d’ancienneté sans modifier la version.

4️⃣ Approbations après attribution de version

Si le type de document a un workflow d’approbation configuré :

• Après l’attribution d’une version, les étapes du workflow (ex. : Relecture, Approuver/Rejeter) apparaissent.
• Utilisez Approuver ou Rejeter pour avancer dans les étapes configurées.

5️⃣ Consulter et comparer les révisions

L’onglet Révisions vous donne une traçabilité complète :

1. Consultez l’historique complet des versions (qui a modifié/approuvé quoi et quand).
2. Sélectionnez n’importe quelle version précédente pour voir son contenu. Utilisez Afficher les changements pour mettre en évidence les différences entre versions. Disponible uniquement pour les documents créés avec l’Éditeur standard.

6️⃣ Bonnes pratiques

• 🔄 Utilisez les marques de relecture pour les vérifications périodiques sans modification de contenu.
• 🚨 Soyez cohérents avec SemVer afin que votre équipe comprenne le type de mise à jour.
• 📝 Ajoutez des notes de version claires pour expliquer pourquoi les changements ont été faits.
• 👀 Comparez régulièrement les révisions pour suivre les modifications subtiles.
• ✅ Associez les approbations aux versions pour une traçabilité complète.

🎯 Checklist

• [x] Version attribuée en utilisant SemVer
• [x] Marque de relecture utilisée sans changement de contenu
• [ ] Workflow d’approbation complété
• [ ] Historique des révisions vérifié et comparé
• [ ] Notes de version documentées pour préparation à l’audit

Mis à jour le : 11/09/2025