Flujos (diagramas de secuencia y estados)
Convenciones de los diagramas
- Todos los diagramas usan requestId y eventId explícitos cuando aplican.
- Los bordes muestran la capa (Cliente, API, PG, Pub/Sub, Worker, Fusion).
- Errores y flujos alternativos se documentan en sus secuencias específicas.
3.1 Secuencia - Creación exitosa
3.2 Secuencia - Error de validacion VALIDATION_FAILED
3.3 Secuencia - Consulta de estado
3.4 Secuencia - Reintento automatico RETRY_PENDING a PROCESSING
3.5 Secuencia - DLQ
3.6 Secuencia - Duplicado idempotencia multi capa
3.7 Secuencia - Transactional Outbox
3.8 Secuencia - Reproceso manual
3.9 Diagrama de estados
3.10 Secuencia - Actualizacion de regla audit
3.11 Secuencia - Oracle Fusion OAuth token y call
3.12 Secuencia - Observabilidad y propagacion de contexto
Recomendacion correlacion
- Propagar traceparent en Pub/Sub attributes.
- Logs siempre incluir requestId eventId partnerId sourceSystem.
- No incluir requestId como label de metricas Prometheus. Usar partnerId status ruleCode.