# Tableau de bord des bâtiments

Le tableau de bord Bâtiments est votre hub central pour gérer toutes les propriétés auxquelles vous avez accès sur la plateforme Magma. Il offre une vue d'ensemble de chaque bâtiment dans votre portefeuille, avec un accès rapide aux fonctionnalités de chaque bâtiment, des indicateurs de statut et des actions de gestion.

***

## Accéder au tableau de bord

Après la connexion, le tableau de bord Bâtiments est le premier écran que vous voyez. Vous pouvez également y revenir à tout moment en cliquant sur le logo Magma ou sur l'élément **Bâtiments** dans la navigation principale.

***

## Modes d'affichage

Le tableau de bord prend en charge deux modes d'affichage, que vous pouvez basculer via le sélecteur de disposition en haut à droite de la barre d'outils :

### Vue en grille (par défaut)

Les bâtiments s'affichent sous forme de cartes arrangées dans une grille adaptative. Chaque carte offre un aperçu visuel du bâtiment :

* **Image de couverture** — La photo de couverture du bâtiment (définie via la fonctionnalité Galerie). Si aucune couverture n'est définie, un espace réservé par défaut est affiché.
* **Nom du bâtiment** — Affiché en évidence sous l'image.
* **Adresse** — Ville et pays du bâtiment.
* **Type de bâtiment** — L'un des 9 types pris en charge : Hôtel, Public, Industriel, Entrepôt, Usage mixte, Commercial, Résidentiel, Bureau ou Médical.
* **Magma Index** — Un indicateur de progression circulaire affichant le score global de complétude de documentation du bâtiment.
* **Badge de statut** — Reflète le statut opérationnel actuel du bâtiment (voir Couleurs et icônes de statut ci-dessous).
* **Menu d'actions rapides** — Un menu à trois points (⋯) donnant accès aux actions au niveau du bâtiment sans avoir à l'ouvrir.

### Vue tableau

Les bâtiments s'affichent sous forme de lignes dans un tableau triable. Chaque ligne inclut les colonnes suivantes :

| Colonne           | Description                                               |
| ----------------- | --------------------------------------------------------- |
| Nom du bâtiment   | Lien cliquable pour ouvrir le bâtiment                    |
| Adresse           | Adresse complète ou ville/pays                            |
| Type              | Label du type de bâtiment                                 |
| Magma Index       | Score numérique (%)                                       |
| Parties prenantes | Nombre de parties prenantes enregistrées                  |
| Statut            | Badge de statut (voir ci-dessous)                         |
| Abonnement        | Plan d'abonnement actuel (Essential / Premium / Infinity) |
| Actions           | Icônes d'actions rapides                                  |

La vue tableau est particulièrement utile pour gérer de grands portefeuilles, car elle permet une analyse et un tri plus rapides sur de nombreux bâtiments.

***

## Couleurs et icônes de statut des bâtiments

Chaque carte ou ligne de bâtiment affiche un indicateur de statut reflétant son état actuel :

| Statut    | Couleur      | Description                                                                                                            |
| --------- | ------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Actif     | Vert         | Le bâtiment est pleinement opérationnel et toutes les fonctionnalités sont accessibles.                                |
| En retard | Orange/Jaune | Un paiement a échoué. Certaines fonctionnalités peuvent être restreintes selon le nombre de jours de retard.           |
| Archivé   | Rouge / Gris | Le bâtiment a été archivé en raison d'un non-paiement prolongé (jour 60). Toutes les fonctionnalités sont désactivées. |
| Suspendu  | Gris         | L'abonnement a été manuellement suspendu.                                                                              |
| Annulé    | Rouge        | L'abonnement a été annulé et ne sera pas renouvelé.                                                                    |

> **Remarque :** Les bâtiments au statut En retard ou Archivé affichent une bannière à l'intérieur du bâtiment expliquant quelles fonctionnalités sont restreintes et quelle action est requise.

***

## Filtres

Le tableau de bord inclut une barre de filtres au-dessus de la grille ou du tableau. Filtres disponibles :

### Recherche

Un champ de recherche en texte intégral qui filtre les bâtiments par nom ou adresse au fil de la saisie.

### Type de bâtiment

Un filtre déroulant ou à sélection multiple permettant d'afficher uniquement les bâtiments d'un type spécifique (ex. uniquement les bâtiments Résidentiels, ou uniquement Bureau et Commercial).

### Statut

Filtrer par statut actuel du bâtiment : Actif, En retard, Suspendu, Annulé ou Archivé.

### Plan d'abonnement

Filtrer par niveau de plan : Essential, Premium ou Infinity.

