Código

Basado en el problema que fui el primero en resolver en Totalplay

Recuperación de la Exception Queue de Oracle AQ

Miles de clientes atorados, sin que nadie lo supiera.

C# 81%SQL 13%MSBuild 6%15 archivos729 líneas de código 9/9 pruebas
namespace AqRecovery;

/// <summary>Mensaje leído de la exception queue.</summary>
public sealed record QueueMessage(
    string MessageId,
    string? CorrelationId,
    byte[] Payload,
    DateTimeOffset EnqueuedAt);

public enum RecoveryActionKind
{
    /// <summary>Se regresa a la cola original con un retraso para reintentar.</summary>
    Requeue,

    /// <summary>Se aparta para revisión humana. Nunca se descarta en silencio.</summary>
    ManualReview,
}

public sealed record RecoveryAction(RecoveryActionKind Kind, TimeSpan Delay, string Reason)
{
    public static RecoveryAction Requeue(TimeSpan delay, string reason) => new(RecoveryActionKind.Requeue, delay, reason);
    public static RecoveryAction Review(string reason) => new(RecoveryActionKind.ManualReview, TimeSpan.Zero, reason);
}

/// <summary>
/// Unidad de trabajo transaccional: desencolar de la exception queue y reencolar (o apartar)
/// ocurre en la misma transacción. Si algo falla antes de <see cref="CommitAsync"/>,
/// el mensaje regresa a la exception queue y nada se pierde.
/// </summary>
public interface IRecoveryUnitOfWork : IAsyncDisposable
{
    Task<QueueMessage?> DequeueAsync(CancellationToken cancellationToken);
    Task RequeueAsync(QueueMessage message, TimeSpan delay, CancellationToken cancellationToken);
    Task MoveToManualReviewAsync(QueueMessage message, string reason, CancellationToken cancellationToken);
    Task RecordAuditAsync(AuditEntry entry, CancellationToken cancellationToken);
    Task CommitAsync(CancellationToken cancellationToken);
}

public interface IRecoveryGateway
{
    Task<IRecoveryUnitOfWork> BeginAsync(CancellationToken cancellationToken);

    /// <summary>Cuántas veces ya se intentó recuperar este mensaje (según la bitácora).</summary>
    Task<int> GetRecoveryAttemptsAsync(string correlationKey, CancellationToken cancellationToken);
}

/// <summary>Registro de auditoría. No incluye el contenido del mensaje: puede tener datos personales.</summary>
public sealed record AuditEntry(
    string MessageId,
    string? CorrelationId,
    string SourceQueue,
    RecoveryActionKind Action,
    string Reason,
    int Attempt);