AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Job/S8WatchSchedulerJob.cs

using Admin.NET.Plugin.AiDOP.Service.S8;
using Admin.NET.Plugin.AiDOP.Infrastructure.S8;
using Furion.Schedule;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using System.Text.Json;

namespace Admin.NET.Plugin.AiDOP.Job;

/// <summary>
/// G-08：S8 自动监控主链定时调度作业。
/// 固定租户 / 工厂上下文下，按周期触发一次 G-01 主链（<see cref="S8WatchSchedulerService.CreateExceptionsAsync"/>）。
/// 本轮仅完成"正式定时触发接入"；不在调度层追加业务逻辑、不改写主链入参语义、不做真实 SQL / 认证链路 / SLA 治理。
/// 周期由 [Period] 属性固化为默认值（30 分钟）；运行期调整走 Admin.NET 作业管理，不走配置中心。
/// 开关：默认通过 Admin.NET 作业管理的触发器状态控制；本作业构造不自动启动。
/// </summary>
[JobDetail("job_s8_watch_scheduler", Description = "S8 自动监控主链定时调度",
    GroupName = "default", Concurrent = false)]
[Period(S8WatchSchedulerJob.IntervalMs, TriggerId = "trigger_s8_watch_scheduler", Description = "S8-SCHED-EXEC-1：DB 驱动派发，1 分钟节拍")]
public class S8WatchSchedulerJob : IJob
{
    private readonly IServiceScopeFactory _scopeFactory;
    private readonly IConfiguration _configuration;
    private readonly ILogger _logger;

    // S8-SCHED-EXEC-1：节拍 5min → 1min；单规则节奏由 watch_rule.poll_interval_seconds + next_run_at 控制，
    // Job 仅做 tick；未到期规则在 PickReadyRulesAsync 阶段自然过滤。
    public const int IntervalMs = 60000;

    // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：业务执行节拍配置项与下限。
    // 业务节拍由 appsettings 的 S8:Scheduler:WatchTickIntervalMs 承载，默认 300000 ms (5 分钟)；
    // 硬件唤醒拍由 [Period(60000, ...)] 注解承载；下限 60000 ms 与硬件拍对齐，配置小于下限按下限处理。
    private const int DefaultWatchTickIntervalMs = 300000;
    private const int MinWatchTickIntervalMs = 60000;

    // 单 tick 最多抢锁规则数；规模上来后可下放到 appsettings。当前 dev 仅 3 条 demo，给 32 留余量。
    private const int BatchSize = 32;

    // 首次激活打印锚点。
    private static int _firstActivationLogged;

    // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：禁用提示锚点 + 业务节拍 due-skip 锚点。
    // _firstDisabledLogged 控制禁用日志单进程内只输出一次，避免每 tick 刷日志。
    // _lastBusinessTickUtcTicks 记录上一次进入业务体（RunDispatchTickAsync）时的 UTC ticks，
    // 用于"硬件拍 60s + 业务拍 5min"模式下的 due-skip 判定。
    // _firstParseFailLogged 控制 AIDOP_* env 解析失败 warn 单进程内只输出一次（首个失败 env 名）。
    private static int _firstDisabledLogged;
    private static long _lastBusinessTickUtcTicks;
    private static int _firstParseFailLogged;

    // S8-SCHEDULER-CONFIG-ORDER-FIX（合入 P0）：AIDOP_* env override 名称。
    // Furion 4.9.8.24 把 Configuration/*.{Environment}.json 追加在 ASP.NET Core
    // EnvironmentVariablesConfigurationProvider 之后，JSON 覆盖了 env，故此处用
    // Environment.GetEnvironmentVariable 做 S8 调度开关专项 override；
    // 命名前缀 AIDOP_ 与 SqlSugarSetup.cs 既有约定（AIDOP_DB_WAIT_MAX_SECONDS 等）一致。
    private const string EnvS8WatchTickMs = "AIDOP_S8_SCHEDULER_WATCH_TICK_MS";