### Mon rôle

Lorsqu'il est activé, affiche uniquement les bâtiments où vous avez un rôle de partie prenante actif assigné.

Les filtres peuvent être combinés. Le nombre de résultats se met à jour dynamiquement à mesure que les filtres sont appliqués.

***

## Tri

En vue tableau, cliquez sur n'importe quel en-tête de colonne pour trier par ce champ. Un deuxième clic inverse l'ordre de tri (croissant/décroissant). En vue grille, un menu déroulant de tri est disponible dans la barre d'outils avec les options suivantes :

* **Alphabétique (A → Z)**
* **Alphabétique (Z → A)**
* **Plus récent** — Basé sur la date de création du bâtiment.
* **Plus ancien** — Basé sur la date de création du bâtiment.
* **Dernière modification** — Basé sur l'activité la plus récente au sein du bâtiment.
* **Magma Index** — Score le plus élevé en premier.

***

## Actions par bâtiment

### Depuis la carte / ligne

* **Ouvrir le bâtiment** — Cliquez sur le nom du bâtiment, la carte ou la ligne pour naviguer dans le bâtiment et accéder à toutes ses fonctionnalités.
* **Menu d'actions rapides (⋯)** — Disponible au survol ou via un clic droit sur une carte ; disponible comme colonne d'icônes en vue tableau :
  * **Modifier les informations du bâtiment** — Mettre à jour le nom, l'adresse, le type ou l'image de couverture du bâtiment.
  * **Gérer les parties prenantes** — Ouvrir directement le panneau de gestion des parties prenantes.
  * **Voir l'abonnement** — Ouvrir la fenêtre de détails de l'abonnement.
  * **Archiver le bâtiment** — Archiver manuellement un bâtiment (nécessite le rôle Propriétaire ou Account Manager).
  * **Supprimer le bâtiment** — Supprimer définitivement le bâtiment (irréversible ; nécessite le rôle Propriétaire et une confirmation).

### Créer un nouveau bâtiment

Le bouton **+ Nouveau bâtiment** est bien visible en haut à droite du tableau de bord. En cliquant dessus, l'assistant de création de bâtiment en 5 étapes se lance. Consultez le guide [Création de bâtiment](/magma-documentation/fr/fonctionnalites/building-creation.md) pour tous les détails.

***

## États vides

### Aucun bâtiment encore

Lorsque votre compte ne comporte aucun bâtiment, le tableau de bord affiche un état vide illustré avec le message :

> « Vous n'avez encore aucun bâtiment. Créez votre premier bâtiment pour commencer. »

Un bouton d'appel à l'action **Créer un bâtiment** est affiché au centre de la page.

### Aucun résultat après filtrage

Si les filtres actifs ne renvoient aucun bâtiment correspondant, le tableau de bord affiche :

> « Aucun bâtiment ne correspond à vos filtres. »

Un bouton **Effacer les filtres** permet de réinitialiser tous les filtres actifs en un clic.

***

## Carte de bâtiment — Détail complet

En vue grille, survoler une carte de bâtiment révèle des affordances d'interaction supplémentaires :

| Élément             | Emplacement                    | Description                                                     |
| ------------------- | ------------------------------ | --------------------------------------------------------------- |
| Image de couverture | En haut de la carte            | Photo pleine largeur ; cliquer ouvre le bâtiment.               |
| Badge de statut     | Superposition en haut à droite | Point ou étiquette coloré indiquant le statut opérationnel.     |
| Nom du bâtiment     | Sous l'image                   | Texte en gras ; cliquable.                                      |
| Type de bâtiment    | Sous le nom                    | Petite étiquette en couleur neutre.                             |
| Adresse             | Sous le type                   | Ville et pays.                                                  |
| Magma Index         | En bas de la carte             | Anneau de progression circulaire avec étiquette de pourcentage. |
| Menu d'actions (⋯)  | En haut à droite au survol     | Affiche le menu déroulant d'actions rapides.                    |

***

## Conseils pour les grands portefeuilles

* Utilisez la **vue tableau** pour une analyse plus rapide lorsque vous gérez 10 bâtiments ou plus.
* Combinez les filtres **Type de bâtiment** et **Statut** pour prioriser les bâtiments nécessitant une attention (ex. filtrer sur En retard + tous les types).
* Le score **Magma Index** permet d'identifier les bâtiments avec une documentation incomplète — triez par index pour trouver ceux qui nécessitent le plus de travail.
* Épinglez les bâtiments fréquemment consultés avec l'icône étoile/favori (si disponible dans votre plan) pour les maintenir en haut de la grille.


---

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