Files
trex-core/docs/batches/bat-046_20260616_observability-classification-pnl-runbook/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-046 Planning

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

Included REQ

  • REQ-086 (청산 reason+actor 노출, Approved)
  • REQ-088 (운영 조회 CLI, Approved)
  • REQ-089 (운영자 런북, Approved)
  • REQ-090 (관측성 baseline 정합, Approved)

Delivery Plan

  1. REQ-086: safety_sell._log_fire 에 actor 동반 + interface-contract.md reason+actor 어휘 절 추가.
  2. REQ-088: application/operator_report.py(순수 집계: holdings/pending/realized PnL net + KST 경계) + cli.py report 서브커맨드(direct-DB psycopg) + 단위 테스트.
  3. REQ-089: docs/operations.md 신설(배포/CLI/로깅·관측성/디버깅 4영역).
  4. REQ-090: runtime-flows.md(로깅/관측성 + report 흐름) + project-structure.md(logging_setup·operator_report·operations.md) 정합.

Dependencies

  • Internal: BAT-045(P0 로깅 기반) 선행 — report/로그가 그 위에 동작. REQ-086 로그는 P0 로깅 포맷 활용.
  • External: psycopg(report direct-DB). 기존 의존, 신규 없음.

Design Gate

  • Design Required Before Implementation: yes
  • Reason: 실현 PnL 정의(net 현금흐름 vs cost-basis), report 표면(CLI/direct-DB), reason+actor 노출 방식(신규 필드 없음) 결정 필요.

Milestones

  1. operator_report 순수 집계 + 단위 테스트 green.
  2. report CLI + safety_sell actor + interface-contract.
  3. 런북 + baseline 정합 + 전체 회귀.

Risks

  • 실현 PnL net 정의가 cost-basis 매칭 PnL과 다름 → 런북·계약 문서에 정의 명시(미청산 평가손익 제외).
  • report direct-DB 는 단위 미검증(psycopg) — 집계 순수 함수로 검증하고 DB 와이어링은 release 운영 검증(pause/resume 선례).