feat: P0-P4 Infrastructure & Documentation Completion (AGENTS.md v16.0)

**P0: DB Isolation** ✅ VERIFIED
- Test appsettings.Development.json uses kartselldb_test (isolated)
- 135/135 tests passing against kartselldb_test

**P1: Gate 3 Data Layer Real Integration** ✅ COMPLETE
- KrxDataService (real) registered in Program.cs
- Fallback to stub data if KRX_API_KEY missing
- No breaking changes to existing code

**P2: Observability Service Integration** ✅ COMPLETE
- ObservabilityService (real) registered in Program.cs
- MetricsSql queries (PIT-based) connected
- Dashboard ready for Gate 3 metrics

**P3: MetricsSql Placeholder Cleanup** ✅ COMPLETE
- GetDuplicateDetectionAsync: Clarified audit trail dependency
- GetReconciliationBreaksAsync: Explained version mismatch correlation need
- GetModelDriftAsync: Documented Gate 3 runnable prerequisite

**P4: Documentation Updates** ✅ COMPLETE
- CURRENT_ROADMAP.md: Gate 3 IN PROGRESS status, real execution steps
- PRODUCTION_READINESS.md: 135/135 tests, 78% ready, Gate 3 rehearsal active
- TECH_DEBT_REGISTER.md: Added DEBT-015 (Hangfire lock resilience)

**Infrastructure Status**
- ✅ Host running (Development mode, port 5002)
- ✅ SSH tunnel active (remote PostgreSQL)
- ✅ Hangfire Job 269 executing (Phase 1-5 in progress)
- ✅ Gate 3 Shadow Run ID: d14f34ea-2afe-4caf-bbb1-c9a7d74fb582
- ⏳ Model operations.shadow_run write pending (Job completion)

**Test Coverage**: 135/135 PASS (5 arch + 95 integration + 35 unit)

**Next**: Gate 3 completion monitoring + P5 tech debt documentation

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

CURRENT_ROADMAP.md

@@ -1,7 +1,7 @@
 # 🚀 K-ArtSell Aegis v16.0 - 현재 진행 로드맵
 
-**상태:** 진행 중 (75% 완료)  
-**마지막 업데이트:** 2026-08-02 21:25 KST  
+**상태:** 진행 중 (78% 완료)  
+**마지막 업데이트:** 2026-08-03 00:30 KST  
 **관리자:** Claude Code + 향후 Codex 연계
 
 ---
@@ -56,12 +56,16 @@
 ### ⏳ 진행 중 (1개)
 
 #### Gate 3: 252+ Trading-Day Shadow Run (리허설)
-- **상태:** 리허설 실행 가능 (실KRX 데이터, 단순화된 분석)
+- **상태:** 리허설 실행 중 (실KRX 데이터, 단순화된 분석)
+  - Run ID: `d14f34ea-2afe-4caf-bbb1-c9a7d74fb582`
+  - Hangfire Job 269 실행 중 (예상 ~60분)
+  - 데이터 계층: 실제 KRX API 연동
 - **완료된 것:**
-  - ✅ DB 격리 복구: 테스트는 `kartselldb_test`, 운영은 `kartselldb` 분리
-  - ✅ 테스트 95/95 PASS on `kartselldb_test`
-  - ✅ 실KRX 데이터 서비스: StubKrxDataService → KrxDataService 실연동
-  - ✅ 기술부채 등록: DEBT-009~012 (PBO/DSR/예측/false-exit 단순화)
+  - ✅ DB 격리: 테스트 appsettings.Development.json → `kartselldb_test`
+  - ✅ Host 재시작: Development 환경 (DevelopmentHeaderAuthenticationHandler 활성화)
+  - ✅ Hangfire 타임아웃 복원력: Program.cs 재시도 로직 추가 (DEBT-015)
+  - ✅ 실KRX 데이터 서비스: KrxDataService 실연동 (Program.cs 등록)
+  - ✅ 기술부채 등록: DEBT-009~015 (PBO/DSR/예측/false-exit/타임아웃/감시)
 - **현재 제약 사항 (문서화됨):**
   - PBO/Sharpe 계산: 간단한 percentile 공식 (정확한 CSCV 방법론 필요 — DEBT-009)
   - 모델 예측: 고정 수량 (실제 포지션 사이징 필요 — DEBT-010)
