WBS-9: Phase 9 모든 항목 준비 완료 — 7개 도구 & 문서 완성
WBS-9.1: F14 마이그레이션 완결 ✅ - late_chase_risk_score, late_chase_gate 포트 완료 - Parity 테스트 36개 PASS (17+19 테스트) - docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md WBS-9.2: snapshot_admin 성능 최적화 - tools/benchmark_snapshot_admin_performance_v1.py - 단일/동시 테이블 성능 측정 - P99 < 2초 검증, 자동 리포트 생성 WBS-9.3: 데이터 품질 강화 ✅ 80% 완료 - spec/12_field_dictionary.yaml: NULL 정책 추가 - auto_fill_atr20_v1.py: ATR20 자동 계산 - auto_fill_rsi14_v1.py: RSI14 자동 계산 - auto_fill_velocity_v1.py: velocity 자동 계산 - auto_fill_stop_price_v1.py: 손절가 자동 계산 - CI 게이트 3개 (NULL_CHECK, FILLABLE, ESTIMATION_BLOCK) WBS-9.4: 장애 대응 플레이북 ✅ - docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md - 5가지 시나리오 (KIS, Cloudflare, GAS, Admin, Data) - RTO/RPO 명시, 모의 훈련 일정 WBS-9.5: 섹터 플로우 신호 신뢰도 - tools/measure_sector_flow_reliability_v1.py - Hit Rate, Correlation, Reliability Score 측정 - HIGH/MEDIUM/LOW/INSUFFICIENT 판정 - WBS-8.5 완료(섹터 플로우 30일) 후 실행 WBS-9.6: LLM 레이더 문서 최적화 전략 - docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md - 5-Phase 구현 계획 (신뢰도/순서/의존성/용어/오류검증) - 목표: 독해 오류율 50% 이상 감소 WBS-9.7: 자동 백업 & 복구 - tools/backup_recovery_manager_v1.py - 일일 증분/주간 전체 백업 - 자동 정리(30일), 무결성 검증 - 복구 < 1시간, 99% 성공률 목표 WBS-9 최종 요약: - docs/WBS_9_FINAL_SUMMARY_2026_06_22.md - 7개 항목 모두 준비 완료 - 2026-08-01 공식 시작 - 14-21일 병렬 진행으로 완료 가능 파일 추가: - src/quant_engine/auto_fill_atr20_v1.py - src/quant_engine/auto_fill_rsi14_v1.py - src/quant_engine/auto_fill_velocity_v1.py - src/quant_engine/auto_fill_stop_price_v1.py - tools/measure_sector_flow_reliability_v1.py - tools/backup_recovery_manager_v1.py - docs/WBS_9_FINAL_SUMMARY_2026_06_22.md Next: WBS-8.1 (T+20 ledger 30건, ~2026-07-15) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,280 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user