# Visionneuse BIM 3D

La visionneuse BIM 3D offre une visualisation tridimensionnelle interactive du modèle IFC (Industry Foundation Classes) de votre bâtiment. Propulsée par **Speckle**, elle permet aux parties prenantes d'explorer la géométrie du bâtiment, d'inspecter des objets individuels, de gérer des champs de données structurées et de collaborer sur l'enrichissement des données — le tout au sein de la plateforme Magma.

***

## Accès à la visionneuse BIM 3D

La visionneuse BIM 3D est accessible de deux façons :

1. Depuis la **Data Room** — Naviguez vers un sous-dossier IFC et cliquez sur **Ouvrir dans BIM**.
2. Depuis la **navigation principale du bâtiment** — Cliquez sur l'onglet **Modèle 3D** ou **BIM** dans le menu du bâtiment.

***

## Format de fichier supporté et limites

| Propriété                  | Valeur                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------- |
| Format de fichier          | IFC (Industry Foundation Classes)                                                                 |
| Taille maximale du fichier | Jusqu'à 10 Go par fichier IFC                                                                     |
| Méthode d'envoi            | Téléversement par blocs (les fichiers volumineux sont découpés en blocs pour un transfert fiable) |

***

## Niveaux Magma du bâtiment

La visionneuse BIM 3D organise les données du bâtiment sur 7 niveaux hiérarchiques, chacun correspondant à une discipline ou une couche du bâtiment :

| Code | Niveau                            | Description                                                            |
| ---- | --------------------------------- | ---------------------------------------------------------------------- |
| S    | Structure                         | Éléments de génie civil (poteaux, poutres, dalles, fondations).        |
| A    | Architecture                      | Éléments architecturaux (murs, portes, fenêtres, plafonds, planchers). |
| W1   | Wired 1 — Mécanique               | Systèmes CVC, ventilation, climatisation.                              |
| W2   | Wired 2 — Plomberie               | Systèmes de plomberie, alimentation en eau, évacuation.                |
| W3   | Wired 3 — Éclairage               | Systèmes électriques, appareils d'éclairage, distribution d'énergie.   |
| W4   | Wired 4 — Appareils & Équipements | Appareils installés, équipements.                                      |
| W5   | Wired 5 — Sécurité & Sûreté       | Sécurité incendie, systèmes de sûreté, systèmes d'urgence.             |
| F    | Filled                            | Design intérieur, mobilier, éléments d'aménagement non structuraux.    |

> **Important :** **Genesis** n'est PAS un niveau BIM. Les documents Genesis (propriété, juridique, financier) existent uniquement dans la Data Room et ne sont pas représentés dans le modèle 3D.

***

## Structure des données d'objet

Chaque objet du modèle BIM peut stocker des données structurées organisées en 12 sections :

| Section                        | Description                                                                                         |
| ------------------------------ | --------------------------------------------------------------------------------------------------- |
| **INDEX\_LEVEL**               | Le niveau Magma auquel appartient cet objet (S, A, W1–W5, F).                                       |
| **OBJECT\_IDENTIFICATION**     | Nom, GUID IFC, type d'objet et identifiants uniques.                                                |
| **OBJECT\_CREATION**           | Fabricant, marque, référence du modèle, numéro de série, date d'installation.                       |
| **SPATIAL\_DATA**              | Niveau d'étage, pièce, zone, coordonnées, dimensions.                                               |
| **CONDITION\_ASSESSMENT**      | Évaluation de l'état actuel, notes d'inspection, historique de maintenance.                         |
| **COMPLIANCE**                 | Certifications, conformité aux normes, approbations réglementaires.                                 |
| **LIFECYCLE\_DATA**            | Informations de garantie, durée de vie prévue, calendrier de remplacement.                          |
| **SMART\_DATA**                | Identifiants des capteurs IoT, appareils connectés, liens vers les données du bâtiment intelligent. |
| **CONTRACT\_AND\_MAINTENANCE** | Contrats de maintenance, prestataires de services, détails des SLA.                                 |
| **FINANCIAL\_DATA**            | Coût d'acquisition, valeur actuelle, amortissement, valeur assurée.                                 |
| **OBJECT\_LIVE\_DATA**         | Flux de données en temps réel (lectures de capteurs, statut opérationnel).                          |
| **ADVANCED\_DATA**             | Champs personnalisés ou spécialisés non couverts par les autres sections.                           |

### Types de champs

Les champs au sein de chaque section sont typés :

