Files
kjh2064 e295efe4f5
deploy / deploy (push) Failing after 1m0s
deploy / notify (push) Successful in 1s
docs: Strategic Roadmap, WBS, and Optimal Execution Plan (AGENTS.md v16.0)
- ROADMAP_2026.md: 4 Phases (Phase 1: Shadow Run ~ Phase 4: Operations)
- WBS_MASTER.md: 40+ tasks with dependencies (Critical Path: 67-107 days)
- STRATEGY_OPTIMAL_EXECUTION.md: AGENTS.md v16.0 20-principle framework

Phase Timeline:
- Phase 1: 50-90 days (auto-running Job 3227)
- Phase 2: 15 days (evidence verification)
- Phase 3: 2 days (production deployment)
- Phase 4: Continuous (monthly debt paydown 20%)

Go-Live Target: 2026-11-20 (Production: kartsell.taxbaik.com)

Following AGENTS.md v16.0:
- SOLID, Code Refactoring, Data Integrity, No Gold-Plating
- Normalization/Denormalization, Process Automation, Standardization
- Vibe Coding, Hallucination Prevention, Field Evidence
- Reproducibility, Traceability, Stability, Architecture Evolution
- Modularity, Right Way, Technical Debt (20% monthly paydown)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-11 18:41:15 +09:00

424 lines
12 KiB
Markdown

