using System.Collections.Generic;

namespace FrameworkDAL.DTO.EIPConversation
{
    /// <summary>
    /// Configuration for a QUALIFY step — runs the GOP Qualifier engine against
    /// selected context variables, then optionally transforms the enriched facts
    /// through a Mapper. Supports lookup, validation, and enrichment use cases.
    /// </summary>
    public class EIPQualifyConfigDTO
    {
        /// <summary>
        /// Entity code registered in MQUALIFIERENTITY (e.g. "EIPCustomer", "EIPLead").
        /// Maps to QualifierExecutionContext.EntityCode.
        /// </summary>
        public string BoundToType { get; set; } = "";

        /// <summary>
        /// Context variable key holding the entity primary key (int).
        /// Pass "0" or omit for new-entity qualification.
        /// </summary>
        public string? BoundToIdContextKey { get; set; }

        /// <summary>
        /// Context variable keys to serialize into the qualifier payload JSON.
        /// E.g. ["Name", "Phone", "Email"] → { "Name": "...", "Phone": "..." }
        /// When empty, the entire context.Variables dict is serialized.
        /// </summary>
        public List<string> InputKeys { get; set; } = new();

        /// <summary>Qualifier execution stage byte (1=PreValidate, 2=PreWorkflow, 3=PrePersist). Default 1.</summary>
        public byte Stage { get; set; } = 1;

        /// <summary>Qualifier scope byte (0=default). Match MQUALIFIERENTITY.SCOPE.</summary>
        public byte Scope { get; set; } = 0;

        /// <summary>
        /// Context key to store the serialized QualifierFactBag.ExportAll() dict after execution.
        /// Available for dot-notation in subsequent steps: {CustomerFacts.Document.CreditLimit}
        /// </summary>
        public string? OutputFactKey { get; set; }

        /// <summary>Optional mapper code to run on the fact export JSON after successful qualification.</summary>
        public string? MapperCode { get; set; }

        /// <summary>Context key to store the mapped output JSON when MapperCode is set.</summary>
        public string? OutputMapKey { get; set; }

        /// <summary>
        /// Step to route to when the qualifier returns any Error-severity finding.
        /// context.Variables["_QualifyError"] will contain the first error message.
        /// When null, errors are stored but flow continues to NextStepCode.
        /// </summary>
        public string? OnValidationErrorStepCode { get; set; }
    }
}