DOCS/journey/plans/archive/260102_db_scheduler_management.md

DB 기반 동적 스케줄러 관리 시스템

날짜: 2026-01-02 작성자: happybell80 관련 서비스: rb8001 상태: 구현 완료 (Phase 1-6)

→ 상세: troubleshooting/260102_db_scheduler_management.md

---

목적

main.py 732줄 중 130줄이 스케줄 관련 코드. DB로 이동하여 동적 관리.

테이블 구조

CREATE TABLE IF NOT EXISTS scheduled_jobs (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name VARCHAR(100) UNIQUE NOT NULL,
    job_type VARCHAR(50) NOT NULL,
    cron_expression VARCHAR(50) NOT NULL,
    enabled BOOLEAN DEFAULT true,
    config JSONB DEFAULT '{}',
    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW()
);

Job Type 매핑

job_type	함수 경로	비고
lunch_worldcup	app.scheduler.jobs.lunch_worldcup._run_worldcup_with_logging	sync 래퍼
diary_generator	app.scheduler.jobs.diary_generator._run_diary_generator_with_logging	sync 래퍼
naverworks_briefing	app.scheduler.jobs.naverworks_briefing._run_briefing_with_logging	sync 래퍼
coldmail_briefing	app.scheduler.jobs.coldmail_briefing._run_coldmail_briefing_with_logging	sync 래퍼

구현 완료 (Phase 1-6)

• Phase 1-2: app/state/scheduler_repository.py - CRUD 함수
• Phase 3: app/scheduler/db_loader.py - DB 로더
• Phase 4: main.py:146-149 - DB 기반 로드로 전환
• Phase 5: app/router/scheduler_endpoint.py - API 엔드포인트
• Phase 6: scripts/migrate_schedules_to_db.py - 기존 데이터 마이그레이션 (4개 스케줄러)

미완료 (Phase 7)

• Phase 7: Pydantic Settings 전환 (선택, 권장)