    public S8WatchSchedulerJob(
        IServiceScopeFactory scopeFactory,
        IConfiguration configuration,
        ILoggerFactory loggerFactory)
    {
        _scopeFactory = scopeFactory;
        _configuration = configuration;
        _logger = loggerFactory.CreateLogger(nameof(S8WatchSchedulerJob));
    }

    public async Task ExecuteAsync(JobExecutingContext context, CancellationToken stoppingToken)
    {
        // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：环境级 + S8 业务级双开关 gate。
        // 任一为 false 时直接早退；早退前不访问任何业务 service / DB。
        // env override（合入 CONFIG-ORDER-FIX）：env 不存在/空白 → 沿用 JSON；
        // 存在但 bool.TryParse 失败 → 保留 JSON 值 + 单次 warn（首个失败 env 名，不输出 value）。
        var gate = S8JobSwitch.Evaluate(_configuration, S8BackgroundJob.WatchScheduler);
        if (gate.ParseFailEnvName != null && Interlocked.Exchange(ref _firstParseFailLogged, 1) == 0)
        {
            _logger.LogWarning(
                "S8WatchSchedulerJob env override 解析失败：{EnvName}，已沿用配置值",
                gate.ParseFailEnvName);
        }
        if (!gate.Enabled)
        {
            if (Interlocked.Exchange(ref _firstDisabledLogged, 1) == 0)
            {
                _logger.LogInformation(
                    "S8WatchSchedulerJob 被配置禁用：Scheduler:Enabled={Scheduler} S8:Scheduler:Enabled={S8Scheduler} {JobKey}={JobEnabled}",
                    gate.EnvironmentEnabled, gate.MasterEnabled,
                    S8JobSwitch.JobEnabledKey(S8BackgroundJob.WatchScheduler), gate.JobEnabled);
            }
            return;
        }

        // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：业务节拍 due-skip。
        // 硬件唤醒拍仍由 [Period(60000, ...)] 维持，但业务体只在配置的 WatchTickIntervalMs 周期上执行。
        // 首次启用时 _lastBusinessTickUtcTicks==0，立即放行；后续 tick 不足 interval 时早退。
        // 早退前不调用 S8WatchSchedulerService、不查询/写入数据库。
        // env override（合入 CONFIG-ORDER-FIX）：env 存在且 int.TryParse 成功 → 覆盖 JSON；
        // 解析失败 → 保留 JSON 值 + 单次 warn（与 bool 解析失败共用 _firstParseFailLogged 锚点）。
        // clamp 规则与 P0 一致：小于 MinWatchTickIntervalMs（60000）时强制按下限处理。
        var tickIntervalMs = _configuration.GetValue("S8:Scheduler:WatchTickIntervalMs", DefaultWatchTickIntervalMs);
        var envTickRaw = Environment.GetEnvironmentVariable(EnvS8WatchTickMs);
        if (!string.IsNullOrWhiteSpace(envTickRaw))
        {
            if (int.TryParse(envTickRaw, out var v)) tickIntervalMs = v;
            else if (Interlocked.Exchange(ref _firstParseFailLogged, 1) == 0)
            {
                _logger.LogWarning(
                    "S8WatchSchedulerJob env override 解析失败：{EnvName}，已沿用配置值",
                    EnvS8WatchTickMs);
            }
        }
        if (tickIntervalMs < MinWatchTickIntervalMs) tickIntervalMs = MinWatchTickIntervalMs;
        var nowUtcTicks = DateTime.UtcNow.Ticks;
        var lastTicks = Interlocked.Read(ref _lastBusinessTickUtcTicks);
        if (lastTicks != 0)
        {
            var elapsedMs = (nowUtcTicks - lastTicks) / TimeSpan.TicksPerMillisecond;
            if (elapsedMs < tickIntervalMs) return;
        }
        Interlocked.Exchange(ref _lastBusinessTickUtcTicks, nowUtcTicks);

        var triggeredAt = DateTime.Now;
        using var scope = _scopeFactory.CreateScope();
        var scheduler = scope.ServiceProvider.GetRequiredService<S8WatchSchedulerService>();

        try
        {
            var lockedBy = BuildLockedBy();
            var scopes = await scheduler.ListEnabledScopesAsync();
            if (Interlocked.Exchange(ref _firstActivationLogged, 1) == 0)
            {
                _logger.LogInformation(
                    "S8WatchSchedulerJob 首次激活：IntervalMs={IntervalMs} TickIntervalMs={TickInterval} BatchSize={Batch} ScopeCount={ScopeCount} LockedBy={LockedBy}",
                    IntervalMs, tickIntervalMs, BatchSize, scopes.Count, lockedBy);
            }

            foreach (var tenantScope in scopes)
            {
                var summary = await scheduler.RunDispatchTickAsync(
                    tenantScope.TenantId, tenantScope.FactoryId, BatchSize, lockedBy);
                // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：完全空跑（6 项摘要全 0）降为 LogDebug；
                // 任何非零字段（picked/failed/perRuleFailed/created/refreshed/leaseReleased）保持 LogInformation。
                if (IsEmptyTick(summary))
                    _logger.LogDebug(BuildTraceLine(triggeredAt, "success", summary, null, tenantScope.TenantId, tenantScope.FactoryId));
                else
                    _logger.LogInformation(BuildTraceLine(triggeredAt, "success", summary, null, tenantScope.TenantId, tenantScope.FactoryId));
            }
        }
        catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
        {
            _logger.LogInformation(BuildTraceLine(triggeredAt, "cancelled", null, null));
        }
        catch (Exception ex)
        {
            // RunDispatchTickAsync 内部已吞所有单规则异常；此处仅兜底。
            _logger.LogError(ex, BuildTraceLine(triggeredAt, "error", null, TruncateSummary(ex.Message)));
        }
    }

