# Comment ça fonctionne ## Le cycle de vie d'un bâtiment sur Magma ### 1. Le propriétaire crée le Digital Twin Token Un propriétaire de bâtiment (ou son asset manager) souscrit un abonnement et crée le DTT® pour son bâtiment. Cela implique de : * Saisir les informations de base du bâtiment : nom, type, adresse, surface, année de construction, coordonnées du propriétaire et TVA * Spécifier optionnellement les exigences du modèle 3D pour chaque niveau du bâtiment * Examiner le devis tarifaire et connecter un **portefeuille de bâtiment** (Venly/VeChain) * Effectuer le paiement Stripe pour activer l'abonnement Le bâtiment démarre au statut **Brouillon** et passe au statut **Non Minté** une fois le paiement confirmé. ### 2. Les parties prenantes sont invitées Le propriétaire invite tous les professionnels impliqués dans le cycle de vie du bâtiment. Chaque invitation crée un **Accord de Partie Prenante** qui définit le rôle et les permissions de la personne sur ce bâtiment. Les types de parties prenantes vont des architectes et ingénieurs en structure aux locataires, observateurs et institutions financières — plus de 50 types spécifiques répartis en 8 catégories. Les invitations arrivent par e-mail avec un lien pour accepter ou refuser. Une fois acceptée, la partie prenante accède au bâtiment selon son rôle. ### 3. Les données sont contribuées Selon leur rôle, les parties prenantes contribuent des données via trois interfaces : **Data Room** — Téléversez des documents au niveau et dans la catégorie appropriés. La plateforme indique quels types de documents sont attendus pour votre rôle et met en évidence ceux qui manquent. Chaque type de document a des rôles de téléverseur et de validateur désignés, définis par type de document. **BIM 3D Viewer** — Les ingénieurs et architectes téléversent des modèles IFC pour leur niveau de bâtiment. Chaque objet du modèle peut ensuite être enrichi de données structurées : identification, matériaux, dimensions, état, évaluations de conformité, dates de cycle de vie, données financières, connexions IoT, et plus encore. **Scan Viewer** — Les géomètres et diagnostiqueurs téléversent des scans en nuage de points E57. Le pipeline d'IA segmente automatiquement le scan, classifie chaque élément et associe les éléments aux objets BIM existants dans la mesure du possible. ### 4. Les validateurs approuvent les données Chaque donnée passe par un **workflow de validation**. Pour les documents, chaque type de document a un validateur primaire, un validateur secondaire optionnel et un validateur tertiaire optionnel. Tous les validateurs configurés doivent approuver — un seul rejet renvoie le document au téléverseur avec une justification. Pour les champs de données BIM, toute modification déclenche une demande de changement. Les validateurs désignés examinent la valeur proposée et votent pour approuver ou rejeter. Tous les validateurs doivent être d'accord. Les données validées reçoivent le statut **Validé** et sont éligibles au minting. ### 5. Le DTT® est minté Une fois suffisamment de données validées accumulées, le propriétaire ou l'asset manager initie le minting. Un processus en 13 étapes s'exécute sur la blockchain : * Tous les documents et champs BIM validés sont synchronisés sur la chaîne * Chaque élément reçoit un ID de token dans le contrat DTT® ERC-1155 du bâtiment * L'empreinte cryptographique de chaque version de document est ajoutée au tableau de hachages de son token dans le contrat HashStorage * Les récompenses en tokens MRT sont calculées pour chaque contributeur et validateur * Les récompenses sont financées et transférées aux portefeuilles des parties prenantes * Le niveau du DTT® est incrémenté Le bâtiment reçoit une adresse blockchain unique. Son historique complet de données est désormais permanent et publiquement vérifiable. ### 6. Le DTT® évolue Les bâtiments changent. De nouveaux locataires arrivent, des équipements sont remplacés, des certifications sont renouvelées. Chaque mise à jour suit le même workflow : téléversement → validation → minting. Chaque nouveau hachage est ajouté au token existant — l'historique complet est préservé, jamais écrasé. Les documents dont les périodes de validité sont limitées (tels que les polices d'assurance ou les rapports de diagnostic qui expirent annuellement) génèrent des tâches rappelant aux parties prenantes de téléverser des versions renouvelées avant l'expiration. *** ## Comment fonctionne la validation ### Validation des documents ``` Téléversement → PENDING_VALIDATION → Tous les validateurs approuvent → VALIDATED → éligible au minting → Un validateur rejette → REQUIRING_ACTION → le téléverseur corrige et soumet à nouveau → Version corrigée → PENDING_VALIDATION (le cycle se répète) ``` Après le minting : MINTED\ Après écoulement du temps : EXPIRED (génère une tâche UPDATE\_EXPIRED\_DOCUMENT)\ Après validation d'une nouvelle version : REPLACED ou CORRECTED ### Validation des champs BIM ``` L'utilisateur modifie un champ → Demande de changement créée → validateurs notifiés → Tous les validateurs approuvent → champ PENDING_TO_MINT → minté = enregistrement on-chain → Un validateur rejette → tâche UPDATE_REJECTED_3D_MODEL_FIELD assignée au demandeur ``` *** ## Comment la blockchain enregistre les données Magma utilise trois contrats intelligents par bâtiment sur la blockchain VeChain : 1. **DTT Factory** — Un contrat partagé unique qui déploie de nouveaux contrats DTT lors de la création de bâtiments 2. **DTT Contract (ERC-1155)** — Un par bâtiment. Contient plusieurs IDs de tokens — un par version de fichier de document et un par version d'objet BIM 3. **HashStorage Contract** — Un par bâtiment, associé au DTT. Stocke un tableau de hachages en mode ajout uniquement par ID de token Lorsque vous téléversez une deuxième version d'un document, un nouveau hachage est ajouté au tableau du même ID de token. Le hachage de la version originale n'est jamais écrasé. Vous pouvez vérifier n'importe quelle version historique en interrogeant le hachage à sa position d'index. L'adresse du DTT® est publique. Toute personne peut visiter `/dtt/[adresse]` pour consulter la hiérarchie complète des tokens du bâtiment, tous les éléments mintés et leurs hachages on-chain. --- # 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/introduction/how-it-works.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.