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.
Trabajo realizado: 2025
preferencias almacenadas que sobreviven a cambios del esquema
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.

Foto: congerdesign / Pixabay 
Foto: Myriams-Fotos / Pixabay
Aplique esta experiencia a su proyecto
Utilice «Combinación recursiva guiada por un catálogo» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. La parte que el usuario no ve: dónde se guardan los datos, qué reglas se aplican y cómo pueden comunicarse otros sistemas con ella.
Mire más allá del resultado
Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Combinación recursiva guiada por un catálogo — preferencias almacenadas que sobreviven a cambios del esquema
Vuelva a ver Datos PostgreSQL centrados en funciones. Lea a continuación: Monedero de fidelidad, ligas e insignias. O eche un vistazo al Portafolio completo.
Una parte de una trayectoria más amplia — y toda ella está en este sitio.
Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

