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

BAT-046: 관측성 P1 — reason+actor 노출 + PnL 조회 CLI + 운영자 런북 + baseline (issue #29)

  • Status: release-candidate
  • Profile: standard
  • Source Discovery: dcy-029
  • Included REQ: REQ-086, REQ-088, REQ-089, REQ-090
  • Excluded REQ: REQ-084·085·087 (P0 → BAT-045)

Summary

  • dcy-029 P1 — P0 로깅 기반(BAT-045) 위에 운영 가시성을 완성한다. 청산 reason+actor 동반 노출(REQ-086, 안전망/전략 구분), 운영 조회 CLI report(REQ-088, 보유·오늘 체결·실현 PnL·대기), 운영자 런북 docs/operations.md(REQ-089), baseline 문서 정합(REQ-090).

Scope

  • In Scope:
    • safety_sell.py — 청산 fire 로그에 actor 동반(REQ-086) + interface-contract.md reason+actor 어휘.
    • application/operator_report.py(신규) + cli.py report 서브커맨드(REQ-088, direct-DB, RPC 없음).
    • docs/operations.md(신규 운영자 런북, REQ-089).
    • docs/runtime-flows.md·docs/project-structure.md 정합(REQ-090).
    • 단위 테스트(report 집계·KST 경계·렌더, safety_sell reason+actor).
  • Out of Scope:
    • 알림 전송 채널(OQ-3 Deferred). 실현 PnL의 cost-basis 매칭(net 현금흐름 정의 사용).

Documents

Notes

  • REQ-086 = Option A(기존 reason·actor 함께 노출, 신규 필드 없음). slot_transition_log 는 이미 actor 기록.
  • REQ-088 실현 PnL = ledger_outbox net 매매 현금흐름(수수료·세금 반영, BAT-038). 미청산 평가손익 제외.