# Simulator

Le Simulateur est un outil de planification qui vous permet de prévisualiser l'impact d'un téléversement de document **avant qu'il ne se produise**. Il calcule la contribution exacte au Magma Index (Micro Index µI) et la distribution des récompenses MRT pour n'importe quelle combinaison hypothétique de niveau de bâtiment, type de document, acteurs et validateurs — afin que vous puissiez prendre des décisions éclairées pour maximiser à la fois le score de votre bâtiment et les récompenses de vos parties prenantes.

***

## Vue d'ensemble

Le Simulateur répond à deux questions avant que vous ne téléversiez un document :

1. **Dans quelle mesure ce document améliorera-t-il mon Magma Index ?** (Panneau Contribution de valeur)
2. **Combien de MRT chaque partie prenante gagnera-t-elle ?** (Panneau Distribution des récompenses)

En ajustant les paramètres — type de document, rôle du téléverseur, rôles des validateurs — vous pouvez comparer différentes combinaisons et choisir la configuration optimale avant de vous engager.

***

## Accès au Simulateur

Le Simulateur est accessible depuis :

* L'onglet ou la section **Simulateur** du bâtiment.
* Le formulaire de téléversement dans la Data Room — un bouton **Simulateur** est disponible avant de confirmer un téléversement.

***

## Paramètres du Simulateur

Configurez les paramètres suivants pour générer une simulation :

### Niveau du bâtiment

Une liste déroulante pour sélectionner le niveau Magma auquel appartient le document :

* Genesis
* Structure
* Architecture
* Wired 1 (Mécanique)
* Wired 2 (Plomberie)
* Wired 3 (Éclairage)
* Wired 4 (Appareils & Équipements)
* Wired 5 (Sécurité & Sûreté)
* Filled

La sélection d'un niveau filtre les types de documents disponibles pour n'afficher que ceux applicables à ce niveau.

### Type de bâtiment

Une liste déroulante pour sélectionner le type de bâtiment (9 options) :

* Hôtel
* Public
* Industriel
* Entreposage
* Usage mixte
* Commercial
* Résidentiel
* Bureau
* Médical

Le type de bâtiment affecte le **facteur de pondération** appliqué à la valeur intrinsèque du document, ce qui à son tour affecte à la fois la contribution et le montant de la récompense.

> **Remarque :** Ce champ est pré-rempli avec le type de bâtiment configuré et ne nécessite généralement pas d'être modifié.

### Type de document

Une liste déroulante affichant tous les types de documents applicables au **Niveau** sélectionné. La liste est filtrée en fonction de la sélection du niveau — sélectionner un niveau différent réinitialise ce champ et n'affiche que les types de documents pertinents.

### Nombre de fichiers

Un champ numérique (1 à 100) représentant le nombre de fichiers qui seront téléversés pour cette définition de document.

### Téléverseur

Configurez la partie prenante qui téléversera le document :

| Sous-champ | Options                                                                                                             |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| Rôle       | Sélectionnez parmi tous les rôles disponibles sur la plateforme (Propriétaire, Architecte, Ingénieur, Avocat, etc.) |
| Réputation | Sélectionnez de 1 à 5 (entier)                                                                                      |

Le badge **Recommandé** apparaît à côté des rôles les plus appropriés pour téléverser le type de document sélectionné. Sélectionner un rôle recommandé maximise les multiplicateurs de catégorie d'acteur et de combinaison de rôles.

### Validateur principal (optionnel)

Configurez le premier validateur :

| Sous-champ | Options                                                         |
| ---------- | --------------------------------------------------------------- |
| Rôle       | Sélectionnez parmi tous les rôles disponibles sur la plateforme |
| Réputation | Sélectionnez de 1 à 5                                           |

Le badge **Recommandé** indique le rôle optimal pour la validation principale de ce type de document.

> **Contrainte :** Le même rôle ne peut pas être sélectionné plus d'une fois parmi le téléverseur et tous les créneaux de validateurs.

### Validateur secondaire (optionnel)

Configurez le deuxième validateur (mêmes champs que le Validateur principal). Optionnel — laisser ce champ vide simule un scénario Niveau 1 (1 validateur).

### Validateur tertiaire (optionnel)

Configurez le troisième validateur (mêmes champs que le Validateur principal). Optionnel — laisser ce champ vide simule un scénario Niveau 2 (2 validateurs). Remplir les trois créneaux simule le scénario maximum Niveau 3.

***

## Recommandations de rôles

