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

/// <summary>
/// S8 标准数据集取数 Provider。
///
/// 职责边界（本批明确不做的事，见 S8-DATASET-PROVIDER-FOUNDATION-1）：
///   · 不刷新数据中台、不调 RunFullAsync、不建调度任务；
///   · 不自行判断数据新鲜度 / staleness，也不发中台停更告警——该能力属数据平台侧，
///     待其提供 freshness 接口后由本层消费，不在 S8 内造替代实现；
///   · 不管理源系统连接串。
///
/// Provider 只回答一件事：给定租户 / 工厂作用域，返回该数据集当前的 canonical 行。
/// </summary>
public interface IS8MonitoringDataProvider
{
    /// <summary>本 Provider 服务的数据集编码，注册表按此解析。</summary>
    string DatasetCode { get; }

    /// <summary>本数据集可支撑的规则类型。</summary>
    S8DatasetCapabilities Capabilities { get; }

    /// <summary>
    /// 按作用域取 canonical 行。
    /// 实现必须先调用 <see cref="S8MonitoringDataRequest.EnsureValid"/>，
    /// 且只能使用请求参数中的 TenantId / FactoryId 作为作用域，不得隐式取值。
    /// </summary>
    Task<S8MonitoringRowSet> LoadAsync(
        S8MonitoringDataRequest request,
        CancellationToken cancellationToken = default);
}