Combinación recursiva guiada por un catálogo
Implementé una combinación recursiva de preferencias JSON
almacenadas, guiada por un catálogo, para evitar fallos por claves
ausentes a medida que evoluciona el esquema.
2025

Situación. La plataforma almacena preferencias JSON — ajustes de
notificaciones y similares — superponiendo los valores guardados de
un usuario a un conjunto de valores predeterminados. La combinación
original lo hacía en un solo nivel. El problema aparece después: al
añadir una clave nueva a los valores predeterminados, las filas
guardadas antes de que existiera sencillamente no la tienen.
Entonces algún código del cliente lee ese campo, obtiene undefined y
falla — precisamente para los usuarios que llevan más tiempo en la
plataforma.

Tarea. La evolución del esquema de preferencias debía ser segura, de
modo que añadir un ajuste nunca pudiera perjudicar a quienes se
registraron antes de que existiera.

Acción. La combinación de un solo nivel se sustituyó por una
combinación profunda guiada por los valores predeterminados como
catálogo. Los valores predeterminados se tratan como la lista
autorizada de todas las claves que deben existir; los valores
guardados del usuario se superponen de forma recursiva, de modo que
se garantiza la presencia de cualquier elemento del catálogo,
estuviera o no en el bloque guardado. Al añadir una clave a los
valores predeterminados, aparece automáticamente en las preferencias
efectivas de todas las filas existentes, incluidas las claves
anidadas. Se introdujo mediante una migración para que los datos
existentes se beneficiaran de inmediato, sin esperar a que se
reescribieran.

Resultado. Las preferencias pueden crecer sin temor. Añadir un
ajuste ya no implica el riesgo de un fallo en el cliente por un
campo undefined, y el frontend dejó de necesitar comprobaciones
defensivas dispersas por cada lugar donde lee una preferencia.
También proporcionó al resto de la plataforma una forma fiable de
ampliar cualquier bloque JSON almacenado — el patrón, no solo esa
corrección concreta.

Categorías:
1Ingeniería de backend	/es/categories/backend/	data.engineer.company	70
1Bases de datos	/es/categories/databases/	data.engineer.company	70
1PostgreSQL	/es/categories/postgresql/	data.engineer.company	70
1Gobernanza de datos	/es/categories/data-governance/	data.engineer.company	70
1Migraciones y modernización	/es/categories/migration/	data.engineer.company	70

Servicios:
1Desarrollo de backend y API	/es/services/backend-development/	data.engineer.company	70
1Diseño y modelado de bases de datos	/es/services/database-design/	data.engineer.company	70
1Gobernanza y calidad de datos	/es/services/data-governance/	data.engineer.company	70

hEsta página en la web	URL:https://data.engineer.company/es/portfolio/implemented-a-catalogue-driven-deep-merge/	data.engineer.company	70
