namespace GB5Shared.DTO.Qualifier
{
    /// <summary>
    /// A single finding produced by a qualifier rule condition evaluation.
    /// Findings are collected into QualifierResult.Findings and returned to the caller.
    /// </summary>
    public sealed class QualifierFinding
    {
        public FindingSeverity Severity      { get; init; }
        public string          Code          { get; init; } = string.Empty;
        public string          Message       { get; init; } = string.Empty;

        /// <summary>JSONPath to the offending field in the source document (e.g. "$.Header.Amount").</summary>
        public string?         DocumentPath  { get; init; }

        /// <summary>0-based line index for line-level findings; null for document-level.</summary>
        public int?            LineIndex     { get; init; }

        /// <summary>Group key for group-level findings (from QualifierFactBag groups).</summary>
        public string?         GroupKey      { get; init; }

        public int             QualifierId   { get; init; }
        public string          QualifierCode { get; init; } = string.Empty;
    }
}