API Core B2B — Backend de sincronización y datos
10 de agosto de 2023
Backend centralizado para sincronizar catálogos, inventario y precios entre múltiples plataformas comerciales con integridad transaccional y trazabilidad de errores.
multicanal
API y datos
proyecto satélite
Contexto
Trabajé en el backend centralizado que sincroniza catálogos, inventario y precios entre múltiples plataformas comerciales, asegurando consistencia de datos y estableciendo un marco de trabajo estricto para mantener la calidad del código en todo el equipo.
Reto
Mantener los datos siempre consistentes entre varias plataformas que comparten el mismo sistema sin mezclar la información de cada negocio, con reglas claras de integridad y la posibilidad de rastrear cualquier error en producción de inmediato.
Tipo de colaboración
Definición de arquitectura, estandarización de código y mantenimiento evolutivo de integraciones backend.
Mi aporte
- Establecí reglas claras de arquitectura para que todo el equipo construyera la API de la misma forma, con estructura y validaciones predecibles.
- Hice que las operaciones complejas sean “todo o nada”: si algo falla a la mitad, el sistema deshace los cambios solo y los datos nunca quedan a medias.
- Eliminé el riesgo de borrar información por accidente: nada se borra de verdad, solo se marca como inactivo guardando quién y cuándo.
- Monté un sistema que ante cualquier error entrega un folio de seguimiento al usuario, así soporte localiza la causa exacta en segundos en lugar de horas.
Resultado
El equipo desarrolla sobre una base sólida y consistente. Los datos se sincronizan de forma confiable, no se pierde información por errores y cualquier falla en producción es rastreable al instante con un folio único, reduciendo la deuda técnica y el tiempo de resolución de incidentes.
Stack
PHP, REST APIs, MySQL, Arquitectura de Software, Estandarización de Código
Estandarización y reglas estrictas Mostrar más
Cuando múltiples desarrolladores tocan la misma API, la consistencia se rompe. El verdadero reto no era solo crear endpoints, sino establecer un marco de trabajo estricto que garantizara calidad y seguridad en entornos multitenant:
- Estructura predecible de endpoints. Se estandarizó el uso del enrutador y la separación de cada operación CRUD con firmas de entrada y salida JSON idénticas.
- Aislamiento de datos por instancia. Cada endpoint valida e impone el contexto del tenant de forma automática, previniendo fugas de información entre clientes del sistema.
Tolerancia a fallos y borrado lógico Mostrar más
Para proteger la integridad de los datos transaccionales, se implementaron políticas a nivel de código:
- Transacciones SQL atómicas. Operaciones complejas se envuelven en transacciones con rollback automático ante cualquier fallo intermedio, protegiendo la consistencia del sistema.
- Política estricta de borrado lógico. Se eliminó por completo la posibilidad de borrado físico en la base de datos. Cada eliminación se convierte en un marcado lógico con metadatos de auditoría (usuario, fecha y hora), manteniendo trazabilidad completa.
Trazabilidad y log de errores Mostrar más
Para acelerar la resolución de bugs, se diseñó un flujo de captura integral de excepciones:
Cualquier excepción de base de datos o fallo en el flujo se registra automáticamente en un sistema de auditoría. Este sistema genera un folio único de seguimiento que se devuelve como respuesta JSON al cliente.
Esto redujo drásticamente el tiempo de depuración en producción: el equipo de soporte ahora solo pide al usuario el folio de seguimiento para localizar de inmediato el archivo exacto, la consulta fallida y el motivo técnico.