feat(runtime): dcy-014 trading_date KST 타임존 분리 + 일일 슬롯 preallocation (BAT-018)

데몬이 시스템 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>
2026-06-08 15:39:04 +09:00
parent 4746f74aae
commit 0b7db66463
20 changed files with 818 additions and 15 deletions
@@ -146,3 +146,43 @@
 - Existing Implementation Invalidated: no
 - Status Recommendation: keep-current (Implemented)
 - Follow-up Action: draft-release 로 BAT-013 배포 편성. token .env 제거는 배포 rollout.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-014) per-instance TOML 설정에 `trading_timezone`(기본 `Asia/Seoul`)·`daily_preallocation_time`(기본 `00:00`) 키 추가. `DaemonInstanceConfig.from_toml` 파싱 + `from_config` → `DaemonConfig` 전파. 본 기능 운영 설정을 TOML 로 일원화(dcy-014 FR-4). BAT-018 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 거래일 타임존·일일 트리거 시각을 신규 설정 표면 없이 기존 `--config` TOML 에 편입(운영자 명시 지정 가능).
+
+#### Acceptance Criteria Delta
+
+- Added:
+  - TOML optional 키 `trading_timezone`/`daily_preallocation_time`(부재 시 KST/00:00 기본). from_config 가 DaemonConfig 로 전파.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/runtime/config.py`(DaemonInstanceConfig/DaemonConfig/from_config)
+- Docs: `config/instance.example.toml`
+- Tests: tests/runtime/test_instance_config.py(기본값/전파)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-018
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-018 에서 완료)
+- Existing Implementation Invalidated: no (optional 키 추가, 기존 TOML 호환)
+- Status Recommendation: Implemented (change-req → BAT-018 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-018).
+
+#### Validation Plan
+
+- BAT-018: from_toml 기본값(KST/00:00) + TOML 값 from_config 전파 단위.
@@ -149,3 +149,41 @@

 #### Validation Plan
 - BAT-002 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-014) baseline 문서를 trading_date 타임존 분리·일일 preallocation 흐름에 맞춰 정합: `docs/runtime-flows.md`(데몬 lifecycle TOML 키·8 스레드·`일일 슬롯 preallocation` Flow 신규), `docs/data-model.md`(trading_date=설정 TZ 기준 / timestamp=UTC 구분). BAT-018 정합 완료 → Implemented 유지.
+
+#### Intent
+
+- 코드(preallocation_scheduler/daemon/config) 변경과 baseline 문서를 일치(S-1~S-4)시켜 운영자 참조 정합 유지.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - runtime-flows 데몬 lifecycle/일일 preallocation, data-model trading_date TZ vs UTC timestamp 기술 정합.
+
+#### Impacted Area Delta
+
+- Docs: docs/runtime-flows.md, docs/data-model.md
+
+#### Delivery Trace Delta
+
+- Batches: BAT-018
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: no (문서 정합)
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented (change-req → BAT-018 정합)
+- Follow-up Action: confirm-req-implemented(BAT-018).
+
+#### Validation Plan
+
+- BAT-018: 코드-문서 diff 대조.
@@ -151,3 +151,42 @@

 #### Validation Plan
 - BAT-002 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-014/issue #14) 데몬 부트스트랩의 슬롯 preallocation 을 시스템 UTC 날짜 1회 생성에서 **설정 타임존(기본 `Asia/Seoul`) 기준 `trading_date` 일일 멱등 생성**으로 전환. `DailyPreallocationScheduler`(REQ-030 SnapshotScheduler 패턴 준용) 신규 + `setup()` 배선 + `trex-preallocation` 스레드. timestamp 는 UTC 유지. BAT-018 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- `trading_date` 가 KST 캘린더 일자와 일치하고, 재시작 없이 TZ 일자 경계마다 다음날 슬롯이 자동 생성되도록(issue #14).
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - setup preallocation 이 UTC 날짜 → 설정 TZ `trading_date` 기준. 일일 멱등 preallocation 스레드 추가(TZ 일자당 1회).
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/application/preallocation_scheduler.py`(신규), `trex_core/runtime/daemon.py`(setup TZ preallocation + 스레드 배선)
+- Tests: tests/application/test_preallocation_scheduler.py
+
+#### Delivery Trace Delta
+
+- Batches: BAT-018
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-018 에서 완료)
+- Existing Implementation Invalidated: yes (UTC 날짜 1회 preallocation 경로)
+- Status Recommendation: Implemented (change-req → BAT-018 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-018).
+
+#### Validation Plan
+
+- BAT-018: KST/UTC 경계 trading_date, 일자 경계 자동 생성+멱등, 설정 TZ, 트리거 시각 게이팅 단위.
@@ -139,8 +139,8 @@

 ## Recent Change Log Summary

