fix(runtime): 強化健康檢查監控韌性

docs/memory/ai_automation_closure_20260429.md

@@ -17,6 +17,8 @@
 - Grafana provisioning 已新增 `MOMO AI Automation Overview`，由 Prometheus `/metrics` 觀測 EventRouter、safe action、replay 與 AutoHeal 趨勢。
 - 2026-04-30 active Grafana 已載入 4 個 dashboard；AI dashboard 檔案同步到 188 實際掛載目錄 `monitoring/grafana/provisioning/dashboards/json/`。
 - 2026-04-30 active Prometheus 補 `momo-app` scrape job，目標 `momo-pro-system:80/metrics`；Prometheus 需加入 `momo-network` 才能解析 app container DNS。
+- 2026-05-01 active Blackbox HTTP target 改打 `/health`；188 stack 使用 `https://mo.wooo.work/health` + `http://momo-pro-system:80/health`，110 gateway stack 使用 `https://mo.wooo.work/health`。禁止再用 Dashboard 首頁 `/` 當探測目標，避免監控觸發重型查詢並和 `/health` 搶 worker。
+- 2026-05-01 Gunicorn runtime 預設 `gthread` + `GUNICORN_THREADS=4`，保留 `preload_app = False` 供 HUP 熱重載，同時讓輕量 health check 不被少數 Dashboard 長請求完全排隊。
 - 2026-04-30 發現並修復 `gunicorn.conf.py` `post_fork` 掃到 Flask/Werkzeug LocalProxy 導致 worker boot fail 的問題。
 - 2026-04-30 CD 健康檢查曾因 rebuild 後短暫 502 太早失敗；已改為 internal `docker exec momo-pro-system /health` + external `https://mo.wooo.work/health` 雙檢查，重試約 3 分鐘。
 - 2026-04-30 CD Sync 模式曾只 rsync + `docker compose up -d`，導致 host 檔案已是新版但 gunicorn process 仍跑舊版；已補 `docker compose restart momo-app scheduler telegram-bot`。
@@ -49,7 +51,7 @@
 - Grafana dashboard 檔案：`docker/grafana/provisioning/dashboards/json/ai-automation-overview.json`；provider 會載入 JSON 目錄，不需要修改 dashboard provider。
 - Active monitoring 使用 `monitoring/prometheus.yml`，不是 `docker/prometheus/prometheus.yml`；若線上 panel 無資料，先查 Prometheus 是否有 `momo-app` target。
 - Monitoring compose 的 cAdvisor 只需在 `monitoring` network 內提供 `cadvisor:8080` 給 Prometheus，不應綁定 host `8080`，避免與其他服務衝突；blackbox target 需要 `blackbox-exporter` 容器存在於同一 network。
-- 2026-04-30 線上驗證：目前 active MOMO UAT blackbox target 只保留 `https://mo.wooo.work`；`momo.wooo.work` 與 `wooo.work` 需等 DNS/Nginx 恢復後再加入 active monitoring。
+- 2026-05-01 線上驗證：188 active MOMO UAT blackbox HTTP target 保留 public `https://mo.wooo.work/health` 與 internal `http://momo-pro-system:80/health`；110 gateway Prometheus 也已把 `https://mo.wooo.work` 改為 `https://mo.wooo.work/health`；`momo.wooo.work` 與 `wooo.work` 需等 DNS/Nginx 恢復後再加入 active monitoring。
 - 110 Gitea runner 必須只宣告 `ewoooc-host` label；若混入 `ubuntu-latest` / `awoooi-host`，EWOOOC 與 AWOOOI workflows 會互相搶同一個 runner，導致推版卡住或跨專案污染。
 - CD sync 模式應對 `momo-pro-system` 發 Gunicorn `HUP` 熱重載，不重啟 app 容器；scheduler / telegram-bot 才用 compose restart。Gunicorn 必須維持 `preload_app = False`，否則 HUP 只重啟 worker、但 app object 仍來自舊 master 預載程式碼。
 - App container 的 runtime `gunicorn.conf.py` 由 `docker-compose.yml` bind mount；若未來改 gunicorn 設定，不應再手動 `docker cp` 作為常態流程。
@@ -66,6 +68,7 @@
 - 2026-04-30 Gunicorn LocalProxy 修復：新增 `tests/test_gunicorn_config.py`。
 - 2026-04-30 Prometheus scrape 修復：新增 `tests/test_prometheus_ai_automation_scrape.py`。
 - 2026-04-30 Monitoring exporter 修復：`tests/test_prometheus_ai_automation_scrape.py` 覆蓋 cAdvisor internal-only 與 blackbox exporter 宣告。
+- 2026-05-01 Health-safe monitoring runtime：`tests/test_gunicorn_config.py` 覆蓋 gthread/threads 預設與 override，`tests/test_prometheus_ai_automation_scrape.py` 覆蓋 blackbox 必須打 `/health`，`tests/test_cd_health_check.py` 覆蓋 monitoring reload 與 gunicorn bind-mounted sync。
 - 2026-04-30 CD health check hardening：新增 `tests/test_cd_health_check.py`。
 - 2026-04-30 CD Gunicorn mount hardening：新增 `tests/test_docker_compose_runtime_mounts.py`。
 - 2026-04-30 Metrics schema drift 降噪：`tests/test_ai_automation_metrics.py` 覆蓋 raw sales count query。

docs/memory/history_logs.md

@@ -66,6 +66,7 @@
 - **Vendor query service extraction**: Vendor V2 首頁統計與缺貨清單 query 移到 `services/vendor_stockout_query_service.py`，`routes/vendor_routes.py` 由約 1,821 行降至 1,675 行，回到 request parsing + template rendering，避免巨型 Blueprint 繼續承接資料組裝邏輯。
 - **Vendor stockout API query extraction**: `/vendor-stockout/api/stockout/list` 與 `/vendor-stockout/api/stockout/batches` 的 query/serialization 移入同一個 `services/vendor_stockout_query_service.py`，保留既有 JSON shape，`routes/vendor_routes.py` 再降至約 1,565 行。
 - **Vendor management query extraction**: `/vendor-stockout/api/vendor/list` 與 `/vendor-stockout/api/vendor/<vendor_code>` 的 query/serialization 移入 `services/vendor_stockout_query_service.py`，保留既有 JSON shape，`routes/vendor_routes.py` 再降至約 1,485 行。
+- **Health-safe monitoring runtime**: 健康檢查失敗盤點確認 Blackbox 打 Dashboard 首頁 `/` 會觸發重型查詢並和 `/health` 搶 worker；188 與 110 active blackbox 均改打 `/health`，Gunicorn 預設改為 `gthread` + `GUNICORN_THREADS=4`，CD 也會在 monitoring target 變更時重新載入 Prometheus/blackbox。
 
 ### 2026-04-28~29：Phase 3e 重構大戰 + daily_sales cache 隱形 bug 根除
 - **app.py 縮減 -10.8%**: 7,386 → 6,590 行，11 commits 全綠零 502。