Pour chaque créneau d'acteur (téléverseur, validateur principal, validateur secondaire, validateur tertiaire), le Simulateur affiche un badge **Recommandé** à côté des rôles les plus appropriés pour le type de document sélectionné. Ces recommandations sont basées sur la matrice de pertinence des rôles de la plateforme, qui détermine quels rôles professionnels sont les plus crédibles pour chaque type de document.

Sélectionner des rôles recommandés pour tous les créneaux permet d'obtenir le multiplicateur de combinaison de rôles maximum et produit les contributions d'index et les montants de récompenses les plus élevés possibles.

***

## Contrainte d'unicité des rôles

Pour éviter des simulations irréalistes (ex. : la même personne validant son propre document dans plusieurs créneaux), **le même rôle ne peut pas être sélectionné plus d'une fois** dans tous les créneaux d'acteurs. Les listes déroulantes désactivent ou filtrent automatiquement les rôles déjà sélectionnés dans un autre créneau.

***

## Résultats du Simulateur

Après avoir configuré tous les paramètres, le Simulateur affiche deux panneaux de résultats :

### 1. Panneau Contribution de valeur

Montre comment le document simulé affecterait le Magma Index :

| Champ                  | Description                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Valeur par acteur**  | La valeur de contribution à l'index attribuée à chaque acteur (téléverseur, principal, secondaire, tertiaire). |
| **Micro Index (µI %)** | La contribution estimée en pourcentage du document au score Magma Index du niveau.                             |

Ce panneau vous montre l'amélioration exacte du Magma Index du bâtiment qui résulterait de ce téléversement, en supposant que le document atteint le statut Validé avec la configuration spécifiée.

### 2. Panneau Distribution des récompenses

Montre comment les récompenses MRT seraient distribuées :

| Champ                         | Description                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Récompense MRT par acteur** | Le montant estimé de récompense MRT pour chaque acteur (téléverseur, validateur principal, validateur secondaire, validateur tertiaire). |

Les récompenses sont détaillées individuellement afin que chaque partie prenante puisse voir sa récompense personnelle attendue avant tout engagement.

***

## Bouton Réinitialiser

Le bouton **Réinitialiser** remet à zéro tous les **champs d'acteurs** (téléverseur, validateurs principal/secondaire/tertiaire) tout en conservant la sélection du type de document et du niveau de bâtiment. Cela vous permet de tester rapidement différentes combinaisons d'acteurs pour le même type de document sans avoir à resélectionner le niveau et le type de document depuis le début.

***

## Cas d'usage pratiques

### Avant de téléverser un document critique

Utilisez le Simulateur pour confirmer que la configuration d'acteurs planifiée (téléverseur + validateurs) fournira l'amélioration attendue du Magma Index et la distribution des récompenses. Si le résultat est inférieur aux attentes, expérimentez avec différents rôles de validateurs ou niveaux de réputation pour comprendre l'impact.

### Choisir les bons validateurs

Saisissez différentes combinaisons de rôles de validateurs pour trouver la combinaison qui maximise la récompense et la contribution à l'index. Les badges Recommandé vous guident, mais le Simulateur vous permet de quantifier exactement l'importance de chaque choix.

### Alignement des parties prenantes

Partagez les résultats du Simulateur avec les validateurs avant de les assigner — leur montrer leur récompense MRT attendue fournit une incitation concrète à prioriser la tâche de validation rapidement.

### Planification de portefeuille

Utilisez le Simulateur sur plusieurs types de documents pour construire une feuille de route de téléversement priorisée — en commençant par les documents qui offrent la plus grande amélioration µI et le meilleur rendement de récompense pour le bâtiment.

***

## Conseils pour utiliser efficacement le Simulateur

* Remplissez toujours les **3 créneaux de validateurs** dans le Simulateur pour voir la récompense maximale atteignable et la contribution à l'index — puis décidez si l'effort de recruter 3 validateurs vaut l'amélioration.
* Testez l'impact de **différents niveaux de réputation** — un validateur principal avec une réputation de 5 par rapport à une réputation de 3 peut faire une différence significative dans les scores de récompense et d'index.
* Utilisez le Simulateur pour la **préparation à la diligence raisonnable** — avant un audit majeur ou une revue d'investisseur, simulez les téléversements nécessaires pour atteindre un score Magma Index cible et construisez un plan de téléversement en conséquence.
* Le Simulateur reflète la **matrice de pondération actuelle** de la plateforme — si les pondérations du type de bâtiment ou du type de document sont mises à jour, relancez la simulation pour voir les projections actualisées.


---

# 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/simulator.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.