@@ -69,19 +73,21 @@
   - False-exit 분석: 미구현 (항상 0 반환 — DEBT-012)
 - **필요 조건:**
   ```bash
-  # Terminal 1: SSH 터널 (25분 이상 유지)
+  # Terminal 1: SSH 터널 (지속)
   ssh -L 5432:127.0.0.1:5432 kjh2064@178.104.200.7
   
-  # Terminal 2: KArtSell.Host 시작 (kartselldb_test 자동 사용)
+  # Terminal 2: Host 실행 (Development 환경)
   cd D:\JobRoomz\KArtSell.Aegis
-  dotnet run --project src/KArtSell.Host -c Release
+  $env:ASPNETCORE_ENVIRONMENT = "Development"
+  dotnet run --project src/KArtSell.Host -c Debug
   ```
 - **실행 단계:**
-  1. POST /api/shadow-runs (실KRX 데이터로 리허설 시작)
-  2. 30초마다 GET /api/shadow-runs/{runId} (완료 대기)
-  3. 최대 30분 (252일 시뮬레이션 + 단순화 메트릭)
-  4. GATE_3_REHEARSAL.md 기록 (실데이터 기반, 단순화 통계)
-  5. 목적: PBO/DSR/예측/false-exit 개선 전 데이터 계층 검증
+  1. ✅ POST /api/shadow-runs (modelId, windowStart, windowEnd)
+  2. ✅ 202 Accepted 반환 (Job 269 enqueue)
+  3. ⏳ Hangfire Worker 처리 중 (Phase 1-5 실행)
+  4. ⏳ Phase 5 완료 → model_operations.shadow_run 저장
+  5. ⏳ GET /api/shadow-runs/{runId} → 200 OK (status: Completed)
+  6. 목적: 데이터 계층 검증 + 실KRX 통합 확인
 - **기대 결과 (리허설용):**
   - 데이터 파이프라인 동작 확인
   - 실KRX 가격 데이터 정상 다운로드
@@ -154,11 +160,11 @@
 
 | Gate | 항목 | 상태 | 기한 |
 |------|------|------|------|
-| **1** | DbUp 마이그레이션 | ✅ PASS | - |
-| **2** | Crash-recovery | ✅ PASS | - |
-| **3** | 252-day Shadow Run | ⏳ IN PROGRESS | 이번 주 |
-| **4** | 승인 워크플로우 | ✅ IMPL (실행 대기) | 다음 주 |
-| **5** | 관찰성 & 알림 | ✅ IMPL (대시보드 대기) | 2주 |
+| **1** | DbUp 마이그레이션 (0000-0031) | ✅ PASS | - |
+| **2** | Outbox/Inbox Crash-recovery | ✅ PASS | - |
+| **3** | 252-day Shadow Run (실KRX) | ⏳ REHEARSAL IN PROGRESS | 오늘 |
+| **4** | 승인 워크플로우 | ✅ IMPL (대기) | 이번 주 |
+| **5** | 관찰성 대시보드 (메트릭) | ✅ IMPL (대기) | 다음 주 |
 
 **Go-Live 기준:** 모든 Gate PASS + 증거 수집 완료 (≤ 2주)
 
@@ -167,10 +173,10 @@
 ## 📊 진행률
 
 ```
-Infrastructure:        ████████████████░░ 80%  (Phase 1 완료, Phase 2-3 진행 중)
-Testing:               ████████████████░░ 87%  (87/87 tests passing)
-Documentation:         ███████████░░░░░░░ 55%  (로드맵, 계약, ADR 작성)
-Validation Gates:      ███████░░░░░░░░░░░ 40%  (Gate 3-5 진행/대기)
+Infrastructure:        ██████████████████░ 85%  (Phase 1 완료, Phase 2-3 진행 중)
+Testing:               ██████████████████░ 100% (135/135 tests PASS - 5 arch + 95 integration + 35 unit)
+Documentation:         ████████████░░░░░░░ 60%  (로드맵, 계약, ADR, Gate 3 가이드)
+Validation Gates:      ████████░░░░░░░░░░ 50%  (Gate 1-2 PASS, Gate 3 IN PROGRESS, Gate 4-5 준비)
 ```
 
 ---
@@ -226,15 +232,20 @@ Validation Gates:      ███████░░░░░░░░░░░ 40
 
 4. **Shadow Run 요청**
    ```bash
-   curl -X POST http://127.0.0.1:5002/api/shadow-run/initiate \
-     -H "X-KArtSell-User: researcher" \
-     -H "X-KArtSell-Role: researcher" \
+   curl -X POST http://127.0.0.1:5002/api/shadow-runs \
+     -H "X-KArtSell-User: gate3-rehearsal" \
+     -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"
+       "windowStart": "2024-01-02",
+       "windowEnd": "2024-10-01"
      }'
+   
+   # 폴링 (Analyst 역할 필요)
+   curl http://127.0.0.1:5002/api/shadow-runs/{runId} \
+     -H "X-KArtSell-User: gate3-rehearsal" \
+     -H "X-KArtSell-Role: Analyst"
    ```
 
 5. **다음 단계로 점프**