UI Translator E2E Environment Setup¶
概念概覽
E2E 環境腳本設計¶
核心知識¶
E2E 環境腳本設計¶
backend/scripts/e2e-setup.sh 支援 --up、--down、--status 三種模式，底層呼叫 docker compose up -d --build。
健康檢查順序：
- PostgreSQL (port 5442)
- MongoDB (port 27027)
- Redis (port 6389)
- Nakama (port 7350)：先嘗試 /healthcheck endpoint，備用方案為 port 可達性確認
預設超時 120 秒，可透過 E2E_TIMEOUT 環境變數覆蓋。
MVP 驗收缺口識別¶
在這次對話中確認了三個關鍵缺口，所有測試都是各自的單元測試，缺乏： 1. 前後端實際聯調（Frontend 打 RPC 到 Backend） 2. E2E 流程驗證（命格生成 → 鎖定 → 章節閱讀 → 靈力消耗） 3. 網路連通性驗證（localhost:7350 是否有回應）
Makefile 整合¶
新增 .PHONY targets：e2e-up、e2e-down、e2e-status、test-e2e，包裝腳本呼叫。
經驗教訓¶
-
Nakama 的健康檢查需雙重備援：先試 /healthcheck API，再降級為 TCP port 可達性
-
E2E 腳本建立後需手動 chmod +x，Bash 工具在受限模式下無法自動執行
-
專案 MVP 驗收前必須明確區分「單元測試通過」與「前後端實際聯調通過」
常見陷阱¶
-
各服務 port mapping 與預設不同（Postgres:5442, Mongo:27027, Redis:6389），健康檢查 port 要跟 docker-compose.yml 對齊
-
沒有跑過真正的前後端聯調不等於串接完成，不能把單元測試當做整合測試的替代
相關概念¶
來源 Sessions¶
| 日期 | Session | 貢獻摘要 |
|---|---|---|
| 2026-04-11 | 38030a5c-54da-4873-9a63-680709c843f1 | 建立 ui-translator 專案的 E2E 環境啟動腳本，涵蓋 Nakama + Mongo + Redis + Postgres 健康檢查邏輯 |