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

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

등록된 잡 —
  · Search Console 색인 점검   : 10분 간격 (GSC_ENABLED=1 일 때만)
  · SNS 승인 만료·중단 복구    : 5분 간격 (scheduler/jobs.sweep_social_posts)

붙을 잡 —
  · 지역정보 갱신 : 축제 주 1회 / 관광정보 월 1회 / 날씨 시간 단위 — 행정구역 코드 단위 캐시 갱신
  · 수집 재시도   : 실패한 수집 작업 재시도 (외부 API 실패 시 직전 값 유지 + 내부 알림)
  · 사이트 재빌드 : 검증 상태가 바뀐 place 만 개별 재빌드 (전체 재빌드 금지)
"""
import os

from apscheduler.schedulers.asyncio import AsyncIOScheduler

from common.logger import LOG

__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

    # 한국시간 기준. 잡은 scheduler/jobs.py 에 정의하고 여기서 add_job 으로 등록한다.
    _scheduler = AsyncIOScheduler(timezone="Asia/Seoul")
    if os.environ.get("GSC_ENABLED") == "1":
        from services.search_console_service import run_scheduled_check
        _scheduler.add_job(run_scheduled_check, "interval", minutes=10,
                           id="search-console", max_instances=1, coalesce=True)

    # ★ 1분이 아니라 5분이다. 이 스윕이 하는 일은 "만료 표시" 와 "중단된 초안 정리" 뿐이라
    #   분 단위 정밀도가 필요 없고, 주기가 짧으면 쓰기 커넥션을 계속 집어 든다 —
    #   실측(2026-09-14): 1분 주기로 두자 같은 컨테이너에서 도는 테스트가 커넥션을 못 받아
    #   TimeoutError 로 무더기 실패했다. 운영에서도 같은 풀을 발행·수집과 나눠 쓴다.
    from scheduler.jobs import sweep_social_posts
    _scheduler.add_job(sweep_social_posts, "interval", minutes=5,
                       id="social-sweep", max_instances=1, coalesce=True)

    _scheduler.start()
    LOG.i(f"[scheduler] started (KST: {len(_scheduler.get_jobs())}개 잡)")


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