AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/FinishedWarehouse/S7MdpSyncTransformService.cs

using Admin.NET.Core.Service;
using Admin.NET.Plugin.AiDOP.Infrastructure;
using Admin.NET.Plugin.AiDOP.MaterialWarehouse;
using Microsoft.Extensions.Logging;
using System.Text.Json;

namespace Admin.NET.Plugin.AiDOP.FinishedWarehouse;

/// <summary>
/// S7 成品仓储 — KPI 计算与刷新转换服务。
/// 双模式：读本地中立标准层（由适配器从贴源→标准），不再直连源库。
/// 计算逻辑沿用方老师 v5.4 KPI J 列口径（等价改写为 MySQL 读 std）。
/// 包含 KPI：S7_L1_001 订单发货周期 / S7_L1_002 订单发货满足率 / S7_L1_003 成品仓储人效。
/// </summary>
public class S7MdpSyncTransformService : ITransient
{
    private readonly ISqlSugarClient _db;
    private readonly TransformRunLogFinalizer _runLogFinalizer;
    private readonly SysNoticeService _sysNoticeService;
    private readonly ILogger<S7MdpSyncTransformService> _logger;
    private readonly SmartOps.KpiCalcDispatcher _kpiCalcDispatcher;
    private readonly SmartOps.KpiDimensionRunService _dimensionRun;
    private readonly SmartOps.IKpiTargetResolver _kpiTargetResolver;
    private readonly InventoryMdpSyncService _inventoryMdpSync;
    private readonly SmartOps.S9CompositeKpiWriter _s9Composite;
    private const string JobCode = "S7_MDP_SYNC_TRANSFORM";
    private const string JobName = "S7 成品仓储 MDP 同步与转换";
    private const string ModuleCode = "S7";
    private const string L2ValueTable = "ado_s9_kpi_value_l2_day";
    // FAILURE-NOTIFICATION-1：超级管理员 superAdmin.NET（AccountType=999）
    private const long NoticeReceiverUserId = 1300000000101L;
    private const string NoticeReceiverUserName = "超级管理员";

    public S7MdpSyncTransformService(
        ISqlSugarClient db,
        SysNoticeService sysNoticeService,
        ILogger<S7MdpSyncTransformService> logger,
        SmartOps.KpiCalcDispatcher kpiCalcDispatcher,
        SmartOps.KpiDimensionRunService dimensionRun,
        SmartOps.IKpiTargetResolver kpiTargetResolver,
        InventoryMdpSyncService inventoryMdpSync,
        TransformRunLogFinalizer runLogFinalizer,
        SmartOps.S9CompositeKpiWriter s9Composite)
    {
        _db = db;
        _runLogFinalizer = runLogFinalizer;
        _sysNoticeService = sysNoticeService;
        _logger = logger;
        _kpiCalcDispatcher = kpiCalcDispatcher;
        _dimensionRun = dimensionRun;
        _kpiTargetResolver = kpiTargetResolver;
        _inventoryMdpSync = inventoryMdpSync;
        _s9Composite = s9Composite;
    }

    public async Task<S7MdpSyncTransformResult> RunFullAsync(
        CancellationToken cancellationToken = default,
        string triggerType = "AUTO",
        S7MdpRefreshOption? option = null)
    {
        cancellationToken.ThrowIfCancellationRequested();
        option ??= S7MdpRefreshOption.Default();
        NormalizeOption(option);

        var now = DateTime.Now;
        var batchId = $"S7_MDP_FULL_{now:yyyyMMddHHmmss}";
        var normalizedTrigger = NormalizeTriggerType(triggerType);
        var runLogId = await InsertTransformRunLogAsync(batchId, now, normalizedTrigger, option);

        var result = new S7MdpSyncTransformResult
        {
            BatchId = batchId,
            RunLogId = runLogId,
            TriggerType = normalizedTrigger,
            SourceZtid = option.SourceZtid,
            TargetTenantId = option.TargetTenantId,
            TargetFactoryId = option.TargetFactoryId,
            BizDate = option.BizDate,
            BizMonth = option.BizMonth,
            MonthlyPeriodStart = option.MonthlyPeriodStart,
            MonthlyPeriodEnd = option.MonthlyPeriodEnd
        };

        try
        {
            result.StageRows = 0;
            result.StandardRows = await _inventoryMdpSync.TransformTransStdFromStgAsync(
                option.TargetTenantId, cancellationToken);

            var sub25 = await BuildS7L1001OrderShipmentCycleAsync(batchId, now, option, normalizedTrigger, cancellationToken);
            result.MergeSub("S7_L1_001", sub25);

            var sub26 = await BuildS7L1002OrderShipmentFulfillmentAsync(batchId, now, option, normalizedTrigger, cancellationToken);
            result.MergeSub("S7_L1_002", sub26);

            var sub27 = await BuildS7L1003FinishedWarehouseEfficiencyAsync(batchId, now, option, normalizedTrigger, cancellationToken);
            result.MergeSub("S7_L1_003", sub27);

            var currentBizDate = option.BizDate;
            const int backfillDays = 14;
            for (var dayOffset = backfillDays - 1; dayOffset >= 0; dayOffset--)
            {
                option.BizDate = currentBizDate.AddDays(-dayOffset);
                foreach (var metricCode in Enumerable.Range(1, 16).Select(x => $"S7_L2_{x:000}"))
                {
                    var sub = await BuildS7StageKpiAsync(
                        metricCode, batchId, now, option, normalizedTrigger, cancellationToken);
                    result.MergeSub(metricCode, sub);
                }
                result.MergeSub("S9_L1_001", await BuildS9L1001QualityReturnRateAsync(
                    batchId, now, option, normalizedTrigger, cancellationToken));
            }
            option.BizDate = currentBizDate;

            result.KpiRows += await _s9Composite.WriteRecentAsync(
                option.TargetTenantId, option.TargetFactoryId, option.BizDate, cancellationToken);
            await MarkTransformRunSuccessAsync(runLogId, now, result);
            return result;
        }
        catch (Exception ex)
        {
            // 宿主关停不是转换失败：交给 finally 收口为 ABORTED，不污染 FAILED 语义。
            if (!_runLogFinalizer.IsHostStopping)
                await MarkTransformRunFailedAsync(runLogId, now, ex.Message, batchId);
            throw;
        }
        finally
        {
            await _runLogFinalizer.FinalizeIfHostStoppingAsync(runLogId, now);
        }
    }

