Guidant AI v1.20.0-beta.2 Release Note（預發版）¶

項目	內容
版本	1.20.0-beta.2（預發版；beta.1 之後的增補版——內容主軸不變，見 v1.20.0-beta.1。本版新增三張卡的修正與八支套件進版。僅供 e2e 測試機驗證，不對外發佈）
發布日期	2026-09-15
上一版本	1.20.0-beta.1（2026-09-14）
涵蓋區間	2026-09-14 ~ 2026-09-15（BE `94370738`..`HEAD` 20 commits；FE 3 commits；jedi monorepo 7 commits）
涵蓋需求	FR-096 租戶邊界與顯示正確性前端修正（CM-1801）／FR-089 套件碼表清理與撞號正名（CM-1802）／FR-090 教學文件對齊取用口寫法（CM-1751）
規模	jedi- 套件八支進 1.1.2*（其餘維持 1.1.0／1.1.1），已推 Nexus、BE pin 已改
適用部署	僅 e2e 測試機（190）。不部署 STG／POC
部署性質	無 DB 結構變更。beta.1 的 migration 已在 190 套用完畢，本版是純程式碼增補

1. 為什麼出這一版¶

beta.1 裝上 190 之後，決策者手測發現三件事，另有一批套件碼表問題是查 bug 時順帶掃出來的。三張卡都已完成並驗收，但改動散在主專案、八支套件與前端三處——套件的改動不重出安裝包就看不到，故出 beta.2 供手測。

本版不含任何資料庫結構變更，190 現有資料不受影響。

症狀：新增角色、權限勾到「合規框架」按存檔，跳出一串資料庫技術訊息，角色建不起來。

原因：合規框架這個功能的四個動作被切在兩層——「檢視」一般租戶就能給，「新增／修改／刪除」屬原廠保留、只有最上層租戶的角色能持有。前端照功能分組勾選時把整組四個一起送出，後三個被資料庫規則擋下。

修法：權限模型維持現狀（決策者裁「合規框架通常是由系統釋出，不會由 User 自己維護」，現行設計與此一致），只改前端送出的內容。矩陣現在會判斷兩件事——我自己拿不拿得到、以及正在編輯的這個角色收不收得下，兩條缺一不可。畫面上另加「原廠保留」標籤，講明這組只有檢視可授予，不靠靜默。

連帶補了一個更隱蔽的洞：最上層管理員替子租戶建角色時，後端會把平台層權限全數回給他（他自己確實有資格持有），但資料庫規則判的是「角色屬哪個租戶」不是「誰在操作」，照樣會失敗。這條在 beta.1 也存在，本版一併修掉。

原本切換租戶是原地重新整理。若當下停在某個專案或資源的詳細頁，網址帶著舊租戶的資料編號，重整後拿去查新租戶就查不到、畫面報錯——那是租戶隔離正常運作的結果，不是壞掉，但使用者只看到一個錯誤。現在改成切換後回到首頁。

順帶補了兩個缺口：切換失敗時會把身分完整切回原租戶並提示（原本 header 已經改掉、使用者卻停在原地，不知道自己算哪個租戶）；切換語系時租戶選單不再長出重複項目。

症狀是標題印成「Access Control null (4)」。控制項目錄的群組本來就沒有描述欄位，前端組標題時把空值直接印出來。兩支畫面同因，一併修正。

三個錯誤碼原本被兩個語意不同的情況共用，前端只認字串、因此只能顯示其中一句——例如改分享設定被擋，畫面卻說「無權切換至該租戶」。本版把主專案那一側改開新號，訊息與動作對上。

兩個維持原狀：「任務非處理中」與「SMTP 設定不存在」兩個碼已寫進 v1.8.0 交付給客戶的設計文件，改號會讓文件與系統對不上，故不動、只在程式碼註解寫明代價。

套件碼表清理（CM-1802）：刪掉 jedi-log 裡 71 個沒有任何地方引用的上古錯誤碼（留著的風險是有人誤以為是現役的拿去用，而它的值與主專案不同）；jedi-remote-agent 指向已刪目錄的過期註解改寫成現況。
新守衛擋碼表撞號：主專案與 21 支套件各自管自己的號段、互相看不見，開新號時撞號是系統性的而非誰粗心。新守衛掃套件自有碼表對主專案，語意相同的刻意鏡像自動放行、語意不同就紅。突變驗證做過三種情境。
能力點清單補回 is_platform 欄位（jedi-iam）：這個事實資料庫早就有，只是斷在傳輸物件那一層沒往前端吐。純新增欄位，不改既有行為。
教學文件對齊實際寫法（CM-1751）：主專案要用套件的服務時該怎麼拿，文件原本教的是已被守衛擋掉的舊寫法。兩份教學改成現行的「從套件取用口拿」，並補上兩個實際踩過的坑（組裝時機、深拷貝遞迴）。

八支進 1.1.2（已推 Nexus，BE pin 已改）：

套件	為什麼進版
`jedi-iam`	能力點清單補 `is_platform`
`jedi-compliance-audit`	鏡像碼表跟著正名
`jedi-common`／`jedi-file-upload`／`jedi-notification`／`jedi-flow-engine`	碼表共用關係註解
`jedi-log`	71 個死碼整檔刪除
`jedi-remote-agent`	過期註解改寫

jedi-survey 與 jedi-task-platform 維持 1.1.1（源碼已對齊），其餘維持 1.1.0。

無 migration，190 直接 install.sh --upgrade 即可；同版號重出要加 --force。
本包與 beta.1 同樣缺正式環境授權簽發鑰（尚未建立，非故障），封包時以 --skip-prod-key-check 略過——不可交付客戶。