# Cycle de vie d'un document Chaque document sur Magma passe par un ensemble défini de statuts, depuis la première importation jusqu'à l'enregistrement permanent sur la blockchain. ## Flux des statuts ``` Importation └─ DRAFT └─ Soumettre pour validation └─ PENDING_VALIDATION ├─ Tous les validateurs approuvent │ └─ VALIDATED ──────────────── Émission ──► MINTED │ └─ Délai écoulé ──► EXPIRED │ └─ Nouvelle version ──► REPLACED └─ Un validateur rejette └─ REQUIRING_ACTION └─ L'importateur corrige et soumet à nouveau └─ CORRECTED → PENDING_VALIDATION (le cycle recommence) ``` ### Cas particuliers * **DUPLICATED** : Le système a détecté que le fichier importé est identique à un fichier déjà validé dans le même type de document * **REVERTED\_TO\_DRAFT** : Les validateurs désignés d'un document soumis ont perdu leur accès au bâtiment (ex. : leur accord a été révoqué). Le document retourne au statut Brouillon afin que de nouveaux validateurs puissent être assignés avant une nouvelle soumission *** ## Descriptions des statuts | Statut | Couleur | Signification | Que faire | | ---------------------------- | ------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | **Brouillon** | Gris | Importé mais pas encore soumis. Seulement vous pouvez le voir. | Soumettez-le quand il est prêt — choisissez vos validateurs et cliquez sur Soumettre | | **En attente de validation** | Orange | Soumis et en attente des votes des validateurs | Attendez les validateurs. Vous serez notifié quand ils agissent. | | **Validé** | Vert | Tous les validateurs configurés l'ont approuvé | Éligible à l'émission. Aucune action requise. | | **Action requise** | Rouge | Au moins un validateur l'a rejeté | Consultez la raison du rejet dans le panneau du document, corrigez le fichier et soumettez à nouveau | | **Corrigé** | — | Une version corrigée a remplacé un document précédemment rejeté | La version corrigée entre en phase En attente de validation | | **Dupliqué** | — | Le contenu du fichier correspond à un document déjà validé | Importez un fichier différent ou contactez le support si c'est une erreur | | **Retourné en brouillon** | Gris | Les validateurs ont été retirés du bâtiment après la soumission | Assignez de nouveaux validateurs et soumettez à nouveau | | **Émis** | Bleu | Enregistré sur la blockchain. Le hash du document est stocké dans HashStorage. | Aucune action supplémentaire requise. Le document est définitivement sur la blockchain. | | **Expiré** | Rouge | La période de validité du document est écoulée | Importez une nouvelle version. Une tâche vous sera assignée à cet effet. | | **Remplacé** | — | Une version plus récente a été validée et la remplace | La version plus récente est maintenant le document actif. L'ancienne version reste dans l'historique des versions. | *** ## Validation multi-niveaux Chaque type de document peut avoir jusqu'à **trois niveaux de validation** : | Niveau | Obligatoire ? | Notes | | --------------------- | ------------------ | --------------------------------------------- | | Validateur principal | Oui (si configuré) | Doit approuver pour que le document progresse | | Validateur secondaire | Si configuré | Doit également approuver | | Validateur tertiaire | Si configuré | Confirmation supplémentaire optionnelle | **Tous les validateurs configurés doivent approuver.** Un seul rejet de n'importe quel validateur renvoie le document en statut Action requise, quel que soit le nombre d'autres approbations. Lorsqu'un validateur rejette, il doit fournir une raison. L'importateur voit cette raison et peut agir en conséquence avant de soumettre à nouveau. *** ## Remplacement de document Lorsque vous devez mettre à jour un document déjà soumis ou validé, vous importez un **remplacement** plutôt qu'un nouveau fichier. Il existe deux types : | Type | Quand l'utiliser | Effet | | ---------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | **Mise à jour totale** | Le document a fondamentalement changé — nouveau contenu, nouvelle version, révision substantielle | L'ancienne version est marquée REPLACED. La nouvelle version entre en phase En attente de validation avec un nouveau cycle. | | **Correction** | Correction mineure — faute de frappe, mise en forme, petite erreur | L'ancienne version est marquée CORRECTED. La nouvelle version entre en phase En attente de validation. | Les deux types nécessitent une **raison** (minimum 5 caractères) expliquant pourquoi le remplacement est effectué. Cette raison est stockée dans le journal d'activité à des fins d'audit. *** ## Périodes de validité des documents Certains types de documents expirent automatiquement après une période définie. Lorsqu'un document expire : 1. Son statut passe à **Expiré** 2. Le score du Magma Index pour la catégorie de ce document est réduit 3. Une tâche **UPDATE\_EXPIRED\_DOCUMENT** est assignée à l'importateur initial 4. La vue d'ensemble du bâtiment et le centre des tâches mettent en évidence le document expiré | Période de validité | Documents | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | **1 an** | Assurance du bâtiment, Statut hypothécaire, Comptes de résultat, Contrat de services de sécurité, Journal de sécurité | | **1 mois** | Taxes foncières, Rapports d'audit, Estimation budgétaire/coûts opérationnels, Plan de sécurité | | **Jusqu'à l'achèvement du bâtiment** | Certificat d'habitation, Estimation du coût de construction | | **Permanent** | Titre, Acte, Registre foncier, et la plupart des documents juridiques, de diagnostic et techniques | *** ## Historique des versions Chaque document conserve un historique complet des versions accessible depuis le panneau d'informations du document. Vous pouvez : * Consulter toutes les versions précédentes avec leurs dates d'importation et leurs statuts * Cliquer sur n'importe quelle version pour basculer vers la consultation de cette version * Voir quelle version est actuellement active (marquée comme principale) * Voir les badges de statut REPLACED et CORRECTED sur les versions obsolètes Le hash cryptographique de chaque version est visible dans le panneau du document et est enregistré sur la blockchain après émission. Cela permet de vérifier le contenu exact de n'importe quelle version historique à tout moment dans le futur. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mymagma.com/magma-documentation/fr/reference/document-lifecycle.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.