    private static string BuildLockedBy()
    {
        try
        {
            var pid = Environment.ProcessId;
            return $"{Environment.MachineName}-{pid}";
        }
        catch
        {
            return "unknown-host";
        }
    }

    // 单行 JSON 留痕：tick 维度 6 字段（触发时间 / 执行结果 / picked / created / refreshed / pending / failed / leaseReleased / runId）。
    private static string BuildTraceLine(
        DateTime triggeredAt,
        string result,
        S8DispatchTickResult? summary,
        string? failureSummary,
        long? tenantId = null,
        long? factoryId = null)
    {
        var payload = new
        {
            job = "S8WatchSchedulerJob",
            triggeredAt = triggeredAt.ToString("yyyy-MM-dd HH:mm:ss"),
            result,
            tenantId,
            factoryId,
            tickId = summary?.TickId,
            runId = summary?.RunId,
            picked = summary?.Picked ?? 0,
            success = summary?.Success ?? 0,
            ruleFailed = summary?.Failed ?? 0,
            created = summary?.Created ?? 0,
            refreshed = summary?.Refreshed ?? 0,
            pending = summary?.Pending ?? 0,
            perRuleFailed = summary?.PerRuleFailed ?? 0,
            leaseReleased = summary?.LeaseReleased ?? 0,
            failureSummary
        };
        return "S8WatchSchedulerJob 留痕 " + JsonSerializer.Serialize(payload);
    }

    private static string? TruncateSummary(string? raw)
    {
        if (string.IsNullOrWhiteSpace(raw)) return null;
        var oneLine = raw.Replace('\n', ' ').Replace('\r', ' ').Trim();
        return oneLine.Length <= 200 ? oneLine : oneLine[..200];
    }

    // S8-SCHEDULER-P0-BLEEDING-STOP-CONFIG-1：完全空跑判定。
    // 6 项摘要全 0 → 视为本 tick 无任何业务变化，日志降级到 Debug。
    private static bool IsEmptyTick(S8DispatchTickResult? summary)
    {
        if (summary == null) return true;
        return summary.Picked == 0
            && summary.Failed == 0
            && summary.PerRuleFailed == 0
            && summary.Created == 0
            && summary.Refreshed == 0
            && summary.LeaseReleased == 0;
    }
}