    // ─────────────────────────────────────────────────────────────────────────

    /// <summary>S7_L1_001 订单发货周期 = 最晚发货日期 - 最早 FQC 报检日期（5 表 JOIN）。</summary>
    private async Task<KpiBuildSubResult> BuildS7L1001OrderShipmentCycleAsync(
        string batchId, DateTime now, S7MdpRefreshOption option, string triggerType, CancellationToken ct)
    {
        var sub = new KpiBuildSubResult();

        const string sql = @"
select order_no as order_no,
       datediff(max(ship_time), min(start_time)) as cycle_days
 from (
   select b.order_no as order_no, b.item_code as item_code,
          ifnull(c.apply_time, b.release_time) as start_time,
          (case when b.closed_flag=1 then b.closed_time else d.approved_time end) as ship_time,
          (case when b.closed_flag=1 or b.qty_planned<=b.qty_completed then 1 else 0 end) as completed
    from mdp_std_work_order_line b
    left join (
      select tenant_id as tenant_id, ref_task_no, item_num,
             max(approved_time) as approved_time, sum(qty_change) as qty_change
       from mdp_std_inv_trans
       where tenant_id=@tenantId and biz_doc_type='SALES_SHIP'
         and summary_flag=0 and void_flag=0 and approved_flag=1 AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
       group by tenant_id, ref_task_no, item_num
    ) d on b.task_no=d.ref_task_no and b.item_code=d.item_num and d.tenant_id=b.tenant_id
    left join mdp_std_fqc_task c on c.sales_order_line=b.source_row_id and c.apply_flag=1 and c.tenant_id=b.tenant_id
    where b.tenant_id=@tenantId and b.doc_type='SALES_ORDER' and b.void_flag=0 and b.approved_flag=1
 ) n
 group by order_no
 having min(completed)=1";

        var rows = await _db.Ado.SqlQueryAsync<S7CycleRow>(sql, new[]
        {
            new SugarParameter("@tenantId", option.TargetTenantId),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", "")
        });
        sub.T8Rows = rows.Count;

        var dwdAffected = 0;
        var cycleList = new List<int>();
        foreach (var r in rows)
        {
            ct.ThrowIfCancellationRequested();
            if (string.IsNullOrEmpty(r.order_no)) continue;
            if (r.cycle_days.HasValue) cycleList.Add(r.cycle_days.Value);

            dwdAffected += await _db.Ado.ExecuteCommandAsync(@"
INSERT INTO dwd_order_shipment_cycle
  (tenant_id, factory_id, biz_date, source_ztid, order_no, cycle_days, batch_id, create_time)
VALUES
  (@tenantId, @factoryId, @bizDate, @sourceDomain, @orderNo, @cycleDays, @batchId, @now)
ON DUPLICATE KEY UPDATE
  cycle_days=VALUES(cycle_days),
  batch_id=VALUES(batch_id), update_time=@now",
                new SugarParameter("@tenantId", option.TargetTenantId),
                new SugarParameter("@factoryId", option.TargetFactoryId),
                new SugarParameter("@bizDate", option.BizDate),
                new SugarParameter("@sourceDomain", option.SourceZtid),
                new SugarParameter("@orderNo", r.order_no),
                new SugarParameter("@cycleDays", r.cycle_days),
                new SugarParameter("@batchId", batchId),
                new SugarParameter("@now", now));
        }
        sub.DwdRows = dwdAffected;

        // 数据准备(dwd 逐单 cycle_days)已完成。最终聚合交分发器（日 KPI：period 复用 BizDate，SQL 按 biz_date 圈选）。
        decimal? legacyValue = cycleList.Count > 0
            ? Math.Round((decimal)cycleList.Average(), 4)
            : null;
        var legacyDenom = cycleList.Count > 0 ? "OK" : "NO_COMPLETED_ORDER";
        var dispatch = await _kpiCalcDispatcher.DispatchAsync(
            "S7_L1_001", ModuleCode, option.TargetTenantId, option.TargetFactoryId,
            option.BizDate, option.BizDate, option.BizDate, option.SourceZtid,
            batchId, triggerType, legacyValue, legacyDenom, ct);
        sub.KpiRows = dispatch.ShouldUpsert
            ? await UpsertKpiValueAsync("S7_L1_001", option.BizDate, dispatch.MetricValue, now, option)
            : 0;
        sub.DenominatorStatus = dispatch.DenominatorStatus;

        // 调度：SUMMARY 成功/NO_DATA 后触发对应 DIMENSION 跑批（共享 BatchId；SUMMARY FAILED 不触发）。
        // 维度失败不影响汇总链路（内部已落 dimension_run_log）。
        if (dispatch.ShouldUpsert)
        {
            try
            {
                await _dimensionRun.RunDimensionAsync(
                    "S7_L1_001", ModuleCode, option.TargetTenantId, option.BizDate, batchId, triggerType, ct);
            }
            catch (Exception ex)
            {
                _logger.LogWarning(ex, "S7_L1_001 维度跑批异常（不影响汇总链路）");
            }
        }
        return sub;
    }

