The-Ouroboros/docs/ouroboros/80_implementation_audit.md

v2/v3 구현 감사 및 수익률 분석 보고서

작성일: 2026-02-28 최종 업데이트: 2026-03-01 (Phase 2 완료 + Phase 3 부분 완료 반영) 대상 기간: 2026-02-25 ~ 2026-02-28 (실거래) 분석 브랜치: feature/v3-session-policy-stream

---

1. 계획 대비 구현 감사

1.1 v2 구현 상태: 100% 완료

REQ-ID	요구사항	구현 파일	상태
REQ-V2-001	4-상태 매도 상태기계 (HOLDING→BE_LOCK→ARMED→EXITED)	src/strategy/position_state_machine.py	✅ 완료
REQ-V2-002	즉시 최상위 상태 승격 (갭 대응)	position_state_machine.py:51-70	✅ 완료
REQ-V2-003	EXITED 우선 평가	position_state_machine.py:38-48	✅ 완료
REQ-V2-004	4중 청산 로직 (Hard/BE/ATR Trailing/Model)	src/strategy/exit_rules.py	✅ 완료
REQ-V2-005	Triple Barrier 라벨링	src/analysis/triple_barrier.py	✅ 완료
REQ-V2-006	Walk-Forward + Purge/Embargo 검증	src/analysis/walk_forward_split.py	✅ 완료
REQ-V2-007	비용/슬리피지/체결실패 모델 필수	src/analysis/backtest_cost_guard.py	✅ 완료
REQ-V2-008	Kill Switch 실행 순서 (Block→Cancel→Refresh→Reduce→Snapshot)	src/core/kill_switch.py	✅ 완료

1.2 v3 구현 상태: ~85% 완료 (2026-03-01 기준)

REQ-ID	요구사항	상태	비고
REQ-V3-001	모든 신호/주문/로그에 session_id 포함	✅ 완료	#326 머지 — log_decision() 파라미터 추가, log_trade() 명시적 전달
REQ-V3-002	세션 전환 훅 + 리스크 파라미터 재로딩	⚠️ 부분	#327 머지 — 재로딩 메커니즘 구현, 세션 훅 테스트 미작성
REQ-V3-003	블랙아웃 윈도우 정책	✅ 완료	src/core/blackout_manager.py
REQ-V3-004	블랙아웃 큐 + 복구 시 재검증	✅ 완료	#324(DB 기록) + #328(가격/세션 재검증) 머지
REQ-V3-005	저유동 세션 시장가 금지	✅ 완료	src/core/order_policy.py
REQ-V3-006	보수적 백테스트 체결 (불리 방향)	✅ 완료	src/analysis/backtest_execution_model.py
REQ-V3-007	FX 손익 분리 (전략 PnL vs 환율 PnL)	⚠️ 코드 완료 / 운영 미반영	src/db.py 스키마·함수 완료, 운영 데이터 fx_pnl 전부 0
REQ-V3-008	오버나잇 예외 vs Kill Switch 우선순위	✅ 완료	src/main.py — _should_force_exit_for_overnight(), _apply_staged_exit_override_for_hold()

1.3 운영 거버넌스: ~60% 완료 (2026-03-01 재평가)

REQ-ID	요구사항	상태	비고
REQ-OPS-001	타임존 명시 (KST/UTC)	⚠️ 부분	DB 기록은 UTC, 세션은 KST. 일부 로그에서 타임존 미표기
REQ-OPS-002	정책 변경 시 레지스트리 업데이트 강제	⚠️ 기본 구현 완료	scripts/validate_governance_assets.py CI 연동 완료; 규칙 고도화 잔여
REQ-OPS-003	TASK-REQ 매핑 강제	⚠️ 기본 구현 완료	scripts/validate_ouroboros_docs.py CI 연동 완료; PR 강제 검증 강화 잔여

---

2. 구현 갭 상세

