Qué información guardar del evento original antes de transformarlo
Antes de transformar un evento, conserva identidad, contexto de recepción, versión y una referencia al original necesario para reconstruir el proceso.
Equipo enginerIT· 2 min de lectura
Antes de transformar un evento, conserva identidad, contexto de recepción, versión y una referencia al original necesario para reconstruir el proceso. Decide qué contenido completo necesitas y durante cuánto tiempo. Guardarlo todo en los logs no ofrece una trazabilidad útil y puede ampliar innecesariamente el acceso a información sensible.
Crea un sobre que sobreviva al cambio de formato
Registra proveedor, cuenta, identificador y tipo de evento, fecha de recepción y versión declarada del esquema o API. Añade referencia de correlación interna y resultado de validación. Mantén separados los datos originales y los calculados por tu transformación. Una fecha corregida o una unidad convertida debe indicar qué regla y versión la produjeron; así podrás diferenciar un problema del origen de un error introducido por el mapeo.
Conserva el original en el lugar adecuado
Si necesitas el cuerpo completo para reprocesar o investigar, almacénalo con controles de acceso, integridad y conservación acordados. Puedes dejar una referencia en la cola en lugar de copiar el contenido varias veces; el patrón Claim Check de Azure describe esa separación. Comprueba que la referencia siga siendo accesible durante la recuperación y que no permita acceso a cualquier persona que vea un log. No guardes credenciales de transporte como parte del evento de negocio.
Verifica antes de transformar
La validación de autenticidad puede necesitar bytes exactos. Stripe, por ejemplo, exige el cuerpo original para comprobar la firma. No confundas conservarlo para esa comprobación inmediata con una obligación de retenerlo indefinidamente. Después de validar, registra evidencia operativa suficiente sin exponer secretos. Si un campo nuevo no se reconoce, conserva el caso y su versión en lugar de sustituirlo por un valor vacío que borre la diferencia.
Haz una reconstrucción controlada
Toma un evento de prueba y reconstruye su resultado usando el original autorizado y la versión del mapeo. Compara valores y efectos previstos sin ejecutar escrituras durante la investigación. Prueba también referencia rota, contenido expirado y acceso denegado: el operador debe entender qué falta y cómo escalarlo. Si reprocesas con una regla nueva, registra otra ejecución relacionada y revisa efectos ya aplicados. Recuperar el contenido no autoriza repetir una acción externa ni saltarse una aprobación vigente.
Comprobaciones para cerrar la tarea
- ✓ Original y valores transformados pueden distinguirse.
- ✓ La referencia al contenido tiene permisos y plazo definidos.
- ✓ La reconstrucción puede ejecutarse sin repetir efectos.
Fuentes y documentación
- Azure: Claim Check — Separación de carga y referencia para mensajes grandes con almacenamiento externo.
- Stripe: recepción de webhooks — Documenta firma sobre cuerpo original, duplicados y ausencia de garantía de orden.
Aplicarlo en tu empresa
Podemos revisar el entorno y acordar qué actuaciones, validaciones y mantenimiento necesitas.
Conocer el servicio relacionado →