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

12 KiB

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