版本與升級維護

版本與升級維護用於讓 FactVerse 環境保持更新，同時保護生產運行。流程應明確版本範圍、審核、維護窗口、驗證、溝通和回復預期。

前提條件

安排生產變更前，先確認部署模型、產品範圍、客戶變更流程、維護窗口、驗證負責人和回復條件。

發布流程

輸入資訊

輸入	範例
版本範圍	平台更新、產品模組更新、連接器變更、憑證續期、安全修補程式。
影響使用者	操作員、管理員、整合負責人、行動端使用者、AI 工作流程負責人。
驗證計畫	登入、產品導覽、關鍵工作流程、連接器任務、API Key、報表、文件存取。
維護窗口	日期、時間、預計時長、溝通負責人、升級路徑。
回復條件	暫停、回復或改期的判斷條件。
已知問題	已接受限制、臨時處理方式和後續負責人。

變更類型

類型	典型驗證
平台版本	登入、租戶存取、導覽、產品 smoke test、關鍵整合。
產品模組更新	目標產品工作流程、角色權限、資料顯示、使用者驗收樣本。
連接器或資料變更	來源連接、映射、樣例記錄、同步計畫、失敗處理。
憑證或網域變更	瀏覽器存取、客戶端存取、SSO 回呼、API 呼叫、監控檢查。
API 或 MCP scope 變更	工具發現、允許呼叫、服務身分歸屬、稽核記錄。

驗證步驟

1. 確認環境和版本範圍。
2. 與產品負責人評審版本說明或變更描述。
3. 確認受影響使用者、整合和關鍵工作流程。
4. 為維護窗口準備驗證清單。
5. 溝通時間和預期影響。
6. 套用版本或配置變更。
7. 驗證登入、租戶存取、產品工作流程、整合和監控。
8. 溝通完成情況、未關閉問題和後續負責人。

溝通清單

維護窗口前，應告知受影響使用者哪個環境將發生變化、窗口開始時間、預計持續時間、使用者存取是否可能中斷、哪些工作流程應暫緩，以及窗口期間由誰負責支援。變更完成後，應溝通結果、驗證狀態、已知問題、臨時處理方式和後續負責人。對於影響整合的變更，還應通知來源系統負責人和排程任務負責團隊。

溝通內容應事實清楚、簡短直接。版本通知的目標是幫助使用者安排工作，並幫助支援團隊識別預期行為。只有當變更引入使用者需要採用的可見業務能力時，才適合使用更偏產品發布的表達。

預期結果

約定驗證清單通過、客戶負責人了解結果、未關閉問題已記錄、支援團隊理解新行為或臨時處理方式後，版本維護才算完成。

常見問題

現象	檢查
發布後使用者回報權限缺失	角色包、租戶成員、工作階段刷新、導覽權限或產品權益變化。
客戶端表現和 Web 控制台不一致	客戶端版本、環境設定、SSO 跳轉支援、快取或功能支援範圍。
升級後連接器失敗	憑據、schema 變化、來源系統可用性、網路路徑或連接器配置。
回復決策不清	預先約定的回復條件、業務負責人、技術負責人和影響說明。