|
|
2f7285437b
|
feat: /scan 採 stale-while-revalidate，閒置時零呼叫
- /scan 永遠秒回當前 Redis 快取，若 TTL < STALE_THRESHOLD 或 key 不存在，用 daemon thread 呼叫 radar_fetcher.main() 非同步更新
- 以 Redis SET NX EX 當互斥 lock（pokemon:radar:fetching，TTL 180s）避免並發 fetcher
- 新增設定：STALE_THRESHOLD=120、FETCH_LOCK_KEY、FETCH_LOCK_TTL=180
- 原本需要 cron 定期跑 fetcher；現在 API 端會自動觸發，沒人打就不動
驗證：
- cold start /scan: 26ms 回空、同時搶 lock
- 背景 fetcher 跑完（~16s Function Server）後寫入 Redis 並釋放 lock
- 下一次 /scan 13ms 回 96 筆、TTL 299s
- 快取新鮮時重複打 /scan 不會重複觸發（refresh counter=1）
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-20 09:30:53 +08:00 |
|
|
|
c95d6074d5
|
docs: 合併成單一 README（寫給一年後回來看的自己）
- 常用指令放最上面，.env 和 API 速查在中間，架構與故障排除在最下面
- QUICKSTART / SUMMARY 砍掉，WHY 融進架構段
- 移除「給新人入門」的 step-by-step 路徑
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-20 09:22:56 +08:00 |
|
|
|
da5a36e8ad
|
security: 移除 hard-coded FUNCTION_TOKEN，改從 env 讀取
- pokemon_location_fetcher.py：DEFAULT_URL/TOKEN 改走 os.getenv，並補 load_dotenv() 讓 fetch_and_upload.sh 能從 .env 取值
- run_pokemon_radar_api.sh：POKER_* 改為可由環境覆蓋（實務上未被 API 使用，保留結構）
- pyproject.toml：補宣告 python-dotenv（專案已使用但原本未列）
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-20 09:17:24 +08:00 |
|
|
|
f7ef105436
|
init: Redis-backed Pokémon 雷達 API
- radar_fetcher.py：呼叫 Function Server 抓 twpkinfo.com 資料後寫入 Redis (TTL 300s)
- pokemon_radar_api.py：FastAPI /scan，從 Redis 讀取並依 request 即時二次篩選；Redis 不可用時回 200 空結果，不再 500
- pokemon_location_fetcher.py：舊版 CLI，仍由 fetch_and_upload.sh 使用
- 文件：README (參考手冊)、QUICKSTART (操作指南)、SUMMARY (故事線)、CLAUDE.md
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-20 09:13:59 +08:00 |
|
