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

namespace GB5Shared.GOP.Qualifier
{
    // ============================================================
    // IQualifierBLL — Qualifier Engine Business Logic
    //
    // Save/Update/Activate operations use the ExecuteSaveAsync
    // pattern: BeginTransaction → GetAutoNumber → DAL callback →
    // CommitTransaction. All writes are transactional.
    //
    // ActivateQualifierVersion must archive the currently Active
    // version and activate the target version in the same DB
    // transaction to prevent dual-active-version on crash.
    // ============================================================
    public interface IQualifierBLL
    {
        // ── Definition ────────────────────────────────────────────

        Task<string> SaveQualifierDefinition(QualifierDefinitionDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifier(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<QualifierDefinitionDTO?> GetQualifierById(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<QualifierDefinitionDTO?> GetQualifierByCode(string qualifierCode, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierDefinitionDTO>> GetQualifierList(LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierDefinitionDTO>> GetSelectListQualifier(CriteriaDTO criteriaDTO, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierLibraryDTO>> GetQualifierLibrary(LoginDTO loginDTO, CancellationToken ct = default);

        // ── Version ───────────────────────────────────────────────

        Task<string> SaveQualifierVersion(QualifierVersionDTO dto, LoginDTO loginDTO, CancellationToken ct = default);

        /// <summary>
        /// Compiles the qualifier plan (topological sort, NCalc/SQL validation),
        /// archives the currently Active version, and activates the target version —
        /// all inside a single DB transaction.
        /// </summary>
        Task<string> ActivateQualifierVersion(int qualifierVersionId, int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);

        Task<QualifierVersionDTO?> GetActiveQualifierPlan(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierVersionDTO>> GetQualifierVersionList(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);

        /// <summary>Only a Draft (VersionStatus=0) version may be deleted — Active/Archived versions
        /// are audit/replay history and must never be removable. Throws ArgumentException otherwise.</summary>
        Task<string> DeleteQualifierVersion(int qualifierVersionId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Entity (bindings) ─────────────────────────────────────

        Task<string> SaveQualifierEntity(QualifierEntityDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierEntityDTO>> GetEntityBindings(string entityCode, byte stage, byte scope, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierEntityDTO>> GetEntityBindingsByQualifier(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Method ────────────────────────────────────────────────

        Task<string> SaveQualifierMethod(QualifierMethodDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierMethodDTO>> GetQualifierMethods(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierMethod(int qualifierMethodId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Rule Groups ───────────────────────────────────────────

        Task<string> SaveQualifierRuleGroup(QualifierRuleGroupDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierRuleGroupDTO>> GetRuleGroups(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierRuleGroup(int ruleGroupId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Rule Conditions ───────────────────────────────────────

        Task<string> SaveQualifierRuleCondition(QualifierRuleConditionDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierRuleConditionDTO>> GetRuleConditions(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierRuleCondition(int conditionId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Outputs ───────────────────────────────────────────────

        Task<string> SaveQualifierOutput(QualifierOutputDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierOutputDTO>> GetQualifierOutputs(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierOutput(int outputId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Dependencies ──────────────────────────────────────────

        Task<string> SaveQualifierDependency(QualifierDependencyDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierDependencyDTO>> GetQualifierDependencies(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierDependency(int dependencyId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Scope ───────────────────────────────────────────────────

        Task<string> SaveQualifierScope(QualifierScopeDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<QualifierScopeDTO>> GetQualifierScopes(int qualifierId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteQualifierScope(int qualifierScopeId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Clone ─────────────────────────────────────────────────

        /// <summary>
        /// Deep-clones a qualifier definition with all its rule groups, conditions,
        /// outputs, methods, and dependencies into a new qualifier.
        /// All ParentRuleGroupId references within rule groups are remapped to the
        /// cloned IDs — no dangling foreign key references remain.
        /// The clone is created as Status=1 (active definition), no active version.
        /// </summary>
        Task<string> CloneQualifier(
            int sourceQualifierId,
            string newQualifierCode,
            string newQualifierName,
            LoginDTO loginDTO,
            CancellationToken ct = default);
    }
}