Files
trex-core/docs/batches/bat-045_20260616_observability-logging-foundation/planning.md
T
genichinandClaude Opus 4.8 d8d9021260 feat(execution,obs): 호가단위 스냅(dcy-030/#28) + 운영 관측성(dcy-029/#29) + REL-007 환류
dcy-030 (issue #28, P0 체결 복구):
- REQ-083 KRX 호가단위(tick) 순수 유틸 (domain/pricing.py)
- REQ-070 CHG: 슬리피지 실효가 호가단위 스냅 — 상한 준수(매수 floor/매도 ceil)
  + band<1tick 하한/상한 보장 + 부동소수 epsilon 가드. 147700→148400/54500→54700.
- BAT-044 release-candidate

dcy-029 (issue #29, 운영 관측성):
- REQ-084 구조화 로깅 기반 (runtime/logging_setup.py): ISO8601 KST·레벨·Loki JSON
  ·correlation id(slot_id)
- REQ-085 주문 결과 로깅 (event=order_submit|fill|reject)
- REQ-087 거부 ERROR 가시성 (조용한 롤백 제거)
- REQ-086 청산 reason+actor 동반 노출 (안전망/전략 구분, 신규 필드 없음)
- REQ-088 운영 조회 CLI report (application/operator_report.py, 보유·오늘 체결
  ·실현 PnL net·대기, direct-DB)
- REQ-089 운영자 런북 docs/operations.md
- REQ-090 baseline 정합 (runtime-flows·project-structure·interface-contract)
- BAT-045(P0)·BAT-046(P1) release-candidate

REL-007: confirmed → feedback-captured (운영 인스턴스 라이브 검증 + #28/#29 환류
정규화). BAT-037~041 released.

검증: 537 passed, 47 skipped, 회귀 0, ruff clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 13:19:31 +09:00

1.7 KiB

BAT-045 Planning

  • Status: confirmed
  • Batch: BAT-045
  • Profile: standard

Included REQ

  • REQ-084 (구조화 로깅 기반, Approved)
  • REQ-085 (주문 결과 로깅, Approved)
  • REQ-087 (주문 거부 ERROR 가시성, Approved)

Delivery Plan

  1. trex_core/runtime/logging_setup.py 신설 — KST 포맷터(text/json) + correlation id contextvar/filter + configure_logging(basicConfig 대체, idempotent).
  2. daemon.py/reset.py 엔트리포인트에서 configure_logging 호출로 교체.
  3. execution.py _dispatch/_poll/_on_filled에 submit/fill/reject 일관 로그(event 키) + correlation id(slot_id) 설정. 거부 라인은 ERROR 레벨(REQ-087).
  4. 테스트: tests/runtime/test_logging_setup.py, tests/application/test_execution_policy.py(주문 결과 로깅 + 거부 ERROR).

Dependencies

  • Internal: execution.py(application)가 logging_setup(runtime)의 set_correlation_id 사용 — 기존 선례(safety_sell→runtime.config) 동일 방향. domain 무의존 유지.
  • External: 없음. Loki 적재는 배포측 수집기(코드는 JSON stdout만, A-4 전제).

Design Gate

  • Design Required Before Implementation: yes
  • Reason: correlation id 키 선택(slot_id), 포맷터 구조, 레이어 의존 방향, basicConfig 교체 idempotency 결정 필요.

Milestones

  1. logging_setup + 단위 테스트 green.
  2. execution 주문 결과 로깅 + 거부 ERROR + 테스트 green.
  3. 전체 회귀 + ruff.

Risks

  • 로그 포맷 변경이 기존 caplog 기반 테스트에 영향 → 메시지 텍스트 보존, 핸들러 교체는 root만.
  • correlation id 단일 스레드 execution 루프에서 set-per-iteration로 충분(리셋 불요).