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

/// <summary>
/// 数据集定义：描述"系统认知中存在这样一个数据集"，
/// 与"当前谁负责给它供数"（Provider Registry 的职责）严格分离。
///
/// 这样才能表达一个必要的中间状态：数据集已定义、规则可以先配好存草稿，
/// 但 Provider 尚未实现，因此不允许启用。
/// </summary>
public sealed class S8DatasetDefinition
{
    /// <summary>数据集编码，规则通过它引用数据集。</summary>
    public string DatasetCode { get; init; } = string.Empty;

    /// <summary>展示名（配置界面用）。</summary>
    public string DisplayName { get; init; } = string.Empty;

    /// <summary>OBJECT（对象级）/ METRIC（指标级）。</summary>
    public string Kind { get; init; } = S8DatasetKind.Object;

    /// <summary>能力声明：机制层 + canonical 字段层。</summary>
    public S8DatasetCapabilities Capabilities { get; init; } = new();

    /// <summary>声明状态：DEFINED（在用）/ DISABLED（停用）。有效状态由诊断结合 Provider 注册情况计算。</summary>
    public string Status { get; init; } = S8DatasetStatus.Defined;

    /// <summary>说明（可选）。</summary>
    public string? Description { get; init; }

    /// <summary>
    /// Authority 声明：健康判定需要知道的一切（生产者作业、新鲜度窗口、快照不变量）。
    ///
    /// <para>为 null 表示该数据集尚未声明 Authority ——
    /// <see cref="Health.IS8AuthorityHealthResolver"/> 会判 UNKNOWN 并拦截恢复判定，
    /// 但<b>不影响</b>取数、命中评估与建单/刷新。保守方向：宁可不恢复，不可误恢复。</para>
    /// </summary>
    public Health.S8AuthoritySpec? AuthoritySpec { get; init; }

    /// <summary>定义本身是否处于可用状态（不含 Provider 判断）。</summary>
    public bool IsActive => string.Equals(Status, S8DatasetStatus.Defined, StringComparison.OrdinalIgnoreCase);
}

/// <summary>
/// 数据集定义来源。真实业务数据集将来通过实现本接口注册进 Catalog，
/// 无需修改 Catalog 自身代码。
///
/// 本批（S8-DATASET-FOUNDATION-HARDENING-2）**不提供任何生产实现**：
/// 字段级审计显示 6 个候选标准数据集全部为 READY_WITH_PLATFORM_GAP，
/// 在数据平台补齐数据集级新鲜度判定之前不登记真实业务数据集。
/// </summary>
public interface IS8DatasetDefinitionSource
{
    IEnumerable<S8DatasetDefinition> GetDefinitions();
}