# Fusion profonde pilotée par un catalogue

Mis en œuvre une fusion profonde des préférences JSON stockées, pilotée par un catalogue, pour éviter les erreurs dues aux clés absentes lors de l'évolution du schéma.

2025

Situation. La plateforme stocke des préférences JSON — paramètres de notification et autres — sous forme de valeurs enregistrées par l'utilisateur, superposées à un ensemble de valeurs prédéfinies. La fusion initiale ne le faisait que sur un seul niveau. Le problème apparaît plus tard : une nouvelle clé est ajoutée aux valeurs prédéfinies, mais les lignes enregistrées avant son existence ne la contiennent tout simplement pas. Du code client lit alors ce champ, obtient undefined et tombe en panne — précisément pour les utilisateurs présents depuis le plus longtemps.

Tâche. L'évolution du schéma de préférences devait être sûre, pour que l'ajout d'un paramètre ne puisse jamais pénaliser les personnes inscrites avant son existence.

Action. La fusion sur un seul niveau a été remplacée par une fusion profonde pilotée par les valeurs prédéfinies utilisées comme catalogue. Ces valeurs constituent la liste faisant autorité de toutes les clés devant exister ; les valeurs enregistrées par l'utilisateur sont fusionnées récursivement par‑dessus, garantissant la présence en sortie de chaque élément du catalogue, qu'il figure ou non dans le bloc enregistré. Une clé ajoutée aux valeurs prédéfinies apparaît automatiquement dans les préférences effectives de chaque ligne existante, clés imbriquées comprises. Le changement a été introduit par une migration pour bénéficier immédiatement aux données existantes, sans attendre leur réécriture.

Résultat. Les préférences peuvent évoluer sans crainte. Ajouter un paramètre ne risque plus de provoquer un plantage du client dû à un champ undefined, et l'interface n'a plus besoin de contrôles défensifs dispersés à chaque endroit où elle lit une préférence. Cela a également fourni au reste de la plateforme un moyen fiable d'étendre n'importe quel bloc JSON stocké — un schéma de solution, au‑delà d'une seule correction.

Rôle: Ingénieure bases de données
=> /fr/categories/backend/ Catégories: Ingénierie backend
=> /fr/categories/databases/ Catégories: Bases de données
=> /fr/categories/postgresql/ Catégories: PostgreSQL
=> /fr/categories/data-governance/ Catégories: Gouvernance des données
=> /fr/categories/migration/ Catégories: Migrations et modernisation
=> /fr/services/backend-development/ Prestations: Développement backend et API
=> /fr/services/database-design/ Prestations: Conception et modélisation de bases de données
=> /fr/services/data-governance/ Prestations: Gouvernance et qualité des données

=> https://data.engineer.company/fr/portfolio/implemented-a-catalogue-driven-deep-merge/ Cette page sur le Web
