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.

Catégories:
1Ingénierie backend	/fr/categories/backend/	software.engineer.company	70
1Bases de données	/fr/categories/databases/	software.engineer.company	70
1PostgreSQL	/fr/categories/postgresql/	software.engineer.company	70
1Gouvernance des données	/fr/categories/data-governance/	software.engineer.company	70
1Migrations et modernisation	/fr/categories/migration/	software.engineer.company	70

Prestations:
1Développement backend et API	/fr/services/backend-development/	software.engineer.company	70
1Conception et modélisation de bases de données	/fr/services/database-design/	software.engineer.company	70
1Gouvernance et qualité des données	/fr/services/data-governance/	software.engineer.company	70

hCette page sur le Web	URL:https://software.engineer.company/fr/portfolio/implemented-a-catalogue-driven-deep-merge/	software.engineer.company	70