    /// <summary>S7_L1_002 订单发货满足率 = (交期前发货行数 / 该订单总行数) × 100%。</summary>
    private async Task<KpiBuildSubResult> BuildS7L1002OrderShipmentFulfillmentAsync(
        string batchId, DateTime now, S7MdpRefreshOption option, string triggerType, CancellationToken ct)
    {
        var sub = new KpiBuildSubResult();

        const string sql = @"
select order_no as order_no,
       count(order_no) as total_rows,
       sum(completed) as in_window_rows
 from (
   select b.order_no as order_no, b.task_no as task_no, b.item_code as item_code,
          (case when sum(d.qty_change)>=b.qty_planned then 1 else 0 end) as completed
    from mdp_std_work_order_line b
    left join (
      select tenant_id as tenant_id, ref_task_no, item_num,
             date(approved_time) as approved_date, qty_change
       from mdp_std_inv_trans
       where tenant_id=@tenantId and biz_doc_type='SALES_SHIP'
         and summary_flag=0 and void_flag=0 and approved_flag=1 AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
    ) d on b.task_no=d.ref_task_no and b.item_code=d.item_num
       and d.approved_date<=b.plan_finish_date and d.tenant_id=b.tenant_id
    where b.tenant_id=@tenantId and b.doc_type='SALES_ORDER' and b.void_flag=0 and b.approved_flag=1
    group by b.order_no, b.task_no, b.item_code, b.qty_planned
 ) n
 group by order_no";

        var rows = await _db.Ado.SqlQueryAsync<S7FulfillmentRow>(sql, new[]
        {
            new SugarParameter("@tenantId", option.TargetTenantId),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", "")
        });
        sub.T8Rows = rows.Count;

        var dwdAffected = 0;
        var rateList = new List<decimal>();
        foreach (var r in rows)
        {
            ct.ThrowIfCancellationRequested();
            if (string.IsNullOrEmpty(r.order_no)) continue;
            decimal? rate = (r.total_rows > 0)
                ? Math.Round((decimal)r.in_window_rows / r.total_rows * 100m, 4)
                : null;
            if (rate.HasValue) rateList.Add(rate.Value);

            dwdAffected += await _db.Ado.ExecuteCommandAsync(@"
INSERT INTO dwd_order_shipment_fulfillment
  (tenant_id, factory_id, biz_date, source_ztid, order_no,
   total_rows, in_window_rows, fulfillment_rate, batch_id, create_time)
VALUES
  (@tenantId, @factoryId, @bizDate, @sourceDomain, @orderNo,
   @total, @inWindow, @rate, @batchId, @now)
ON DUPLICATE KEY UPDATE
  total_rows=VALUES(total_rows), in_window_rows=VALUES(in_window_rows),
  fulfillment_rate=VALUES(fulfillment_rate),
  batch_id=VALUES(batch_id), update_time=@now",
                new SugarParameter("@tenantId", option.TargetTenantId),
                new SugarParameter("@factoryId", option.TargetFactoryId),
                new SugarParameter("@bizDate", option.BizDate),
                new SugarParameter("@sourceDomain", option.SourceZtid),
                new SugarParameter("@orderNo", r.order_no),
                new SugarParameter("@total", r.total_rows),
                new SugarParameter("@inWindow", r.in_window_rows),
                new SugarParameter("@rate", rate),
                new SugarParameter("@batchId", batchId),
                new SugarParameter("@now", now));
        }
        sub.DwdRows = dwdAffected;

        // 数据准备(dwd 逐单 fulfillment_rate，已 ×100)已完成。最终聚合交分发器（CONFIG_SQL 直接 AVG 该列不再 ×100）。
        decimal? legacyValue = rateList.Count > 0
            ? Math.Round(rateList.Average(), 4)
            : null;
        var legacyDenom = rateList.Count > 0 ? "OK" : "NO_VALID_ORDER";
        var dispatch = await _kpiCalcDispatcher.DispatchAsync(
            "S7_L1_002", ModuleCode, option.TargetTenantId, option.TargetFactoryId,
            option.BizDate, option.BizDate, option.BizDate, option.SourceZtid,
            batchId, triggerType, legacyValue, legacyDenom, ct);
        sub.KpiRows = dispatch.ShouldUpsert
            ? await UpsertKpiValueAsync("S7_L1_002", option.BizDate, dispatch.MetricValue, now, option)
            : 0;
        sub.DenominatorStatus = dispatch.DenominatorStatus;

        // 调度：SUMMARY 成功/NO_DATA 后触发对应 DIMENSION 跑批（共享 BatchId；SUMMARY FAILED 不触发）。
        if (dispatch.ShouldUpsert)
        {
            try
            {
                await _dimensionRun.RunDimensionAsync(
                    "S7_L1_002", ModuleCode, option.TargetTenantId, option.BizDate, batchId, triggerType, ct);
            }
            catch (Exception ex)
            {
                _logger.LogWarning(ex, "S7_L1_002 维度跑批异常（不影响汇总链路）");
            }
        }
        return sub;
    }

    /// <summary>S7_L1_003 成品仓储人效 = SALES_SHIP 数量 / WAREHOUSE ACTIVE 人数。</summary>
    private async Task<KpiBuildSubResult> BuildS7L1003FinishedWarehouseEfficiencyAsync(
        string batchId, DateTime now, S7MdpRefreshOption option, string triggerType, CancellationToken ct)
    {
        var sub = new KpiBuildSubResult();

        const string sqlNumer = @"
select ref_task_no as task_no, item_num as item_code,
       date(approved_time) as approved_date, qty_change as qty_change
 from mdp_std_inv_trans
 where tenant_id=@tenantId and biz_doc_type='SALES_SHIP'
   and summary_flag=0 and void_flag=0 and approved_flag=1 AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
   and date(approved_time) between @startDateText and @endDateText";
        const string sqlDenom = @"
select count(*) as penum
 from mdp_std_employee
 where tenant_id=@tenantId and employment_status='ACTIVE' and position_code='WAREHOUSE' AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)";

        var pNumer = new[]
        {
            new SugarParameter("@tenantId", option.TargetTenantId),
            new SugarParameter("@startDateText", option.MonthlyPeriodStart.ToString("yyyy-MM-dd")),
            new SugarParameter("@endDateText", option.MonthlyPeriodEnd.ToString("yyyy-MM-dd")),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", "")
        };
        var pDenom = new[]
        {
            new SugarParameter("@tenantId", option.TargetTenantId),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", "")
        };

        var numerRows = await _db.Ado.SqlQueryAsync<S7ShipmentDetailRow>(sqlNumer, pNumer);
        var denomRows = await _db.Ado.SqlQueryAsync<S7PeNumRow>(sqlDenom, pDenom);
        sub.T8Rows = numerRows.Count + denomRows.Count;

        decimal? shipmentQty = numerRows.Sum(r => r.qty_change ?? 0m);
        if (numerRows.Count == 0) shipmentQty = null;

        int? headcount = denomRows.FirstOrDefault()?.penum;

