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

項目	內容
版本	1.21.0-beta.3（預發版；FR-114 資安修正第 7、8 批。本版為內部測試包，僅供 190 e2e 專機總測，不對外發佈、不可交付客戶；總測通過再定正式 1.21.0）
發布日期	2026-09-26
上一版本	1.21.0-beta.2（2026-09-24）
涵蓋區間	BE `9ff0a5060`（v1.21.0-beta.2）..`fix/security-b1` 本進版 commit；FE `6f3a075`..本進版 commit；jedi monorepo 至 `35ba8e84`
涵蓋需求	FR-114 資安修正第 7 批（CM-2071、CM-2072、CM-2168～2196）與第 8 批（CM-2200～2229）
規模	jedi- 套件 10 支發新版（見第 5 節）；3 支主線 migration*＋2 支資料補齊 migration
適用部署	僅 190 e2e 專機總測。不部署 STG／POC
部署性質	190 移除 beta.2 後全新安裝（決策者裁定，不走升級）；安裝包以 `--skip-prod-key-check` 產出（缺 PROD 簽章鑰），不可出貨給客戶

0. 發版前回歸 gate¶

預發版不跑 site-regression 自動 gate。各卡都有本機實跑驗證（見各卡 commit message）；發版前另跑十支套件自己的測試、主專案守衛測試與本批改到的 47 支測試檔（812 passed），整體行為交給決策者在 190 總測。

1. 概述¶

這一版是資安總表第 7、8 批的修正集合：大量「知道網址就能看／改別人資料」的入口補上成員與歸屬檢查，匯入類功能擋掉會把伺服器拖垮的特製檔案，診斷包與日誌的敏感資料遮罩補齊，並拆掉一批沒人在用、卻沒有守門的舊網址。另外，落地版開放證據自動分類：分類改成隨安裝啟動的常駐服務，後端不再需要操作主機的 docker。

2. 使用者可見變更¶

2.1 新功能¶

落地版開放證據自動分類（CM-2223，併 CM-1871）：安裝後多一個分類服務（guidant-classifier），隨系統一起啟動；分類映像檔已包在安裝包內，不必另外下載。
同一個 Google 帳號只能接一個公司（CM-2204）：已經被別家公司接上雲端硬碟的 Google 帳號，再接會被擋下並提示原因。
雲端硬碟授權要在同一個瀏覽器完成（CM-2218）：授權連結轉給別人代按會被擋。

2.2 收緊的權限（操作會變）¶

落地版商務授權一律執法（CM-2205）：原本兩個「關閉授權檢查」的開關，現在只在 SaaS 有效；落地版沒買的模組一律用不了。
授權到期那一刻起即唯讀（CM-2217）：不再等排程；問卷即時填答也跟著唯讀。
超級管理員不是專案成員時，任務完成／退回／佐證／檢測回 403（CM-2147，beta.2 起；本版延續）。
規劃頁任務清單、匯入匯出、稽核團隊名單、稽核計畫選單與儀表板、任務進度查詢、流程圖編輯器增刪任務、重建專案雲端資料夾等處補上「必須是該專案成員／管理人」與「資料必須屬於網址上的專案」檢查（CM-2172、CM-2191、CM-2201、CM-2208、CM-2211）。
合規範本十三個讀取入口要有「看範本」權限；既有角色若能建專案或改範本卻缺這個權限，升級時自動補上（CM-2186）。合規範本寫入入口補齊能力點與租戶歸屬檢查（CM-2178、CM-2187）。
AI 儀表板的「自動產生」要有儀表板權限；查問卷資料要公司有買問卷模組（CM-2220）。
建資源庫只能用已發佈的框架版本（CM-2179）；刪框架／版本時若仍被資源庫引用會被擋下（CM-2180）。
建任務時任務類型必須在公司已授權範圍內（CM-2194）；問卷填答半邊補商務授權檢查。

2.3 退役的網址¶

稽核計畫：更新稽核計畫、重生草稿，以及 launch-audit／start-auditing／ar/finalize 三支直打推進網址（v1.20.0 已預告），任務設定樹、目前 SSP，共 7 支已拆（CM-2176、CM-2177）。
專案群組／控制項層的「成員」功能四支網址退役，前端對應按鈕與側欄一併拿掉（CM-2072）。
舊版 Drive 分類線九支網址退役，前端入口一併拿掉（CM-2222）。
/static/ 公開下載路徑關閉（CM-2219）。

