Mina Choi
5406094ea1
- scheduler/(__init__·jobs): 마감 처리·낙찰자 선정 잡 - quotation_crud·service: 스케줄러 연동 조회/마감 로직 - web_main·requirements·docker-compose·config: 스케줄러 기동 설정 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
75 lines
2.9 KiB
Python
75 lines
2.9 KiB
Python
"""백그라운드 스케줄러(크론) 패키지 — '언제'(when) 담당.
|
|
|
|
router/(HTTP 진입점)와 동급의 '시간 진입점' 계층. APScheduler 수명주기와 잡 등록(타이밍)만 책임지고,
|
|
실제로 하는 일(what)은 scheduler/jobs.py 에 있다.
|
|
|
|
- 다중 워커(운영)에서 잡이 워커마다 중복 실행되면 안 되므로 SCHEDULER_ENABLED=1 인 프로세스에서만 등록한다.
|
|
(개발은 RELOAD=1 단일 워커라 docker-compose 에서 SCHEDULER_ENABLED=1 로 켠다.)
|
|
- apscheduler import 는 start_scheduler() 안에서 한다 → 미설치(이미지 미재빌드) 상태라도 API 는 부팅된다.
|
|
|
|
잡 ① close_expired_quotations : 매일 UTC 00:10(KST 09:10) — 마감시각 지난 견적 마감
|
|
잡 ② complete_requote_quotations: 1시간마다 — 재견적 중 DONE 세션 있으면 즉시 마감
|
|
"""
|
|
import os
|
|
|
|
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
|
|
|
|
try:
|
|
from apscheduler.schedulers.asyncio import AsyncIOScheduler
|
|
from apscheduler.triggers.cron import CronTrigger
|
|
from apscheduler.triggers.interval import IntervalTrigger
|
|
except ImportError:
|
|
# 의존성 미설치(이미지 미재빌드) → API 는 살리고 스케줄러만 끈다.
|
|
LOG.e_no_callstack("[scheduler] apscheduler 미설치 → 스케줄러 비활성. requirements 재설치(이미지 재빌드) 필요")
|
|
return
|
|
|
|
_scheduler = AsyncIOScheduler(timezone="UTC")
|
|
# 잡 ① 마감시간 처리: 매일 UTC 00:10
|
|
_scheduler.add_job(
|
|
jobs.close_expired_quotations,
|
|
CronTrigger(hour=0, minute=10),
|
|
id="close_expired_quotations",
|
|
coalesce=True, # 밀린 실행이 여러 번 쌓여도 1번만
|
|
misfire_grace_time=3600, # 정시보다 늦게 깨어나도 1시간 내면 실행
|
|
max_instances=1,
|
|
)
|
|
# 잡 ② 재견적 협상완료 처리: 1시간마다
|
|
_scheduler.add_job(
|
|
jobs.complete_requote_quotations,
|
|
IntervalTrigger(hours=1),
|
|
id="complete_requote_quotations",
|
|
coalesce=True,
|
|
misfire_grace_time=600,
|
|
max_instances=1,
|
|
)
|
|
_scheduler.start()
|
|
LOG.i("[scheduler] started (close_expired=daily 00:10 UTC, complete_requote=hourly)")
|
|
|
|
|
|
def shutdown_scheduler():
|
|
"""lifespan shutdown 에서 호출."""
|
|
global _scheduler
|
|
if _scheduler is not None:
|
|
_scheduler.shutdown(wait=False)
|
|
_scheduler = None
|
|
LOG.i("[scheduler] stopped")
|