2026-03-01 업데이트: GAP-1~5 모두 해소되었거나 이슈 머지로 부분 해소됨.

GAP-1: DecisionLogger에 session_id 미포함 → ✅ 해소 (#326)

• 위치: src/logging/decision_logger.py
• 문제: log_decision() 함수에 session_id 파라미터가 없음
• 해소: #326 머지 — log_decision() 파라미터에 session_id 추가, DB 기록 포함
• 요구사항: REQ-V3-001

GAP-2: src/main.py 거래 로그에 session_id 미전달 → ✅ 해소 (#326)

• 위치: src/main.py
• 문제: log_trade() 호출 시 session_id 파라미터를 전달하지 않음
• 해소: #326 머지 — log_trade() 호출 시 런타임 session_id 명시적 전달
• 요구사항: REQ-V3-001

GAP-3: 세션 전환 시 리스크 파라미터 재로딩 없음 → ⚠️ 부분 해소 (#327)

• 위치: src/main.py, src/config.py
• 해소 내용: #327 머지 — SESSION_RISK_PROFILES_JSON 기반 세션별 파라미터 재로딩 메커니즘 구현
  • SESSION_RISK_RELOAD_ENABLED=true 시 세션 경계에서 파라미터 재로딩
  • 재로딩 실패 시 기존 파라미터 유지 (안전 폴백)
• 잔여 갭: 세션 경계 실시간 전환 E2E 통합 테스트 보강 필요 (test_main.py에 설정 오버라이드/폴백 단위 테스트는 존재)
• 요구사항: REQ-V3-002

GAP-4: 블랙아웃 복구 DB 기록 + 재검증 → ✅ 해소 (#324, #328)

• 위치: src/core/blackout_manager.py, src/main.py
• 해소 내용:
  • #324 머지 — 복구 주문 실행 후 log_trade() 호출, rationale에 [blackout-recovery] prefix
  • #328 머지 — 가격 유효성 검증 (진입가 대비 급변 시 드롭), 세션 변경 시 새 파라미터로 재검증
• 요구사항: REQ-V3-004

GAP-5: 시간장벽이 봉 개수 고정 → ✅ 해소 (#329)

• 위치: src/analysis/triple_barrier.py
• 문제: max_holding_bars (고정 봉 수) 사용
• 해소: #329 머지 — max_holding_minutes (캘린더 분) 기반 시간장벽 전환
  • 봉 주기 무관하게 일정 시간 경과 시 장벽 도달
  • max_holding_bars deprecated 경고 유지 (하위 호환)
• 요구사항: REQ-V2-005 / v3 확장

GAP-6 (신규): FX PnL 운영 미활성 (LOW — 코드 완료)

• 위치: src/db.py (fx_pnl, strategy_pnl 컬럼 존재)
• 문제: 스키마와 함수는 완료되었으나 운영 데이터에서 fx_pnl 전부 0
• 영향: USD 거래에서 환율 손익과 전략 손익이 분리되지 않아 성과 분석 부정확
• 요구사항: REQ-V3-007

---

3. 실거래 수익률 분석

3.1 종합 성적

지표	값
총 실현 손익	-52,481 (KRW + USD 혼합, 통화 분리 집계는 3.4 참조)
총 거래 기록	19,130건 (BUY 121, SELL 46, HOLD 18,963)
집계 기준	UTC 2026-02-25T00:00:00 ~ 2026-02-28T00:00:00, SELL 45건 (기간 외 1건 제외)
승률	39.1% (18승 / 46매도, 0손익 포함 기준)
평균 수익 거래	+6,107
평균 손실 거래	-7,382
최대 수익 거래	+46,350 KRW (452260 KR)
최대 손실 거래	-26,400 KRW (000370 KR)
운영 모드	LIVE (실계좌)

3.2 일별 손익

날짜	매도 수	승	패	일간 손익
02-25	9	8	1	+63.21 (USD, 미세 수익)
02-26	14	5	5	-32,083.40 (KR 대량 손실)
02-27	22	5	16	-20,461.11 (고빈도 매매, 대부분 손실)

정확한 재현: scripts/audit_queries.sql 참조.

3.3 시장별 손익

시장	매도 수	승률	총 손익
KR	17	38.5% (0손익 제외, 5/13)	-56,735 KRW
US_AMEX	12	75%	+4,476 USD
US_NASDAQ	4	0%	-177 USD
US_NYSE	13	30.8%	-45 USD

KR 시장이 손실의 주 원인. US는 AMEX 제외 시 대체로 손실 또는 보합.

3.4 재계산 주석 반영 (통화 분리)

산식 주석: 기존 표의 총 실현 손익 -52,481은 KRW/USD를 단순 합산한 값으로, 회계적으로 해석 불가. 아래는 같은 기간(2026-02-25~2026-02-27, SELL 45건)을 통화별로 분리한 결과.

통화	매도 수	승/패	실현 손익
KRW	17	5승 / 8패 (4건 0손익)	-56,735 KRW
USD	28	13승 / 14패 (1건 0손익)	+4,253.70 USD

3.5 재계산 주석 반영 (기존 보유 청산 성과 분리)

분리 기준: 각 SELL의 직전 BUY가 rationale LIKE '[startup-sync]%' 인 경우를 기존 보유(시작 시점 동기화 포지션) 청산으로 분류.

구분	통화	매도 수	손익
기존 보유 청산분	KRW	10	+12,230 KRW
기존 보유 청산분	USD	2	+21.03 USD
신규/전략 진입분만	KRW	7	-68,965 KRW
신규/전략 진입분만	USD	26	+4,232.67 USD

추가로, 요청 취지(“기존 보유 수익 종목 정리 수익 제외”)에 맞춰 기존 보유 청산 중 수익(+PnL)만 제외하면:

• KRW: -56,735 → -113,885 KRW (기존 보유 수익 +57,150 KRW 제거)
• USD: +4,253.70 → +4,232.67 USD (기존 보유 수익 +21.03 USD 제거)

즉, 기존 성과표는 기보유 청산 이익(특히 KR 452260 +46,350 KRW)을 전략 성과에 포함해 전략 자체 손익을 과대평가한 상태다.

3.6 데이터 무결성 점검 (모의투자 혼합 여부 + USD 과대수익 원인)

• mode 점검 결과: live 19,130건, paper 0건
  → 모의투자 혼합은 확인되지 않음.
• 다만 USD 손익에는 체결 매칭 이상치 1건이 존재:
  • CRCA SELL(15주, $35.14, +4,612.15 USD) vs 직전 BUY(146주, $3.5499)
  • BUY/SELL 수량 불일치(146→15) 상태에서 PnL이 계산되어, 역분할/동기화 이슈 가능성이 큼.

보수적 재집계(2026-02-25~2026-02-27, USD SELL 28건):

집계 기준	USD 손익	환산 KRW (참고)	KRW 합산 참고값
원집계	+4,253.70 USD	+6,167,865	-56,735 + 6,167,865 = +6,111,130
기존보유(startup-sync) 제외	+4,232.67 USD	+6,137,372	-68,965 + 6,137,372 = +6,068,407
수량 일치 체결만 포함	-358.45 USD	-519,753	-56,735 + (-519,753) = -576,488
기존보유 제외 + 수량 일치 체결만 포함	-379.48 USD	-550,246	-68,965 + (-550,246) = -619,211

가정 환율: 1 USD = 1,450 KRW (2026-02-28 기준 참고 환율). 환산 KRW 및 합산값은 비교용 보조지표이며, 회계/정산 기준값과는 분리해 해석해야 한다.

결론적으로 USD 구간의 플러스 성과는 실질적으로 CRCA 이상치 1건 영향이 지배적이며, 해당 거래를 무결성 필터로 제외하면 USD 성과는 손실 구간으로 전환된다.

3.7 데이터 품질 이슈 요약

• startup-sync 중복: BUY 76건 반복 동기화, price=0 38건 → PnL 매칭 왜곡 가능. 분리 집계는 3.5 참조.
• 티커-거래소 드리프트: 동일 티커가 다중 거래소에 혼재 기록 → ROOT-7 참조.
• FX PnL 미활성: 스키마 존재, 운영 데이터 전부 0 → REQ-V3-007 참조.

3.8 표준 집계 SQL (재현용)

성과표 재현을 위한 기준 쿼리는 scripts/audit_queries.sql에 분리되어 있다.

• Base: 기간 + LIVE + SELL + 직전 BUY 메타 매칭
• Q1: 통화 분리 손익 (KRW/USD 혼합 금지)
• Q2: 기존 보유(startup-sync) 제외 성과
• Q3: 수량 일치 체결만 포함 (무결성 필터)
• Q4: 이상치 목록 (수량 불일치)

---

4. 수익률 저조 근본 원인 분석

ROOT-1: hard_stop_pct 기본값(-2%)이 KR 소형주 변동성 대비 과소

• 현재 설정: stop_loss_threshold = -2.0 (src/main.py:511), staged exit의 hard_stop_pct로 전달
• v2 계획: ATR 기반 동적 trailing stop (ExitPrice = PeakPrice - k × ATR)
• 실제 동작: staged exit는 호출되나, atr_value/pred_down_prob 등 피처가 0.0으로 공급되어 hard_stop 편향 발동 (ROOT-5 참조)
• 증거:
  • 000370: 매수 8,040 → 24분 후 -2.74% 손절
  • 033340: 매수 2,080 → 18분 후 -3.13% 손절
  • 229000: -3.7%, -3.25%, -3.2% 반복 손절

ROOT-2: 동일 종목 반복 매매 (재진입 쿨다운 미구현)

• 문제: 손절 후 동일 종목 즉시 재매수 → 고가 재진입 → 재손절 반복
• 최악 사례: 종목 229000

  매수가	매도가	손익	보유 시간
  5,670	5,460	-24,780	0.5h
  5,540	5,360	-21,780	0.7h
  5,310	5,580	+34,020 (승)	0.8h
  5,620	5,440	-21,420	1.5h

• 순손실: 하루 한 종목에서 -33,960 KRW

ROOT-3: 미국 페니스탁/마이크로캡 무분별 진입

• 문제: $2 이하 종목에 confidence 85~90으로 진입, 오버나잇 대폭락
• 사례:

  종목	손실률	보유시간
  ALBT	-27.7%	~23h
  SMJF	-15.9%	~23h
  KAPA	-18.2%	~23h
  CURX	-10.6%	~23h
  CELT	-8.3%	~23h

ROOT-4: 진화 전략 코드 생성기 문법 오류

• 위치: src/strategies/v20260227_*_evolved.py
• 문제: 중첩 def evaluate 정의 (들여쓰기 오류)
• 영향: 런타임 실패 → 기본 전략으로 폴백 → 진화 시스템 사실상 무효

ROOT-5: v2 청산 로직이 부분 통합되었으나 실효성 부족 → ⚠️ 부분 해소 (#325)

초기 진단 (2026-02-28 감사 기준):

• hard_stop_pct에 고정 -2.0이 기본값으로 들어가 v2 계획의 ATR 적응형 의도와 괴리
• be_arm_pct/arm_pct가 playbook의 take_profit_pct에서 기계적 파생(* 0.4)되어 v2 계획의 독립 파라미터 튜닝 불가
• atr_value, pred_down_prob 등 런타임 피처가 0.0으로 공급되어 사실상 hard stop만 발동

현재 상태 (#325 머지 후):

• STAGED_EXIT_BE_ARM_PCT, STAGED_EXIT_ARM_PCT 환경변수로 독립 파라미터 설정 가능
• _inject_staged_exit_features(): KR 시장 ATR 실시간 계산 주입, RSI 기반 pred_down_prob 공급
• KR ATR dynamic hard stop (#318)으로 -2.0 고정값 문제 해소

잔여 리스크:

• KR 외 시장(US 등)에서 atr_value 공급 경로 불완전 — hard stop 편향 잔존 가능
• pred_down_prob가 RSI 프록시 수준 — 추후 실제 ML 모델 대체 권장

ROOT-6: SELL 손익 계산이 부분청산/수량 불일치에 취약 (CRITICAL) → ✅ 해소 (#322)

현재 상태: #322 머지로 해소됨. 아래는 원인 발견 시점(2026-02-28) 진단 기록.

• 위치: src/main.py:1658-1663, src/main.py:2755-2760
• 문제: PnL 계산이 실제 매도 수량(sell_qty)이 아닌 직전 BUY의 buy_qty를 사용
  • trade_pnl = (trade_price - buy_price) * buy_qty
• 영향: 부분청산, 역분할/액분할, startup-sync 후 수량 드리프트 시 손익 과대/과소 계상
• 실증: CRCA 이상치(BUY 146주 → SELL 15주에서 PnL +4,612 USD) 가 이 버그와 정합

ROOT-7: BUY 매칭 키에 exchange_code 미포함 — 잠재 오매칭 리스크 (HIGH) → ✅ 해소 (#323)

현재 상태: #323 머지로 해소됨. 아래는 원인 발견 시점(2026-02-28) 진단 기록.

• 위치: src/db.py:292-313
• 문제: get_latest_buy_trade()가 (stock_code, market)만으로 매칭, exchange_code 미사용
• 성격: 현재 즉시 발생하는 확정 버그가 아닌, 동일 티커가 다중 거래소에 혼재 기록될 때 증폭되는 구조 리스크
• 영향: 데이터 드리프트 조건(예: CCUP/CRCA 등 다중 exchange 기록)에서 오매칭 → 손익 왜곡 가능

---

5. 수익률 개선 방안

5.1 즉시 적용 가능 (파라미터/로직 수정)

우선순위	방안	예상 효과	난이도
P0	KR 손절선 확대: -2% → -4~5% 또는 ATR 기반	노이즈 손절 대폭 감소	낮음
P0	재진입 쿨다운: 손절 후 동일 종목 1~2시간 매수 차단	churn & burn 패턴 제거	낮음
P1	US 최소 가격 필터: $5 이하 종목 진입 차단	페니스탁 대폭락 방지	낮음
P1	진화 전략 코드 생성 시 syntax 검증 추가	진화 시스템 정상화	낮음

5.2 구조적 개선 현황 (2026-03-01 기준)

완료 항목 (모니터링 단계):

항목	이슈	상태
SELL PnL 계산을 sell_qty 기준으로 수정 (ROOT-6)	#322	✅ 머지
v2 staged exit 피처 공급 + 독립 파라미터 설정 (ROOT-5)	#325	✅ 머지
BUY 매칭 키에 exchange_code 추가 (ROOT-7)	#323	✅ 머지
블랙아웃 복구 주문 log_trade() 추가 (GAP-4)	#324	✅ 머지
세션 전환 리스크 파라미터 동적 재로딩 (GAP-3)	#327	✅ 머지
session_id 거래/의사결정 로그 명시 전달 (GAP-1, GAP-2)	#326	✅ 머지
블랙아웃 복구 가격/세션 재검증 강화 (GAP-4 잔여)	#328	✅ 머지

잔여 개선 항목:

우선순위	방안	난이도
P1	US 시장 ATR 공급 경로 완성 (ROOT-5 잔여)	중간
P1	FX PnL 운영 활성화 (REQ-V3-007)	낮음
P2	pred_down_prob ML 모델 대체 (ROOT-5 잔여)	높음
P2	세션 경계 E2E 통합 테스트 보강 (GAP-3 잔여)	낮음

5.3 권장 실행 순서

Phase 1 (즉시): 파라미터 조정
  → KR 손절 확대 + 재진입 쿨다운 + US 가격 필터
  → 예상: 가장 큰 손실 패턴 2개(노이즈 손절, 반복 매매) 즉시 제거

Phase 2 (단기): 데이터 정합성 + v2 실효화
  → SELL PnL을 sell_qty 기준으로 수정
  → BUY 매칭 키에 exchange_code 추가
  → 블랙아웃 복구 주문 DB 기록 추가
  → v2 staged exit에 실제 피처(ATR, pred_down_prob) 공급 + 독립 파라미터 설정
  → session_id 명시적 전달
  → 예상: 손익 정확도 확보 + 수익 구간 보호 메커니즘 실효화

Phase 3 (중기): v3 세션 최적화
  → 세션 전환 훅 + 파라미터 재로딩
  → 블랙아웃 재검증
  → 운영 거버넌스 CI 자동화

---

6. 테스트 커버리지 현황

테스트 존재 (통과)

• ✅ 상태기계 승격 (test_strategy_state_machine.py)
• ✅ 4중 청산 규칙 (test_strategy_exit_rules.py)
• ✅ Triple Barrier 라벨링 (test_triple_barrier.py)
• ✅ Walk-Forward + Purge/Embargo (test_walk_forward_split.py)
• ✅ 백테스트 비용 검증 (test_backtest_cost_guard.py)
• ✅ Kill Switch 순서 (test_kill_switch.py)
• ✅ 블랙아웃 관리 (test_blackout_manager.py)
• ✅ 주문 정책 저유동 거부 (test_order_policy.py)
• ✅ FX 손익 분리 (test_db.py)
• ✅ 블랙아웃 복구 후 유효 intent 실행 (tests/test_main.py:5811)
• ✅ 블랙아웃 복구 후 정책 거부 intent 드롭 (tests/test_main.py:5851)

테스트 추가됨 (Phase 1~3, 2026-03-01)

• ✅ KR ATR 기반 동적 hard stop (test_main.py — #318)
• ✅ 재진입 쿨다운 (손절 후 동일 종목 매수 차단) (test_main.py — #319)
• ✅ US 최소 가격 필터 ($5 이하 차단) (test_main.py — #320)
• ✅ 진화 전략 syntax 검증 (test_evolution.py — #321)
• ✅ SELL PnL sell_qty 기준 계산 (test_main.py — #322)
• ✅ BUY 매칭 키 exchange_code 포함 (test_db.py — #323)
• ✅ 블랙아웃 복구 주문 DB 기록 (test_main.py — #324)
• ✅ staged exit에 실제 ATR/RSI 피처 공급 (test_main.py — #325)
• ✅ session_id 거래/의사결정 로그 명시적 전달 (test_main.py, test_decision_logger.py — #326)
• ✅ 블랙아웃 복구 후 유효 intent 실행 (tests/test_main.py:5811)
• ✅ 블랙아웃 복구 후 정책 거부 intent 드롭 (tests/test_main.py:5851)

테스트 미존재 (잔여)

• ❌ 세션 전환 훅 콜백 (GAP-3 잔여)
• ❌ 세션 경계 리스크 파라미터 재로딩 단위 테스트 (GAP-3 잔여)
• ❌ 실거래 경로 ↔ v2 상태기계 통합 테스트 (피처 공급 포함)
• ❌ FX PnL 운영 활성화 검증 (GAP-6)

---

7. 후속 문서

• 실행 계획: 85_loss_recovery_action_plan.md — ROOT/GAP 해소를 위한 Phase별 작업 분해 및 Gitea 이슈 연결
• 표준 집계 SQL: scripts/audit_queries.sql

---

끝.