2.4 其他修正¶

首次開通精靈重複送出只會建一家公司（CM-2216）。
建公司時自動補一個預設問卷資料夾，既有公司升級時回填（CM-2169）；沒有資料夾時新增問卷改提示先建資料夾。
SSP Excel 範本下載依權限拿掉人員 email 與設備 IP（CM-2188）；範本下載的使用者內容一律標純文字（CM-2189）。
匯入類（SSP Excel／Word、AP／AR、任務 Excel、CMMC PDF、YAML 範本）擋壓縮炸彈與超大輸入、失敗只回固定白話訊息（CM-2181～2184、CM-2190、CM-2203）。
回廠診斷包的遮罩規則補齊、暫存目錄改隨機名（CM-2193、CM-2212、CM-2214）；操作日誌與來源 IP 處理收緊（CM-2171）。
證據分類：送 AI 前清除內容裡的界線、依賴全部鎖版本與雜湊、工作目錄跑完即清、容器有資源上限（CM-2225～2227）。
出貨映像基底釘到固定 digest（CM-2229）。

3. Breaking Changes¶

第 2.3 節的網址全部回 404，前端已同步拿掉。
超級管理員非專案成員時，任務完成／退回／佐證／檢測回 403。
套件契約：jedi-ai-dashboard 必填接線多 capability_required；jedi-survey 新增選填 readonly_check（主專案已接上，搭舊版套件無法掛載問卷模組）；jedi-task-platform 任務進度查詢多必填 user_id。

4. DB Migration¶

檔案	類型	說明
`2026-09-25-fr114-ap-ar-parse-jobs-rls-fix.sql`	結構	AP／AR 解析工作單 RLS 改標準四條（子公司看不到母公司的）
`2026-09-26-fr114-drive-integration-email-unique.sql`	結構	同一 Google 帳號只能被一個租戶接著
`2026-09-26-fr114-8e-ssp-parse-jobs-tenant-check.sql`	結構	SSP 解析工作單寫入補租戶檢查
`2026-09-25-fr114-module-frame-read-capability-backfill.sql`	資料	缺「看範本」權限的角色補上
`2026-09-25-fr114-survey-default-folder-backfill.sql`	資料	沒有問卷資料夾的公司補一個

三支結構 migration 已併入出貨基線（scripts/init/02-schema.sql）；套件另帶 jedi-detection 006-detection-profiles-shared-scope.sql。

5. 相依套件版本¶

套件	v1.21.0-beta.2	本版
jedi-common	1.3.0	1.3.1
jedi-iam	1.4.3	1.4.4
jedi-ai-dashboard	1.3.0	1.4.0
jedi-detection	1.2.0	1.2.1
jedi-file-upload	1.3.1	1.3.2
jedi-survey	1.2.0	1.2.1
jedi-task-platform	1.2.0	1.3.0
jedi-compliance-audit	1.2.0	1.3.0
jedi-oscal-v2	2.4.0	2.5.0
jedi-evidence-classification	1.3.0	1.4.0

其餘套件與 beta.2 相同。

6. 部署順序（190 用）¶

188 build 機 BE／FE／套件三個 clone 都 git pull 到 fix/security-b1 本進版 commit，指定臨時 smoke 庫跑 build_all.sh --all，另 build 分類映像。
補 FE 標籤 guidant-ai-fe:1.21.0b3（FE 版號是 1.21.0-beta.3），build_bundle.sh --skip-prod-key-check 封包。
190 先備份資料庫，sudo guidant uninstall 移除 beta.2，確認沒有殘留的分類映像檔，再用本包全新安裝；授權匯入與開通精靈由決策者操作。

7. 已知 follow-up（不擋本版）¶

beta.1 第 8 節所列各項仍然有效。
190 走全新安裝，驗不到「升級時補寫分類服務共享密鑰」那條升級路徑，留到下一版升級時驗。
jedi-file-upload 有 2 條 migration 契約測試在 CM-1850 加了 RLS migration 後就紅（斷言沒跟上，非本版造成）。
多支套件子目錄的 poetry.lock 與 pyproject 不符（不進 wheel、不影響發佈）。

8. 正式版待辦¶

同 beta.1 第 9 節。