| Type        | Description                                |
| ----------- | ------------------------------------------ |
| **TEXT**    | Chaîne de texte libre.                     |
| **NUMBER**  | Valeur numérique décimale.                 |
| **INTEGER** | Nombre entier.                             |
| **BOOLEAN** | Bascule vrai/faux.                         |
| **FILE**    | Pièce jointe (document, image, PDF).       |
| **SELECT**  | Liste déroulante avec options prédéfinies. |

***

## Panneau de détail de l'objet

Cliquer sur un objet dans la visionneuse 3D ouvre le **Panneau de détail de l'objet** sur le côté droit de l'écran. Ce panneau est organisé en onglets :

### Onglet OVERVIEW

Un résumé des informations d'identification clés de l'objet :

* Nom et type de l'objet
* GUID IFC
* Attribution du niveau Magma
* Score actuel de complétude des données

### Onglet BIM\_DATA

L'interface principale de saisie et de consultation des données, organisée en sous-onglets :

| Sous-onglet       | Contenu                                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------------------ |
| **Basic**         | Champs principaux issus de OBJECT\_IDENTIFICATION, SPATIAL\_DATA et d'autres sections fondamentales.   |
| **Smart Queries** | Requêtes avancées qui extraient des données calculées ou dérivées de plusieurs sections.               |
| **Live Basic**    | Champs OBJECT\_LIVE\_DATA affichant les données en temps réel des capteurs et données opérationnelles. |
| **Advanced**      | Champs de la section ADVANCED\_DATA pour les données spécialisées ou personnalisées.                   |

### Onglet BIM\_ORIGINAL\_DATA

Affiche les propriétés brutes, non traitées, extraites directement du fichier IFC original tel que téléversé. Il s'agit des données sources avant tout enrichissement Magma. Utile pour comparer ce qui figurait dans le modèle original avec ce qui a été ajouté via la plateforme.

### Onglet CF\_DATA

Données contractuelles et financières, organisées en deux sous-onglets :

| Sous-onglet   | Contenu                                                                                            |
| ------------- | -------------------------------------------------------------------------------------------------- |
| **Contract**  | Champs de la section CONTRACT\_AND\_MAINTENANCE (contrats de service, calendriers de maintenance). |
| **Financial** | Champs de la section FINANCIAL\_DATA (coûts, valeurs, amortissement).                              |

***

## Panneau latéral

La visionneuse inclut un panneau latéral rétractable sur le côté gauche de l'écran :

* **Masquer / Afficher la sélection** (icône œil) — Basculer la visibilité des objets actuellement sélectionnés dans la scène 3D.
* **Isoler / Dé-isoler** (icône filtre) — Isoler le(s) objet(s) sélectionné(s) afin que toute autre géométrie devienne transparente ou masquée, vous permettant de vous concentrer sur un élément spécifique.
* Le panneau latéral est **redimensionnable** — faites glisser le séparateur pour ajuster sa largeur.

***

## Outils de la visionneuse

La barre d'outils en haut ou sur le côté de la visionneuse donne accès à une suite d'outils. Chaque outil est également accessible via un raccourci clavier :

### Vues (Alt + Chiffre)

Basculer entre des vues de caméra prédéfinies :

| Raccourci | Vue             |
| --------- | --------------- |
| Alt+1     | Vue de dessus   |
| Alt+2     | Vue de face     |
| Alt+3     | Vue de gauche   |
| Alt+4     | Vue de derrière |
| Alt+5     | Vue de droite   |

### Modes d'affichage (Shift + Chiffre)

Modifier le mode de rendu visuel du modèle :

| Raccourci | Mode     | Description                                              |
| --------- | -------- | -------------------------------------------------------- |
| Shift+1   | Défaut   | Rendu ombré standard.                                    |
| Shift+2   | Arêtes   | Affichage des arêtes en mode filaire.                    |
| Shift+3   | Ombré    | Ombré lisse sans arêtes.                                 |
| Shift+4   | Stylo    | Rendu stylisé crayon/encre.                              |
| Shift+5   | Arctique | Rendu minimal blanc/clair pour une documentation épurée. |
| Shift+6   | Couleurs | Codage couleur basé sur le type d'objet.                 |

### Outils supplémentaires (Shift + Lettre)

