chore(governance): consolidate roadmap and backup policies

docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md

@@ -10,6 +10,8 @@
 - `GatherTradingData.xlsx`는 직접 입력이 아니다.
 - workbook이 필요한 작업은 별도 seed-prep에서만 수행한다.
 - KIS 수집, snapshot admin, platform transition 검증은 JSON/SQLite 우선을 따른다.
+- KIS Open API access token은 `Temp/kis_tokens.db`에 저장하고, `TOKEN_REFRESH_SKEW_MINUTES=10` 기준으로 만료 전 재사용한다.
+- 토큰 캐시 경로는 `KIS_TOKEN_DB_PATH` 환경변수로 오버라이드할 수 있다.
 
 ## 보관 정책
 
@@ -41,6 +43,8 @@
 2. JSON이 없고 workbook 변환이 필요하면 `tools/convert_xlsx_to_json.py`를 별도 seed-prep 단계에서 실행한다.
 3. `docs/ROADMAP_WBS.md`의 WBS-8.2를 따른다.
 4. `tools/validate_platform_transition_wbs_v1.py`와 `tools/validate_snapshot_admin_web_v1.py`를 확인한다.
+5. KIS 토큰은 `src/quant_engine/kis_api_client_v1.py`가 SQLite 캐시로 관리하므로, 수집 재실행 시에도 토큰을 매번 새로 발급하지 않는다.
+6. 토큰 상태는 `python tools/inspect_kis_token_cache_v1.py`로 확인한다.
 
 ## 재생성 명령
 
@@ -75,6 +79,9 @@ python tools/validate_snapshot_admin_web_v1.py
 - JSON 우선 workflow가 xlsx를 직접 재생성하지 않는다.
 - xlsx는 보조 자산으로만 남는다.
 - SQLite 우선 실행 경로가 1차 권위다.
+- KIS 토큰 캐시는 수집 DB와 분리되어야 하며, 기본 경로는 `Temp/kis_tokens.db`다.
+- 토큰 갱신은 `TOKEN_REFRESH_SKEW_MINUTES` 기준으로만 다시 호출한다.
+- 토큰 캐시 진단은 `python tools/inspect_kis_token_cache_v1.py --json`를 사용한다.
 
 ## 비고