wooo/ewoooc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

記錄觀測台視覺契約守門

Browse Source
This commit is contained in:
OoO
2026-05-13 18:47:36 +08:00
parent b6e65733a7
commit c10e6a45e7
1 changed files with 5 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/memory/observability_ui_qa_guardrails_20260505.md
View File

@@ -19,6 +19,7 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下
- Production smoke：`scripts/check_observability_pages.py`
- 一鍵 QA：`scripts/check_observability_suite.sh`
- CSS mirror sync：`scripts/sync_observability_css.py`
- 渲染後視覺契約：`scripts/check_observability_visual_contract.sh`
## 必跑指令
@@ -30,12 +31,13 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下
./scripts/quick_review.sh --observability-qa
```
指定環境或只跑靜態 guard：
指定環境、渲染後視覺契約或只跑靜態 guard：
```bash
./scripts/quick_review.sh --observability-smoke --base-url https://mo.wooo.work --timeout 12
./scripts/quick_review.sh --observability-qa --base-url https://mo.wooo.work
./scripts/quick_review.sh --observability-qa --skip-production
./scripts/quick_review.sh --observability-visual --base-url http://127.0.0.1:5016 --timeout 20
./scripts/quick_review.sh --observability-help
```
@@ -45,6 +47,7 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下
python3 scripts/sync_observability_css.py
python3 scripts/sync_observability_css.py --check
bash scripts/check_observability_suite.sh
bash scripts/check_observability_visual_contract.sh --base-url http://127.0.0.1:5016 --timeout 20
```
## 重要陷阱
@@ -55,6 +58,7 @@ bash scripts/check_observability_suite.sh
- Production smoke 必須看到 `觀測台 CSS: HTTP 200, markers=ok`。
- 觀測台頁面清單、URL、`active_page`、內容 marker 不要分散維護，先改 `scripts/observability_contract.py`。
- `quick_review.sh --observability-qa` 預設打 production `https://mo.wooo.work`；測 staging/localhost 時要明確帶 `--base-url`。
- `quick_review.sh --observability-visual` 也預設打 production；驗證尚未部署的本機變更時，必須先啟 Flask local server 並明確帶 `--base-url http://127.0.0.1:<port>`。若打 production 失敗，先確認正式端是否已部署該版，不要把舊版正式站結果誤判成本機 diff 失敗。
- Gitea CD 會偵測觀測台 template/CSS/route/QA script/guide 變更：deploy 前跑 CSS mirror check + static QA，deploy 後跑 production smoke。QA script 範圍包含 `quick_review.sh`、`check_observability_*`、`observability_contract.py`、`sync_observability_css.py`。CD 不會偷偷修 mirror；若 check fail，先本地跑 sync 後提交。
- CD 觸發判斷集中在 `scripts/check_observability_deploy_gate.py`；不要在 `.gitea/workflows/cd.yaml` 另維護一份長 regex。
- `check_observability_suite.sh` 會跑 deploy gate self-test，確認觀測台相關檔案會觸發 QA、一般 backend/docs 檔案不會誤觸發。