| Raccourci   | Outil              | Description                                                                           |
| ----------- | ------------------ | ------------------------------------------------------------------------------------- |
| Shift+R     | Mesures            | Activer l'outil de mesure.                                                            |
| Shift+F     | Étages             | Ouvrir le sélecteur de niveau d'étage.                                                |
| Shift+P     | Projection         | Basculer entre la projection en perspective et orthographique.                        |
| Shift+B     | Boîte de section   | Activer une boîte de découpe pour couper le modèle et révéler les espaces intérieurs. |
| Shift+Space | Zoom ajusté        | Zoomer et déplacer pour faire tenir le modèle entier dans la vue.                     |
| Shift+M     | Modèles            | Ouvrir l'outil de gestion des modèles.                                                |
| Shift+S     | Recherche / Filtre | Ouvrir le panneau de recherche et de filtrage.                                        |
| Shift+E     | Explorateur        | Ouvrir l'explorateur d'objets (arborescence hiérarchique).                            |
| Shift+N     | Notifications      | Ouvrir le panneau de notifications.                                                   |
| Shift+T     | Tâches             | Ouvrir le panneau des tâches (affiche le badge de comptage).                          |

***

## Outil de mesure

Activé via **Shift+R**. L'outil de mesure permet une mesure précise des distances entre des points dans le modèle 3D.

### Types de mesure

| Type                | Description                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------ |
| **Point à point**   | Cliquez sur deux points dans le modèle pour mesurer la distance en ligne droite entre eux. |
| **Perpendiculaire** | Mesurer la distance perpendiculaire d'un point à une surface ou une arête.                 |

### Accrochage

L'outil s'accroche aux **sommets des objets** pour une mesure précise, vous permettant de capturer des distances exactes d'arête à arête ou de coin à coin.

### Unités

Les mesures peuvent être affichées dans l'une des unités suivantes, sélectionnables depuis les options de l'outil :

`mm` | `cm` | `m` | `km` | `in` | `ft` | `yd` | `mi`

***

## Outil Modèles (Shift+M)

L'outil Modèles gère les fichiers IFC chargés dans la visionneuse.

### Téléverser un nouveau fichier IFC

1. Ouvrez l'outil Modèles (Shift+M).
2. Cliquez sur **Téléverser un modèle**.
3. Sélectionnez votre fichier IFC (jusqu'à 10 Go). Les fichiers volumineux sont téléversés par blocs automatiquement.
4. Le modèle apparaît dans la liste avec un statut **EN ATTENTE** et une barre de progression.

### Statuts de traitement des modèles

| Statut         | Description                                                          |
| -------------- | -------------------------------------------------------------------- |
| **EN ATTENTE** | Le fichier est téléversé et en file d'attente pour le traitement.    |
| **ÉCHEC**      | Le traitement a échoué. Un bouton **Réessayer** est affiché.         |
| **DISPONIBLE** | Le traitement est terminé. Le modèle est chargé dans la visionneuse. |

### Supprimer un modèle

Un modèle peut être supprimé s'il y a plus d'un modèle chargé. Cliquez sur l'icône de suppression (corbeille) à côté du modèle dans la liste. La suppression retire la géométrie de la visionneuse mais n'affecte pas les documents stockés dans la Data Room.

***

## Outil Parties prenantes

L'outil Parties prenantes, accessible depuis la visionneuse BIM 3D, fournit toutes les fonctionnalités de gestion des parties prenantes sans quitter le contexte de la visionneuse. Vous pouvez :

* Consulter la liste des parties prenantes actuelles avec leurs rôles.
* Inviter de nouvelles parties prenantes.
* Modifier les rôles des parties prenantes existantes.
* Supprimer des parties prenantes.

Cela reflète le panneau complet de gestion des parties prenantes disponible dans les paramètres du bâtiment.

***

## Outil de filtrage (Shift+S)

Filtrer les objets visibles dans la scène 3D en fonction de leurs valeurs de champs BIM.

### Comment filtrer

1. Ouvrez l'outil de filtrage (Shift+S).
2. Sélectionnez un **champ** dans la liste déroulante (parmi les 12 sections de données).
3. Sélectionnez un **opérateur** (égal à, contient, supérieur à, inférieur à, etc.).
4. Entrez une **valeur** pour filtrer.
5. Cliquez sur **Appliquer**.

Les objets correspondant au filtre sont mis en surbrillance ou isolés dans la fenêtre d'affichage. Plusieurs filtres peuvent être combinés avec une logique ET/OU.

***

## Assistant d'initialisation

Pour les nouveaux bâtiments ou les fichiers IFC nouvellement téléversés, l'**Assistant d'initialisation** vous guide à travers la saisie initiale des données pour les 12 sections de tous les objets.

### Fonctionnement

1. L'assistant présente un **formulaire par section** pour chaque objet (ou groupe d'objets).
2. Pour chaque section, vous remplissez les champs pertinents.
3. L'**Assistant de données BIM originales** est disponible en tant que panneau d'aide — il affiche les propriétés IFC brutes extraites du fichier téléversé, qui sont **consultables** et peuvent être utilisées comme référence ou directement mappées pour remplir les champs du formulaire.
4. Un **indicateur de progression WebSocket** affiche l'état de traitement en temps réel au fur et à mesure que les données sont enregistrées et synchronisées.

