trex-core/docs/srs/Configuration/req-041_safety-sell-env-config.md

req-041: safety-sell 환경 설정 — 5종 env var

• Status: Implemented
• Type: Configuration
• Priority: High
• Owner: project maintainers

Intent

자율 안전 매도 기능(REQ-034~039)에서 사용하는 5종의 환경 변수를 trex_core/runtime/config.py의 DaemonConfig.from_env()에 추가한다. 모든 값은 env에서 파싱되며 기본값을 제공해야 한다(dcy-007 NFR-1·3, A-4).

Requirement

• 시스템은 아래 5종 env var를 DaemonConfig.from_env()에서 파싱해야 한다.

환경 변수	타입	기본값	설명
TREX_WATCHDOG_TIMEOUT	int (초)	120	워치독 만료 임계값 (REQ-034)
TREX_WATCHDOG_GRACE_PERIOD	int (초)	60	데몬 재시작 후 만료 판정 유예 시간 (REQ-034)
TREX_FORCED_CLOSE_CHECK_INTERVAL	int (초)	60	forced_close_at 만기 체크 주기 (REQ-037)
TREX_STOP_LOSS_POLL_INTERVAL	int (초)	30	stop-loss·take-profit 가격 polling 주기 (REQ-038)
TREX_MARKET_CLOSE_LIQUIDATION_TIME	str (HH:MM KST)	None (미설정)	장 마감 강제 청산 시각 (REQ-039). 미설정 시 동작 없음.

Acceptance Criteria

1. Given 환경 변수가 설정되지 않았을 때, When DaemonConfig.from_env()를 호출하면, Then watchdog_timeout=120, watchdog_grace_period=60, forced_close_check_interval=60, stop_loss_poll_interval=30, market_close_liquidation_time=None이 반환된다.
2. Given TREX_WATCHDOG_TIMEOUT=180이 설정됐을 때, When from_env()를 호출하면, Then watchdog_timeout=180이 반환된다.
3. Given TREX_MARKET_CLOSE_LIQUIDATION_TIME=15:10이 설정됐을 때, When from_env()를 호출하면, Then market_close_liquidation_time이 파싱되어 datetime.time(15, 10)(또는 동등한 형식)으로 반환된다.
4. Given TREX_MARKET_CLOSE_LIQUIDATION_TIME이 설정되지 않았을 때, When from_env()를 호출하면, Then market_close_liquidation_time=None이 반환된다.
5. Given 잘못된 형식의 TREX_MARKET_CLOSE_LIQUIDATION_TIME(예: "25:99")이 설정됐을 때, When from_env()를 호출하면, Then 명확한 오류(ValueError 또는 ConfigError)가 발생한다.

Impacted Area

• Docs:
  • docs/project-structure.md — Primary Runtime env var 목록에 5종 추가 (REQ-042 참조)
• Modules:
  • trex_core/runtime/config.py — DaemonConfig에 5종 env var 파싱 추가
• Tests:
  • DaemonConfig.from_env() 단위 테스트 — 기본값 확인, 개별 설정 확인, 잘못된 형식 오류 확인

Notes

• TREX_MARKET_CLOSE_LIQUIDATION_TIME은 HH:MM KST 형식으로 파싱한다. datetime.time 또는 (hour, minute) tuple로 저장한다. 배치에서 결정.
• TREX_WATCHDOG_TIMEOUT과 TREX_WATCHDOG_GRACE_PERIOD의 단위는 초(int)다.
• 기존 DaemonConfig에는 TREX_SNAPSHOT_TICK_SEC, TREX_SNAPSHOT_SCHEDULE_KST 등 유사 env var가 이미 있으므로 동일 파싱 패턴을 따른다.

Change Log

CHG-20260607-01

• Date: 2026-06-07
• Author: Justin Ko

Change Summary

• dcy-007 confirmed → REQ-041 초안 생성

Intent

• safety-sell 기능에 필요한 5종 env var를 Configuration REQ로 정규화

Acceptance Criteria Delta

• Added: AC-1~5 전체

Impacted Area Delta

• Docs: project-structure.md (REQ-042에서 처리)
• Modules: config.py
• Tests: DaemonConfig 단위 테스트

Delivery Trace Delta

• Batches: none (미할당)
• Releases: none

Revalidation Impact

• Reverification Needed: no
• Existing Implementation Invalidated: no
• Status Recommendation: keep-current
• Follow-up Action: suggest-batch-reqs 후 batch 배정

CHG-20260607-02

• Date: 2026-06-07
• Author: Justin Ko

Change Summary

• Proposed → Approved (confirm-req)

Intent

• 승인 게이트 통과: 필수 필드·AC·Impacted Area·Change Log 완비 확인. dcy-007(confirmed) 범위 및 결정 사항과 모순 없음.

Acceptance Criteria Delta

• (변경 없음)

Impacted Area Delta

• (변경 없음)

Delivery Trace Delta

• Batches: none (미할당)
• Releases: none

Revalidation Impact

• Reverification Needed: no
• Existing Implementation Invalidated: no
• Status Recommendation: keep-current
• Follow-up Action: suggest-batch-reqs 후 batch 배정