# WBS (Work Breakdown Structure): K-ArtSell Aegis v16.0 배포 로드맵
**목표:** 90% → 100% 프로덕션 배포 (2026-08-11 ~ 2026-12-31)
---
## 1️⃣ PHASE 1: Shadow Run & Validation (자동 진행)
### 1.1 자동 실행 (Hangfire Job 3227)
**일정:** 2026-08-11 ~ 2026-10-31 (50-90일)
**담당:** 자동화 시스템
**상태:** 🟢 진행 중
```
1.1.1 252+ Trading Day Execution
└─ [진행중] Daily PBO/DSR 계산
└─ [진행중] Daily OOS 드리프트 검증
└─ [진행중] Crash Recovery (4/4 시나리오)
└─ [진행중] Duplicate Detection 로깅 (DEBT-014)
└─ [진행중] Event Audit Trail (DEBT-029)
1.1.2 메트릭 자동 계산
└─ [일일] PBO (Probability of Backtest Overfit)
└─ [일일] DSR (Daily Sharpe Ratio)
└─ [일일] OOS (Out-of-Sample) 드리프트
└─ [주간] 누적 성과 리포트
1.1.3 감사 기록
└─ [실시간] operation_audit_trail 로깅
└─ [실시간] outbox/inbox 이벤트 처리
└─ [주간] 데이터 정합성 검증
```
**산출물:**
- Job 3227 실행 로그
- 일일 메트릭 데이터
- 주간 진행 보고서
---
## 2️⃣ PHASE 2: Evidence Collection & Verification
### 2.1 PBO 메트릭 검증
**일정:** 2026-11-01 ~ 2026-11-08
**담당:** 데이터 팀
**상태:** ⏳ 대기
```
2.1.1 PBO 계산 검증
├─ [Task] Phase 1 마지막 데이터 수집
├─ [Task] PBO 공식 적용 (confidence interval)
└─ [검증] PBO < 20% threshold 확인
└─ PASS → Phase 3 진행
└─ FAIL → 모델 재조정 (리스크)
2.1.2 PBO 리포트 작성
├─ [Report] 계산 방법론 문서화
├─ [Report] 결과 해석 (signal strength)
└─ [Approval] 기술 리더 검토 & 승인
```
**성공 기준:**
- PBO < 20% (probability < 20%)
- 계산 재현 가능 (git 추적)
- 리더 승인 문서
---
### 2.2 DSR 메트릭 검증
**일정:** 2026-11-01 ~ 2026-11-08
**담당:** 퀀트 팀
**상태:** ⏳ 대기
```
2.2.1 DSR 계산 검증
├─ [Task] 252+ 트레이딩 데이 DSR 누적 계산
├─ [Task] 월별/분기별 DSR 추이 분석
└─ [검증] DSR > 0.5 threshold 확인
└─ PASS → Phase 3 진행
└─ FAIL → 전략 재평가 (리스크)
2.2.2 DSR 리포트 작성
├─ [Report] Sharpe ratio 방법론
├─ [Report] 리스크 조정 성과 분석
└─ [Approval] CFO 검토 & 승인
```
**성공 기준:**
- DSR > 0.5 (risk-adjusted return)
- 월별 일관성 (< 20% 변동)
- CFO 승인
---
### 2.3 OOS (Out-of-Sample) 드리프트 검증
**일정:** 2026-11-01 ~ 2026-11-10
**담당:** 모델 팀
**상태:** ⏳ 대기
```
2.3.1 OOS 드리프트 분석
├─ [Task] In-sample vs Out-of-sample 성과 비교
├─ [Task] 일일 드리프트 계산 (Phase 1 기간)
└─ [검증] OOS 드리프트 < 2.5% 확인
└─ PASS → Phase 3 진행
└─ FAIL → 모델 튜닝 (리스크)
2.3.2 드리프트 분석 보고서
├─ [Report] 시간대별 드리프트 추이
├─ [Report] 시장 조건별 드리프트 (bull/bear/sideways)
└─ [Approval] 리스크 위원회 검토
```
**성공 기준:**
- OOS 드리프트 < 2.5%
- 모든 시장 조건에서 안정성 입증
- 위원회 승인
---
### 2.4 감시 이벤트 로그 검토
**일정:** 2026-11-01 ~ 2026-11-12
**담당:** 감사 팀
**상태:** ⏳ 대기
```
2.4.1 DEBT-014: Operation Audit Trail
├─ [Task] 252일 기간 duplicate detection 로그 분석
├─ [Task] 중복 이벤트 발생률 검증
└─ [검증] False positive rate < 0.1% 확인
2.4.2 DEBT-029: Event Audit Logging
├─ [Task] outbox/inbox 이벤트 일관성 검증
├─ [Task] 재처리 안전성 (idempotency) 검증
└─ [검증] 모든 이벤트 정상 처리 확인
2.4.3 감시 보고서
├─ [Report] 감지된 이상 사항 요약
├─ [Report] 시스템 안정성 인증
└─ [Approval] Compliance 팀 서명
```
**성공 기준:**
- Duplicate detection: < 0.1% false positive
- Event processing: 100% success rate
- Compliance 승인
---
### 2.5 기술부채 최종 검토
**일정:** 2026-11-10 ~ 2026-11-15
**담당:** 아키텍처 팀
**상태:** ⏳ 대기
```
2.5.1 DEBT 현황 검토
├─ [Task] DEBT-014/029/030/032/016/024 결제 확인
├─ [Task] 미결제 DEBT 식별 및 우선순위
└─ [검증] 월별 20% 결제 목표 달성 확인
2.5.2 DEBT 정리
├─ [Task] 미결제 DEBT → 다음 분기 로드맵 이관
├─ [Task] TECH_DEBT_REGISTER.md 업데이트
└─ [Report] DEBT 관리 정책 문서화
2.5.3 기술부채 승인
├─ [Approval] CTO 최종 검토
└─ [Approval] Phase 3 진행 승인 서명
```
**성공 기준:**
- 275% DEBT 결제 이력 확인
- 모든 미결제 DEBT 문서화
- CTO 서명
---
## 3️⃣ PHASE 3: Production Deployment
### 3.1 배포 전 준비
**일정:** 2026-11-16 ~ 2026-11-19
**담당:** DevOps 팀
**상태:** ⏳ 대기
```
3.1.1 환경 준비
├─ [Setup] kartsell.taxbaik.com 서버 준비
├─ [Setup] PostgreSQL 마이그레이션 계획
├─ [Setup] API keys 및 secrets 확보
└─ [Verify] Sandbox 테스트 완료
3.1.2 배포 체크리스트
├─ [Checklist] .NET 10 runtime 설치 확인
├─ [Checklist] 데이터베이스 백업 계획
├─ [Checklist] 롤백 계획 수립
├─ [Checklist] 모니터링 대시보드 준비
└─ [Checklist] Nginx 설정 검증
3.1.3 팀 준비
├─ [Briefing] 배포 팀 교육
├─ [Briefing] 긴급 연락망 확인
└─ [Briefing] 일정 최종 확인
```
**산출물:**
- 배포 체크리스트 (모두 체크됨)
- 롤백 계획 문서
- 팀 교육 기록
---
### 3.2 데이터베이스 마이그레이션
**일정:** 2026-11-19 (야간)
**담당:** DBA 팀
**상태:** ⏳ 대기
```
3.2.1 마이그레이션 실행 (야간 진행)
├─ [Step 1] 기존 DB 전체 백업
├─ [Step 2] 0041_create_operation_audit_trail 실행
├─ [Step 3] 마이그레이션 검증 (모든 테이블 확인)
└─ [Step 4] Idempotency 재테스트
3.2.2 마이그레이션 롤백 준비
├─ [Rollback] 백업에서 복구 계획
├─ [Rollback] 복구 예상 시간: 30분
└─ [Verify] 롤백 테스트 (sandbox)
3.2.3 마이그레이션 로그
├─ [Log] 모든 SQL 문 기록
├─ [Log] 실행 시간 기록
└─ [Log] 에러 로그 (있으면) 기록
```
**성공 기준:**
- 마이그레이션 완료
- 모든 테이블 존재 확인
- 데이터 무결성 검증 (row count match)
---
### 3.3 애플리케이션 배포
**일정:** 2026-11-20 (오전 업무 외 시간)
**담당:** DevOps + Engineering
**상태:** ⏳ 대기
```
3.3.1 배포 실행
├─ [Deploy] 기존 서비스 중지
├─ [Deploy] 새 바이너리 배치
├─ [Deploy] 환경 변수 설정 (API keys, DB conn)
├─ [Deploy] Nginx 재구성
└─ [Deploy] 새 서비스 시작
3.3.2 배포 후 검증 (Smoke Test)
├─ [Test] HTTP 상태 코드 확인 (200)
├─ [Test] 인증 엔드포인트 테스트
├─ [Test] Shadow Run API 테스트
├─ [Test] 데이터베이스 연결 확인
└─ [Test] 로그 정상 기록 확인
3.3.3 배포 로그
├─ [Log] 배포 시간
├─ [Log] 배포 담당자
├─ [Log] 모든 에러 기록
└─ [Log] 모니터링 메트릭 스냅샷
```
**성공 기준:**
- 서비스 정상 가동 (99.5% uptime)
- API 응답 시간 < 500ms
- 에러율 < 0.1%
---
### 3.4 배포 후 모니터링 (72시간)
**일정:** 2026-11-20 ~ 2026-11-23
**담당:** SRE 팀
**상태:** ⏳ 대기
```
3.4.1 실시간 모니터링 (24/7)
├─ [Monitor] 에러율 추적
├─ [Monitor] 응답 시간 추적
├─ [Monitor] CPU/메모리 사용률
├─ [Monitor] 데이터베이스 연결 풀
└─ [Monitor] API 호출률
3.4.2 매시간 보고서
├─ [Report] SLA 준수 여부
├─ [Report] 이상 사항 식별
└─ [Action] 필요 시 즉시 조치
3.4.3 문제 해결 (필요시)
├─ [If Issue] 로그 분석
├─ [If Issue] 패치 준비
└─ [If Issue] 롤백 또는 핫픽스
3.4.4 72시간 보고서
├─ [Report] 전체 안정성 검증
├─ [Report] 성능 메트릭 요약
└─ [Approval] Go-Live 최종 승인
```
**성공 기준:**
- 99.5% SLA 달성
- 에러율 < 0.1%
- 응답 시간 < 500ms (p95)
- 최고 경영진 승인
---
## 4️⃣ PHASE 4: Operations & Continuous Improvement
### 4.1 월별 기술부채 관리 (첫 달: 2026-11월)
**일정:** 2026-11-24 ~ 2026-11-30
**담당:** Engineering Lead
**상태:** ⏳ 대기
```
4.1.1 DEBT 식별
├─ [Task] 이전 월 DEBT 리스트 검토
├─ [Task] 이 달 새로운 DEBT 식별
└─ [Task] TECH_DEBT_REGISTER.md 업데이트
4.1.2 DEBT 결제 (20% 목표)
├─ [Task] High Impact / Low Effort DEBT 우선
├─ [Task] 월별 20% (점수 기준) 결제 실행
└─ [Verify] 결제 커밋 기록 (git log)
4.1.3 DEBT 리뷰 회의
├─ [Meeting] 완료된 DEBT 리뷰
├─ [Meeting] 다음 월 계획 수립
└─ [Report] 월간 DEBT 리포트 작성
```
**성공 기준:**
- 20% DEBT 결제 달성
- 모든 DEBT git에 기록됨
- 리더 승인
---
### 4.2 분기별 성과 검토 (Q4 2026: 12월)
**일정:** 2026-12-01 ~ 2026-12-31
**담당:** CTO + 팀 리더
**상태:** ⏳ 대기
```
4.2.1 성과 지표 수집
├─ [Metric] 가용성 (99.5% SLA)
├─ [Metric] 성능 (응답 시간, throughput)
├─ [Metric] 품질 (테스트 커버리지, 버그율)
├─ [Metric] 기술부채 (월별 20% 결제)
└─ [Metric] 비즈니스 (모델 정확도, ROI)
4.2.2 리스크 평가
├─ [Risk] 모니터링 이상 (드리프트, 이상)
├─ [Risk] 보안 문제 (알려진 CVE)
└─ [Risk] 기술부채 누적
4.2.3 Q1 2027 계획 수립
├─ [Planning] 새 기능 (auto-learning 검토)
├─ [Planning] 최적화 (성능, 비용)
└─ [Planning] 운영 개선 (모니터링, 자동화)
4.2.4 분기별 리포트
├─ [Report] 성과 요약
├─ [Report] 리스크 및 완화 방안
├─ [Report] 개선 기회
└─ [Approval] 경영진 검토 & 승인
```
**성공 기준:**
- SLA 99.5% 달성
- DEBT 60% 결제 (3개월)
- 0건의 critical incident
- Q1 계획 수립 완료
---
## 📊 WBS 요약 (Task Count)
| Phase | 작업수 | 상태 | 담당 |
|-------|--------|------|------|
| **P1: Execution** | 5 | 🟢 진행중 | 자동화 |
| **P2: Verification** | 16 | ⏳ 대기 | Engineering |
| **P3: Deployment** | 11 | ⏳ 대기 | DevOps |
| **P4: Operations** | 8+ | ⏳ 대기 | SRE |
| **Total** | **40+** | - | - |
---
## 🎯 Critical Path (병렬화 불가)
```
Phase 1 (자동, 50-90일)
Phase 2 (15일, 병렬 가능)
├─ 2.1 PBO 검증
├─ 2.2 DSR 검증
├─ 2.3 OOS 검증
├─ 2.4 감시 로그
└─ 2.5 DEBT 검토
Phase 3 (2일)
├─ 3.1 배포 준비
├─ 3.2 DB 마이그레이션
├─ 3.3 앱 배포
└─ 3.4 모니터링 (72시간)
Phase 4 (지속, 월별/분기별)
```
**최단 시간:** 50 + 15 + 2 = **67일** (2026-08-11 ~ 2026-10-17)
**최장 시간:** 90 + 15 + 2 = **107일** (2026-08-11 ~ 2026-11-25)
---
**Version:** 1.0
**Last Updated:** 2026-08-11
**Owner:** Program Manager
**Status:** ACTIVE