Ysidro Almonte
Resumen
Una plataforma inmobiliaria necesitaba que sus listados de propiedades se mantuvieran precisos sin re-entrada manual cada vez que cambiaban los datos de origen — precios, disponibilidad y detalles de propiedad debían reflejar el sistema externo dentro de WordPress.
El Desafío
Los datos inmobiliarios cambian constantemente y provienen de una fuente que WordPress no entiende de forma nativa. La integración debía mantener los listados actualizados sin corromper el contenido existente, sin degradar el rendimiento del sitio durante las sincronizaciones, y sin crear entradas duplicadas o huérfanas cuando se agregaban, actualizaban o eliminaban propiedades en el origen.
Mi Rol
Diseñé y construí toda la integración de principio a fin: el modelo de datos dentro de WordPress, la lógica de sincronización y las herramientas operativas para monitorearla.
Arquitectura
Los listados de propiedades viven como Custom Post Types con campos estructurados mapeados directamente al esquema de la API externa. Una capa de sincronización dedicada se encarga de obtener, comparar y escribir los datos — solo toca los campos que cambiaron, en vez de sobrescribir publicaciones completas en cada ejecución, lo que mantiene intactas las anulaciones editoriales y los metadatos de SEO entre sincronizaciones.
Implementación Técnica
- Clases de servicio en PHP que encapsulan por separado el cliente de la API, la capa de mapeo y la capa de escritura, de modo que cualquiera de las tres puede cambiar sin afectar a las demás.
- Endpoints de WP REST API que exponen los datos sincronizados a otras herramientas internas.
- Índices de MySQL en los campos usados para el emparejamiento, manteniendo la comparación rápida a medida que crece el número de listados.
Retos de Ingeniería
El problema más difícil no fue obtener los datos — fue la reconciliación. Las propiedades podían renombrarse, volver a listarse bajo un nuevo ID, o eliminarse y reinstalarse temporalmente en el origen, y una sincronización ingenua habría creado publicaciones duplicadas o eliminado listados en silencio.
Solución
Una estrategia de emparejamiento basada en un identificador externo estable (no el título o el slug) hizo que la reconciliación fuera determinista. Las ejecuciones de sincronización fallidas registran el error y reintentan en vez de aplicar cambios parcialmente, de modo que una ejecución rota nunca deja el sitio en un estado inconsistente.
Rendimiento / Seguridad / Escalabilidad
Las ejecuciones de sincronización se procesan en lotes y con límite de tasa contra la API externa, y se programan durante ventanas de bajo tráfico para que nunca compitan con las solicitudes de producción por recursos de base de datos.
Resultados
Los listados se mantienen actualizados sin intervención manual, los equipos editoriales dejaron de re-ingresar datos a mano, y la sincronización ha corrido en producción sin downtime.
Aprendizajes Clave
Este proyecto demuestra ingeniería de backend dentro de WordPress que va más allá del theming — modelado de datos, diseño de integraciones y mantenibilidad a largo plazo bajo un esquema que no está bajo mi control.