` 半透明深色 banner，文字格式「資料更新於 HH:MM:SS（N 分鐘前）」 - 相對時間：<30s 剛剛 / <60m 分鐘前 / <24h 小時前 / 否則日期 - `setInterval` 每 10 秒重算顯示（不重 fetch） - 只在成功拿到有 items 的 response 時更新，空/錯誤分支保留上次值後端變更需手動部署到 42.108：`git pull && uv sync && supervisorctl restart`。前端透過 webhook 自動部署。 --- ## 4. 日常操作 Cookbook ### 新增一個 repo 自動部署前提：repo 已在 Gitea，且有 main branch。 ```bash ssh 192.168.42.104 'sudo /opt/git-webhook/add-deploy.sh \

' ``` 範例（把 `timmy/blog` 自動部署到 caddy）： ```bash ssh 192.168.42.104 'sudo /opt/git-webhook/add-deploy.sh \ timmy blog /opt/caddy/www/blog 737e5eb08811...' ``` 完成後，push 該 repo main → 自動部署。 ### 查 webhook deploy log ```bash ssh 192.168.42.104 'sudo docker logs git-webhook --tail 50' ``` ### 手動重新部署 ```bash ssh 192.168.42.104 'sudo /opt/git-webhook/hooks//deploy.sh' ``` ### 暫停自動部署 ```bash ssh 192.168.42.104 'sudo docker stop git-webhook' # 停掉 webhook receiver # 或 # 在 Gitea UI (http://192.168.42.124:31337///settings/hooks) disable ``` ### API 端（42.108）操作 ```bash # 重啟 ssh 192.168.42.108 'sudo supervisorctl restart pokemon-radar-api' # 查 log ssh 192.168.42.108 'sudo tail -f /var/log/supervisor/pokemon-radar-api.log' # 看 Redis 內容 ssh 192.168.42.108 'sudo docker exec pokemon-radar-redis redis-cli GET pokemon:radar:latest' | head -100 # 手動觸發 fetcher ssh 192.168.42.108 'cd /opt/pokemon-radar-api && sudo /root/.local/bin/uv run python radar_fetcher.py' ``` ### 更新生產 API 程式碼後續 pokemon-radar-api 的 commit push 到 Gitea 後，生產機還要手動 pull + restart： ```bash ssh 192.168.42.108 'cd /opt/pokemon-radar-api && sudo git pull && sudo /root/.local/bin/uv sync && sudo supervisorctl restart pokemon-radar-api' ``` （若要把 API 端也做成 webhook 自動部署，需要設計一個能「git pull + uv sync + supervisorctl restart」的 deploy.sh，並讓 webhook container 有權限 ssh 或 supervisorctl — 比前端複雜。先保持手動） ### 新增 NPM 反代 + LE cert ```bash # 1. DNS: 在 Cloudflare 加 .lotimmy.com A record → 125.229.110.50（僅 DNS，不走 CF proxy） # 2. NPM API 建 proxy host（或到 http://192.168.42.124:81/ UI 按按鈕） TOKEN=$(curl -sS -X POST http://192.168.42.124:81/api/tokens \ -H "Content-Type: application/json" \ -d '{"identity":"admin@example.tw","secret":""}' \ | python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])') curl -sS -X POST http://192.168.42.124:81/api/nginx/proxy-hosts \ -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \ -d '{ "domain_names": [".lotimmy.com"], "forward_scheme": "http", "forward_host": "192.168.42.X", "forward_port": NNNN, "certificate_id": "new", "ssl_forced": true, "http2_support": true, "block_exploits": true, "meta": {"letsencrypt_agree": true, "letsencrypt_email": "admin@example.tw", "dns_challenge": false}, "locations": [] }' ``` --- ## 5. 已知限制與 follow-up ### 必看 - **state.json 是整條 pipeline 最脆弱的點**：過期時 Function Server 返回 200 但 results 空或登入頁，pipeline 靜默吐 0 筆。目前 state 是 2025-11-04 的，仍有效但總有一天會壞。重登 twpkinfo.com 匯出新 state 即可 - **42.108 supervisor conf 裡仍硬寫 `POKER_TOKEN="6R0W53R135510"`**（`/etc/supervisor/conf.d/pokemon-radar-api.conf` 的 `environment=` 那行），程式碼已不讀這個變數，但機器上 token 還在。非緊急，可空檔時清掉 - **第一個 commit `f7ef105` 含歷史 token**：public repo 歷史檔仍含當時 `FUNCTION_TOKEN=6R0W53R135510`，要徹底清需 `git filter-repo` + force push。目前暫不處理 ### 小疵 - `.env.bak.` 備份檔留在 `/opt/pokemon-radar-api/` 和 `/opt/gitea/data/gitea/conf/`，確認系統穩定後可刪 - 兩個 fetcher（`radar_fetcher.py` + `pokemon_location_fetcher.py`）篩選邏輯重複實作，合併到共用 module 是理想做法（但兩條 pipeline 短期共存，現在不急） - 前端 `API_URL` 仍 hardcode 在 `index.html`，未來要做 dev/prod 切換可抽 `config.js` 或用 `window.location.hostname` 判斷 - 前端空 items 用紅色 `showLoadError` 呈現，嚴格說這不是錯誤而是 SWR 暫態，可改中性 banner + auto retry - `pokemon-radar-api` 沒做 webhook 自動部署（還是手動 git pull + restart），若希望一致化可仿 `add-deploy.sh` 但加上 `supervisorctl restart` 步驟 ### 沒做但值得之後做 - 監控：webhook deploy 失敗時沒通知、API 500 時沒通知；可考慮 ntfy / Discord webhook 串起來 - Redis 在 42.108 Docker 裡，**沒設 persistence volume**；restart container 資料丟掉但 SWR 會自動重建，實務上無感。若以後需要 persist：加 `-v redis-data:/data` - `add-deploy.sh` 需要 Gitea token 當 arg，使用上每次要貼。可在 42.104 寫個 `/opt/git-webhook/.env` 放 `GITEA_TOKEN`，helper 自動 source - `pokemon-radar-api` 後端還是手動 `git pull + restart`。仿 `add-deploy.sh` 做一個帶 `supervisorctl restart` 的 deploy.sh 即可（需要 webhook container 能 ssh 進 host 執行 supervisorctl，或改用 host-level daemon）