# Récompenses Le système de récompenses Magma incite les parties prenantes à contribuer une documentation de bâtiment de haute qualité et vérifiée en distribuant des récompenses en cryptomonnaie **MRT (Magma Reward Token)** pour les actions éligibles. Les récompenses sont calculées en fonction de la qualité et de la crédibilité de chaque contribution, et non simplement de la quantité. *** ## Vue d'ensemble Les récompenses sont gagnées par les parties prenantes qui effectuent des actions spécifiques liées à la documentation des bâtiments : * Téléverser des documents (lorsque le document est ensuite validé). * Valider des documents téléversés par d'autres. * Saisir des données dans les champs d'objets BIM (lorsque la saisie est ensuite approuvée). * Valider des saisies de champs BIM soumises par d'autres. Les récompenses sont distribuées en **MRT**, un token ERC-20 sur la blockchain VeChain (également disponible sur ETH, BNB et Polygon). Le MRT est reçu dans le **Portefeuille de la partie prenante** personnel (distinct du Portefeuille du bâtiment). *** ## Actions de récompense éligibles | Action | Description | Déclencheur | | --------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | **Téléversement de document** | Une partie prenante téléverse un document dans la Data Room. | La récompense est émise lorsque le document atteint le statut **Validé**. | | **Validation de document (Principale)** | Une partie prenante valide un document en tant que validateur principal (premier). | La récompense est émise à la fin de la validation. | | **Validation de document (Secondaire)** | Une partie prenante valide un document en tant que deuxième validateur. | La récompense est émise à la fin de la validation. | | **Validation de document (Tertiaire)** | Une partie prenante valide un document en tant que troisième validateur. | La récompense est émise à la fin de la validation. | | **Saisie de champ BIM** | Une partie prenante saisit des données dans un champ d'objet BIM via la visionneuse 3D. | La récompense est émise lorsque la modification du champ est **approuvée** par tous les validateurs. | | **Validation de champ BIM** | Une partie prenante vote pour approuver une demande de modification de champ BIM. | La récompense est émise lors de l'approbation réussie. | *** ## Formule de calcul des récompenses Le montant de la récompense MRT pour chaque action est déterminé en multipliant plusieurs facteurs : ``` Récompense = Valeur intrinsèque du document × Catégorie d'acteur × Combinaison Téléverseur/Validateur × Complétude des validateurs × Réputation de la partie prenante × Facteur d'expiration des données ``` ### Facteur 1 — Valeur intrinsèque du document La valeur de base attribuée à un type de document spécifique, ajustée en fonction de : * Le **type de document** (ex. : un Titre de propriété a une valeur intrinsèque plus élevée qu'un document Budgétaire). * Le **type de bâtiment** (ex. : un Contrat de sécurité est pondéré plus fortement pour un Hôtel que pour un bâtiment d'Entreposage). * Le **niveau Magma** (ex. : les documents Genesis ont des valeurs de base différentes des documents Wired). ### Facteur 2 — Catégorie d'acteur | Catégorie | Multiplicateur | | --------------------- | -------------------------- | | Professionnel (agréé) | Multiplicateur plus élevé | | Amateur (non agréé) | Multiplicateur plus faible | ### Facteur 3 — Pertinence de la combinaison Téléverseur / Validateur Si le téléverseur et le(s) validateur(s) sont les rôles optimaux pour le type de document spécifique. Les combinaisons de rôles pertinentes reçoivent un multiplicateur plus élevé. Les rôles non adaptés (ex. : un Locataire validant un document d'ingénierie structurelle) reçoivent un multiplicateur plus faible. ### Facteur 4 — Complétude des validateurs | Validateurs assignés | Niveau | Effet sur la récompense | | -------------------- | -------- | -------------------------- | | 0 | Aucun | Pas de bonus de validation | | 1 | Niveau 1 | Multiplicateur modéré | | 2 | Niveau 2 | Multiplicateur plus élevé | | 3 | Niveau 3 | Multiplicateur maximum | ### Facteur 5 — Réputation de la partie prenante Chaque partie prenante possède un **score de réputation** (entier de 1 à 5, par défaut : 3) : * Réputation plus élevée = multiplicateur de récompense plus élevé. * **Augmentation :** +1 pour chaque tranche de 5 validations mintées (plafond à 5). * **Diminution :** Appliquée par le job cron de la plateforme pour les comportements sanctionnables (ex. : validations rejetées, soumissions de données inexactes). La réputation est un **score global** — elle s'applique à tous les bâtiments auxquels la partie prenante participe. Construire une forte réputation dans un bâtiment bénéficie aux récompenses de la partie prenante sur l'ensemble du portefeuille. ### Facteur 6 — Expiration des données Les documents avec des dates de validité actives et non expirées reçoivent la récompense complète. Les documents dont la date d'expiration est déjà passée au moment du minting reçoivent une **récompense réduite** en raison de la pénalité d'expiration des données. *** ## États des récompenses Chaque récompense passe par trois états : | État | Description | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **En attente** | L'action éligible a eu lieu mais le minting n'est pas encore terminé. La récompense est calculée et réservée mais pas encore distribuée. | | **Financée** | Le processus de minting s'est déroulé et la récompense a été allouée on-chain. | | **Payée** | Les tokens MRT ont été transférés vers le Portefeuille de la partie prenante. | *** ## Token MRT | Propriété | Valeur | | ------------------------ | --------------------------------------------------------- | | Type de token | ERC-20 | | Blockchain principale | VeChain | | Également disponible sur | ETH, BNB, Polygon | | Portefeuille (réception) | Portefeuille de la partie prenante (personnel), via Venly | Les récompenses MRT sont distinctes du Portefeuille du bâtiment, qui détient le contrat DTT®. Le portefeuille personnel de chaque partie prenante reçoit le MRT indépendamment. *** ## Réputation de la partie prenante La réputation est un multiplicateur clé à la fois pour les récompenses et pour le scoring du Magma Index. ### Fonctionnement de la réputation | Événement | Changement de réputation | | ------------------------------------- | ------------------------ | | Par défaut (nouvelle partie prenante) | 3 | | Chaque 5 validations mintées | +1 (max 5) | | Pénalisation par le job cron | -1 (selon l'infraction) | ### Réputation et droits de vote La réputation confère également des **droits de vote** dans les demandes de modification de champs. Les validateurs ayant une réputation plus élevée ont plus de poids dans le processus d'approbation. Cela se reflète dans les avantages affichés sur l'écran de connexion du portefeuille. *** ## Onglet Récompenses L'onglet Récompenses est accessible uniquement par les **Propriétaires** et les **Gestionnaires de compte** du bâtiment. Il offre une visibilité sur toute l'activité de récompenses pour le bâtiment. ### Sous-onglets L'onglet Récompenses est divisé en deux sous-onglets : #### Sous-onglet Documents Un tableau affichant toutes les récompenses liées aux documents : | Colonne | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------ | | Acteur | La partie prenante qui a effectué l'action (nom + avatar). | | Type d'action | L'action éligible (Téléversement, Validation Principale, Validation Secondaire, Validation Tertiaire). | | Montant de la récompense | Le montant de récompense MRT calculé. | | Statut | En attente / Financée / Payée. | #### Sous-onglet Modèle 3D Un tableau affichant toutes les récompenses liées au BIM : | Colonne | Description | | ------------------------ | ----------------------------------------------- | | Acteur | La partie prenante qui a effectué l'action. | | Type d'action | Saisie de champ BIM ou Validation de champ BIM. | | Montant de la récompense | Le montant de récompense MRT calculé. | | Statut | En attente / Financée / Payée. | ### Activation/désactivation des récompenses par partie prenante Les Propriétaires et les Gestionnaires de compte peuvent **activer ou désactiver les récompenses** pour des parties prenantes individuelles. Cela est géré via un interrupteur à côté de chaque partie prenante dans l'onglet Récompenses. Désactiver les récompenses pour une partie prenante signifie que ses actions éligibles ne génèreront pas de récompenses MRT. *** ## Simulateur de récompenses Avant de téléverser un document, les parties prenantes peuvent utiliser le **Simulateur** pour prévisualiser la distribution exacte de récompenses MRT qui résultera du téléversement. Le Simulateur prévisualise : * Combien de MRT le téléverseur recevra. * Combien chaque validateur recevra (par créneau de validateur : principal, secondaire, tertiaire). * Le pool de récompenses total pour le document. Consultez le guide [Simulateur](/magma-documentation/fr/fonctionnalites/simulator.md) pour tous les détails sur son utilisation. *** ## Conseils pour maximiser les récompenses * **Construisez votre réputation** — Chaque validation mintée augmente votre score de réputation (jusqu'à 5). Une réputation plus élevée signifie des récompenses plus élevées pour chaque action suivante. * **Validez aussi souvent que possible** — Chaque validation (principale, secondaire ou tertiaire) génère une récompense. Être assigné comme validateur est l'une des actions les plus rentables sur la plateforme. * **Téléversez en tant que professionnel** — Les parties prenantes ayant des rôles professionnels reçoivent un multiplicateur de catégorie d'acteur plus élevé. Assurez-vous que votre rôle sur la plateforme reflète fidèlement votre statut professionnel. * **Remplissez les créneaux de validateurs** — Les documents avec 3 validateurs génèrent la récompense maximale pour toutes les parties. Les téléverseurs devraient toujours chercher à attribuer les 3 créneaux de validateurs. * **Gardez les documents à jour** — Les documents qui expirent avant le minting reçoivent une récompense réduite. Mettez à jour les documents sensibles au temps de manière proactive pour éviter la pénalité d'expiration. * **Utilisez le Simulateur** — Prévisualisez votre récompense avant de téléverser pour confirmer que la distribution est celle attendue et pour choisir la combinaison de validateurs optimale. --- # 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/rewards.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.