+- 2026-06-08 :: REQ-005/048/009 change-req (dcy-014, BAT-018): 당일 슬롯 생성 기준을 시스템 UTC 날짜에서 설정 타임존(기본 KST) 기준 `trading_date` 로 분리(timestamp 는 UTC 유지) + 데몬 1회 preallocation 을 `DailyPreallocationScheduler`(TZ 일자당 1회 멱등 fire, 재시작 없이 다음날 자동 생성)로 대체(REQ-005), TOML `trading_timezone`/`daily_preallocation_time` 키(REQ-048), runtime-flows/data-model 정합(REQ-009). 전부 change-req(신규 REQ 없음, OQ-3; 스케줄러는 REQ-030 패턴 준용). 단위 302 passed, 인프라 게이트 334 passed, ruff clean. (change-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-012/013/018/031/014/015 change-req (dcy-013, BAT-017): KIS 외부 주문 취소 시 슬롯이 pending_sell 에 영구 갇히던 버그(issue #9) 정정. KIS `poll_fill` 이 `cncl_yn` 파싱해 외부 취소 감지 — 체결 0 취소→`cancelled`(롤백 자동 복구), 부분 체결 후 취소→`is_partial_cancel`(체결분 원장 1회+qty 차감+holding 복귀, OQ-1 A안)(REQ-012/013/018), 잔여 포지션 정합 연계(REQ-031), pending stale 워치독 Alert-only(`TREX_PENDING_STALE_THRESHOLD`, WARN+카운터, 상태 미변경)(REQ-014), baseline 2문서 정합(REQ-015). 전부 change-req(신규 REQ 없음, OQ-3). 단위 294 passed, 인프라 게이트 326 passed, ruff clean. (change-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-013/007/036/002/006/003/015 change-req (dcy-012, BAT-016): 매도 주문이 매수가(entry_price) 지정가로 나가던 버그(issue #10) 정정. 슬롯 `entry_price`→`limit_price`(side 무관 pending 지정가) rename + pending 이탈 clear(REQ-002), 컬럼 rename 마이그레이션 006(REQ-006), `_dispatch` 가 slot.limit_price 단일 필드로 가격/주문유형 결정(REQ-013), SellIntent/sell payload optional limit_price·_admit_sell 운반(REQ-007), SlotService.sell optional 가격→자율 매도 시장가(REQ-036), 컬럼 계약 가드(REQ-003), baseline 3문서 정합(REQ-015). 전부 change-req(신규 REQ 없음, OQ-3). 단위 286 passed, 인프라 게이트 318 passed, ruff clean. (change-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-007/018/021 change-req + REQ-055 생성·Implemented (dcy-011, BAT-015): buy intent 계약 hard cutover — portfolio_id 필수화 + symbol 서버 resolve(SnapshotStore) + unknown_portfolio/portfolio_id_required 거부(REQ-007), buy payload symbol 제거(REQ-021), ledger skip 가시화(WARN+ledger_skipped 카운터, REQ-018), closed↔outbox anti-join 운영 점검 `find_ledger_gap_slots` 신규(REQ-055). 전체 인프라 게이트 314 passed, ruff clean. (change-req/draft-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-052~054 Approved → Implemented (confirm-req-implemented): BAT-014(batch-lite) verify 완료(신규 8 단위, 전체 278 passed, ruff clean). SafetySellService per-slot 쿨다운(skip/만료재시도/경고/prune, market_close 제외), SafetySellConfig env 2종(min_retry_interval_sec 600/max_retry_warn_count 3), runtime-flows 정합. (confirm-req-implemented)
- 2026-06-08 :: REQ-052~054 Proposed → Approved (confirm-req): dcy-010 safety-sell 쿨다운 3개 전원 승인 게이트 통과. dcy-010(confirmed) FR/OQ 와 모순 없음, 필수 필드·구체 AC 완비. 피드백 채널·DB 영속은 Out of Scope 비핵심. (confirm-req)