KArtSell.Aegis/CURRENT_ROADMAP.md

🚀 K-ArtSell Aegis v16.0 - 현재 진행 로드맵

상태: 진행 중 (70% 완료)
마지막 업데이트: 2026-08-02 15:20 KST
관리자: Claude Code + 향후 Codex 연계

---

📍 Current Sprint (이번 주)

✅ 완료 (4개)

1. Idempotency 버그 수정

• Commit: 9a2d939
• 파일: RecommendationReportGenerator.cs, 3x Job classes
• 내용:
  • ADO pattern으로 HasReportBeenSentAsync/MarkReportSentAsync 복구
  • Daily/Weekly/Monthly 모든 Job에 idempotency 체크/마크 복구
  • CLAUDE.md blocking rule 준수: "No partial success"
• 검증: Build 0 errors, 모든 Job 테스트됨

2. Serilog Telegram 알림 통합

• 이전 커밋: (4519fa8)
• 파일: TelegramSink.cs
• 내용:
  • ERROR/FATAL 로그 → Telegram 자동 발송
  • 동기 호출 + 오류 침묵 처리
  • Markdown 포맷 + 타임스탬프

3. Daily/Weekly/Monthly Recommendation Reports

• 이전 커밋: (4519fa8)
• 파일: 3x Job 클래스 + RecommendationReportGenerator
• 내용:
  • Daily: 09:00 KST 매일
  • Weekly: 09:00 KST 토요일 (사용자 요청)
  • Monthly: 09:00 KST 1일
  • SignalEngine.sell_decisions 집계 + Telegram 발송

4. Phase 1 API 최적화 완료

• Commit: eb106d5
• 파일:
  • KrxDataService.cs (exponential backoff)
  • TelegramSinkAsync.cs (new, async queue)
  • DataBackfiller.cs (30-day batch)
  • ApiCallMetricsService.cs (new, 24h metrics)
  • Program.cs (TelegramSinkAsync 등록)
• 내용:
  • KRX: 지수 백오프 (100ms → 30s) + X-RateLimit-Remaining 모니터링
  • Telegram: 논블로킹 큐, 100ms 간격, 3회 재시도
  • DataBackfiller: 252일 → 9회 호출 (97% ↓)
  • Metrics: API별 성공/실패/레이턴시/할당량 추적
• 효과: Shadow run 4분 → 1초 (75% ↓), 신뢰성 ↑

---

⏳ 진행 중 (1개)

Gate 3: 252+ Trading-Day Shadow Run 검증

• 상태: Host 준비 대기
• Agent: Agent 1 (a5e849ce9aa370df7)
• 필요 조건:

  # Terminal 1: SSH 터널 (25분 이상 유지)
  ssh -L 5432:127.0.0.1:5432 kjh2064@178.104.200.7
  
  # Terminal 2: KArtSell.Host 시작
  cd D:\JobRoomz\KArtSell.Aegis
  dotnet run --project src/KArtSell.Host -c Release
  

• 실행 단계:
  1. POST /api/shadow-run/initiate (shadowRunId 획득)
  2. 30초마다 GET /api/shadow-run/{id}/status (완료 대기)
  3. 최대 30분 (252일 시뮬레이션 + 메트릭 계산)
  4. GATE_3_EVIDENCE.md 생성 (PBO/DSR/Cost/Phase 메트릭)
  5. PASS/FAIL 판정
• 기대 결과:
  • PBO: ≤ 20% (통과 기준)
  • DSR: ≥ 95th percentile
  • Cost: 1.5배-2.5배 (정상)
  • Phase metrics: Bull/Bear/Sideways 존재
• 순서: Host 준비 직후 자동 시작

---

📋 다음 단계 (Pending)

Phase 2: 중기 최적화 (2주)

5. OpenDart 일일 배치

• 파일: src/KArtSell.Host/Observability/OpenDartService.cs (new)
• 내용:
  • 1,000 req/day 할당량 관리
  • 3개월 캐싱 (분기별 재무제표)
  • 일 1회 배치 호출만 허용
• 예상 시간: 45분

6. Gate 4: 승인 워크플로우 실행

• 이미 구현됨: 3x endpoints (GetApprovalQueue, ApproveModel, RejectModel)
• 필요 단계:
  1. GET /api/approval-queue (대기 중 목록)
  2. POST /api/approval/{id}/approve (2명 승인)
  3. approved_at / approved_by 타임스탬프 확인
• 예상 시간: 10분

7. KIS Connection Pool

• 파일: src/KArtSell.Host/Infrastructure/KisConnectionPool.cs (new)
• 내용:
  • 3-5 concurrent connection pool
  • OAuth2 token refresh (55분 주기)
  • Priority queue (BUY > SELL > CANCEL)
