# Magma Index Le Magma Index est le système propriétaire de Magma permettant de mesurer la complétude et la qualité de la documentation d'un bâtiment. Il quantifie le niveau de documentation d'un bâtiment à travers tous les niveaux et toutes les dimensions — des titres de propriété légaux aux données IoT en temps réel — et fournit une mesure transparente et objective de la maturité numérique d'un bâtiment. *** ## Vue d'ensemble Le Magma Index produit un score (exprimé en pourcentage) pour chaque bâtiment. Ce score reflète non seulement le nombre de documents téléversés, mais aussi la qualité, la pertinence et la crédibilité de ces documents et des acteurs qui les ont produits. L'index est calculé à la fois au niveau du bâtiment (global) et au niveau individuel (par niveau Magma). Il est également décomposé au niveau du document via le **Micro Index (µI)** — le pourcentage de contribution d'un seul document au score de son niveau. *** ## Les cinq niveaux Magma Le Magma Index organise toute la documentation du bâtiment en 5 niveaux, chacun représentant une dimension distincte du bâtiment : | Niveau | Code | Description | | ---------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **Genesis** | G | Documents fondamentaux : titres de propriété, documentation juridique, instruments financiers et diagnostics du bâtiment. | | **Structure** | S | Documentation d'ingénierie structurelle : calculs de structures, relevés, rapports géotechniques. | | **Architecture** | A | Documentation architecturale : plans, permis, certifications (LEED, BREEAM, HQE, WELL). | | **Wired** | W1–W5 | Systèmes techniques : CVC (W1), Plomberie (W2), Électricité/Éclairage (W3), Appareils et équipements (W4), Systèmes de sécurité et sûreté (W5). | | **Filled** | F | Design intérieur et mobilier : plans d'aménagement, spécifications du mobilier, photos intérieures. | Chaque niveau dispose d'un ensemble défini de **tâches documentaires** — des types de documents spécifiques qui doivent être présents pour un dossier complet du bâtiment. *** ## Facteurs de notation Le Magma Index n'est pas un simple comptage de documents. La contribution de chaque document à l'index est pondérée par 7 facteurs de notation : ### Facteur 1 — Quantité par rapport à l'attendu Le ratio de documents effectivement téléversés par rapport au nombre de types de documents attendus pour ce bâtiment (en fonction du type de bâtiment). Un bâtiment avec tous les types de documents attendus remplis obtient un score plus élevé que celui n'en ayant que quelques-uns. ### Facteur 2 — Catégorie de l'acteur La catégorie de l'intervenant ayant téléversé le document : | Catégorie | Description | | ----------------- | --------------------------------------------------------------------- | | **Professionnel** | Professionnels agréés (Architecte, Ingénieur, Notaire, Avocat, etc.). | | **Amateur** | Personnes non agréées (Propriétaire agissant personnellement, etc.). | Les acteurs professionnels contribuent davantage à l'index que les acteurs amateurs, car leurs documents bénéficient d'une crédibilité plus élevée. ### Facteur 3 — Pertinence de la combinaison téléverseur / validateur Si la personne ayant téléversé le document et celle(s) qui l'ont validé sont les rôles les plus appropriés pour ce type de document spécifique. Par exemple, un document d'assurance téléversé par un Avocat et validé par un Notaire obtient un score plus élevé que le même document téléversé par un Locataire. ### Facteur 4 — Complétude de validation Selon qu'il y a 1, 2 ou 3 validateurs assignés au document : | Validateurs | Niveau | | ------------- | ------------------------- | | 0 validateur | Aucun bonus de validation | | 1 validateur | Niveau 1 | | 2 validateurs | Niveau 2 | | 3 validateurs | Niveau 3 (maximum) | Plus le nombre de validateurs est élevé, plus la crédibilité du document est grande et donc sa contribution à l'index. ### Facteur 5 — Réputation des intervenants Le score de réputation (entier 1–5, valeur par défaut 3) du téléverseur et des validateurs. Une réputation plus élevée signifie plus de confiance accordée à leur contribution. * Réputation par défaut pour tous les intervenants : **3** * La réputation augmente de **+1** pour chaque **5 validations mintées** (plafonnée à **5**). * La réputation peut être réduite par des pénalisations appliquées par une tâche planifiée (par exemple, pour des validations rejetées, de l'inactivité, etc.). ### Facteur 6 — Pénalité d'expiration des données Les documents avec une date d'expiration dépassée appliquent une **pénalité négative** à leur contribution. Les documents expirés réduisent le score Magma Index de leur niveau. Cela incite à maintenir les documents sensibles au temps à jour. ### Facteur 7 — Pondération par type de bâtiment Différents types de documents ont une importance intrinsèque différente selon le type de bâtiment. Par exemple, un contrat de sécurité est plus critique pour un Hôtel que pour un bâtiment d'Entreposage. La matrice de pondération ajuste la contribution de base de chaque document en fonction du type de bâtiment. **Les 9 types de bâtiments et leurs profils de pondération :** * Hôtel * Public * Industriel * Entreposage * Usage mixte * Commercial * Résidentiel * Bureau * Médical *** ## Micro Index (µI) Le **Micro Index** (abrégé **µI**) représente le pourcentage de contribution d'un seul document au score global Magma Index de son niveau. * Le µI est exprimé en pourcentage (par exemple, un document peut contribuer à hauteur de 3,4 % au score du niveau Architecture). * Le µI est visible dans le panneau d'information du document dans la Data Room. * Le µI est également visible dans la section [Contributions de valeur](/magma-documentation/fr/fonctionnalites/value-contributions.md), où la contribution de chaque document est listée. * Le µI est utilisé dans le [Simulateur](/magma-documentation/fr/fonctionnalites/simulator.md) pour prévisualiser l'impact d'un nouveau document avant son téléversement. Comprendre le µI aide les intervenants à prioriser les documents à téléverser ou à mettre à jour pour maximiser le score global de l'index du bâtiment. *** ## Widget d'index du bâtiment Le widget d'index du bâtiment fournit un aperçu visuel du Magma Index du bâtiment. Il est accessible depuis la page de profil principale du bâtiment. ### Vue simple Un **anneau de progression circulaire** pour chacun des 5 niveaux, affichant : * **Remplissage couleur primaire** — Pourcentage de documents validés. * **Remplissage couleur succès** — Pourcentage de documents en attente de validation (documents téléversés mais pas encore validés). Les anneaux offrent une vue d'ensemble rapide de la complétude et de la validation de la documentation du bâtiment à chaque niveau. ### Vue détaillée Basculez vers la vue détaillée pour voir une décomposition complète : * Un **accordéon** pour chaque niveau qui peut être développé. * À l'intérieur de chaque accordéon : une liste de toutes les tâches documentaires pour ce niveau. * Chaque ligne de tâche documentaire affiche : * **Icône de statut** — Si le document est manquant, téléversé (en attente) ou validé. * **Nom du document** — Le nom du type de document. * **Avatar du téléverseur** — L'avatar de l'intervenant ayant téléversé la version la plus récente. * **Cliquable** — Cliquer sur une ligne de tâche documentaire ouvre ce document directement dans la Data Room. La vue détaillée facilite l'identification précise des documents manquants ou en attente de validation, permettant une action immédiate. *** ## Certifications au niveau Architecture Le niveau Architecture du Magma Index suit spécifiquement les certifications de durabilité et de performance des bâtiments. Les types de certifications pris en charge incluent : * **LEED** (Leadership in Energy and Environmental Design) * **BREEAM** (Building Research Establishment Environmental Assessment Method) * **HQE** (Haute Qualité Environnementale) * **WELL** (WELL Building Standard) Les documents de certification téléversés au niveau Architecture avec le type de document approprié sont reconnus et pondérés en conséquence dans le calcul de l'index. *** ## Comment le Magma Index influence les autres fonctionnalités Le score Magma Index est utilisé sur toute la plateforme de plusieurs façons : | Fonctionnalité | Utilisation de l'index | | --------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **Minting DTT®** | Le score de l'index est affiché sur la fiche DTT® et intégré dans les métadonnées du token minté. | | **Récompenses** | Les montants des récompenses de document sont partiellement déterminés par la contribution du document à l'index. | | **Tableau de bord** | L'index est affiché sur chaque fiche de bâtiment comme indicateur de performance clé. | | **Simulateur** | Prévisualise la contribution à l'index (µI) d'un téléversement de document hypothétique avant qu'il ne se produise. | | **Contributions de valeur** | Liste la contribution individuelle de chaque document et objet BIM à l'index. | *** ## Conseils pour maximiser votre Magma Index * Commencez par les documents du niveau **Genesis** — Le titre de propriété, l'acte et le registre foncier sont des documents permanents qui contribuent dès le premier jour et n'expirent jamais. * Privilégiez les **téléverseurs professionnels** — Les documents téléversés par des professionnels agréés (Architectes, Ingénieurs, Avocats) bénéficient d'un bonus de catégorie d'acteur plus élevé. * Assignez toujours **3 validateurs** lors du téléversement de documents critiques — le bonus de complétude de validation de niveau 3 augmente significativement la contribution du document. * Développez la **réputation des intervenants** au fil du temps — des validations cohérentes et de haute qualité augmentent les scores de réputation, ce qui amplifie la contribution à l'index de chaque document ultérieur. * Mettez régulièrement à jour les **documents sensibles au temps** (Assurance, Taxes foncières, Rapports d'audit) avant leur expiration pour éviter que la pénalité d'expiration des données ne fasse baisser votre score. * Utilisez le **Simulateur** avant de téléverser des documents coûteux ou complexes pour prévisualiser exactement leur contribution à l'index. --- # 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/magma-index.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.