這張卡做什麼（白話）

最終驗收：找一台乾淨的 Linux 主機，完全照客戶手冊把整條路真機走一遍——安裝、精靈開通、升級、回滾，加上各種「應該要被擋下來」的負面情境（竄改的 image、錯的 token、空的 machine-id、不相容的版本）逐一確認真的被擋。

• 母案 CM-1189：https://app.notion.com/p/FR-065-Installer-3bc346da4cd081c4abf3ce74a28ba384
• 所屬子需求卡 CM-1246：https://app.notion.com/p/FR-065-4-3be346da4cd08150a5eadfc9d1913073
• 設計文件：docs/features/FR-065-2608-onprem-installer/design.md §6（端到端驗收全文）

具體實作內容

全鏈場景（乾淨機器）：

1. 裝：解 bundle 執行 install.sh → 環境檢查過 → load＋digest 驗證過 → DB init 完成 → up 全組 healthy → 印出精靈網址＋setup token
2. 精靈：瀏覽器開站自動進精靈 → 貼 token → 建 admin（密碼自設）→ 看到機器指紋並複製
3. 開通：指紋送原廠簽照（模擬離線往返）→ 精靈匯入 .license → 進登入頁 → 登入後全功能可用（license 軸外不再 403）
4. 升級：舊版裝機後套升級 bundle --upgrade → 備份 → migration → recreate → healthcheck 全綠、資料保留
5. 回滾：restore 備份＋回舊 tag → 系統回到升級前狀態可用

負面案（全數要如預期拒絕）：

• 竄改任一 image tar → digest 比對失敗、明確報錯、不進入 load 後續
• setup token 錯誤拒入；admin 建立後一次性通道重放被拒
• /etc/machine-id 缺檔或空檔 → 環境檢查即擋（不進安裝，防指紋漂移）
• 升級版號區間不符 → --upgrade 拒跑

易踩雷提醒

• 「乾淨」是硬要求——用過的機器殘留 volume／network／舊 image 會遮蔽問題；每輪要能重置
• 驗收照 T-4.1 手冊操作（同時驗手冊可用性），不照自己記憶的流程