using GB5Shared.DTO.Framework.Login;
using SwDAL.DTO.RolloutCampaign;

namespace SwBLL.RolloutCampaign;

public interface IRolloutCampaignBLL
{
    /// <summary>Resolves the target set per dto.TargetScope, creates the campaign row plus one
    /// RolloutTarget row per resolved ClientDbId. Returns the new RolloutCampaignId.</summary>
    Task<int> CreateCampaignAsync(RolloutCampaignDTO dto, LoginDTO login, CancellationToken ct);

    Task<RolloutCampaignStatusDTO> GetCampaignStatusAsync(int rolloutCampaignId, LoginDTO login, CancellationToken ct);

    /// <summary>Flat, unpaginated list of every campaign for this tenant, newest first — for
    /// an admin browse screen. Realistic volume per tenant is small (see GET_LIST's own
    /// comment).</summary>
    Task<IEnumerable<RolloutCampaignDTO>> GetListAsync(LoginDTO login, CancellationToken ct);

    /// <summary>Per-target status/error detail for one campaign — the drill-down an admin needs
    /// to Defer/Skip a specific target (both need a real RolloutTargetId, only discoverable
    /// from this list).</summary>
    Task<IEnumerable<RolloutTargetDTO>> GetTargetsAsync(int rolloutCampaignId, LoginDTO login, CancellationToken ct);

    /// <summary>Explicitly delay one target — independent of every other target in the same
    /// campaign and of the campaign's own ScheduledStartOn.</summary>
    Task DeferTargetAsync(int rolloutTargetId, DateTime deferredUntil, LoginDTO login, CancellationToken ct);

    /// <summary>Permanently excludes one target from this campaign — never retried by it. Does
    /// not affect whether that same client database is included in a future campaign.</summary>
    Task SkipTargetAsync(int rolloutTargetId, LoginDTO login, CancellationToken ct);

    /// <summary>The operator's own confirmation that they ran SwOfflineApply successfully for a
    /// target sitting AwaitingManualApply (tracker §53) — only valid from that status. Moves it
    /// to Applied, letting the campaign's own rollup finally consider it done.</summary>
    Task MarkManuallyAppliedAsync(int rolloutTargetId, LoginDTO login, CancellationToken ct);

    /// <summary>Worker entry point (called by RolloutCampaignWorkerJob) — finds every target
    /// currently due (Pending, or Deferred with DeferredUntil passed, on a campaign whose own
    /// ScheduledStartOn has arrived) and applies each one, updating status as it goes. Returns
    /// the number of targets processed this pass.</summary>
    Task<int> ProcessDueTargetsAsync(LoginDTO login, CancellationToken ct);
}