shoc-backend/SeaHaven.Services/Interfaces/ISlaBreachAcknowledgementService.cs

using System.Security.Claims;

namespace SeaHaven.Services.Interfaces
{
    public enum SlaBreachAcknowledgementOutcome
    {
        Acknowledged,
        /// <summary>This breach was already acknowledged; nothing new is recorded.</summary>
        AlreadyAcknowledged,
        /// <summary>Not an SLA work order the caller's Notification Center covers (another account or dispatcher, closed, no SEV level).</summary>
        NotFound,
        /// <summary>The work order has not missed its response deadline.</summary>
        NotBreached
    }

    /// <summary>
    /// Acknowledging a missed SEV response deadline from the Notification Center: records who and when in
    /// the work order's audit history, which is also what removes the breach row from the feed.
    /// </summary>
    public interface ISlaBreachAcknowledgementService
    {
        Task<SlaBreachAcknowledgementOutcome> AcknowledgeAsync(
            ClaimsPrincipal user, int workOrderId, CancellationToken cancellationToken);
    }
}