chore(governance): consolidate roadmap and backup policies

2026-06-23 18:00:34 +09:00
parent 357d2507da
commit f73a66818f
28 changed files with 381 additions and 76 deletions
@@ -225,6 +225,22 @@ phase_2_structural:
      workflow:
      - .gitea/workflows/snapshot_admin.yml
    verification: python tools/validate_snapshot_admin_web_v1.py
+
+  S8_kis_open_api_token_cache:
+    priority: HIGH
+    status: DONE
+    purpose: KIS Open API access token을 호출마다 재발급하지 않고 SQLite 캐시로 재사용한다.
+    required_fields:
+    - access_token
+    - expires_at
+    - updated_at
+    implementation_plan:
+      step_1: 토큰 캐시를 수집 DB와 분리된 SQLite 파일로 저장한다.
+      step_2: TOKEN_REFRESH_SKEW_MINUTES=10 기준으로 기존 토큰을 재사용한다.
+      step_3: 동시 호출 시 토큰 재발급을 직렬화한다.
+      step_4: DB 오버라이드 경로를 환경변수로 노출한다.
+      step_5: 토큰 캐시 상태를 조회하는 진단 CLI를 제공한다.
+    implementation_note: '2026-06-23 구현 완료. src/quant_engine/kis_api_client_v1.py가 Temp/kis_tokens.db를 기본 캐시로 사용하고, KIS_TOKEN_DB_PATH로 오버라이드 가능하다. 갱신 임계값은 TOKEN_REFRESH_SKEW_MINUTES=10이며, tools/inspect_kis_token_cache_v1.py로 상태를 조회한다.'
 phase_3_enhancement:
  A1_daily_leader_scan_auto:
    priority: MEDIUM