        decimal? efficiency = null;
        string denomStatus;
        if (!headcount.HasValue || headcount.Value <= 0)
            denomStatus = "NO_HEADCOUNT";
        else if (!shipmentQty.HasValue)
            denomStatus = "NO_NUMERATOR";
        else
        {
            efficiency = Math.Round(shipmentQty.Value / headcount.Value, 4);
            denomStatus = "OK";
        }
        sub.DenominatorStatus = denomStatus;

        var dwdAffected = await _db.Ado.ExecuteCommandAsync(@"
INSERT INTO dwd_finished_warehouse_efficiency
  (tenant_id, factory_id, biz_month, source_ztid, period_start, period_end,
   shipment_qty, warehouse_headcount, efficiency, denominator_status, batch_id, create_time)
VALUES
  (@tenantId, @factoryId, @bizMonth, @sourceDomain, @periodStart, @periodEnd,
   @shipmentQty, @headcount, @efficiency, @denomStatus, @batchId, @now)
ON DUPLICATE KEY UPDATE
  period_start=VALUES(period_start), period_end=VALUES(period_end),
  shipment_qty=VALUES(shipment_qty), warehouse_headcount=VALUES(warehouse_headcount),
  efficiency=VALUES(efficiency), denominator_status=VALUES(denominator_status),
  batch_id=VALUES(batch_id), update_time=@now",
            new SugarParameter("@tenantId", option.TargetTenantId),
            new SugarParameter("@factoryId", option.TargetFactoryId),
            new SugarParameter("@bizMonth", option.BizMonth),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@periodStart", option.MonthlyPeriodStart),
            new SugarParameter("@periodEnd", option.MonthlyPeriodEnd),
            new SugarParameter("@shipmentQty", shipmentQty),
            new SugarParameter("@headcount", headcount),
            new SugarParameter("@efficiency", efficiency),
            new SugarParameter("@denomStatus", denomStatus),
            new SugarParameter("@batchId", batchId),
            new SugarParameter("@now", now));
        sub.DwdRows = dwdAffected;

        // 月度 KPI 最终聚合交分发器；bizDate=月末、period=当月窗口；
        //   legacyValue=efficiency、legacyDenom 保留 NO_HEADCOUNT/NO_NUMERATOR（CONFIG_SQL 下塌缩为 NO_DATA）。
        var dispatch = await _kpiCalcDispatcher.DispatchAsync(
            "S7_L1_003", ModuleCode, option.TargetTenantId, option.TargetFactoryId,
            option.MonthlyPeriodEnd, option.MonthlyPeriodStart, option.MonthlyPeriodEnd, option.SourceZtid,
            batchId, triggerType, efficiency, denomStatus, ct);
        sub.KpiRows = dispatch.ShouldUpsert
            ? await UpsertKpiValueAsync("S7_L1_003", option.MonthlyPeriodEnd, dispatch.MetricValue, now, option)
            : 0;
        sub.DenominatorStatus = dispatch.DenominatorStatus;

