# Monitoring, Alerting & Operational Controls

## 1. 목적

Phase 6 운영은 단순 로그 수집이 아니라 **실제 거래 리스크를 제어하는 관제 레이어**가 필요합니다.
이 문서는 모니터링 지표, 알림 정책, degraded mode, 운영 통제 기준을 정의합니다.

## 2. 주요 모니터링 영역

### 2.1 시스템 상태
- collector/parser snapshot freshness
- order planner latency
- broker adapter heartbeat
- DB write/read latency
- queue backlog
- reconciliation lag

### 2.2 거래 상태
- today planned orders count
- submitted orders count
- rejected orders count
- cancel ratio
- partial fill ratio
- execution slippage estimate
- open positions count
- sector exposure

### 2.3 리스크 상태
- daily pnl
- daily realized loss
- gross exposure
- planned risk remaining
- kill switch 상태
- no-trade mode 상태

### 2.4 운영 상태
- pending approval tickets
- unresolved mismatches
- manual override count
- operator acknowledgement overdue

## 3. Alert Severity

### P1
즉시 운영자 확인 필요. 자동으로 hard halt 또는 no-trade 고려.
예:
- broker unreachable
- position mismatch with non-zero exposure
- duplicate order suspicion
- flatten all 실패

### P2
빠른 확인 필요. 신규 주문 제한 가능.
예:
- data freshness breach
- repeated order rejects
- reconciliation mismatch unresolved for N minutes
- approval queue backlog

### P3
참고용.
예:
- 예상보다 높은 partial fill ratio
- overlay source 일부 지연
- 비핵심 배치 실패

## 4. Degraded Mode 규칙

### degraded_mode_level_1
- overlay 비활성화
- auto approval 비활성화
- 신규 주문 수량 축소

### degraded_mode_level_2
- 신규 진입 중단
- 기존 포지션 관리만 유지

### no_trade_mode
- 주문 제출 전면 중단
- signal 계산과 관측만 유지

## 5. 운영 대시보드 최소 요구사항

대시보드는 최소 아래 패널을 제공해야 한다.

- current session status
- broker/account status
- open positions
- working orders
- pending approvals
- recent order events
- alerts / exceptions
- risk summary
- reconciliation summary

## 6. End-of-day 산출물

매 거래일 종료 후 자동 생성:
- execution summary
- trade blotter
- risk summary
- exception report
- reconciliation report
- operator actions log
- session status report

## 7. 감사 추적

아래는 반드시 immutable 또는 append-only에 가깝게 보관한다.
- approval decisions
- manual overrides
- kill switch activations
- order submissions / cancels / replaces
- reconciliation mismatch and resolution
