# Calcul du Magma Index

Le Magma Index mesure le degré de complétude numérique d'un bâtiment. Ce n'est pas un simple compteur de fichiers — il évalue la **qualité, la provenance et la pertinence** de chaque donnée contribuée à un DTT® de bâtiment.

## Les cinq niveaux

Le Magma Index est divisé en cinq niveaux, chacun couvrant un domaine différent des données du bâtiment :

| Niveau           | Ce qu'il couvre                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------------- |
| **Genesis**      | Données fondamentales : propriété, juridique, financier, assurance, diagnostics                            |
| **Structure**    | Ingénierie structurelle : calculs, plans, conformité, modèle BIM                                           |
| **Architecture** | Conception : plans, paysagisme, certifications (LEED, BREEAM, HQE, WELL), scan 3D                          |
| **Wired**        | Systèmes techniques : HVAC (W1), Plomberie (W2), Électrique (W3), Équipements (W4), Sécurité incendie (W5) |
| **Filled**       | Intérieur : plans de décoration, mobilier, nettoyage, modèle BIM intérieur                                 |

Chaque niveau a son propre pourcentage de complétion. Le **Magma Index global** est dérivé des cinq niveaux combinés.

***

## Comment chaque document est évalué

Chaque type de document a une **valeur intrinsèque** — un score de base — déterminé par trois facteurs :

1. **Le niveau d'index** (Genesis, Structure, Architecture, Wired, Filled)
2. **Le type de bâtiment** (Hôtel, Bureau, Résidentiel, etc.)
3. **Le type de document spécifique** (ex. : Acte de propriété, Plans de structure, Certification LEED)

Cette valeur intrinsèque est ensuite ajustée par cinq facteurs :

### Facteur 1 — Catégorie de l'acteur

Qui a contribué les données importe. Les professionnels directement responsables de ce domaine de données contribuent davantage :

* Un architecte important des plans de structure apporte plus de valeur qu'une partie prenante générale important le même document
* Le système utilise la **catégorie** de la partie prenante (Propriétaire, Asset Manager, Prestataire de services, etc.) et son **type** spécifique (Architecte, Ingénieur structure, etc.) pour déterminer cet ajustement

### Facteur 2 — Combinaison importateur/validateur

La combinaison de qui a importé et qui a validé le document affecte le score :

* Un document importé par le professionnel le plus pertinent (ex. : un Diagnostiqueur) et validé par l'autorité la plus appropriée (ex. : l'Asset Manager et l'Inspecteur municipal) obtient le score le plus élevé
* Un document importé et validé par des parties moins pertinentes contribue quand même, mais avec un coefficient plus faible

### Facteur 3 — Complétude des validateurs

Les documents avec les trois niveaux de validation complétés obtiennent un score plus élevé que les documents avec un seul validateur principal :

* 3 validateurs : score de complétude maximum
* 2 validateurs : score modéré
* 1 validateur : score minimum de complétude
* 0 validateur : pas encore validé, ne contribue pas

### Facteur 4 — Réputation de la partie prenante

Chaque partie prenante possède un **score de réputation** (entier 1–5, global sur tous les bâtiments, valeur par défaut 3). Les contributeurs avec une réputation plus élevée produisent des données de plus grande valeur :

* La réputation augmente de **+1 tous les 5 validations émises** (plafond à 5)
* La réputation de l'importateur et de chaque validateur est intégrée dans la valeur finale
* Des pénalisations peuvent réduire la réputation (appliquées par un processus planifié)

Le facteur de réputation garantit que les contributeurs expérimentés et régulièrement précis sont reconnus dans le temps.

### Facteur 5 — Expiration des données

Les documents ayant des périodes de validité (assurance, taxes foncières, rapports d'audit, etc.) perdent leur contribution à l'index à mesure qu'ils approchent de leur expiration :

* Un document actif et non expiré contribue à sa pleine valeur
* Un document expiré réduit le score de l'index pour sa catégorie jusqu'à ce qu'une version renouvelée soit importée et validée

***

## Le Micro Index (µI)

Le **Micro Index** (µI) représente le pourcentage de contribution d'un seul document au score de son niveau. Il est affiché en pourcentage (ex. : « 2,3% ») et visible dans :

* Le panneau de résultats du **Simulator** (avant l'importation, pour prévisualiser l'impact)
* L'onglet **Contributions de valeur** (après l'importation, montrant la contribution réelle)
* L'accordéon **Détails de l'index du bâtiment** (en mode développeur)

Le µI vous permet de comparer l'importance relative de différents documents et de prioriser les importations qui auront le plus d'impact sur votre Magma Index.

***

## Lecture du widget Magma Index

Le widget Index du bâtiment dans l'onglet Vue d'ensemble affiche trois types de progression par niveau :

| Couleur              | Signification                                                                                      |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| **Bleu (principal)** | Données déjà émises sur la blockchain — verrouillées dans l'enregistrement blockchain              |
| **Vert (succès)**    | Données validées et approuvées mais pas encore émises — seront incluses dans la prochaine émission |
| **Restant**          | Données en attente de validation ou pas encore importées — ne contribuent pas encore               |

La **vue Simple** affiche des indicateurs de progression circulaires par niveau avec les pourcentages validés (bleu) et en attente de validation (vert).

La **vue Détaillée** (accordéon) affiche chaque tâche de document individuelle, son statut, qui l'a importée, et permet de cliquer pour accéder à ce document.

***

## Résumé de la formule de calcul

```
Contribution du document = 
  Valeur intrinsèque (niveau × type de bâtiment × type de document)
  × Ajustement de la catégorie d'acteur
  × Ajustement de la combinaison importateur/validateur  
  × Ajustement de la complétude des validateurs
  × Facteur de réputation (importateur + validateurs)
  × Ajustement d'expiration (réduction si expiré)
```

La somme de toutes les contributions des documents sur tous les niveaux produit le pourcentage global du Magma Index du bâtiment.

***

## Maximiser votre Magma Index

Pour atteindre le Magma Index le plus élevé possible :

1. **Importez tous les types de documents attendus** pour votre type de bâtiment — l'index tient compte de ce qui est attendu, pas seulement de ce que vous avez
2. **Utilisez le bon professionnel** — assurez-vous que le rôle d'importateur désigné pour chaque document est bien celui qui importe
3. **Assignez les trois niveaux de validation** — ne sautez pas les validateurs secondaires et tertiaires
4. **Maintenez les documents à jour** — renouvelez les documents expirés avant leur échéance
5. **Construisez la réputation** — les parties prenantes avec une réputation plus élevée produisent des contributions de plus grande valeur
6. **Importez des modèles BIM** pour tous les niveaux — les données d'objets 3D contribuent séparément des documents
7. **Utilisez le Simulator** — prévisualisez l'impact exact en µI avant d'importer tout document


---

# 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/magma-index-scoring.md?ask=<question>
```

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.