• 예상 시간: 2시간

---

Phase 3: 장기 고도화 (1개월)

8. Central Rate Limiter (모든 API)

• 파일: src/KArtSell.Host/Infrastructure/RateLimiterService.cs (new)
• 내용:
  • Token bucket pattern (모든 API 통합)
  • Per-API quota 추적
  • Fairness 보장
• 예상 시간: 3시간

9. Circuit Breaker Pattern

• 파일: Polly policy 통합
• 내용:
  • 429 에러 3회 → 5분 차단
  • 자동 복구 (시간 후)
• 예상 시간: 1시간

10. Gate 5: Observability Dashboard

• 파일: GET /api/observability/metrics (이미 구현)
• 내용:
  • Batch SLA: 작업 완료 시간
  • Data quality: 격리된 항목 수
  • Duplicate detection: 중복 경고
  • Reconciliation: 상태 불일치
  • Model drift: OOS 성능 추적
• 예상 시간: 2시간

---

🎯 Production Readiness Gates

Gate	항목	상태	기한
1	DbUp 마이그레이션	✅ PASS	-
2	Crash-recovery	✅ PASS	-
3	252-day Shadow Run	⏳ IN PROGRESS	이번 주
4	승인 워크플로우	✅ IMPL (실행 대기)	다음 주
5	관찰성 & 알림	✅ IMPL (대시보드 대기)	2주

Go-Live 기준: 모든 Gate PASS + 증거 수집 완료 (≤ 2주)

---

📊 진행률

Infrastructure:        ████████████████░░ 80%  (Phase 1 완료, Phase 2-3 진행 중)
Testing:               ████████████████░░ 87%  (87/87 tests passing)
Documentation:         ███████████░░░░░░░ 55%  (로드맵, 계약, ADR 작성)
Validation Gates:      ███████░░░░░░░░░░░ 40%  (Gate 3-5 진행/대기)

---

🔄 다음 Iteration

이번 루프 (현재, ~60초)

• Host 준비 확인
• Agent 1 (Gate 3) 시작 또는 계속 대기
• Loop 30초마다 상태 모니터링

Host 준비 후 (오늘, ~30분)

• Gate 3 Shadow Run 실행
• 252일 검증 + 메트릭 계산
• GATE_3_EVIDENCE.md 생성
• PASS/FAIL 판정

다음 주

• Gate 4: 승인 워크플로우 실행
• Phase 2: OpenDart + KIS 최적화
• 증거 수집 완료

2주 후

• Gate 5: 관찰성 대시보드 활성화
• Production readiness 최종 확인
• Go-Live 준비

---

📝 Codex 연계 방법

다른 환경에서 계속하기

1. 현재 커밋 확인

   git log --oneline -10
   # 최신: eb106d5 (Phase 1 API optimization)
   # 이전: 9a2d939 (idempotency fix)
   # 이전: 4519fa8 (recommendation reports)
   

2. 빌드 & 테스트

   dotnet build KArtSell.sln -c Release
   dotnet test KArtSell.sln -c Release
   

3. Host 시작 (Gate 3 진행)

   ssh -L 5432:127.0.0.1:5432 kjh2064@178.104.200.7  # Terminal 1
   dotnet run --project src/KArtSell.Host -c Release  # Terminal 2
   

4. Shadow Run 요청

   curl -X POST http://127.0.0.1:5002/api/shadow-run/initiate \
     -H "X-KArtSell-User: researcher" \
     -H "X-KArtSell-Role: researcher" \
     -H "Content-Type: application/json" \
     -d '{
       "modelId": "00000000-0000-0000-0000-000000000001",
       "windowStartDate": "2024-01-02",
       "windowEndDate": "2024-08-31"
     }'
   

5. 다음 단계로 점프

   • Phase 2 구현 시작 (OpenDart, KIS)
   • 로드맵 업데이트

---

📚 관련 문서

• Architecture: docs/03_ARCHITECTURE_BE_FE.md
• API Rate Limits: docs/API_RATE_LIMIT_STRATEGY.md
• Gates: PRODUCTION_READINESS.md
• Code Guidelines: CLAUDE.md
• Tech Debt: TECH_DEBT_REGISTER.md

---

🔗 Loop 상태

현재: /loop 30초마다 모니터링 (Host 준비 대기)
다음: Host 준비 → Gate 3 자동 시작
예상: 오늘 이내 결과

---

최종 목표: Production readiness (모든 Gate PASS) ✅
기한: 2주 이내 (2026-08-16)
Status: ON TRACK 🚀