alt/services/worker/testdata/providers/kis/README.md
toki 8c3c4ba5a2 feat: operator surface phase updates, worker backtest/kis live client, binary utilities
- Add bin/kis-paper-daily-smoke and bin/kis-sops-env utilities
- Update agent-roadmap for operator surface phase
- Add worker backtest bar source and Kis live client
- Update KIS live secret configuration and documentation
- Refine worker datacheck and daily chart price providers
2026-06-03 12:10:48 +09:00

39 lines
1.5 KiB
Markdown

# KIS Provider Fixtures
This directory is the landing zone for KIS mock-provider fixtures used by worker adapter tests and mapping work.
## Source Reference
Use the locally cached official KIS sample repository first:
- `.agent-cache/koreainvestment/open-trading-api`
The first daily-bar mapping reference is:
- `examples_llm/domestic_stock/inquire_daily_itemchartprice/inquire_daily_itemchartprice.py`
- `examples_llm/kis_auth.py`
- `kis_devlp.yaml`
- `stocks_info/`
Postman exports are not required for the current milestone now that the official API sample repo is available locally.
## Mock Test Fixtures
Keep fixtures small, deterministic, and secret-free. The current minimum set is:
- `daily_itemchartprice_request.sample.json`: KIS daily chart request parameters.
- `daily_itemchartprice_response.sample.json`: KIS-like response payload with `output1` metadata and `output2` OHLCV rows.
- `daily_bars_normalized.expected.json`: expected normalized daily bars used by worker tests.
- `provider_symbols.sample.json`: provider symbol metadata for watchlist, exchange-wide, and sector-like selector tests.
## Sanitization
Before committing fixtures, remove:
- app keys, app secrets, access tokens, refresh tokens, approval keys
- account numbers or personal identifiers
- live authorization headers
- local hostnames or machine-specific paths
- secret-store item references
Runtime credentials are not required for mock tests. Later live KIS smoke tests should inject credentials at runtime from SOPS-decrypted environment variables only.