 kjh2064
|
17326dae77
|
KRX API Integration: Contract definition (real market data)
Defines KRX OpenAPI specification for replacing stub data:
Contract:
- src/KArtSell.Host/Features/ShadowRun/KRX_API_INTEGRATION_CONTRACT.md
Endpoint specs, response DTOs, retry strategy, cache design
DTOs:
- src/KArtSell.Modules.ModelOperations/ShadowRun/Services/KrxApiResponses.cs
KrxPriceResponse, PriceItem, CalendarResponse for JSON deserialization
Specifications:
- Stock Prices: GET /StockPrice (basDt, isuCd)
Response: open, high, low, close, volume
- Market Calendar: GET /ClosedDaysList
Response: trading sessions, holidays with reasons
Implementation Strategy:
- Real API endpoint instead of stub
- Exponential backoff retry (429, 503)
- Cache: 24 hours per (ticker, date)
- Timeout: 30 seconds
AGENTS.md v16.0 compliance verified:
✅ Contract defined (API spec, retry classification, cache strategy)
✅ SOLID principles (HttpClient injection, IKrxDataService)
✅ Proper error handling (transient vs permanent)
✅ Testable design (mock API ready for unit tests)
Next steps:
1. KrxDataService implementation (real API + retry + cache)
2. Integration tests (API parsing, retry logic, cache)
3. Configuration: appsettings.json, Program.cs registration
4. False Exit Analysis (Option C)
5. Database Migrations (Option D)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-02 12:22:50 +09:00 |
|