L'assistant peut être mis en pause et repris. Les objets partiellement complétés sont sauvegardés automatiquement.

***

## Processus de demande de modification de champ

Lorsqu'une partie prenante souhaite modifier la valeur d'un champ sur un objet BIM, elle soumet une **Demande de modification de champ** plutôt que de modifier la valeur directement. Cela garantit l'intégrité des données via un processus d'approbation par les validateurs.

### Soumettre une demande de modification

1. Dans le Panneau de détail de l'objet, cliquez sur **Modifier** pour le champ que vous souhaitez changer.
2. Entrez la nouvelle valeur proposée.
3. Ajoutez une note facultative expliquant la raison du changement.
4. Soumettez la demande.

### Vote des validateurs

* Les validateurs assignés à l'objet ou au niveau sont notifiés de la modification en attente.
* Chaque validateur vote : **Approuver** ou **Rejeter**.
* Une raison de rejet doit être fournie lors d'un rejet.
* **Tous les validateurs assignés doivent approuver** pour que la modification soit appliquée. Si **un validateur rejette**, la demande de modification est bloquée.

### Popup des modifications en attente

Les validateurs voient une popup **Modifications en attente** lorsqu'ils ouvrent l'objet concerné. Cette popup affiche :

* **Valeur actuelle** — La valeur existante du champ.
* **Valeur proposée** — La nouvelle valeur demandée.
* **Statut du vote** — Qui a voté, qui est en attente.
* Boutons **Approuver** et **Rejeter** (avec champ de raison obligatoire pour le rejet).

### Intégration avec les tâches

Les demandes de modification de champ génèrent automatiquement des tâches **VALIDATE\_3D\_MODEL\_FIELD**, visibles dans le panneau [Tâches](/magma-documentation/fr/fonctionnalites/tasks.md) (Shift+T).

***

## Liens directs vers les objets

Tout objet dans la visionneuse BIM peut être directement lié. Le paramètre URL `?objectId=` ajouté à l'URL de la visionneuse ouvrira la visionneuse avec cet objet spécifique pré-sélectionné et mis en focus.

**Exemple :**

```
https://app.mymagma.com/buildings/[building-id]/bim?objectId=abc123
```

Ce lien peut être partagé avec les parties prenantes — en cliquant dessus, la visionneuse s'ouvre et sélectionne immédiatement l'objet spécifié. Les liens directs sont également utilisés par la fonctionnalité [Contributions de valeur](/magma-documentation/fr/fonctionnalites/value-contributions.md), où cliquer sur une ligne d'objet de modèle 3D dans le tableau des contributions ouvre la visionneuse sur cet objet exact.

***

## Conseils et bonnes pratiques

* Utilisez **Shift+B (Boîte de section)** pour couper à travers les murs et les planchers lors de l'inspection des systèmes MEP (Mécanique, Électrique, Plomberie) cachés à l'intérieur de la structure.
* Utilisez **Shift+F (Étages)** pour isoler un seul niveau d'étage et réduire l'encombrement visuel lors du travail sur les éléments intérieurs.
* L'**outil de filtrage** est puissant pour le contrôle qualité — filtrez les objets par les champs `CONDITION_ASSESSMENT` pour identifier rapidement les éléments en mauvais état.
* Complétez toujours l'**Assistant d'initialisation** pour les modèles nouvellement téléversés avant d'inviter les parties prenantes à examiner les données — des données incomplètes réduisent le score Magma Index.
* Utilisez les **liens directs** (`?objectId=`) lors de la coordination avec les parties prenantes dans les e-mails ou les descriptions de tâches pour les diriger vers l'objet exact en question.
* Téléversez plusieurs fichiers IFC spécifiques à chaque discipline (un par niveau : S, A, W1–W5, F) plutôt qu'un modèle combiné pour de meilleures performances et une meilleure organisation des donné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/bim-3d-viewer.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.
