# WBS-9: Phase 9 성능 & 엔터프라이즈 안정성 — 최종 준비 완료

**상태**: 2026-06-22 완료  
**시작 예정**: 2026-08-01  
**목표**: GAS 마이그레이션 완결, 성능 최적화, 장애 대응 자동화

---

## 📊 WBS-9 7개 항목 상태

| # | 항목 | 상태 | 완료도 | 파일 |
|---|------|------|--------|------|
| 9.1 | F14 마이그레이션 | ✅ COMPLETE | 100% | docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md |
| 9.2 | snapshot_admin 최적화 | ✅ TOOLS READY | 50% | tools/benchmark_snapshot_admin_performance_v1.py |
| 9.3 | 데이터 품질 강화 | ✅ IMPLEMENTATION | 80% | spec/12_field_dictionary.yaml + 4개 auto_fill 모듈 |
| 9.4 | 장애 대응 플레이북 | ✅ COMPLETE | 100% | docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md |
| 9.5 | 섹터 플로우 신뢰도 | ✅ TOOLS READY | 30% | tools/measure_sector_flow_reliability_v1.py |
| 9.6 | LLM 레이더 최적화 | ✅ STRATEGY | 40% | docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md |
| 9.7 | 자동 백업 & 복구 | ✅ TOOLS READY | 50% | tools/backup_recovery_manager_v1.py |

---

## 🔍 각 항목 상세

### WBS-9.1: GAS 마이그레이션 완결 ✅

**완료**: F14 (late_chase_risk_score) 및 F15 (late_chase_gate)

**파일**:
- formulas/late_chase_risk_v1.py (포트 완료)
- formulas/late_chase_gate_v1.py (포트 완료)
- tests/parity/test_late_chase_risk_parity.py (17개 테스트, PASS)
- tests/parity/test_late_chase_gate_parity_v1.py (19개 테스트, PASS)

**검증**: Parity 테스트 100% PASS

**다음**: GAS 코드 정리 (WBS-9.6 완료 후)

---

### WBS-9.2: snapshot_admin 성능 최적화

**도구**: tools/benchmark_snapshot_admin_performance_v1.py

**기능**:
- 단일 테이블 성능 측정 (10회 반복)
- 동시 10개 테이블 로드 성능 테스트
- P99 < 2초 검증
- 성능 리포트 자동 생성
- 최적화 권장사항 제시

**사용법**:
```bash
# 서버 시작
python tools/run_snapshot_admin_server_v1.py &

# 벤치마크 실행
python tools/benchmark_snapshot_admin_performance_v1.py
```

**예상 소요**: 3~4분 (10회 × 10개 테이블)

**목표**: P99 < 2초 달성

---

### WBS-9.3: 데이터 품질 강화

**정책 파일**: spec/12_field_dictionary.yaml (NULL 정책 섹션 추가)

**자동 충전 모듈** (4개):
1. `auto_fill_atr20_v1.py`: ATR20 자동 계산
2. `auto_fill_rsi14_v1.py`: RSI14 자동 계산
3. `auto_fill_velocity_v1.py`: velocity_1d/5d 자동 계산
4. `auto_fill_stop_price_v1.py`: 손절가 자동 계산 (ATR 기반)

**CI 게이트** (3개):
- DATA_QUALITY_NULL_CHECK: 필수 필드 검증
- DATA_QUALITY_FILLABLE_CHECK: 자동 충전 실행
- DATA_QUALITY_ESTIMATION_BLOCK: 추정 금지 필드 검증

**통합**: GAS runDataFeed() 또는 snapshot_admin API 호출 시 자동 실행

**목표**: 100% 필드 충전율, 오류율 0%

---

### WBS-9.4: 장애 대응 플레이북

**파일**: docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md

**5가지 시나리오**:

1. **KIS API 단절** (RTO: 5분)
   - FALLBACK_MODE: CACHED_ONLY 전환
   - 로컬 SQLite 미러 사용

2. **Cloudflare 403** (RTO: 2분)
   - User-Agent 검증
   - Graceful degradation (캐시 사용)

3. **GAS 배포 실패** (RTO: 3분)
   - clasp 재배포
   - OAuth 토큰 재인증

4. **snapshot_admin 다운** (RTO: 1분)
   - systemd 재시작
   - 메모리 프로파일링

5. **데이터 수집 중단** (RTO: 2분)
   - 스냅샷 롤백
   - 강제 재계산

**모의 훈련**: 2026-07-01 ~ 07-29 (5회)

**RTO/RPO 목표**: 달성 가능 (모두 < 5분)

---

### WBS-9.5: 섹터 플로우 신호 신뢰도

**도구**: tools/measure_sector_flow_reliability_v1.py

**측정 지표**:
- Hit Rate: flow_credit 신호 정확도 (%)
- Correlation: flow_credit vs 실제 PnL 상관도 (-1~1)
- Reliability Score: 0-100 (Hit Rate 70% + Correlation 기반)

**상태 판정**:
- HIGH: Score ≥ 70
- MEDIUM: Score 50-69
- LOW: Score < 50
- INSUFFICIENT: 표본 < 5

**실행 시점**: WBS-8.5 완료 후 (섹터 플로우 30일 축적)

**사용법**:
```bash
python tools/measure_sector_flow_reliability_v1.py
```

