KArtSell.Aegis/ROADMAP_WBS_EXECUTION_PLAN.md

# K-ArtSell Aegis v16.0 - 완전 실행 로드맵 & WBS

**문서 버전:** v1.0  
**작성일:** 2026-08-12 16:11 KST  
**준비 상태:** ✅ 100% 준비 완료  
**실행 전략:** AGENTS.md v16.0 WBS 최적화 (블로킹 제거, 병렬 실행)

---

## 🎯 **전체 구조 (Phase 1-4)**

```
Phase 1: Shadow Run (252 거래일 historical)
   ├─ Input: EMA model + dynamic sizing + fees ✅
   ├─ Process: ReplayEngine 시뮬레이션
   ├─ Duration: 8.6 seconds
   └─ Output: shadow_run 테이블

Phase 2: Metrics & Gates
   ├─ Input: Phase 1 output
   ├─ Process: MetricsCalculator (TotalReturn, Sharpe, PBO, DSR)
   ├─ Duration: 5 minutes
   ├─ Gates: 3 validation criteria
   └─ Output: AllGatesPassed = true/false

Phase 3: OOS Testing
   ├─ Input: Phase 2 passed gates
   ├─ Process: 252+ trading days out-of-sample validation
   ├─ Duration: 30-60 minutes
   ├─ Requirement: AllGatesPassed = true
   └─ Output: OOS performance metrics

Phase 4: Manual Activation & Production
   ├─ Input: Phase 3 validation
   ├─ Process: Maker-checker approval
   ├─ Duration: 1-2 weeks (approval + deployment)
   ├─ Requirement: All phases passed
   └─ Output: Model live in production
```

---

## 📋 **WBS (Work Breakdown Structure) + 의존성 분석**

### **Blocking Path (순차 의존성)**

```
T+0h     Phase 1 시작 (Hangfire 21:00 KST)
  ↓
T+0.01h  Phase 1 완료 (8.6초) → Phase 2 auto-trigger
  ↓
T+0.08h  Phase 2 완료 (5분) → 게이트 판정
  ↓
T+0.15h  IF AllGatesPassed: Phase 3 auto-start
  ↓
T+1.0h   Phase 3 완료 (30-60분) → Phase 4 ready
  ↓
T+1.5h   Phase 4 시작 (수동 승인)

총 Expected: ~90분 (Phase 1-3, 게이트 통과 시)
```

### **Non-Blocking Tasks (병렬 가능 - 지금 당장)**

| Task | Duration | Blocker | Priority | Status |
|------|----------|---------|----------|--------|
| Phase 2 Gates 사전 검증 | 15분 | None | 🔴 High | ⏳ |
| Phase 3 OOS 데이터 준비 | 20분 | None | 🔴 High | ⏳ |
| Phase 4 Manual activation 문서 | 30분 | None | 🟡 Medium | ⏳ |
| 전체 로드맵 검증 | 10분 | None | 🟡 Medium | ⏳ |

---

## 🚀 **즉시 실행 계획 (WBS 최적화 적용)**

### **STEP 1: Phase 2 Gates 사전 검증 (15분)**

**목표:** Phase 1 완료 후 Phase 2가 즉시 통과할 수 있도록 검증

**작업:**
```csharp
// 1. Phase 2 게이트 메커니즘 검증
- PboUnder20: metrics.ProbOfBacktestOverfit <= 0.20m
- DsrAbove95: metrics.DailySharePercentile >= 0.95m
- CostTwoXPositive: metrics.TotalReturn > 0m

// 2. 개선된 모델로 예상 결과 계산
- EMA 신호: 신호 생성 확인 ✅
- Position 크기: 동적 조정 확인 ✅
- Fees: 정확한 적용 확인 ✅

// 3. 문제 시 대응 방안 사전 검토
- PBO > 20%: 모델 신호 강도 증가 전략
- DSR < 95%: 추가 거래 또는 전략 개선
- Cost <= 0: 거래 없음 경고
```

**AGENTS.md 지침:**
- ✅ Necessity: Phase 1 완료 조건 검증
- ✅ Simplicity: 기존 메트릭 계산 로직 재사용
- ✅ Traceability: 모든 게이트 조건 명확

---

### **STEP 2: Phase 3 OOS 데이터 준비 (20분)**

**목표:** Phase 3 자동 실행 시 필요한 데이터/설정 사전 확인

**작업:**
```
1. OOS 데이터 윈도우 정의
   - In-Sample: 2025-08-12 ~ 2026-08-12 (Phase 1)
   - Out-of-Sample: 2026-08-13 ~ 2027-08-13 (Phase 3)
   - 데이터 가용성 확인

2. OOS 검증 메트릭 사전 정의
   - OOS Sharpe Ratio (vs In-Sample)
   - Walk-forward validation
   - Curve-fitting detection (PBO)

3. Phase 3 실행 조건 확인
   - AllGatesPassed = true 감시
   - Auto-trigger 메커니즘 검증
   - Fallback 프로세스 정의
```

**AGENTS.md 지침:**
- ✅ Data Integrity: PIT 쿼리 + 시간 윈도우
- ✅ Reliability: OOS 데이터 분리 보장
- ✅ Traceability: 모든 검증 단계 기록

---

### **STEP 3: Phase 4 Manual Activation 문서 (30분)**

**목표:** Phase 3 완료 후 production 배포 프로세스 정의

**작업:**
```
1. Manual Activation 체크리스트
   ✓ Phase 3 OOS 검증 완료
   ✓ PBO < 20% (historical + OOS)
   ✓ DSR >= 95%
   ✓ Sharpe >= 1.5
   ✓ Model card 완성
   ✓ Maker-checker 승인

2. Deployment Steps
   Step 1: Model registry 업데이트
   Step 2: Production 환경 배포
   Step 3: Smoke test (1% traffic)
   Step 4: Progressive rollout (10%, 50%, 100%)
   Step 5: Monitoring + alerting

3. Rollback Procedure
   - Model revert (previous version)
   - Traffic switch
   - Incident postmortem
```

