---
title: "Bâtiments GMAO — Documentation Fonctionnelle"
module: gmao
type: functional
status: active
updated: 2026-08-11
---

# Bâtiments GMAO — Documentation Fonctionnelle

> Gérez le parc immobilier de vos clients : bâtiments, logements, pièces et locataires, avec suivi des équipements rattachés.

---

## Vue d'ensemble

Le module Bâtiments GMAO permet de modéliser la hiérarchie immobilière d'une entité cliente :

```
Adresse
└── Bâtiment(s)
    └── Logement(s) / Lot(s)
        ├── Pièce(s)
        └── Locataire(s)
```

Chaque niveau dispose de sa propre fiche avec informations techniques, et les équipements peuvent être rattachés à n'importe quel niveau de la hiérarchie.

---

## Accès

- **Menu :** GMAO > Bâtiments
- **Module requis :** GMAO (13050101)
- **Droits :** consultation, modification et suppression gérés séparément par profil

---

## Fonctionnalités principales

### Liste des bâtiments

La liste affiche tous les bâtiments du parc avec des filtres par :
- **Recherche textuelle** sur le nom, l'identifiant ou l'adresse spécifique du bâtiment (voie, code postal, ville)
- **Adresse** : filtrer par une ou plusieurs adresses
- **Entité cliente** : filtrer par entité rattachée
- **Type d'immeuble** (liste paramétrable)
- **Type ERP / Catégorie ERP** (établissement recevant du public)
- **Propriétaire** : afficher uniquement les bâtiments dont le client est propriétaire

Un export Excel/CSV est disponible depuis la liste.

### Fiche bâtiment

Chaque fiche contient :

- **Informations générales** : nom, description, plan (image), adresse de rattachement
- **Adresse spécifique du bâtiment** : voie, code postal et ville propres au bâtiment, à renseigner lorsqu'il est physiquement situé ailleurs que le site auquel il est rattaché (voir ci-dessous)
- **Caractéristiques** : surface totale, surface terrain, surface utile, année de construction, nombre de niveaux
- **Classification** : type d'immeuble, type ERP, catégorie ERP
- **Champs personnalisés** : extensible via le système de champs custom

En mode modification, des onglets supplémentaires apparaissent :
- **Logements** : liste des logements/lots du bâtiment avec recherche
- **Pièces** : liste de toutes les pièces du bâtiment (toutes lots confondus)
- **Équipements** : liste des équipements directement rattachés au bâtiment

### Logements (lots)

Depuis l'onglet Logements d'un bâtiment, il est possible de :
- **Lister** tous les logements avec nom, type, surface et position (étage)
- **Créer** un nouveau logement via une modale sans quitter la page
- **Accéder** à la fiche complète de chaque logement

Chaque logement dispose de sa propre fiche avec : type de logement, surface, étage, usage, classement énergétique, numéro de copropriété/notaire, montant de loyer et date de bail.

### Pièces

L'onglet Pièces affiche l'ensemble des pièces de tous les logements du bâtiment :
- Nom, type de pièce, surface, logement parent
- Lien vers la fiche de chaque pièce

### Équipements du bâtiment

L'onglet Équipements liste les équipements directement attachés au bâtiment (distincts des équipements de logements ou pièces). Fonctionnalités :
- **Filtres** : statut, type d'équipement, recherche textuelle
- **Persistance des filtres** par bâtiment (chaque bâtiment conserve ses propres filtres)
- **Création rapide** : bouton pré-rempli avec la localisation bâtiment

---

## Adresse spécifique d'un bâtiment

Par défaut, l'adresse d'un bâtiment est celle du site (adresse client) auquel il est rattaché. Lorsqu'un
bâtiment se trouve à une autre adresse, renseignez le bloc **« Adresse spécifique du bâtiment »** de sa
fiche : *N° et voie*, *Code postal*, *Ville*. Les trois champs sont facultatifs.

- Dès qu'**au moins un** de ces champs est renseigné, cette adresse remplace celle du site partout où le
  bâtiment est présenté : liste des bâtiments (avec la mention « Adresse spécifique »), fiche synthétique,
  export Excel et carte de l'onglet Localisation.
- Si aucun n'est renseigné, rien ne change : l'adresse du site continue de s'afficher.
- L'**adresse de rattachement reste obligatoire** : c'est elle qui détermine l'entité cliente propriétaire
  du bâtiment et donc sa visibilité. L'adresse spécifique est purement descriptive et n'affecte ni les
  droits, ni les filtres par adresse ou par entité.

---

## Saisie des surfaces

Les surfaces en m² (bâtiment, logement, pièce) acceptent les décimales. La **virgule et le point** sont
tous deux acceptés à la saisie comme au collage : `12,5` et `12.5` sont enregistrés à l'identique.

---

## Hiérarchie des localisations

Les équipements sont rattachés via un champ de type localisation :

| Niveau | Valeur `tplocation` | Description |
|--------|---------------------|-------------|
| Bâtiment | `building` | Équipement commun au bâtiment entier |
| Logement | `lot` | Équipement d'un logement spécifique |
| Pièce | `room` | Équipement d'une pièce précise |

---

## Locataires

Depuis la fiche d'un logement, un onglet Locataires permet de suivre l'historique des occupants avec dates d'entrée/sortie, montant du loyer et caution.

---

## Comportements notables

- Un bâtiment est rattaché à une adresse client ; il n'est visible que pour l'entité cliente correspondante.
- Les logements et pièces hérités de plusieurs bâtiments restent isolés par tenant.
- La suppression d'un bâtiment est **définitive** : la table ne gère pas d'archivage, la ligne est réellement supprimée.
- La recherche sur le nom du bâtiment normalise espaces et tirets pour faciliter la correspondance.

---

## Voir aussi

- Documentation technique : `.claude/technical-docs/gmao/gmao-buildings.md`
- Documentation équipements : `docs/gmao/gmao-equipments.md`
