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

項目	內容
版本	1.21.0-beta.2（預發版；beta.1 在 190 e2e 專機試用後回報問題的修正版。本版為內部測試包，僅供 190 e2e 專機總測，不對外發佈、不可交付客戶；總測通過再定正式 1.21.0）
發布日期	2026-09-24
上一版本	1.21.0-beta.1（2026-09-24）
涵蓋區間	BE `74239a353`（v1.21.0-beta.1）..`fix/security-b1` HEAD（3 支修正 commit）；FE `dba0c24`..`9d2f962`（4 支）；jedi monorepo `73901919`..`7596692f`（1 支）
涵蓋需求	FR-114 資安修正派工的測試期修正：CM-2142、CM-2143、CM-2144、CM-2145、CM-2147、CM-2148
規模	jedi- 套件 2 支發新版（jedi-file-upload 1.3.1、jedi-issue 1.3.1）；無 DB migration*
適用部署	僅 190 e2e 專機升級總測。不部署 STG／POC
部署性質	從 1.21.0-beta.1 用 `install.sh --upgrade` 升級，既有資料保留；安裝包以 `--skip-prod-key-check` 產出（缺 PROD 簽章鑰），不可出貨給客戶

0. 發版前回歸 gate¶

預發版不跑 site-regression 自動 gate。本版每張卡都有本機實跑驗證（見各卡 commit message），整體行為交給決策者在 190 總測。

beta.1 裝上 190 之後，決策者試用回報了幾個問題，這一版全部修掉：上傳的檔案一律打不開、找回設定碼的提示路徑寫錯、公告列表看不出「全公司」、AI 分類設定頁一按新增就壞。修的過程中又順手查出兩個權限漏洞：超級管理員不是專案成員也能操作任務、「任務是否卡住」任何人都查得到。

上傳的檔案一律打不開（CM-2142）：beta.1 的「檔案歸屬檢查」在查詢資料庫之前就把連線關掉了，結果每個檔案都被判成「沒人認領」，下載、預覽一律回「找不到」。改成取檔和歸屬檢查在同一次資料庫連線裡做完，擁有者與專案成員可以正常下載；真正沒人認領的檔案仍然回「找不到」。意見回饋附件的歸屬查詢如果出錯，現在會留下錯誤紀錄，不再只剩一個「找不到」。
找回設定碼的提示寫錯路徑（CM-2143）：開通精靈與安裝完成畫面原本叫人 cat 一個寫死的檔案路徑，但資料目錄可以自訂，路徑常常是錯的。新增指令 sudo guidant setup-token：還沒開通時印出設定碼，已經開通就告訴你「設定碼已失效」。畫面上的提示也改成這條指令。
公告列表「公告部門」欄空白（CM-2144）：發給全公司的公告，這一欄現在顯示「全公司」。簡體中文介面補上發送範圍三個欄位的翻譯。
「AI 分類設定」分頁拿掉（CM-2145）：合規框架版本管理頁的這個分頁，按「新增設定」整頁會壞（正式包才會出現），清單也永遠是空的；而且一般使用者看不懂它是做什麼的。決策者裁定畫面拿掉、後端保留：出廠的通用設定照樣在背後生效，證據分類的行為完全不變。

超級管理員不再免專案成員檢查（CM-2147）：任務的完成、退回、佐證、檢測這幾條路，以前帳號層的超級管理員直接放行；問卷、任務詳情等其他路則一律要專案成員。現在統一：專案權限只看你是不是專案成員。超級管理員要操作某個專案的任務，需要先被加進該專案。
「任務是否卡住」查詢補成員檢查（CM-2148）：規劃頁查任務卡在哪個分支的查詢，以前只要登入、知道編號就查得到別人專案的內容。現在要是該專案成員（任何角色都可以）。

超級管理員非專案成員時，任務完成／退回／佐證／檢測會收到 403（見 2.2）。
jedi-file-upload 移除 UploadFileService.get_upload_file_raw，改為 assert_can_access_by_uid（只有套件內部的守門在用，主專案與其他套件都沒有呼叫點）。

無。scripts/init/99-stamp.sql 只重生基線版號字樣（__init_baseline_v1.21.0b2__），補登清單不變。

套件	v1.21.0-beta.1	本版
jedi-file-upload	1.3.0	1.3.1
jedi-issue	1.3.0	1.3.1

其餘套件與 beta.1 相同（見 v1.21.0-beta.1.md 第 6 節）。

188 build 機 BE／FE 都 git pull 到 fix/security-b1 本進版 commit，指定臨時 smoke 庫跑 build_all.sh --all。
補 FE 標籤 guidant-ai-fe:1.21.0b2（FE 版號是 1.21.0-beta.2），build_bundle.sh --skip-prod-key-check 封包。
190 先備份資料庫，再用安裝包的 install.sh --upgrade 從 beta.1 升上來，開通、授權、帳號與測試資料全部保留。

beta.1 第 8 節所列各項仍然有效。
jedi-issue 有 6 條整合測試因測試庫的 upload_files 表缺 tenant_id 欄位而紅（測試資料過期，不是本版造成）；jedi-file-upload 有 2 條 migration 契約測試在 CM-2142 之前就紅。

同 beta.1 第 9 節。