"""백그라운드 스케줄러(크론) 패키지 — '언제'(when) 담당.

다중 워커(운영)에서 잡이 워커마다 중복 실행되면 안 되므로 SCHEDULER_ENABLED=1 인 프로세스에서만 등록한다.

잡 ① close_expired_quotations  : 5분마다(KST) — 마감시각 지난 견적 마감
잡 ② close_negotiated_quotations: 5분마다(KST) — 모든 세션 협상 끝난 견적 즉시 마감(타입 무관)
"""
import os

from apscheduler.schedulers.asyncio import AsyncIOScheduler
from apscheduler.triggers.cron import CronTrigger

from common.logger import LOG
from scheduler import jobs

__all__ = ["start_scheduler", "shutdown_scheduler"]

_scheduler = None  # AsyncIOScheduler | None


def _is_enabled() -> bool:
    return os.environ.get("SCHEDULER_ENABLED", "0") == "1"


def start_scheduler():
    """lifespan startup 에서 호출. SCHEDULER_ENABLED=1 일 때만 스케줄러를 띄운다."""
    global _scheduler
    if not _is_enabled():
        LOG.i("[scheduler] disabled (SCHEDULER_ENABLED != 1)")
        return
    if _scheduler is not None:
        return

    # 한국시간 기준, 두 잡 모두 5분마다 실행.
    _scheduler = AsyncIOScheduler(timezone="Asia/Seoul")
    # 잡 ① 마감시각 지난 견적 처리
    _scheduler.add_job(
        jobs.close_expired_quotations,
        CronTrigger(minute="*/5"),
        id="close_expired_quotations",
        coalesce=True,           # 밀린 실행이 쌓여도 1번만
        misfire_grace_time=600,  # 정시보다 늦게 깨어나도 10분 내면 실행
        max_instances=1,
    )
    # 잡 ② 모든 세션 협상 끝난 견적 즉시 마감(타입 무관)
    _scheduler.add_job(
        jobs.close_negotiated_quotations,
        CronTrigger(minute="*/5"),
        id="close_negotiated_quotations",
        coalesce=True,
        misfire_grace_time=600,
        max_instances=1,
    )
    _scheduler.start()
    LOG.i("[scheduler] started (KST, both every 5min)")


def shutdown_scheduler():
    """lifespan shutdown 에서 호출."""
    global _scheduler
    if _scheduler is not None:
        _scheduler.shutdown(wait=False)
        _scheduler = None
        LOG.i("[scheduler] stopped")