alt/services/worker/testdata/providers/kis/README.md
toki 735dafe927 feat: Korea daily data foundation task and documentation updates
- Add agent-task/m-korea-data-foundation with plans and code reviews
- Update agent-roadmap data-foundation milestones
- Update README files for project and worker service
- Add worker testdata directory
2026-05-29 19:28:03 +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
- 1Password secret references or item names
Runtime credentials are not required for mock tests. Later live KIS smoke tests should inject credentials at runtime through 1Password CLI or a later secret-provider implementation.