        // 调度：SUMMARY 成功/NO_DATA 后触发人效月度 DIMENSION 跑批（月度：@biz_date=月末派生 biz_month）。
        if (dispatch.ShouldUpsert)
        {
            try
            {
                await _dimensionRun.RunDimensionAsync(
                    "S7_L1_003", ModuleCode, option.TargetTenantId, option.MonthlyPeriodEnd, batchId, triggerType, ct);
            }
            catch (Exception ex)
            {
                _logger.LogWarning(ex, "S7_L1_003 维度跑批异常（不影响汇总链路）");
            }
        }
        return sub;
    }

    private Task<KpiBuildSubResult> BuildS7StageKpiAsync(
        string metricCode, string batchId, DateTime now, S7MdpRefreshOption option,
        string triggerType, CancellationToken ct)
    {
        var (sql, emptyDenom) = metricCode switch
        {
            "S7_L2_001" => (
                """
                SELECT ROUND(AVG(TIMESTAMPDIFF(MINUTE,q.FAPPLYTIME,q.jywcsj)/1440),4) AS MetricValue,
                       COUNT(*) AS RowCount
                FROM qms_fqcbj q
                WHERE q.tenant_id=@TenantId
                  AND q.FAPPLYTIME IS NOT NULL AND q.jywcsj>=q.FAPPLYTIME
                  AND UPPER(IFNULL(q.FINSPECTSTATUS,'')) IN ('检验完成','COMPLETED','CLOSED')
                """,
                "NO_COMPLETED_FQC"),
            "S7_L2_002" => (
                """
                SELECT ROUND(
                           100 * SUM(CASE WHEN q.jywcsj IS NOT NULL AND q.jywcsj<=w.DueDate THEN 1 ELSE 0 END)
                               / NULLIF(COUNT(*),0),
                           4) AS MetricValue,
                       COUNT(*) AS RowCount
                FROM qms_fqcbj q
                INNER JOIN WorkOrdMaster w
                    ON w.tenant_id=q.tenant_id AND w.WorkOrd=q.sczld
                WHERE q.tenant_id=@TenantId AND w.DueDate IS NOT NULL
                """,
                "NO_FQC_REQUIRED_DATE"),
            "S7_L2_003" => (
                """
                SELECT ROUND(
                           SUM(CASE WHEN q.jywcsj IS NOT NULL
                                     AND UPPER(IFNULL(q.FINSPECTSTATUS,'')) IN ('检验完成','COMPLETED','CLOSED')
                                    THEN 1 ELSE 0 END)
                               / NULLIF(COUNT(DISTINCT NULLIF(TRIM(q.jyfzr),'')),0),
                           4) AS MetricValue,
                       SUM(CASE WHEN q.jywcsj IS NOT NULL THEN 1 ELSE 0 END) AS RowCount
                FROM qms_fqcbj q
                WHERE q.tenant_id=@TenantId
                """,
                "NO_FQC_INSPECTOR"),
            "S7_L2_004" => (WarehouseTurnoverSql("FG_FQC_RELEASE", "FG_PROD_RECEIPT"), "NO_FINISHED_RECEIPT_COST"),
            "S7_L2_005" => (WarehouseCycleSql("FG_FQC_RELEASE", "FG_PUTAWAY"), "NO_FINISHED_PUTAWAY_CYCLE"),
            "S7_L2_006" => (WarehouseSatisfactionSql("FG_PUTAWAY"), "NO_FINISHED_PUTAWAY_REQUIRED_DATE"),
            "S7_L2_007" => (WarehouseEfficiencySql("FG_PUTAWAY"), "NO_FINISHED_PUTAWAY_OPERATOR"),
            "S7_L2_008" => (WarehouseTurnoverSql("FG_PUTAWAY", "FG_PROD_RECEIPT"), "NO_FINISHED_RECEIPT_COST"),
            "S7_L2_009" => (WarehouseCycleSql("FG_PUTAWAY", "FG_PICK"), "NO_FINISHED_PICK_CYCLE"),
            "S7_L2_010" => (WarehouseSatisfactionSql("FG_PICK"), "NO_FINISHED_PICK_REQUIRED_DATE"),
            "S7_L2_011" => (WarehouseEfficiencySql("FG_PICK"), "NO_FINISHED_PICK_OPERATOR"),
            "S7_L2_012" => (WarehouseTurnoverSql("FG_PICK", "FG_SHIP"), "NO_FINISHED_SHIPMENT_COST"),
            "S7_L2_013" => (WarehouseCycleSql("FG_SHIP", "FG_RECEIPT"), "NO_FINISHED_DELIVERY_CYCLE"),
            "S7_L2_014" => (
                """
                SELECT ROUND(100 * SUM(completed) / NULLIF(COUNT(*),0),4) AS MetricValue,
                       COUNT(*) AS RowCount
                FROM (
                    SELECT b.order_no, b.task_no, b.item_code,
                           CASE WHEN SUM(IFNULL(d.qty_change,0))>=b.qty_planned THEN 1 ELSE 0 END AS completed
                    FROM mdp_std_work_order_line b
                    LEFT JOIN (
                        SELECT tenant_id, ref_task_no, item_num, qty_change, DATE(approved_time) AS ship_date
                        FROM mdp_std_inv_trans
                        WHERE tenant_id=@TenantId
                          AND biz_doc_type='SALES_SHIP' AND summary_flag=0 AND void_flag=0 AND approved_flag=1 AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
                    ) d ON d.tenant_id=b.tenant_id AND d.ref_task_no=b.task_no
                       AND d.item_num=b.item_code AND d.ship_date<=b.plan_finish_date
                    WHERE b.tenant_id=@TenantId
                      AND b.doc_type='SALES_ORDER' AND b.void_flag=0 AND b.approved_flag=1
                    GROUP BY b.order_no, b.task_no, b.item_code, b.qty_planned
                ) x
                """,
                "NO_SHIPMENT_NOTICE"),
            "S7_L2_015" => (WarehouseEfficiencySql("FG_SHIP"), "NO_FINISHED_SHIPMENT_OPERATOR"),
            "S7_L2_016" => (WarehouseTurnoverSql("FG_SHIP", "FG_RECEIPT"), "NO_SIGNED_RECEIPT_COST"),
            _ => throw new ArgumentOutOfRangeException(nameof(metricCode), metricCode, "不支持的 S7 阶段指标")
        };
        return DispatchS7StageKpiAsync(
            metricCode, sql, emptyDenom, batchId, now, option, triggerType, ct);
    }

    private static string WarehouseCycleSql(string fromStage, string toStage) =>
        $"""
         SELECT ROUND(AVG(TIMESTAMPDIFF(MINUTE,a.trans_time,b.trans_time)/1440),4) AS MetricValue,
                COUNT(*) AS RowCount
         FROM mdp_std_inv_trans a
         INNER JOIN mdp_std_inv_trans b
             ON b.tenant_id=a.tenant_id AND b.source_system=a.source_system
            AND b.item_num=a.item_num AND b.lot_serial=a.lot_serial
            AND b.trans_type='{toStage}'
         WHERE a.tenant_id=@TenantId AND a.trans_type='{fromStage}'
           AND (@sourceSystem='' OR a.source_system=@sourceSystem) AND (a.source_system<>'T8' OR a.domain=@sourceDomain)
           AND a.trans_time IS NOT NULL AND b.trans_time>=a.trans_time
         """;

    private static string WarehouseSatisfactionSql(string stage) =>
        $"""
         SELECT ROUND(100 * SUM(CASE WHEN trans_time<=eff_date THEN 1 ELSE 0 END)
                          / NULLIF(COUNT(*),0),4) AS MetricValue,
                COUNT(*) AS RowCount
         FROM mdp_std_inv_trans
         WHERE tenant_id=@TenantId AND trans_type='{stage}'
           AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
           AND trans_time IS NOT NULL AND eff_date IS NOT NULL
         """;

    private static string WarehouseEfficiencySql(string stage) =>
        $"""
         SELECT ROUND(COUNT(DISTINCT NULLIF(lot_serial,''))
                      / NULLIF(COUNT(DISTINCT NULLIF(TRIM(create_user),'')),0),4) AS MetricValue,
                COUNT(*) AS RowCount
         FROM mdp_std_inv_trans
         WHERE tenant_id=@TenantId AND trans_type='{stage}'
           AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
         """;

    private static string WarehouseTurnoverSql(string inventoryStage, string flowStage) =>
        $"""
         SELECT ROUND(
                    30 * SUM(CASE WHEN trans_type='{inventoryStage}'
                                  THEN IFNULL(end_balance,0)
                                       * IFNULL(CAST(NULLIF(dimension1,'') AS DECIMAL(18,4)),1)
                                  ELSE 0 END)
                       / NULLIF(SUM(CASE WHEN trans_type='{flowStage}'
                                        THEN ABS(IFNULL(qty_change,0))
                                             * IFNULL(CAST(NULLIF(dimension1,'') AS DECIMAL(18,4)),1)
                                        ELSE 0 END),0),
                    4) AS MetricValue,
                SUM(CASE WHEN trans_type='{inventoryStage}' THEN 1 ELSE 0 END) AS RowCount
         FROM mdp_std_inv_trans
         WHERE tenant_id=@TenantId AND trans_type IN ('{inventoryStage}','{flowStage}')
           AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
         """;

    private async Task<KpiBuildSubResult> DispatchS7StageKpiAsync(
        string metricCode, string sql, string emptyDenom, string batchId, DateTime now,
        S7MdpRefreshOption option, string triggerType, CancellationToken ct)
    {
        var row = await _db.Ado.SqlQuerySingleAsync<S7StageKpiRow>(
            sql,
            new SugarParameter("@TenantId", option.TargetTenantId),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", ""));
        var value = row?.RowCount > 0 ? row.MetricValue : null;
        var dispatch = await _kpiCalcDispatcher.DispatchAsync(
            metricCode, ModuleCode, option.TargetTenantId, option.TargetFactoryId,
            option.BizDate, option.BizDate, option.BizDate, option.SourceZtid,
            batchId, triggerType, value, value.HasValue ? "OK" : emptyDenom, ct);
        var sub = new KpiBuildSubResult
        {
            T8Rows = row?.RowCount ?? 0,
            KpiRows = dispatch.ShouldUpsert
                ? await UpsertKpiValueAsync(
                    metricCode, option.BizDate, dispatch.MetricValue, now, option,
                    valueTable: L2ValueTable)
                : 0,
            DenominatorStatus = dispatch.DenominatorStatus
        };
        if (dispatch.ShouldUpsert)
        {
            try
            {
                await _dimensionRun.RunDimensionAsync(
                    metricCode, ModuleCode, option.TargetTenantId, option.BizDate, batchId, triggerType, ct);
            }
            catch (Exception ex)
            {
                _logger.LogWarning(ex, "{MetricCode} 维度跑批异常（不影响汇总链路）", metricCode);
            }
        }
        return sub;
    }

    // ─────────────────────────────────────────────────────────────────────────

    /// <summary>S9_L1_001 质量退货率 = SALES_RETURN 数量 / SALES_SHIP 数量 × 1,000,000 PPM。</summary>
    private async Task<KpiBuildSubResult> BuildS9L1001QualityReturnRateAsync(
        string batchId, DateTime now, S7MdpRefreshOption option, string triggerType, CancellationToken ct)
    {
        var sub = new KpiBuildSubResult();
        var summary = await _db.Ado.SqlQuerySingleAsync<S7QualityReturnSummaryRow>(
            """
            SELECT
                SUM(CASE WHEN biz_doc_type='SALES_RETURN' THEN ABS(IFNULL(qty_change,0)) ELSE 0 END) AS return_qty,
                SUM(CASE WHEN biz_doc_type='SALES_SHIP' THEN ABS(IFNULL(qty_change,0)) ELSE 0 END) AS shipped_qty
            FROM mdp_std_inv_trans
            WHERE tenant_id=@TenantId
              AND summary_flag=0 AND void_flag=0 AND approved_flag=1 AND (@sourceSystem='' OR source_system=@sourceSystem) AND (source_system<>'T8' OR domain=@sourceDomain)
              AND biz_doc_type IN ('SALES_RETURN','SALES_SHIP')
              AND approved_time BETWEEN @PeriodStart AND @PeriodEnd
            """,
            new SugarParameter("@TenantId", option.TargetTenantId),
            new SugarParameter("@PeriodStart", option.MonthlyPeriodStart),
            new SugarParameter("@PeriodEnd", option.MonthlyPeriodEnd),
            new SugarParameter("@sourceDomain", option.SourceZtid),
            new SugarParameter("@sourceSystem", ""));

        sub.T8Rows = summary == null ? 0 : 1;
        decimal? ppm = summary?.shipped_qty > 0
            ? Math.Round((summary.return_qty ?? 0m) / summary.shipped_qty.Value * 1_000_000m, 4)
            : null;
        var denominatorStatus = summary?.shipped_qty > 0 ? "OK" : "NO_SHIPMENT";
        var dispatch = await _kpiCalcDispatcher.DispatchAsync(
            "S9_L1_001", "S9", option.TargetTenantId, option.TargetFactoryId,
            option.MonthlyPeriodEnd, option.MonthlyPeriodStart, option.MonthlyPeriodEnd, option.SourceZtid,
            batchId, triggerType, ppm, denominatorStatus, ct);
        sub.KpiRows = dispatch.ShouldUpsert
            ? await UpsertKpiValueAsync("S9_L1_001", option.MonthlyPeriodEnd, dispatch.MetricValue, now, option, "S9")
            : 0;
        sub.DenominatorStatus = dispatch.DenominatorStatus;
        return sub;
    }

    private async Task<int> UpsertKpiValueAsync(
        string metricCode,
        DateTime bizDate,
        decimal? metricValue,
        DateTime now,
        S7MdpRefreshOption option,
        string moduleCode = ModuleCode,
        string valueTable = "ado_s9_kpi_value_l1_day")
    {
        // 沿用 S3 UpsertS3KpiValueAsync 范式：先查现存行 → UPDATE；不存在 → SELECT MAX(id)+1 显式生成 id 后 INSERT。
        // ado_s9_kpi_value_l1_day.id 为手工分配主键（无 AUTO_INCREMENT），必须显式 set；
        // metric_value 允许 NULL（分母缺失不得伪装真实 0）。
        // FIX-2：截断时分秒（月度 KPI 入参可能为 YYYY-MM-DD 23:59:59），保证 SELECT WHERE biz_date=@BizDate 与 DB date 列匹配，避免重复 INSERT。
        // FIX-1：tenant_id/factory_id 取自 option，默认仍为 1300000000001/1，不破坏 Demo。
        bizDate = bizDate.Date;
        var snap = await _kpiTargetResolver.ResolveAsync(option.TargetTenantId, option.TargetFactoryId, metricCode, moduleCode, bizDate);
        var existingId = await _db.Ado.GetLongAsync(
            $"SELECT IFNULL((SELECT id FROM {valueTable} WHERE tenant_id=@TenantId AND factory_id=@FactoryId " +
            "AND module_code=@ModuleCode AND metric_code=@MetricCode AND biz_date=@BizDate AND is_deleted=0 " +
            "ORDER BY id LIMIT 1), 0)",
            new List<SugarParameter>
            {
                new("@TenantId", option.TargetTenantId),
                new("@FactoryId", option.TargetFactoryId),
                new("@ModuleCode", moduleCode),
                new("@MetricCode", metricCode),
                new("@BizDate", bizDate)
            });

        if (existingId > 0)
        {
            return await _db.Ado.ExecuteCommandAsync(
                $"UPDATE {valueTable} SET metric_value=@MetricValue, target_value=@TargetValue, " +
                "target_config_id=@TargetConfigId, target_source=@TargetSource, target_resolved_at=@TargetResolvedAt, " +
                "calc_time=@Now, update_time=@Now, is_deleted=0, is_active=1 WHERE id=@Id",
                new SugarParameter("@MetricValue", metricValue),
                new SugarParameter("@TargetValue", SmartOps.KpiTargetSnapshotSql.ValueOrDbNull(snap)),
                new SugarParameter("@TargetConfigId", SmartOps.KpiTargetSnapshotSql.ConfigIdOrDbNull(snap)),
                new SugarParameter("@TargetSource", SmartOps.KpiTargetSnapshotSql.SourceOrDbNull(snap)),
                new SugarParameter("@TargetResolvedAt", snap.ResolvedAt),
                new SugarParameter("@Now", now),
                new SugarParameter("@Id", existingId));
        }

        var nextId = Yitter.IdGenerator.YitIdHelper.NextId();
        return await _db.Ado.ExecuteCommandAsync($@"
INSERT INTO {valueTable}
  (id, tenant_id, org_id, company_id, factory_id, status, biz_date,
   create_time, update_time, is_deleted, is_active,
   module_code, metric_code, metric_value, target_value, calc_time,
   target_config_id, target_source, target_resolved_at)
VALUES
  (@Id, @TenantId, NULL, NULL, @FactoryId, NULL, @BizDate,
   @Now, @Now, 0, 1,
   @ModuleCode, @MetricCode, @MetricValue, @TargetValue, @Now,
   @TargetConfigId, @TargetSource, @TargetResolvedAt)",
            new SugarParameter("@Id", nextId),
            new SugarParameter("@TenantId", option.TargetTenantId),
            new SugarParameter("@FactoryId", option.TargetFactoryId),
            new SugarParameter("@BizDate", bizDate),
            new SugarParameter("@Now", now),
            new SugarParameter("@ModuleCode", moduleCode),
            new SugarParameter("@MetricCode", metricCode),
            new SugarParameter("@MetricValue", metricValue),
            new SugarParameter("@TargetValue", SmartOps.KpiTargetSnapshotSql.ValueOrDbNull(snap)),
            new SugarParameter("@TargetConfigId", SmartOps.KpiTargetSnapshotSql.ConfigIdOrDbNull(snap)),
            new SugarParameter("@TargetSource", SmartOps.KpiTargetSnapshotSql.SourceOrDbNull(snap)),
            new SugarParameter("@TargetResolvedAt", snap.ResolvedAt));
    }

    private async Task<long> InsertTransformRunLogAsync(string batchId, DateTime startedAt, string triggerType, S7MdpRefreshOption option)
    {
        await _db.Ado.ExecuteCommandAsync(@"
INSERT INTO mdp_transform_run_log
  (tenant_id, job_code, job_name, trigger_type, batch_id, status, start_time, stage_rows, standard_rows, dwd_rows, create_time, update_time)
VALUES
  (@TenantId, @JobCode, @JobName, @TriggerType, @BatchId, 'RUNNING', @StartTime, 0, 0, 0, @StartTime, @StartTime)",
            new SugarParameter("@TenantId", option.TargetTenantId),
            new SugarParameter("@JobCode", JobCode),
            new SugarParameter("@JobName", JobName),
            new SugarParameter("@TriggerType", triggerType),
            new SugarParameter("@BatchId", batchId),
            new SugarParameter("@StartTime", startedAt));
        return await _db.Ado.GetLongAsync(
            "SELECT id FROM mdp_transform_run_log WHERE batch_id=@BatchId ORDER BY id DESC LIMIT 1",
            new List<SugarParameter> { new("@BatchId", batchId) });
    }

    private async Task MarkTransformRunSuccessAsync(long runLogId, DateTime startedAt, S7MdpSyncTransformResult result)
    {
        var finishedAt = DateTime.Now;
        await _db.Ado.ExecuteCommandAsync(@"
UPDATE mdp_transform_run_log
SET status='SUCCESS', end_time=@EndTime, duration_ms=@DurationMs,
    stage_rows=@StageRows, standard_rows=@StandardRows, dwd_rows=@DwdRows,
    summary_json=@SummaryJson, update_time=CURRENT_TIMESTAMP
WHERE id=@Id",
            new SugarParameter("@EndTime", finishedAt),
            new SugarParameter("@DurationMs", (int)(finishedAt - startedAt).TotalMilliseconds),
            new SugarParameter("@StageRows", result.StageRows),
            new SugarParameter("@StandardRows", result.StandardRows),
            new SugarParameter("@DwdRows", result.DwdRows),
            new SugarParameter("@SummaryJson", JsonSerializer.Serialize(new
            {
                batchId = result.BatchId,
                sourceZtid = result.SourceZtid,
                bizDate = result.BizDate.ToString("yyyy-MM-dd"),
                bizMonth = result.BizMonth,
                dwdRows = result.DwdRows,
                kpiRows = result.KpiRows,
                perKpiDwdRows = result.PerKpiDwdRows,
                perKpiKpiRows = result.PerKpiKpiRows,
                denominatorStatus = result.KpiDenominatorStatus
            })),
            new SugarParameter("@Id", runLogId));
    }

    private async Task MarkTransformRunFailedAsync(long runLogId, DateTime startedAt, string message, string batchId)
    {
        bool runLogUpdated = false;
        try
        {
            var finishedAt = DateTime.Now;
            await _db.Ado.ExecuteCommandAsync(@"
UPDATE mdp_transform_run_log
SET status='FAILED', end_time=@EndTime, duration_ms=@DurationMs,
    error_message=@ErrorMessage, update_time=CURRENT_TIMESTAMP
WHERE id=@Id",
                new SugarParameter("@EndTime", finishedAt),
                new SugarParameter("@DurationMs", (int)(finishedAt - startedAt).TotalMilliseconds),
                new SugarParameter("@ErrorMessage", Truncate(message, 2000)),
                new SugarParameter("@Id", runLogId));
            runLogUpdated = true;
        }
        catch (Exception ex)
        {
            Console.Error.WriteLine($"[S7MdpSyncTransform] MarkTransformRunFailed write failed (runLogId={runLogId}): {ex.Message}");
        }

        // FAILURE-NOTIFICATION-1：写库 FAILED 成功后发通知给超级管理员；通知失败不影响主流程
        if (!runLogUpdated) return;
        try
        {
            await _sysNoticeService.AddNotice(new AddNoticeInput
            {
                Title = "S7 成品仓储 T8 KPI 跑批失败",
                Content = $"模块：S7 成品仓储\n批次ID：{batchId}\n失败时间：{DateTime.Now:yyyy-MM-dd HH:mm:ss}\n错误信息：{Truncate(message, 1000)}\n\n请查看 mdp_transform_run_log 获取完整错误与重试记录。",
                Type = NoticeTypeEnum.NOTICE,
                PublicTime = DateTime.Now,
                Status = NoticeStatusEnum.PUBLIC,
                PublicUserId = NoticeReceiverUserId,
                PublicUserName = NoticeReceiverUserName
            });
        }
        catch (Exception notifyEx)
        {
            _logger.LogError(notifyEx, "[S7MdpSyncTransform] SysNotice 发送失败 (runLogId={RunLogId}, batchId={BatchId})", runLogId, batchId);
        }
    }

    private static string NormalizeTriggerType(string s) =>
        string.IsNullOrWhiteSpace(s) ? "AUTO" : s.Trim().ToUpperInvariant();

    private static void NormalizeOption(S7MdpRefreshOption option)
    {
        var d = S7MdpRefreshOption.Default();
        if (option.TargetFactoryId <= 0) option.TargetFactoryId = d.TargetFactoryId;
        if (string.IsNullOrWhiteSpace(option.SourceZtid)) option.SourceZtid = d.SourceZtid;
        option.TargetTenantId = AidopSourceTenantMap.ResolveTenantId(option.SourceZtid, option.TargetTenantId);
        if (option.BizDate == default) option.BizDate = d.BizDate;
        if (string.IsNullOrWhiteSpace(option.BizMonth)) option.BizMonth = d.BizMonth;
        if (option.MonthlyPeriodStart == default) option.MonthlyPeriodStart = d.MonthlyPeriodStart;
        if (option.MonthlyPeriodEnd == default) option.MonthlyPeriodEnd = d.MonthlyPeriodEnd;
    }

    private static string Truncate(string s, int max) =>
        string.IsNullOrEmpty(s) ? "" : (s.Length <= max ? s : s.Substring(0, max));
}

