KTSPS 家庭儀表板1C

設定

Google Calendar 同步 · eClass 拉取 · 家庭成員邀請（稍後）

家庭

Au-Yeung 家庭 · 班別 1C

  • Johnny Au-Yeung (owner) · johnny@example.com
  • 家庭成員（稍後邀請） (member) · family.member@example.com

邀請其他成員／可訂閱分享：尚未實作（功能預留）。

Google Calendar

將家庭活動推送到 Google Calendar。狀態： 未設定環境變數

Google OAuth 未設定 — 在 Google Cloud Console 建立 Web 用戶端，重新導向 URI 設為 https://family.profit-access.com/api/auth/google/callback，並填入 Vercel 環境變數。

eClass 通告拉取

排程：每日 12:00 與 18:00 Asia/Hong_Kong （UTC 04:00 / 10:00，見 vercel.json）。 預設 fixtures；設 ECLASS_USE_FIXTURES=false 與 ECLASS_SESSION_COOKIE 後改用 TypeScript live discover（適合 Vercel）。

本機 scraper 路徑（可選）：/var/eclass-ktsps-scraper

# Production (Vercel) — TypeScript live discover:
ECLASS_USE_FIXTURES=false
ECLASS_SESSION_COOKIE=<paste Cookie header from browser DevTools>
ECLASS_BASE_URL=https://eclass.ktsps.edu.hk

# Optional local Python inventory (not available on Vercel serverless):
cd /var/eclass-ktsps-scraper
source .venv/bin/activate
python -m eclass_scraper discover --fixtures tests/fixtures -o inventory.json
ECLASS_INVENTORY_PATH=…/inventory.json
立即執行拉取 job

最近 SyncJob

  • [success] pull_eclass — Upserted 4 circulars from inventory
  • [success] pull_eclass — Upserted 4 circulars from inventory
  • [success] pull_eclass — Upserted 4 circulars from inventory
  • [success] pull_eclass — Upserted 4 circulars from inventory
  • [success] pull_eclass — Upserted 4 circulars from inventory

生產環境檢查清單

  1. 瀏覽器登入 eClass → DevTools → 複製 Cookie → Vercel ECLASS_SESSION_COOKIE（勿提交 git）。
  2. ECLASS_USE_FIXTURES=false、CRON_SECRET。
  3. Google Cloud OAuth Web 用戶端，重新導向 URI：https://family.profit-access.com/api/auth/google/callback
  4. 定期輪換 Neon / DATABASE_URL 密碼。