feat(kis-collection): finalize sqlite migration, add fallback resilience, and update WBS documentation

.gitea/workflows/kis_data_collection.yml

@@ -2,8 +2,8 @@ name: KIS Data Collection (SQLite Canonical Feed)
 
 # ─────────────────────────────────────────────────────────────────
 # [중요] 이 워크플로우는 KIS Open API를 코어로 하는 read-only 데이터 수집만 수행한다.
-# xlsx를 직접 읽지 않고 GatherTradingData.json + live read-only APIs를 통해
-# SQLite canonical store를 갱신한다. 매수/매도 주문은 어떤 경우에도 실행하지 않는다.
+# GatherTradingData.json + live read-only APIs를 통해 SQLite canonical store를 갱신한다.
+# xlsx는 이 워크플로우의 직접 입력이 아니며, KIS 실패 시에만 별도 보조 경로에서 사용한다.
 #
 # 스케줄: 영업일(월~금) 08:00~17:00 KST, 2시간 간격(08/10/12/14/16시).
 # Gitea Actions의 schedule cron은 UTC 기준으로 평가된다(서버 타임존이 별도
@@ -52,48 +52,18 @@ jobs:
           exit 0
         fi
 
-        if [ -f GatherTradingData.xlsx ]; then
-          echo "GatherTradingData.json missing; regenerating from GatherTradingData.xlsx"
-          python3 tools/convert_xlsx_to_json.py \
-            --xlsx GatherTradingData.xlsx \
-            --out GatherTradingData.json
-          if [ -f GatherTradingData.json ]; then
-            echo "GatherTradingData.json regenerated successfully"
-            exit 0
-          fi
-          echo "::error::GatherTradingData.xlsx is present but JSON regeneration failed."
-          echo "::error::Check tools/convert_xlsx_to_json.py and workbook sheet integrity."
-          exit 1
-        fi
-
         if [ -f .clasprc.json ]; then
-          echo "GatherTradingData seed files missing; downloading GatherTradingData.xlsx from Google Drive via .clasprc.json"
-          python3 tools/download_trading_data.py
-          if [ -f GatherTradingData.xlsx ]; then
-            echo "GatherTradingData.xlsx downloaded successfully; regenerating GatherTradingData.json"
-            python3 tools/convert_xlsx_to_json.py \
-              --xlsx GatherTradingData.xlsx \
-              --out GatherTradingData.json
-            if [ -f GatherTradingData.json ]; then
-              echo "GatherTradingData.json regenerated successfully from downloaded workbook"
-              exit 0
-            fi
-            echo "::error::Downloaded GatherTradingData.xlsx but JSON regeneration failed."
-            echo "::error::Check workbook integrity and tools/convert_xlsx_to_json.py."
-            exit 1
-          fi
-          echo "::error::.clasprc.json exists but GatherTradingData.xlsx was not downloaded."
-          echo "::error::Check Google Drive access and tools/download_trading_data.py."
+          echo "GatherTradingData.json missing; seed regeneration is not performed in this workflow."
+          echo "::error::Commit or pre-stage GatherTradingData.json before running this workflow."
+          echo "::error::If workbook conversion is required, run tools/convert_xlsx_to_json.py in a separate seed-prep step."
           exit 1
         fi
 
-        echo "::error::Neither GatherTradingData.json nor GatherTradingData.xlsx exists in the checked-out tree."
-        echo "::error::This workflow requires a canonical seed snapshot before KIS collection can start."
+        echo "::error::GatherTradingData.json is missing."
+        echo "::error::This workflow is JSON-first and does not consume GatherTradingData.xlsx directly."
         echo "::error::Fix options:"
         echo "::error::  1) Commit GatherTradingData.json to the repository tree."
-        echo "::error::  2) Commit GatherTradingData.xlsx so the workflow can regenerate the JSON."
-        echo "::error::  3) Provide .clasprc.json so the workflow can download GatherTradingData.xlsx from Google Drive and regenerate the JSON."
-        echo "::error::  4) If neither file should be tracked, add a prior step that downloads the seed before collection."
+        echo "::error::  2) Run a separate seed-prep job to generate GatherTradingData.json from workbook sources."
         exit 1
 
     - name: Configure Runtime Paths