AiDOPWarehouse/server/Admin.NET.Test/S8/S8ResultKpiEnabledGateTests.cs

using Admin.NET.Plugin.AiDOP.Entity.S8;
using Admin.NET.Plugin.AiDOP.Service.S8;
using Xunit;

namespace Admin.NET.Test.S8;

/// <summary>
/// S8-CONFIG-AUTHORITY-FIX-1：结果 KPI 的「停用即不显示」门禁。
///
/// 修复前的缺陷：<c>GetResultKpiSummaryAsync</c> 只按 mechanism / is_result_kpi / 租户作用域取行，
/// <b>完全不读 enabled</b>。运行库里 5 条结果 KPI 全部 enabled=0（remark "[RESERVED] S9 result KPI"），
/// 却照常出现在监控总览——配置页面的停用开关对业务零效力。
///
/// 本文件锁定的契约与失败后果：
///   A. enabled=true  → 纳入          → 否则正常指标消失，属功能倒退
///   B. enabled=false → 不纳入        → 否则"停用"仍然显示，用户认为配置坏了
///   C. is_result_kpi=false → 不纳入  → 否则机制字典项（Rule 向导用）会污染结果 KPI 卡片
///   D. 门禁必须在**覆盖解析之后**   → 这是最容易写错的一条：
///      若把 Enabled 下推成 SQL WHERE，租户 override enabled=false 的行会先被滤掉，
///      分组里只剩 enabled=true 的全局行 → 结果回落成"显示"，与停用意图完全相反。
///   E. 不触碰 Rule 机制字典          → 门禁只作用于结果 KPI 路径
///
/// 不接 DB、不接 DI、不触发任何真实规则。
/// </summary>
public class S8ResultKpiEnabledGateTests
{
    private const long TenantId = 838257186181189L;
    private const long FactoryId = 838257186320453L;

    private static AdoS8MonitorMetric Metric(
        string code, bool enabled, bool isResultKpi = true,
        long tenantId = 0, long factoryId = 0, string mechanism = "RATIO", int sortNo = 0) => new()
    {
        MetricCode = code,
        MetricName = code,
        Mechanism = mechanism,
        IsResultKpi = isResultKpi,
        Enabled = enabled,
        TenantId = tenantId,
        FactoryId = factoryId,
        SortNo = sortNo
    };

    private static List<string> CodesOf(IEnumerable<AdoS8MonitorMetric> rows) =>
        rows.Select(x => x.MetricCode).ToList();

    // ============================================================
    // A/B/C. 基础门禁
    // ============================================================

