逐步遷移

安全的遷移方式是循序漸進。在您於 Development 中連接並檢查每個部分的同時，您的公開網站會維持原樣繼續運作。

確保安全的原則

• 設計不得改變。 無論 Atlas 是否有該頁面的內容，每個頁面看起來都必須完全相同。
• 備援是必要的。 如果 Atlas 無法連線，或某個頁面沒有任何已發布內容，網站就提供其內建內容。
• 使用文字，絕不使用 HTML。 CMS 的值以文字形式，或透過您的元件算繪。
• 先在 Development。 在發行版本通過檢查且經人員核准之前，任何內容都不會抵達 Production。

階段 1：連接一個頁面（約一天）

1. 在 Studio 中建立網站，並草擬一份只有一種頁面類型的最小合約。
2. 依照連接 Next.js 網站進行。
3. 在 Development 中發布該頁面，並與正式頁面比較。

完成條件： 該頁面由 Atlas 算繪、外觀相同，且在關閉 Atlas 的情況下仍能運作。

階段 2：為整個網站建模

1. 列出網站提供的每個路由，並將每個路由對應到一種頁面類型。
2. 撰寫合約套件：含具型別欄位的元件、含區域的頁面類型、集合、媒體設定檔，以及頁首與頁尾的全域內容。將它放在您的儲存庫中，檔名為 atlas/contract.bundle.json。
3. 驗證並提出申請。網站管理員在 Studio 中啟用它（Site setup）。
4. 重構每個頁面元件，讓 Atlas 的區段決定順序與內容，並以內建資料作為備援。

完成條件： Studio 顯示網站與使用中的合約 In sync。

階段 3：移轉內容與圖片

1. 以正確的媒體設定檔上傳圖片。切勿拉伸或放大；請列出不適合的圖片。
2. 為每個重複出現的項目建立項目，以資產 ID 參照圖片，並附上替代文字。
3. 以目前的內容填寫頁首與頁尾全域內容。
4. 依其頁面類型為每個路由建立頁面，並調整其區段，直到草稿與目前的頁面相符。
5. 起草翻譯，並請母語人士審閱。

透過 MCP 連接的 AI 程式碼代理程式可以將其中大部分作為草稿完成。由人員以 Preview on website 檢查每個頁面並發布。

階段 4：重新整理、SEO 與重新導向

• 加入 Webhook 接收端，讓發布後數秒內即可更新網站。
• 從 Delivery API 讀取 SEO 標題、說明與 noindex，並從 /routes 建立 sitemap。
• 載入 /redirects 並套用，讓舊的 URL 保有排名。

階段 5：上線

1. 訓練編輯者使用 Studio、草稿、預覽與發布。
2. 建立發行版本。Atlas 會檢查合約是否同步、是否沒有發布問題、網站是否正常，以及備份是否為近期的。
3. 具核准權限的人員核准。網站管理員開啟 Production，然後您建立 Production 傳遞權杖。
4. 以 Production 權杖部署您的網站。保留備援內容。

Production 提供什麼

Production 提供其正式發行版本中的內容、表單、聊天機器人與搜尋設定。預覽仍僅限 Development。確切步驟請依照上線進行。

還原

• 內容錯誤：還原到較早的修訂版本，或較早的 Production 發行版本。
• 程式碼錯誤：像現在一樣，重新部署您先前的網站建置。
• Atlas 無法使用：備援內容會提供內建內容，直到 Atlas 恢復。