o2o-negosium-original/negodata/backend/scheduler/__init__.py
Mina Choi 7f948075e5 [feat] negodata/backend: 견적 자동마감 스케줄러 + 다음 라운드 재생성(자동/수동)
- APScheduler 크론(KST 5분): 마감일 지난 견적 / 모든 세션 종결 견적 → close_and_decide
- 마감 판정: 단독 최저가 낙찰 확정 / 동가·전원미참여 다음 라운드 재생성 / 거부·한도 마감
- 재생성: 같은 견적번호 체인(round+1, 이름 '(N차)'), 공급사 수로 재협상·재견적, 사유별 한도(미참여1+동가1)
- 수동 재생성 POST /regenerate/{qt_id} (마지막 차수만 허용)
- CloseOutcome enum + 잡 결과별 로그

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 16:36:22 +09:00

65 lines
2.2 KiB
Python

"""백그라운드 스케줄러(크론) 패키지 — '언제'(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")