// DTO ────────────────────────────────────────────────────────────────────────

public sealed class S7MdpRefreshOption
{
    public string SourceZtid { get; set; } = "pbxfxp";
    /// <summary>KPI/DWD 落库目标租户；≤0 时由 <see cref="AidopSourceTenantMap"/> 按 SourceZtid 解析。</summary>
    public long TargetTenantId { get; set; }
    /// <summary>KPI/DWD 落库目标工厂；默认 1。</summary>
    public long TargetFactoryId { get; set; } = 1L;
    public DateTime BizDate { get; set; }
    public string BizMonth { get; set; } = "";
    public DateTime MonthlyPeriodStart { get; set; }
    public DateTime MonthlyPeriodEnd { get; set; }

    public static S7MdpRefreshOption Default()
    {
        var today = DateTime.Today;
        var yesterday = today.AddDays(-1);
        var lastMonth = today.AddMonths(-1);
        var monthStart = new DateTime(lastMonth.Year, lastMonth.Month, 1);
        var monthEnd = monthStart.AddMonths(1).AddDays(-1);
        return new S7MdpRefreshOption
        {
            SourceZtid = "pbxfxp",
            TargetTenantId = 0,
            TargetFactoryId = 1L,
            BizDate = yesterday,
            BizMonth = lastMonth.ToString("yyyy-MM"),
            MonthlyPeriodStart = monthStart,
            MonthlyPeriodEnd = monthEnd.AddDays(1).AddSeconds(-1)
        };
    }
}

