Emdash CMS 部署驗收與首次登入 FAQ
部署後的可執行驗收步驟、首次管理後台設定，以及「部分成功」狀態的排查。
部署後最先該驗證什麼？
三層驗收順序：
- 前端可達：首頁回傳預期內容。
- 管理後台可達：
/_emdash/admin能載入。 - 資料可寫：建立並讀取一筆內容。
僅路由可達不等於部署完成。
為什麼前端正常，管理端初始化卻失敗？
常見原因：
- 繫結不一致（
DB、MEDIA等） - 缺少環境變數或密鑰
- 為 Free 方案保留了不支援的設定
建議排查順序：先繫結，再環境變數，再方案層級限制。
首次登入管理端會發生什麼？
通常會：
- 建立管理員身分
- 註冊憑證（如 Passkey）
- 寫入初始系統狀態
此步驟依賴瀏覽器與帳號狀態，請在穩定網路與支援良好的瀏覽器中完成。
Passkey 設定失敗時先看什麼？
依此順序：
- 瀏覽器是否支援、Passkey 是否可用
- 系統時間是否準確
- 是否存在跨域或反向代理標頭問題
不要先懷疑資料庫——多數認證問題在客戶端或邊緣代理。
什麼是「最小正式驗收指令稿」？
可重複流程：
- 開啟前端首頁並記錄回應。
- 登入管理端並完成初始設定。
- 建立並發佈一則測試內容。
- 上傳一個媒體檔並驗證可存取。
- 確認前端能看到已發佈內容。
由此驗證路由、認證、寫入、儲存與讀取。
部署看似成功但內容缺失，從哪查？
最短路徑：
- 項目是否已發佈（非草稿）。
- 前端是否查詢了預期的集合。
- 查看執行階層記錄是否有查詢或權限錯誤。
多數缺內容來自狀態或查詢路徑，而非平台中斷。
團隊如何把驗收品質制度化？
納入發佈流程：
- 合併前：在本機或 staging 跑三層驗收
- 發佈後：值班同仁在 10 分鐘內執行最小指令稿
- 事故後：新增一條確定性檢查以防復發
可靠上線靠流程控制，不靠口耳相傳。
驗收命令片段
# 範例執行階層檢查
curl -I https://your-site.workers.dev
curl -I https://your-site.workers.dev/_emdash/admin
npx wrangler tail your-worker-name