namespace Admin.NET.Plugin.AiDOP.Service.S8.Rules.DataAccess;

/// <summary>
/// S8 canonical 行契约列名。
///
/// 这些名字此前散落在三个 evaluator 的 private const 里（S8-WATCH-EXPRESSION-COLUMN-CONTRACT-FIX-1
/// 引入），本类只是把同一批既有字面量集中声明，**不改变任何取值语义**：
/// evaluator 仍是"canonical 优先，缺失回退 params_json 指定的真实列名"。
///
/// STANDARD_DATASET 模式下 Provider 必须直接以这些列名产出行，从而天然命中 canonical 分支。
/// </summary>
public static class S8CanonicalColumns
{
    /// <summary>业务对象唯一标识。参与 DedupKey，格式变化会导致历史异常与新异常断代。</summary>
    public const string SourceObjectId = "source_object_id";

    /// <summary>业务对象展示编码。</summary>
    public const string RelatedObjectCode = "related_object_code";

    /// <summary>业务对象展示名称。</summary>
    public const string RelatedObjectName = "related_object_name";

    /// <summary>到期时间。TIMEOUT 判定字段。</summary>
    public const string DueAt = "due_at";

    /// <summary>状态。TIMEOUT 判定字段（与 completedStates 比对）。</summary>
    public const string Status = "status";

    /// <summary>被监测数值。OUT_OF_RANGE 判定字段。</summary>
    public const string MeasuredValue = "measured_value";

    /// <summary>目标数量。SHORTAGE 判定字段。</summary>
    public const string TargetQty = "target_qty";

    /// <summary>实际数量。SHORTAGE 判定字段。</summary>
    public const string ActualQty = "actual_qty";

    /// <summary>发生部门（可选，行内携带）。</summary>
    public const string OccurrenceDeptId = "occurrence_dept_id";

    /// <summary>责任部门（可选，行内携带）。</summary>
    public const string ResponsibleDeptId = "responsible_dept_id";
}