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.
Travaux réalisés : 2025
des préférences stockées qui résistent aux changements de schéma
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.

Photo : congerdesign / Pixabay 
Photo : Myriams-Fotos / Pixabay
Mettez cette expérience au service de votre projet
Prenez « Fusion profonde pilotée par un catalogue » comme point de départ pour un défi similaire dans votre organisation. Les prestations mobilisées pour cette réalisation sont disponibles pour votre projet. La partie invisible pour les utilisateurs : où résident les données, quelles règles s'appliquent et comment les autres systèmes peuvent y accéder.
Examinez ce qui a conduit au résultat
Découvrez la situation, les décisions et le résultat de cet exemple. Nous pouvons discuter des éléments transposables à vos contraintes et de ceux qui nécessitent une autre démarche. Fusion profonde pilotée par un catalogue — des préférences stockées qui résistent aux changements de schéma
Revenir sur Couche PostgreSQL fondée sur les fonctions. À lire ensuite : Portefeuille de fidélité, ligues et badges. Ou découvrez l'ensemble du Portfolio.
Un élément d'un parcours plus long — entièrement présenté sur ce site.
Chaque entrée suit la même structure : la situation, la tâche, ce que nous avons fait et ce qui a changé.

