using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GB5Shared.DTO.Framework.Login;
using GB5Shared.DTO.Qualifier;

namespace GB5Shared.GOP.Qualifier.Executors
{
    // ============================================================
    // IQualifierMethodExecutor
    //
    // One implementation per ExecutionMode (NCalc / DataSource / Service).
    // Registered as keyed scoped services in DI:
    //   services.AddKeyedScoped<IQualifierMethodExecutor, NCalcEvaluator>("NCalc");
    //   services.AddKeyedScoped<IQualifierMethodExecutor, DataSourceExecutor>("DataSource");
    //   services.AddKeyedScoped<IQualifierMethodExecutor, ServiceExecutor>("Service");
    //
    // Dispatch: sp.GetRequiredKeyedService<IQualifierMethodExecutor>(modeKey)
    // ============================================================
    public interface IQualifierMethodExecutor
    {
        /// <summary>"NCalc", "DataSource", or "Service" — matches keyed DI registration.</summary>
        string ExecutionModeKey { get; }

        /// <summary>
        /// Executes the method and writes any output facts to ctx.Facts.
        /// Returns zero or more findings (validation failures, warnings, info).
        /// </summary>
        Task<IReadOnlyList<QualifierFinding>> ExecuteAsync(
            SnapshotMethod           method,
            QualifierExecutionContext ctx,
            LoginDTO                 loginDTO,
            CancellationToken         ct);
    }
}