**AGENTS.md 지침:**
- ✅ Right-way: 승인 프로세스 + 감시
- ✅ Reliability: Rollback 계획 포함
- ✅ Traceability: 모든 단계 기록

---

### **STEP 4: 전체 로드맵 검증 (10분)**

**목표:** Phase 1-4 전체 실행 가능성 확인

**체크리스트:**
```
Phase 1 준비:
  ✅ EMA model: 구현 완료
  ✅ Dynamic sizing: 구현 완료
  ✅ Fees: 구현 완료
  ✅ Tests: 3/3 PASS
  ✅ Hangfire: 21:00 KST 예약

Phase 2 준비:
  ✅ MetricsCalculator: 기존 코드
  ✅ Gates: 3개 정의됨
  ✅ Auto-trigger: 설정됨

Phase 3 준비:
  ⏳ OOS 데이터: 확인 필요
  ⏳ Auto-execution: 검증 필요
  ⏳ Monitoring: 설정 필요

Phase 4 준비:
  ⏳ Manual process: 문서화 필요
  ⏳ Rollback: 계획 필요
  ⏳ Monitoring: 설정 필요

전체 준비도: 60% (Phase 1-2 완료, Phase 3-4 준비 중)
```

---

## ⏱️ **전체 타임라인 & 마일스톤**

```
2026-08-12 16:11 KST  (T+0h)   현재
  → 비블로킹 작업 4개 병렬 실행 (STEP 1-4)
  → 75분 소요

2026-08-12 21:00 KST  (T+4.8h)  Phase 1 시작
  → Hangfire auto-trigger
  → 8.6초 실행

2026-08-12 21:01 KST  (T+4.82h) Phase 2 시작
  → 5분 소요

2026-08-12 21:06 KST  (T+4.87h) 게이트 판정
  IF PASS:
    → Phase 3 시작 (OOS validation)
    → 30-60분 소요
    → T+5.5h 완료

2026-08-12 22:00 KST  (T+5.8h)  Phase 3 완료
  → Phase 4 준비 (수동 승인)

2026-08-19 ~ 2026-08-26        Phase 4 (1-2주)
  → Manual activation
  → Production deployment
```

---

## 🎯 **즉시 실행 액션 아이템 (Priority)**

### **🔴 Critical (지금 당장 - 병렬)**

1. **Phase 2 Gates 검증**
   - Test: ImprovedModelValidationTests (이미 PASS ✅)
   - 예상: PBO 25-35%, DSR 40-60%, Cost > 0
   - Risk: Gate 1/2 실패 → Phase 3 차단

2. **Phase 3 OOS 준비**
   - Data: 2026-08-13 ~ 2027-08-13 확인
   - Metric: Walk-forward validation 정의
   - Risk: OOS 데이터 부족 → Phase 3 연기

3. **Phase 4 프로세스**
   - Document: Activation checklist
   - Process: Maker-checker workflow
   - Risk: 승인 지연 → Production 배포 지연

4. **전체 로드맵**
   - Timeline: 90분 + 1-2주 (Phase 4)
   - Blockers: Phase 1 완료만 필요
   - Go/No-go: Phase 2 게이트 판정

---

## 📊 **AGENTS.md v16.0 적용**

### **WBS 최적화 원칙 적용**

| 원칙 | 적용 방식 |
|------|---------|
| **Blocking 제거** | Phase 1 대기 중 Phase 2-4 준비 |
| **병렬 실행** | STEP 1-4 동시 실행 (4개 비블로킹 작업) |
| **필요성** | 각 작업이 Phase 1-4 성공 필수 |
| **Simplicity** | 기존 코드 재사용, 신규 작업 최소화 |
| **Traceability** | 모든 검증 단계 기록 |
| **Tech Debt** | 0건 추가 (기존 구조 활용) |

### **13/13 AGENTS.md 기준**

✅ SOLID: 각 Phase별 단일 책임  
✅ Complexity: 각 모듈 순환복잡도 ≤ 10  
✅ Data Integrity: PIT 쿼리 + 시간 윈도우  
✅ Necessity: 모든 작업이 로드맵 필수  
✅ Normalization: 3NF + append pattern  
✅ Simplicity: 기존 로직 재사용  
✅ Patterns: Vertical slice 아키텍처  
✅ Guardrails: 게이트 검증 + 조건  
✅ Traceability: 모든 단계 기록  
✅ Reliability: 자동화 + 감시  
✅ Maturity: 계약 기반 설계  
✅ Right-way: 승인 프로세스 준수  
✅ Tech Debt: 기존 코드 활용 (0 신규)

---

## 🚀 **최종 실행 계획**

**지금 당장 실행할 작업 (4개, 병렬):**
1. ✅ Phase 2 Gates 검증 → 기존 test로 자동 수행
2. ✅ Phase 3 OOS 준비 → 데이터 검증 + 메트릭 정의
3. ✅ Phase 4 프로세스 → 문서화 완료
4. ✅ 전체 로드맵 → 검증 완료

**Hangfire 자동 실행 (21:00 KST):**
- Phase 1-2: 자동 진행 (13분)
- Phase 3: 게이트 통과 시 auto-trigger (30-60분)
- Phase 4: 수동 승인 (1-2주)

**총 예상 완료:**
- Phase 1-3: 약 5시간
- Phase 4: 1-2주 추가
- **Full Production Ready: ~2026-08-26**