    [Fact]
    public void T1_EnabledResultKpi_IsReturned()
    {
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("ORDER_DELIVERY_RATE", enabled: true)
        });

        Assert.Equal(new[] { "ORDER_DELIVERY_RATE" }, CodesOf(result));
    }

    [Fact]
    public void T2_DisabledResultKpi_IsNotReturned()
    {
        // 运行库现状：5 条结果 KPI 全部 enabled=0，修复前它们照常显示。
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("IQC_PASS_RATE", enabled: false)
        });

        Assert.Empty(result);
    }

    [Fact]
    public void T3_NonResultKpi_IsNotReturned()
    {
        // is_result_kpi=false 的是 Rule 向导用的机制字典项（DATE / VALUE_RANGE），
        // 即使 enabled=true 也不属于结果 KPI 卡片。
        // 注：调用方 SQL 已按 IsResultKpi 过滤，这里再断言一次，防止将来有人把过滤挪进本方法时写反。
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("ORDER_DUE_AT", enabled: true, isResultKpi: false, mechanism: "DATE")
        }.Where(m => m.IsResultKpi));

        Assert.Empty(result);
    }

    // ============================================================
    // D. 覆盖解析与门禁的先后顺序 —— 本文件最关键的两条
    // ============================================================

    [Fact]
    public void T4_TenantOverrideDisable_HidesMetric_EvenWhenGlobalEnabled()
    {
        // 全局启用 + 租户停用 → 租户看不到。
        // 若实现把 Enabled 下推成 SQL WHERE，租户行会先被滤掉、只剩全局行，
        // 结果反而变成"可见"——本用例正是为了钉死这个反向缺陷。
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("ORDER_DELIVERY_RATE", enabled: true),                                        // 平台全局
            Metric("ORDER_DELIVERY_RATE", enabled: false, tenantId: TenantId, factoryId: FactoryId) // 租户覆盖：停用
        });

        Assert.Empty(result);
    }

    [Fact]
    public void T5_TenantOverrideEnable_ShowsMetric_EvenWhenGlobalDisabled()
    {
        // 反向：全局停用 + 租户启用 → 租户可见。
        // 覆盖语义由 OrderByDescending(FactoryId).ThenByDescending(TenantId) 承载，本用例确认它对两个方向都成立。
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("PO_DELIVERY_RATE", enabled: false),
            Metric("PO_DELIVERY_RATE", enabled: true, tenantId: TenantId, factoryId: FactoryId)
        });

        Assert.Equal(new[] { "PO_DELIVERY_RATE" }, CodesOf(result));
    }

    /// <summary>
    /// 覆盖解析必须"每个 code 只留一条"，否则同一 KPI 会在卡片上重复出现 —— 这条不变。
    ///
    /// <para><b>S8-TENANT-ONLY-BATCH6：优先级判据由「工厂号降序」改为「租户行优先」。</b>
    /// 原断言是「工厂行优先级最高」。本批之后租户覆盖行的 <c>factory_id</c> 恒为 0，
    /// 按工厂排序会与平台默认打平并退化成任意序，可能让平台默认反超租户覆盖 ——
    /// 表现为「配置页显示一种生效值、运行时用另一种」。故优先级只认「是不是租户行」。</para>
    ///
    /// <para>同租户内仅工厂元数据不同的两行属**歧义配置**：真库取证
    /// <c>(tenant_id, metric_code)</c> 重复组为 0，该情形不存在；此处只断言
    /// 「收敛为一条且必是租户行」，不再对工厂号做任何承诺。</para>
    /// </summary>
    [Fact]
    public void T5b_EachMetricCode_ResolvesToExactlyOneEffectiveRow()
    {
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("WO_COMPLETION_RATE", enabled: true),
            Metric("WO_COMPLETION_RATE", enabled: true, tenantId: TenantId),
            Metric("WO_COMPLETION_RATE", enabled: true, tenantId: TenantId, factoryId: FactoryId)
        });

        Assert.Single(result);
        // 胜出的必须是租户行，而不是平台默认行；工厂号不再参与优先级。
        Assert.Equal(TenantId, result[0].TenantId);
        Assert.NotEqual(0L, result[0].TenantId);
    }

    // ============================================================
    // E. Rule 机制字典不受影响
    // ============================================================

    [Fact]
    public void T6_RuleMechanismDictionary_IsUntouchedByTheGate()
    {
        // 运行库中 ado_s8_monitor_metric 有 8 条 enabled=1 的机制字典项（DATE / VALUE_RANGE），
        // 由 S8ConfigDraftService（Rule 向导）消费。本门禁只在结果 KPI 路径调用，
        // 这里断言：即使把它们混进候选集，也只会因 IsResultKpi=false 被调用方排除，
        // 而不会被本方法当作结果 KPI 返回。
        var mixed = new[]
        {
            Metric("ORDER_DUE_AT",              enabled: true, isResultKpi: false, mechanism: "DATE"),
            Metric("INV_QTY",                   enabled: true, isResultKpi: false, mechanism: "VALUE_RANGE"),
            Metric("ORDER_FLOW_STAGE_VARIANCE", enabled: true, isResultKpi: false, mechanism: "VALUE_RANGE"),
            Metric("ORDER_DELIVERY_RATE",       enabled: true)
        };

        // 模拟调用方 SQL 的 mechanism + is_result_kpi 过滤。
        var candidates = mixed.Where(m => m.Mechanism == "RATIO" && m.IsResultKpi);
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(candidates);

        Assert.Equal(new[] { "ORDER_DELIVERY_RATE" }, CodesOf(result));
        // 机制字典项全部保持 enabled=true，未被本批改动。
        Assert.All(mixed.Where(m => !m.IsResultKpi), m => Assert.True(m.Enabled));
    }

    // ============================================================
    // 排序稳定性（卡片顺序不应因门禁而乱）
    // ============================================================

    [Fact]
    public void EnabledMetrics_KeepSortNoThenCodeOrdering()
    {
        var result = S8MonitoringService.ResolveEnabledEffectiveResultKpis(new[]
        {
            Metric("B_RATE", enabled: true,  sortNo: 2),
            Metric("A_RATE", enabled: true,  sortNo: 2),
            Metric("Z_RATE", enabled: true,  sortNo: 1),
            Metric("X_RATE", enabled: false, sortNo: 0)   // 停用项不参与排序结果
        });

        Assert.Equal(new[] { "Z_RATE", "A_RATE", "B_RATE" }, CodesOf(result));
    }
}