public sealed class S7MdpSyncTransformResult
{
    public string BatchId { get; set; } = "";
    public long RunLogId { get; set; }
    public string TriggerType { get; set; } = "AUTO";
    public string SourceZtid { get; set; } = "";
    public long TargetTenantId { get; set; }
    public long TargetFactoryId { get; set; }
    public DateTime BizDate { get; set; }
    public string BizMonth { get; set; } = "";
    public DateTime MonthlyPeriodStart { get; set; }
    public DateTime MonthlyPeriodEnd { get; set; }

    public int StageRows { get; set; }
    public int StandardRows { get; set; }
    public int DwdRows { get; set; }
    public int KpiRows { get; set; }

    public Dictionary<string, int> PerKpiDwdRows { get; } = new();
    public Dictionary<string, int> PerKpiKpiRows { get; } = new();
    public List<string> KpiDenominatorStatus { get; } = new();

    public void MergeSub(string kpiCode, KpiBuildSubResult sub)
    {
        PerKpiDwdRows[kpiCode] = sub.DwdRows;
        PerKpiKpiRows[kpiCode] = sub.KpiRows;
        DwdRows += sub.DwdRows;
        KpiRows += sub.KpiRows;
        KpiDenominatorStatus.Add($"{kpiCode}:{sub.DenominatorStatus}");
    }
}

public sealed class KpiBuildSubResult
{
    public int T8Rows { get; set; }
    public int DwdRows { get; set; }
    public int KpiRows { get; set; }
    public string DenominatorStatus { get; set; } = "OK";
}

// T8 result set 投影类型 ──────────────────────────────────────────────────────

internal sealed class S7CycleRow
{
    public string? order_no { get; set; }
    public int? cycle_days { get; set; }
}

internal sealed class S7FulfillmentRow
{
    public string? order_no { get; set; }
    public int total_rows { get; set; }
    public int in_window_rows { get; set; }
}

internal sealed class S7ShipmentDetailRow
{
    public string? task_no { get; set; }
    public string? item_code { get; set; }
    public string? approved_date { get; set; }
    public decimal? qty_change { get; set; }
}

internal sealed class S7PeNumRow
{
    public int penum { get; set; }
}

internal sealed class S7QualityReturnSummaryRow
{
    public decimal? return_qty { get; set; }
    public decimal? shipped_qty { get; set; }
}

internal sealed class S7StageKpiRow
{
    public decimal? MetricValue { get; set; }
    public int RowCount { get; set; }
}