diff --git a/journey/plans/260214_calendar_skill_자동_휴일감지_행동제어_구축.md b/journey/plans/260214_calendar_skill_자동_휴일감지_행동제어_구축.md index 89fc7ba..9e3573c 100644 --- a/journey/plans/260214_calendar_skill_자동_휴일감지_행동제어_구축.md +++ b/journey/plans/260214_calendar_skill_자동_휴일감지_행동제어_구축.md @@ -1,9 +1,16 @@ +--- +tags: [calendar, scheduler, holiday, blackout, plans] +--- + # Calendar Skill 기반 자동 휴일 감지 행동 제어 시스템 구축 **날짜**: 2026-02-14 **작성자**: happybell80 **관련 서비스**: rb8001, skill-calendar, robeing-monitor +## 관련 문서 +- [Calendar Skill 자동휴일감지 행동제어 원인확정 리서치](../research/260310_calendar_skill_자동휴일감지_행동제어_원인확정_리서치.md) + --- ## 1. 문제 @@ -11,11 +18,24 @@ - 연휴 중에도 평일 잡이 실행되어 운영 정책과 충돌한다. - 현재 연휴 제어는 수동 비활성화에 의존한다. +## 1-1. 원인 확정 +- `scheduled_jobs`에 휴일/블랙아웃 정책 저장층이 없다. +- `skill-calendar`에 휴일 판정 API가 없다. +- `rb8001` 잡 실행 전에 공통 실행 가드가 없다. +- `robeing-monitor`의 `schedule_type`, `schedule_days`는 실제 DB에 저장되지 않는다. + ## 2. 목표 - 목표 1: 상시 규칙으로 워킹데이(공휴일 제외) 실행을 자동화한다. - 목표 2: 특정 기간(예: 설 연휴) 블랙아웃으로 즉시 실행 차단을 지원한다. - 목표 3: 운영 API에서 상태 조회와 제어 이력을 확인한다. +## 2-1. 고정 결정 +- 대한민국 공휴일 1차 SSOT는 **공공데이터포털 한국천문연구원 `특일 정보` OpenAPI**로 고정한다. +- 1차 운영 범위는 `country=KR`, `timezone=Asia/Seoul`로 고정한다. +- 잡 실행 정책 저장 위치는 `scheduled_jobs.schedule_policy JSONB`로 고정한다. +- 실행 차단 위치는 각 `_run_*_with_logging` 진입점 앞 공통 가드 헬퍼로 고정한다. +- `db_loader`는 정책 전달까지만 담당하고, 실행 여부 판정은 하지 않는다. + ## 3. 해결방안 - `skill-calendar`에 휴일 판정 API를 추가한다. - `rb8001` 스케줄러 실행 경로에 공통 가드를 추가한다. @@ -23,7 +43,7 @@ - `robeing-monitor` 설정 API에서 `schedule_type`, `schedule_days`를 실제 저장/조회로 전환한다. ## 4. 아키텍처 -- 휴일 소스: Google Calendar의 공휴일 캘린더 + 수동 블랙아웃 기간. +- 휴일 소스: 한국천문연구원 `특일 정보` OpenAPI + 수동 블랙아웃 기간. - 판정 서비스: `skill-calendar`가 날짜별 `is_workday`, `is_blackout`, `reason`을 반환. - 실행 가드: `rb8001` 잡 실행 직전 판정 API 호출 후 실행/스킵 결정. - 운영 가시성: 스킵 로그를 activity 로그에 저장하고 모니터링 API로 조회. @@ -31,7 +51,7 @@ ## 5. Phase 작업 ### Phase 1: 데이터 모델 - `scheduled_jobs`에 `schedule_policy` JSONB 컬럼을 추가한다. -- 기본 정책을 `{"mode":"workday","blackout_ranges":[]}`로 저장한다. +- 기본 정책을 `{"mode":"workday","country":"KR","timezone":"Asia/Seoul","blackout_ranges":[]}`로 저장한다. - Repository CRUD에서 `schedule_policy` 읽기/쓰기/수정 경로를 추가한다. ### Phase 2: skill-calendar 휴일 판정 @@ -41,7 +61,7 @@ - 결과 캐시를 1일 단위로 저장해 반복 조회 부하를 줄인다. ### Phase 3: rb8001 실행 가드 -- `db_loader`에서 잡 등록 시 policy를 실행 함수 인자로 전달한다. +- `db_loader`에서 잡 등록 시 `schedule_policy`를 실행 함수 인자로 전달한다. - 각 `_run_*_with_logging` 진입점에서 공통 가드 함수를 먼저 호출한다. - `should_run=false`면 작업 본문을 실행하지 않고 스킵 로그를 남긴다.