ZeroJudge 學生進度追蹤器 (ZeroJudge Student Progress Tracker)

這是一個自動化工具，用於抓取 ZeroJudge 課程頁面的學生練習進度，並將資料同步到 Google Sheets。

安裝步驟

1. 確保電腦已安裝 Python 3.8+。
2. 進入專案目錄，建立並啟動虛擬環境：

   cd zj_tracker
   python -m venv venv
   .\venv\Scripts\activate

3. 安裝所需的依賴套件：

   pip install -r requirements.txt

4. 設定設定檔： 編輯 config.yaml，填寫您的課程 course_id 與 course_url。
5. 準備 Google API 憑證： 將您的 Google Service Account JSON 檔案命名為 service_account.json 並放在本目錄下。

1. 設定與驗證

• ZeroJudge 驗證：
  • 程式執行時，會於終端機主動提示您輸入帳號與密碼進行自動登入。
  • 安全性：帳號與密碼不會被儲存在任何設定檔中。
• Google Sheets 驗證：確保目錄下有 service_account.json。

2. 執行同步

.\venv\Scripts\python main.py

3. 注意事項

• 試算表格式要求 (重要)：您的 Google 試算表的第一欄 (A欄) 必須是學生的 ZeroJudge 帳號或學號（須與 ZeroJudge 系統上顯示的身分名稱相符），程式才能據此比對並正確填入該學生的成績。
• 欄位自動建立：如果試算表中還沒有該作業的對應標題欄位，程式會自動向右新增。
• 資料格式：進度會以 分數 / 時間 的格式顯示在單一儲存格中。
• 共用權限：請確保該 Google 試算表已經分享「編輯權限」給 Service Account 的服務信箱 (信箱地址可於 .json 檔案中的 client_email 找到)。