**기대 결과**: 10개 섹터 중 6개 이상 HIGH/MEDIUM (≥60% hit rate)

---

### WBS-9.6: LLM 레이더 문서 최적화

**전략 파일**: docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md

**5가지 Phase**:

1. **신뢰도 분류** (1일)
   - Canonical (100%): 현재 유효한 규격
   - Adapter (80%): 인터페이스 정의
   - Reference (60%): 배경/의사결정
   - Deprecated (0%): 폐기된 개념

2. **읽음 순서 정의** (1.5일)
   - Tier 1: 기초 개념 (field, mapping, flow)
   - Tier 2: 비즈니스 규칙 (strategy, scoring)
   - Tier 3: 실행 계약 (contracts)
   - Tier 4: 기술 세부사항
   - Tier 5: 운영/플레이북

3. **의존성 그래프** (1.5일)
   - 자동 추출 (파일 참조 스캔)
   - 순환 의존성 검사
   - 고아 파일 식별

4. **용어 표준화** (1.5일)
   - Terminology Glossary 생성
   - 동일 개념 다중 이름 제거
   - 약자 정의 자동화

5. **오류 검증** (2일)
   - 30개 질문 테스트 세트
   - LLM 독해 정확도 측정
   - 오류율 리포트

**목표**: 독해 오류율 30% → 15% (-50%)

---

### WBS-9.7: 자동 백업 & 복구

**도구**: tools/backup_recovery_manager_v1.py

**백업 정책**:
- **일일**: 증분 백업 (data_feed.db, specs, formulas)
- **주간**: 전체 백업 (전체 프로젝트)
- **보관**: 30일 자동 정리

**복구 기능**:
- 백업에서 복원 (RTO < 1시간)
- 무결성 검증 (DB PRAGMA check)
- 메타데이터 추적

**사용법**:
```bash
# 일일 백업 실행
python tools/backup_recovery_manager_v1.py

# 특정 백업에서 복원
manager = BackupRecoveryManager()
result = manager.restore_from_backup("daily_20260622_120000")
```

**목표**: 99% 성공률, 복구 < 1시간

---

## 🎯 병렬 실행 계획 (2026-08-01 시작)

### 병렬 가능 (동시 진행)
- 9.1: F14 마이그레이션 검증 (이미 완료)
- 9.2: snapshot_admin 벤치마크
- 9.3: 데이터 품질 강화 (자동 충전 활성화)
- 9.4: 장애 대응 훈련
- 9.6: LLM 레이더 최적화
- 9.7: 백업 정책 실행

### 순차 필수
- 9.5: WBS-8.5 완료 후 (섹터 플로우 30일)

---

## 📈 예상 일정

| Week | Task | Owner | Duration |
|------|------|-------|----------|
| W1 (Aug 1-7) | 9.2 벤치마크 + 9.3 활성화 | Dev | 2-3 days |
| W1 (Aug 1-7) | 9.4 훈련 #1 + 9.7 설정 | DevOps | 2 days |
| W2 (Aug 8-14) | 9.6 Phase 1-2 (신뢰도 + 순서) | ML/Doc | 3-4 days |
| W3 (Aug 15-21) | 9.6 Phase 3-4 (의존성 + 용어) | ML/Doc | 3-4 days |
| W3 (Aug 15-21) | 9.5 신뢰도 측정 (WBS-8.5 완료시) | Analysis | 1 day |
| W4 (Aug 22-28) | 9.6 Phase 5 (오류 검증) + 9.2 최적화 | ML/Dev | 2-3 days |
| W4 (Aug 22-28) | 9.4 훈련 #2-5 | DevOps | 2 days |

**총 예상**: 14-21일 (병렬 진행)

---

## ✅ 완료 체크리스트

### 준비 단계 (2026-06-22)
- ✅ WBS-9.1: F14 마이그레이션 완료
- ✅ WBS-9.2: 벤치마크 도구 작성
- ✅ WBS-9.3: NULL 정책 + auto_fill 모듈 4개
- ✅ WBS-9.4: 장애 대응 플레이북 작성
- ✅ WBS-9.5: 신뢰도 측정 도구 작성
- ✅ WBS-9.6: 최적화 전략 수립
- ✅ WBS-9.7: 백업/복구 도구 작성

### 실행 단계 (2026-08-01부터)
- ⏳ WBS-9.1: GAS 코드 정리
- ⏳ WBS-9.2: 성능 벤치마크 실행 및 최적화
- ⏳ WBS-9.3: auto_fill 자동화 활성화
- ⏳ WBS-9.4: 장애 대응 훈련 5회 실행
- ⏳ WBS-9.5: 신뢰도 측정 (WBS-8.5 완료 후)
- ⏳ WBS-9.6: LLM 레이더 최적화 실행
- ⏳ WBS-9.7: 백업 정책 운영

---

## 📋 결론

**WBS-9 모든 항목이 준비 완료 상태입니다.**

- 도구: 7개 항목 모두 구현 또는 전략 수립 완료
- 문서: 5개 상세 계획 문서 작성
- 테스트: F14 parity 100% PASS
- 일정: 병렬 진행으로 14-21일 내 완료 가능

**2026-08-01부터 공식 시작 예정**

---

**작성**: 2026-06-22  
**상태**: 최종 준비 완료  
**다음**: WBS-9 공식 시작 (2026-08-01)
