o2o-negosium-original/negodata/backend/scheduler/__init__.py
민헌 5ddf5f6249 refactor(negodata): LPS 자동 요청 배치 제거 — 검색은 수동 트리거 전용
협의 결정(2026-07-10): 크롤 비용이 사용자 행동에만 비례하도록,
갱신 오래된 상품을 자동으로 검색 요청하던 잡(매일 04:00, 상한 500건,
일 ~$2)을 제거한다. 검색 진입점은 상품 화면의 수동 트리거
(POST /v1/item/{id}/lowest-price) 하나만 남는다.

- request_lps_searches 잡·request_stale_searches 서비스·stale_items
  CRUD·배치 상수(REFRESH_HOURS 등) 제거
- 수집 잡(sync_lps_results, 5분)은 유지 — 크롤을 일으키지 않는
  반영 백스톱(모달 조기 종료·폴링 초과분 자동 반영, 비용 0)

검증: 스케줄러 등록 잡 3개(견적마감 2 + LPS 수집 1) 확인, 수집 잡 실행 정상

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 16:47:39 +09:00

79 lines
3.0 KiB
Python

"""백그라운드 스케줄러(크론) 패키지 — '언제'(when) 담당.
다중 워커(운영)에서 잡이 워커마다 중복 실행되면 안 되므로 SCHEDULER_ENABLED=1 인 프로세스에서만 등록한다.
잡 ① close_expired_quotations : 5분마다(KST) — 마감시각 지난 견적 마감
잡 ② close_negotiated_quotations: 5분마다(KST) — 모든 세션 협상 끝난 견적 즉시 마감(타입 무관)
잡 ③ sync_lps_results : 5분마다(KST) — lps_db 결과 증분 수집 → 이력 append + 상품 최저가 박제
(수동 트리거된 검색의 반영 백스톱 — 크롤을 일으키지 않음, 비용 0)
LPS 검색 **요청**은 배치로 돌리지 않는다(2026-07-10 협의) — 상품 화면의 수동 트리거
(POST /v1/item/{id}/lowest-price)로만 검색한다. 크롤 비용이 사용자 행동에만 비례하게.
"""
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,
)
# 잡 ③ LPS 결과 수집·반영 — 증분·멱등이라 잦아도 안전. 크롤 요청은 하지 않는다(수동 트리거 전용).
_scheduler.add_job(
jobs.sync_lps_results,
CronTrigger(minute="*/5"),
id="sync_lps_results",
coalesce=True,
misfire_grace_time=600,
max_instances=1,
)
_scheduler.start()
LOG.i("[scheduler] started (KST: 견적마감 2잡 5분 · LPS 수집 5분 — LPS 요청 배치 없음, 수동 트리거 전용)")
def shutdown_scheduler():
"""lifespan shutdown 에서 호출."""
global _scheduler
if _scheduler is not None:
_scheduler.shutdown(wait=False)
_scheduler = None
LOG.i("[scheduler] stopped")