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

/// <summary>
/// Dataset 启用 / 取数失败的 reason code。
///
/// 与既有 evaluator reason 码（rule_not_configured / params_parse_failed / data_source_unavailable /
/// query_failed / result_too_many_rows）同为 snake_case，可被同一套失败处理链消费。
///
/// 每个码只表达一件事，禁止合并 —— 合并会让运维分不清"配错了"和"还没实现"。
/// </summary>
public static class S8DatasetReasonCode
{
    /// <summary>规则声明 STANDARD_DATASET 但没填 dataset_code。</summary>
    public const string CodeMissing = "dataset_code_missing";

    /// <summary>Catalog 中查无此数据集（很可能是编码写错）。</summary>
    public const string NotDefined = "dataset_not_defined";

    /// <summary>数据集已定义，但当前没有 Provider 实现（可存草稿，不可启用）。</summary>
    public const string ProviderNotRegistered = "dataset_provider_not_registered";

    /// <summary>数据集定义已停用。</summary>
    public const string NotReady = "dataset_not_ready";

    /// <summary>Provider 自报的 DatasetCode 与 Catalog 定义不一致。</summary>
    public const string ProviderCodeMismatch = "dataset_provider_code_mismatch";

    /// <summary>数据集不支持该规则类型（机制层能力不匹配）。</summary>
    public const string CapabilityMismatch = "dataset_capability_mismatch";

    /// <summary>数据集缺少该规则类型必需的 canonical 字段（字段层能力不足）。</summary>
    public const string MissingRequiredField = "dataset_missing_required_field";

    /// <summary>租户作用域非法。</summary>
    public const string InvalidTenantScope = "invalid_tenant_scope";

    /// <summary>工厂作用域非法。</summary>
    public const string InvalidFactoryScope = "invalid_factory_scope";

    /// <summary>规则类型不在 canonical 词表内，无法解析其字段要求。</summary>
    public const string UnknownRuleType = "dataset_unknown_rule_type";

    /// <summary>Provider 取数抛错。绝不因此回落 Legacy SQL。</summary>
    public const string QueryFailed = "dataset_query_failed";
}