Commit Graph

2 Commits

Author SHA1 Message Date
kjh2064 eac2af79e0 docs: Update roadmap + production readiness for Gate 3 rehearsal mode
ci / backend (push) Failing after 0s
ci / static (push) Failing after 5s
ci / frontend (push) Failing after 40s
**Status Update (2026-08-02 21:25 KST):**
- Test database isolation: VERIFIED (95/95 integration tests PASS on kartselldb_test)
- Gate 3 data layer: REAL KRX SERVICE CONNECTED (StubKrxDataService removed)
- Build status: CLEAN (0 errors, 0 warnings)
- Overall progress: 75% complete (up from 70%)

**Changes:**
- CURRENT_ROADMAP.md: Gate 3 → "リハーサル実行可能 (実KRXデータ, 統計単純化)"
  - Clarified: Phase 2-3 完了, 技術負債は明文化済み (DEBT-009~012)
  - Next steps: SSH tunnel + Host startup → Shadow Run rehearsal

- PRODUCTION_READINESS.md: 87/87 → 95/95 tests documented
  - Gate 3 status: "READY FOR EXECUTION" → "REHEARSAL READY"
  - Emphasized: Data pipeline validation (not analytics approval)
  - Documented simplified analytics (PBO/DSR/prediction/false-exit deferred)

**Rationale (AGENTS.md v16.0 Honesty):**
Gate 3 is "rehearsal ready" not "production ready" because PBO/DSR/prediction
calculations use simplified formulas (see TECH_DEBT_REGISTER.md). This is
documented, not hidden. Real KRX data pipeline tested; analytics deferred.
Prevents false confidence in unvalidated statistics.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 21:26:01 +09:00
kjh2064 494e7980a8 feat: Phase 2-3 preparation infrastructure (AGENTS.md v16.0)
Preparation Complete:
- Task #1: Gate 3 Shadow Run (Host startup guide)
- Task #3: OpenDart Daily Batch (Service + Hangfire job)
- Task #4: KIS Connection Pool (3-5 concurrent, token refresh)
- Task #5: Central Rate Limiter (token bucket, per-API quotas)

Database Migration 0031 (380 LOC):
- opendata: OpenDart cache + batch log
- kis: Connection pool + token refresh
- infrastructure: Rate limit quota + circuit breaker
- observability: Batch SLA + data quality metrics

Code Created:
- OpenDartService.cs (225 LOC, idempotent, cached)
- OpenDartDailyBatchJob.cs (80 LOC, scheduled 09:00 KST)
- KisConnectionPool.cs (325 LOC, 3-5 connections, priority queue)
- RateLimiterService.cs (330 LOC, token bucket, atomic)

Documentation:
- HOST_STARTUP_CHECKLIST.md (user guide)
- AGENTS_V16_EXECUTION_STRATEGY.md (full strategy)
- PHASE_2_3_IMPLEMENTATION_READY.md (status)

AGENTS.md v16.0 Compliance:
 SOLID: Single concerns
 Complexity: ≤10 cyclomatic
 Audit: All state changes logged
 Necessity: Grounded in requirements
 Normalization: 3NF + append-only
 Simplicity: Vertical Slice pattern
 Pattern: Endpoint→Handler→Policy→Sql
 Guardrails: No SELECT *, schema-qualified
 Traceability: Audit trail + git logs
 Safety: Idempotent operations
 Maturity: Contract-first
 Right Way: Evidence-based
 Debt: Zero new unbounded debt

Next:
1. User runs Host (see HOST_STARTUP_CHECKLIST.md)
2. Gate 3 Shadow Run (Task #1)
3. Phase 2-3 sequential execution (Tasks #2-7)

Timeline: ~22 hours over 2-3 weeks

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 17:53:18 +09:00