更新 DevOps 手冊 runtime 指令

docs/guides/devops_handbook.md

@@ -15,12 +15,18 @@
 ### 常用操作
 - **查看狀態**: `docker ps | grep momo`
 - **查看日誌**: `docker logs -f momo-pro-system --tail 100`
-- **重啟主應用**: `docker restart momo-pro-system`
+- **熱重載主應用**: `docker kill -s HUP momo-pro-system`
+- **精準重建應用容器**: `docker compose up -d --no-deps --force-recreate momo-app`
+- **精準重建排程/Telegram**: `docker compose up -d --no-deps --force-recreate scheduler telegram-bot`
 - **全面啟動**: `docker compose up -d`
 - **進入資料庫**: `docker exec -it momo-db psql -U momo`
 
+紅線：
+- 禁止使用 `docker compose down` 或 `--remove-orphans`。
+- 禁止 stop/remove/recreate `momo-db`；資料庫生命週期需另走明確維護流程。
+
 ### 影像管理
-- **重建影像**: `docker compose build --no-cache momo-pro-system`
+- **重建影像**: `docker compose build --no-cache momo-app`
 - **清理過期資源**: `docker system prune -f`
 
 ---
@@ -40,10 +46,10 @@
 
 ---
 
-## ❄️ K8s 相關指令 (已撤除，備份存檔)
-- **查看 Pod**: `kubectl get pods -n momo`
-- **重啟 Deployment**: `kubectl rollout restart deployment/momo-app -n momo`
-- **查看日誌**: `kubectl logs -f deployment/momo-app -n momo`
+## ❄️ K8s / K3s 狀態
+已撤除。EwoooC 正式 runtime 是 188 主機的 Docker Compose，110 只作為 Gateway / Nginx / Gitea 等周邊服務主機。
+
+若看到舊文件提到 Pod、Deployment、PVC 或叢集操作，先以 `docs/adr/ADR-008-actual-runtime-on-188.md` 與 `docs/adr/ADR-011-cross-project-resource-isolation.md` 為準，不要照抄舊叢集命令。
 
 ---
 

docs/memory/claude_inventory_validation_20260513.md

@@ -63,6 +63,7 @@
 - AI 觀測台 V3 排版規範已補強：`scripts/check_responsive_overflow.js` 會把視覺 overflow offenders 視為失敗，並允許表格/圖表在 `.obs-table-shell`、`.obs-chart-frame` 等局部容器內滾動；`observability-system.css` / `web/static/css/observability-system.css` 已同步新增 bounded table/chart/mobile containment，CSS mirror 與 `quick_review.sh --observability-qa --skip-production` 均通過。
 - app.py/BP 路由雙寫已完成收斂：active `@app.route` 為 0，`USE_MODULAR_ROUTES` 與舊 routes registry shim 已不存在；`tests/test_phase3f_cleanup_contracts.py::test_app_py_stays_blueprint_only_for_routes` 會防止 route decorator 回到 `app.py`。
 - `app.py` 開頭的歷史「重開機後請依序執行」TODO banner 已移除；入口治理以 `AGENTS.md` / `CONSTITUTION.md` / ADR / memory 索引為準，`tests/test_phase3f_cleanup_contracts.py::test_app_py_does_not_start_with_stale_restart_todo_banner` 會防止 stale 操作清單回流。
+- `docs/guides/devops_handbook.md` 已移除活躍手冊中的舊 K8s command 區塊，並把 app 操作改為 Gunicorn HUP 熱重載、Docker Compose 精準 force-recreate、`momo-app` service build；`tests/test_phase3f_cleanup_contracts.py::test_devops_handbook_uses_current_docker_runtime_commands` 會防止 `kubectl`、`docker restart momo-pro-system` 與錯誤 compose service name 回流。
 - AI 觀測台 badge/chip 對比規範已補強：`.momo-observability-mode` 內的 badge、pill 與 nested surface 會改走亮底、8px radius、無負字距、可換行且不再殘留低對比 legacy dark-hero 樣式；CSS mirror、`quick_review.sh --observability-ui`、`quick_review.sh --observability-qa --skip-production` 均通過。
 - AI 觀測台 rendered visual contract 已入庫：`scripts/check_observability_visual_contract.sh` 會用 Playwright 檢查 10 頁 × desktop/tablet/mobile 的 title typography、surface radius/background、chip contrast、hero height 與水平 overflow；V10.116 main 版 local server 驗證 30 項 PASS。測未部署變更時必須帶 localhost `--base-url`，打 production fail 可能只是正式站尚未部署該版。
 - V10.117 已把 AI 觀測台背景語彙收斂為 tokenized dot-matrix：合約會要求 hero/signal/panel surface 的 computed `background-image` 是 `radial-gradient`，並拒絕 legacy `linear-gradient` / `background-image: none` 回流；終端 dot-matrix layer 必須留在 CSS 檔尾以贏過舊 neutralizer。

tests/test_phase3f_cleanup_contracts.py

@@ -275,3 +275,16 @@ def test_gitea_cd_uses_ewoooc_dedicated_runner_label():
     assert "runs-on: ubuntu-latest" not in workflow
     assert "runs-on: ubuntu-22.04" not in workflow
     assert "runs-on: ubuntu-24.04" not in workflow
+
+
+def test_devops_handbook_uses_current_docker_runtime_commands():
+    handbook = (ROOT / "docs" / "guides" / "devops_handbook.md").read_text(encoding="utf-8")
+
+    assert "kubectl" not in handbook
+    assert "docker restart momo-pro-system" not in handbook
+    assert "docker compose build --no-cache momo-pro-system" not in handbook
+    assert "docker kill -s HUP momo-pro-system" in handbook
+    assert "docker compose build --no-cache momo-app" in handbook
+    assert "docker compose up -d --no-deps --force-recreate momo-app" in handbook
+    assert "--remove-orphans" in handbook
+    assert "禁止" in handbook