genichinandClaude Opus 4.8
0b7db66463
데몬이 시스템 UTC 날짜로 슬롯을 1회만 preallocate 해 trading_date 가 KST 캘린더와 어긋나고 재시작 없이는 다음날 슬롯이 안 생기던 문제(issue #14) 정정. 거버넌스: 전부 change-req (신규 REQ 없음, dcy-014 OQ-3; 스케줄러는 REQ-030 패턴 준용). - REQ-005: trading_date 를 설정 타임존(기본 Asia/Seoul) 기준 계산(timestamp 는 UTC 유지). DailyPreallocationScheduler 신규 — TZ 일자당 1회 멱등 fire, 재시작 없이 다음날 슬롯 자동 생성. setup() 배선 + trex-preallocation 스레드 - REQ-048: TOML trading_timezone/daily_preallocation_time 키 + from_config 전파 - REQ-009: runtime-flows/data-model 정합 + instance.example.toml OQ-1 기본 00:00(TZ 자정, TOML 설정 가능) / OQ-2 매 캘린더일 생성(거래일 캘린더 후속). 멱등 preallocate 로 중복 tick·다중 인스턴스 중복 생성 0. 검증: 단위 302 passed/32 skipped, 인프라 게이트(PG+RabbitMQ) 334 passed, ruff clean. 신규 test_preallocation_scheduler(고정 clock) + test_instance_config 확장. BAT-018 release-candidate. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
BAT-018 Planning
- Status: confirmed
- Batch: BAT-018
- Profile: standard
Included REQ
- REQ-005 (Installation, change-req): setup() UTC→TZ trading_date +
DailyPreallocationScheduler신규 + daemon 스레드 배선. - REQ-048 (Configuration, change-req): TOML
trading_timezone/daily_preallocation_time키 + from_config 전파. - REQ-009 (Documentation, change-req): runtime-flows/data-model 정합.
Delivery Plan
- REQ-005:
application/preallocation_scheduler.py(SnapshotScheduler 패턴, TZ date + 일자당 1회 멱등 fire + boot run_once). - REQ-048:
config.pyDaemonInstanceConfig TOML 키 2종 + DaemonConfig 필드 + from_config 전파(+ from_env KST/00:00 기본). - REQ-005 배선:
daemon.pysetup() →preallocation_scheduler.run_once(),_preallocation_loop스레드 + workers 등록, ZoneInfo(tz). - REQ-009: runtime-flows(데몬 lifecycle + 일일 preallocation Flow)/data-model(trading_date TZ vs UTC) + instance.example.toml.
- 신규 테스트(test_preallocation_scheduler, test_instance_config 확장) + 전체 회귀 + ruff + 인프라 게이트.
Dependencies
- Internal:
- dcy-002/BAT-002 daemon 부트스트랩(REQ-005) — preallocation 지점.
- dcy-005/BAT-008 SnapshotScheduler(REQ-030) — 스케줄러 패턴 준용.
- dcy-009/BAT-013 DaemonInstanceConfig TOML(REQ-048) — 설정 키 추가.
- REQ-002 preallocate_daily_slots — date 멱등(재사용, 본문 변경 없음).
- External:
- stdlib
zoneinfo(py3.12) — IANA 타임존.
- stdlib
Design Gate
- Design Required Before Implementation: yes
- Reason: (a) trading_date TZ 분리는 daemon 부트스트랩·스케줄러·설정·도메인 호출부 경계에 걸쳐, "TZ 는 호출부에서, 도메인 시그니처는 date 유지"(A-3) 경계를 설계에서 못박지 않으면 도메인 침범/회귀 위험. (b) 일자 경계 fire/멱등/트리거 시각 게이팅 규칙(SnapshotScheduler 준용)을 설계에서 고정해야 중복 생성·누락(NFR-2/3)을 막는다. (c) 설정 표면(TOML 일원화 + from_env 기본)·timestamp UTC 유지(NFR-1) 경계 명시. → design.md 동일 턴 scaffold.
Milestones
- M1 — REQ-005 DailyPreallocationScheduler, test_preallocation_scheduler green
- M2 — REQ-048 TOML 키 + from_config 전파, test_instance_config 확장 green
- M3 — REQ-005 daemon 배선(setup + 스레드)
- M4 — REQ-009 문서 정합 + instance.example.toml
- M5 — 전체 회귀 + ruff + 인프라 게이트
Risks
- R-1 (Low, OQ-1): 트리거 시점 운영 기대 불일치. 대응: 기본 00:00 + TOML 설정, SnapshotScheduler 패턴 재사용.
- R-2 (Medium): TZ 전환 경계에서 기존 UTC 날짜 슬롯과 새 TZ trading_date 불일치. 대응: 멱등 생성으로 중복 방지 + 경계 케이스 테스트(KST/UTC 경계).
- R-3 (Low, OQ-2 수용): 비거래일 idle 슬롯 누적. 대응: 매 캘린더일 생성 수용, idle 은 buy admit 시에만 활성화로 무해. 거래일 캘린더 후속.
Notes
- 1차 게이트: 전체 회귀 green(부트스트랩 변경 무회귀).
- 경계 검증은 고정 clock 주입 단위로 결정론 확보(스레드 불필요).
- 멱등 preallocation 은 PG 게이트 전이/마이그레이션 테스트 회귀로도 간접 검증.