# Data Room La Data Room est le hub central de gestion documentaire de la plateforme Magma. Elle offre un stockage sécurisé et structuré pour tous les documents liés au bâtiment, avec prise en charge du versionnage des documents, du hachage cryptographique, du partage entre intervenants, des annotations, des flux de validation et du minting blockchain. *** ## Modes d'affichage La Data Room propose deux modes d'affichage, commutables via la barre d'outils : ### Mode étendu (3 colonnes) Vue par défaut. Trois panneaux sont affichés côte à côte : 1. **Panneau gauche** — Navigation par arborescence/liste de documents. 2. **Panneau central** — Lignes de documents pour la catégorie sélectionnée. 3. **Panneau droit** — Panneau d'information du document pour le document sélectionné. Ce mode est idéal pour travailler sur un document spécifique, examiner ses métadonnées et gérer le partage ou la validation. ### Mode compact Le panneau d'information de droite est réduit. Les documents sont affichés dans un format de liste/grille plus large, facilitant la navigation dans de grandes collections sans se concentrer sur un seul document. Cliquer sur une ligne de document ouvre le panneau d'information en superposition ou développe temporairement l'affichage. *** ## Structure de navigation Les documents sont organisés dans une hiérarchie stricte appelée l'**arborescence Magma Index** : ``` Niveau (Genesis / Structure / Architecture / Wired / Filled) └── Catégorie (par ex. Propriété, Juridique, Assurance) └── Définition de document (par ex. Titre de propriété, Registre foncier) └── Sous-dossier IFC (pour les types de documents applicables) ``` ### Vue arborescente Le panneau gauche affiche cette hiérarchie sous forme d'arborescence développable. Cliquer sur un nœud développe ou réduit ses enfants. Cliquer sur un nœud de **définition de document** charge ses documents dans le panneau central. ### Vue liste Une vue plate alternative qui affiche tous les documents de toutes les catégories dans une seule liste déroulante, sans le regroupement hiérarchique. Utile pour parcourir rapidement tous les documents quel que soit le niveau ou la catégorie. ### Sous-dossiers IFC Certaines définitions de documents prennent en charge les fichiers IFC (Industry Foundation Classes). Ces définitions affichent un **sous-dossier IFC** dans l'arborescence de documents. Dans un sous-dossier IFC, deux boutons d'action sont disponibles : * **Ouvrir dans BIM** — Ouvre le fichier IFC dans le [BIM 3D Viewer](/magma-documentation/fr/fonctionnalites/bim-3d-viewer.md). * **Ouvrir dans Scan** — Ouvre le scan associé dans le [Scan Viewer](/magma-documentation/fr/fonctionnalites/scan-viewer.md). *** ## Ligne de document Chaque document est affiché sous forme de ligne dans le panneau central. La ligne contient les éléments suivants : | Élément | Description | | ----------------------- | ----------------------------------------------------------------- | | Icône de statut | Indicateur visuel du statut actuel du document (voir ci-dessous). | | Nom du document | Le nom lisible de la définition du document. | | Version | Le numéro de version actuel (par ex. v1, v2, v3). | | Nom de fichier original | Le nom de fichier réel du fichier téléversé. | | Catégorie | La catégorie du document au sein du Magma Index. | | Taille du fichier | Taille du fichier téléversé. | | Avatar du propriétaire | Photo de profil du téléverseur du document (propriétaire). | | Avatars des validateurs | Photos de profil des validateurs assignés (jusqu'à 3). | | Dernière modification | Horodatage relatif ou absolu de la modification la plus récente. | *** ## Statut des documents Les documents progressent dans un cycle de vie défini, indiqué par un badge de statut : | Statut | Description | | ---------------------------- | ---------------------------------------------------------------------------------------- | | **Brouillon** | Le document a été téléversé mais pas encore soumis pour validation. | | **En attente de validation** | Le document a été soumis et attend la révision du validateur. | | **Validé** | Tous les validateurs assignés ont approuvé le document. | | **Minté** | Le document a été inclus dans un minting DTT® sur la blockchain. | | **Action requise** | Le document nécessite une attention — généralement parce qu'il a été rejeté ou a expiré. | *** ## Panneau d'information du document Sélectionner une ligne de document ouvre le panneau d'information du document sur le côté droit de l'écran (ou en superposition en mode compact). Ce panneau fournit tous les détails du document sélectionné : ### Informations sur le téléverseur * **Avatar**, **nom complet** et **rôle sur la plateforme** du téléverseur (par ex. Architecte, Propriétaire). ### Badges de statut Des badges de statut spéciaux apparaissent le cas échéant : * **REPLACED** — Cette version du document remplace une version antérieure via un remplacement Total Update. * **CORRECTED** — Cette version du document remplace une version antérieure via un remplacement Correction. ### Métadonnées | Champ | Description | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Taille du fichier | Taille du fichier de document actuel. | | Date de téléversement | Date et heure du téléversement du fichier. | | Date de validation | Date à laquelle le document a atteint le statut Validé (le cas échéant). | | Date d'expiration | La date après laquelle la validité du document expire (varie selon le type de document — voir les périodes de validité). | | Hachage du document | Un hachage cryptographique du contenu du fichier. Ce hachage est également stocké sur la blockchain lors du minting et peut être utilisé pour prouver l'authenticité. | ### Journal d'activité récente Un fil chronologique de tous les événements liés à ce document, incluant : * Fichier téléversé * Envoyé pour validation * Validateur approuvé / rejeté * Document remplacé ou corrigé * Document minté * Accès accordé / révoqué ### Liste des utilisateurs autorisés Une liste de tous les intervenants et invités ayant reçu l'accès à ce document spécifique. Chaque entrée affiche : * Avatar et nom de l'utilisateur * Leur rôle ou type d'accès (Intervenant du bâtiment, Invité non enregistré, Utilisateur Magma invité) * Un bouton **Révoquer** pour supprimer immédiatement leur accès ### Historique des versions Une liste de toutes les versions précédentes de ce document, dans l'ordre chronologique inverse. Chaque entrée de version est cliquable et charge les métadonnées et le fichier de cette version. Les versions affichent : * Numéro de version * Date de téléversement * Statut au moment du remplacement * Type de remplacement (Total Update ou Correction) *** ## Filtres et tri ### Recherche Un champ de recherche en texte intégral en haut de la liste de documents. Effectue des recherches dans les noms de documents, les noms de fichiers et les catégories. ### Filtre par statut Filtrez les documents par leur statut actuel : * Brouillon * En attente de validation * Validé * Minté * Action requise Plusieurs statuts peuvent être sélectionnés simultanément. ### Filtre par niveau Filtrez les documents par leur niveau Magma Index : * Genesis * Structure * Architecture * Wired (W1 à W5) * Filled ### Filtre par rôle Basculez entre : * **Mon rôle** — Affiche uniquement les documents pertinents pour votre rôle assigné (par ex. les documents que vous êtes assigné à valider ou que vous avez téléversés). * **Tous** — Affiche tous les documents quel que soit le rôle assigné. ### Options de tri | Tri | Description | | --------------------- | ------------------------------------------------------------------ | | Alphabétique | Trie les documents de A à Z par nom de définition de document. | | Plus récent | Les documents téléversés le plus récemment en premier. | | Plus ancien | Les documents téléversés le plus anciennement en premier. | | Dernière modification | Les documents modifiés ou mis à jour le plus récemment en premier. | *** ## Barre latérale des favoris La barre latérale **Favoris** est un panneau de 312px qui glisse depuis le côté droit de l'écran (indépendamment du panneau d'information). Elle vous permet d'enregistrer et d'accéder rapidement aux documents fréquemment utilisés. * **Mettre un document en favori** — Cliquez sur l'icône de favori sur n'importe quelle ligne de document pour l'ajouter à vos favoris. * **Ouvrir les favoris** — Cliquez sur l'icône de favori dans la barre d'outils de la Data Room pour faire glisser la barre latérale. * **Supprimer un favori** — Cliquez à nouveau sur l'icône de favori d'un document mis en favori, ou supprimez-le depuis la barre latérale. Les favoris sont personnels et ne sont pas partagés avec les autres intervenants. *** ## Mon coffre-fort La bascule **Mon coffre-fort** filtre la Data Room pour n'afficher que les documents que vous avez personnellement téléversés, dont vous êtes propriétaire ou auxquels vous avez des droits d'accès spécifiques. Cela est utile pour trouver rapidement vos propres contributions sans faire défiler la liste complète des documents. *** ## Téléverser des documents ### Prérequis * **Taille maximale du fichier :** 150 Mo par fichier. * **Fichiers par téléversement :** Entre 1 et 6 fichiers par définition de document (selon la configuration de la définition). * **Méthode de téléversement :** Glissez-déposez des fichiers sur la zone de téléversement, ou cliquez pour parcourir votre système de fichiers. ### Champs du formulaire de téléversement | Champ | Description | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Fichier(s) | Sélectionnez 1 à 6 fichiers. Glisser-déposer pris en charge. | | Validateurs | Assignez jusqu'à 3 validateurs. Les validateurs avec le badge **Recommandé** sont ceux dont le rôle correspond le mieux au type de document. | | Date d'expiration | Définissez optionnellement une date d'expiration. Certains types de documents ont des périodes de validité fixes (voir ci-dessous) et ce champ peut être pré-rempli automatiquement. | ### Badge Recommandé À côté de chaque emplacement de sélection de validateur, un badge **Recommandé** apparaît à côté des intervenants dont le rôle professionnel est le plus approprié pour valider ce type de document particulier. Cela aide les téléverseurs à sélectionner les validateurs les plus crédibles, ce qui impacte positivement le score Magma Index. ### Périodes de validité Certains types de documents ont des périodes de validité fixes définies par la plateforme : | Période de validité | Types de documents | | ------------------------------ | ------------------------------------------------------------------------------------ | | **1 an** | Assurance, Hypothèque, Compte de résultat, Contrat de sécurité / Journal de sécurité | | **1 mois** | Taxes foncières, Rapports d'audit, Budget, Plan de sécurité | | **À la livraison du bâtiment** | Certificat de conformité | | **Permanent** | Titre de propriété, Acte, Registre foncier | *** ## Remplacement de documents Lorsqu'un document doit être mis à jour, vous devez utiliser le flux de remplacement plutôt que de supprimer et re-téléverser. Cela préserve l'historique des versions et la piste d'audit. ### Types de remplacement | Type | Description | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **TOTAL\_UPDATE** | Un remplacement complet du document. Utilisé lorsque le contenu a fondamentalement changé (par ex. une nouvelle police d'assurance). | | **CORRECTION** | Une correction mineure d'un document existant (par ex. corriger une faute de frappe, mettre à jour une signature). | ### Flux de remplacement 1. Ouvrez le panneau d'information du document. 2. Cliquez sur le bouton **Remplacer**. 3. Sélectionnez le type de remplacement : **Total Update** ou **Correction**. 4. Saisissez un **motif** pour le remplacement (minimum 5 caractères — obligatoire). 5. Téléversez le nouveau fichier. 6. Soumettez. L'ancienne version est archivée dans l'historique des versions et marquée du badge **REPLACED** ou **CORRECTED**. La nouvelle version devient le document actif actuel et recommence le flux de validation si des validateurs sont assignés. *** ## Partage de documents Vous pouvez partager des documents individuels avec des personnes qui ne font pas déjà partie de l'équipe d'intervenants du bâtiment. Le partage est accessible via le bouton **Partager** dans le panneau d'information du document. ### Types de partage | Type | Description | | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | | **Intervenant du bâtiment** | Partagez avec un intervenant existant du bâtiment. Sélectionnez dans une liste des intervenants actuels. | | **Invité non enregistré** | Partagez avec quelqu'un qui n'a pas de compte Magma. Saisissez son adresse e-mail ; il recevra un lien d'accès. | | **Utilisateur Magma invité** | Partagez avec un utilisateur Magma qui n'est pas un intervenant de ce bâtiment. Recherchez par nom ou e-mail. | L'accès partagé est spécifique au document. Les utilisateurs partagés apparaissent dans la liste des utilisateurs autorisés dans le panneau d'information, et leur accès peut être révoqué à tout moment. *** ## Annotations Les annotations permettent aux intervenants de laisser des commentaires, des demandes ou des caviardages directement sur les pages de documents dans le visualiseur de la Data Room. ### Créer une annotation 1. Ouvrez un document dans le visualiseur. 2. Cliquez et faites glisser sur la zone de la page pour définir la zone d'annotation. 3. Une fenêtre de commentaire apparaît. ### Annotations de commentaire * Rédigez votre texte de commentaire. * Ajoutez des **réactions emoji** pour accuser réception ou répondre rapidement. * Utilisez des **@mentions** pour notifier des intervenants spécifiques. * **Joignez des fichiers** (images ou documents) au commentaire. * **Réponses en fil de discussion** — D'autres intervenants peuvent répondre directement dans le même fil d'annotation. ### Annotations de caviardage Les caviardages vous permettent de dessiner des boîtes noires sur le contenu sensible des pages de documents : 1. Sélectionnez l'outil **Caviarder** dans la barre d'outils d'annotation. 2. Dessinez des boîtes noires sur tout contenu que vous souhaitez caviarder. 3. Cliquez sur **Enregistrer**. L'enregistrement d'un caviardage crée une **nouvelle version** du document avec le contenu caviardé appliqué de manière permanente. La version originale (non caviardée) est préservée dans l'historique des versions pour les utilisateurs autorisés disposant des permissions appropriées. ### Types d'annotations | Type | Description | | ----------- | --------------------------------------------------------------------------------------------------------------------- | | Commentaire | Un commentaire général, une question ou une note attachée à une zone spécifique du document. | | Caviardage | Un caviardage en boîte noire dessiné sur le contenu sensible. L'enregistrement crée une nouvelle version du document. | *** ## Flux de demande d'accès Si un intervenant ou un utilisateur externe tente de consulter un document auquel il n'a pas accès, il peut soumettre une **demande d'accès** : 1. L'utilisateur clique sur **Demander l'accès** sur le document restreint. 2. Ajoute optionnellement un message expliquant pourquoi il a besoin de l'accès. 3. Le propriétaire du document et les administrateurs du bâtiment reçoivent une notification dans le [Fil d'activité](/magma-documentation/fr/fonctionnalites/activity-feed.md) avec un bouton d'action **Examiner la demande**. 4. Le réviseur approuve ou refuse la demande. 5. Si approuvée, l'utilisateur demandeur est ajouté à la liste des utilisateurs autorisés et reçoit une notification d'accès. *** ## Hachage cryptographique des documents Chaque document téléversé dans la Data Room reçoit un **hachage cryptographique** (SHA-256 ou équivalent) calculé à partir du contenu binaire du fichier. Ce hachage : * Est affiché dans le panneau d'information du document pour la transparence. * Est stocké sur la blockchain lors du minting DTT® (via le contrat intelligent HashStorage). * Peut être vérifié indépendamment par n'importe quelle partie pour confirmer l'authenticité du document et détecter toute falsification. Le hachage est immuable — si le contenu du fichier change (même d'un seul octet), le hachage change et une nouvelle version doit être créée. *** ## Conseils et bonnes pratiques * Assignez toujours **3 validateurs** lorsque c'est possible — un document entièrement validé reçoit la contribution Magma Index la plus élevée et la récompense maximale. * Utilisez le **badge Recommandé** pour sélectionner les validateurs dont le rôle correspond le mieux au type de document pour une notation optimale. * Définissez les dates d'expiration avec précision — les documents expirés réduisent votre score Magma Index via la pénalité d'expiration des données. * Utilisez la **barre latérale des favoris** pour accéder rapidement aux documents que vous référencez fréquemment. * Utilisez les **annotations** pour la révision collaborative des documents avant de finaliser et de minter. * Remplacez les documents en utilisant le **flux de remplacement** approprié plutôt que de supprimer et re-téléverser — cela préserve votre piste d'audit et l'historique des versions. --- # 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/fonctionnalites/data-room.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.