Conventions de millesimage de la BDNB

La BDNB suit un double millesimage :

  • Le millesime des données au format YYYY-MM.{a:z} : caractérise la fraicheur des données
  • La version du schéma de données, au format Semver pour caractériser la structure de la données.

Exemple : 2022-10.c (format v0.7.3)

Les changements du millesime

Au format millesime YYY-MM.{a:z} (ex : 2022-10.c)

La date du millesime majeur change à chaque fois que nous relançons le croisement géospatial entre les différentes bases de données qui constituent le coeur de la base (BAN, Fichiers Fonciers, BDTOPO)

Le millesime mineur est incrémenté à chaque mise à jour de la base de données (ex : nouveaux millesime des données locales de l’energie

Les changements de version

Au format vX.Y.Z (ex : v0.7.3)

X : la version majeur du modèle de données est incrémentée à chaque rupture d’API lié au coeur de la BDNB. Ex : Renommage/suppression de colonne ou table du coeur

Y : la version mineur du modèle de données : est incrémentée à chaque modification de l’API sur les tables métiers de la BDNB. Ex : Renommage/suppression de colonne/table liés aux dpe ou merimée par exemple

Z : la version de patch : est incrémentée à chaque ajout de colonne / table

Note: La version initiale 0 ne garantit pas la stabilité complète des formats. La feuille de route vise une stabilité des modèles de données et API à partir de la 1.0. Nous nous interdisons les changements majeurs dans la mesure du possible, mais l’objectif est de converger rapidement vers un modèle de données compatible avec le futur référentiel de bâtiments