手冊首頁／ Release Notes ／ Guidant AI v1.7.1 Release Note

Guidant AI v1.7.1 Release Note

項目	內容
版本	1.7.1（v1.7.0 後的 bugfix 收斂版；含租戶階層 RLS / 帳號匯入升級 / 審計欄位 nickname 等）
發布日期	2026-06-28
上一版本	1.7.0（2026-06-25）
涵蓋區間	2026-06-26 ~ 2026-06-28
規模	4 個功能（角色矩陣 TreeTable / 租戶 seed + 階層 RLS / 帳號 Excel 匯入升級 / 問卷清單效能）+ 多個 bug fix / tweak，跨 BE + FE + jedi-auth + jedi-common + jedi-survey
適用部署	dev / staging / poc（已套 RLS migration）；prod 待辦
部署性質	非破壞（程式修正 + RLS policy/函式調整，無 drop）。含 2 支 RLS DB migration + jedi-auth 0.1.22 / jedi-common 0.0.26 / jedi-survey 0.0.23 pin。多數修正為純程式碼，BE 需重啟生效。

1. 概述

v1.7.1 是 v1.7.0 之後的 bug 收斂 + 體驗強化版，主線：

租戶管理體系：角色/部門名稱唯一性改 tenant-scoped；新增租戶自動 seed 預設部門（System Administrator）+ 管理員角色（System Manager）；修正租戶階層 RLS（最上層租戶＝平台管理者、INSERT…RETURNING 可見性、空 allowed_tenant_paths 安全洞）。
帳號 Excel 批次匯入升級：下載範本改成依下載者權限動態產生（租戶/機關單位/角色 scoped 下拉）、角色逐列必填、上傳改兩步精靈 + dropzone。
審計欄位 nickname：6 個管理列表「建立/修改人員」統一顯示真名（主專案 app service 層 enrich）。
系統設定 / 表單體驗：必填欄位紅星標記補齊（前方統一）、系統設定頁 loading 統一、問卷清單狀態欄可排序、問卷清單效能（list 輕量投影）。

版本定位為 1.7.1（bugfix arc）；雖含數個功能項，整條 arc 屬 v1.7 收斂期，故走 BUG 版號。

/ui-routes 由扁平改回 pid+sort 巢狀樹（BE route 邊界組樹），前端純渲染 TreeTable（三態 aggregate/cascade、表頭全選、凍結表頭）。menu 巢狀化後扁平矩陣只剩空群組、無法指派權限的問題解除。

新增租戶 orchestration（@transaction 原子）：建租戶 → 建部門 System Administrator → 取 capability 全集扣停用模組（101）→ 建角色 System Manager。
角色/部門名稱唯一性改 tenant-scoped（跨租戶可同名；users login_name/email 維持全域唯一）。
租戶階層 RLS：最上層租戶（path 單層 /N/）成員視為平台管理者；tenants_select 改 row 自身 path inline 比對（修 INSERT…RETURNING 新 row 不可見）；空 allowed_tenant_paths 由 allow-all 改 deny。

審計欄位 nickname（6 頁）：資訊系統 / 專案摘要報告 / 崡航回饋 / 權限 / 帳號 / 問卷管理列表建立/修改人員顯真名（主專案 wrapper enrich，不改套件、不在 infra JOIN）。
必填欄位標記：多處表單/Dialog 補紅星，統一「前方」標記；修 /project/projects/new 前後雙星 + 星號換行。
系統設定頁 loading 統一：通知設定 / LDAP 補進頁 loading；儲存設備設定全螢幕遮罩改 card 範圍。
問卷清單狀態欄可排序：derived 狀態補 statusOrder sortField。
FE 批次：帳號 MTRBAC 編輯既有列 / 主要權限唯一、問卷管理批刪 / 資料夾批刪 / 設計器 Dialog、回饋 loading、麵包屑、專案清單解耦。
取消按鈕樣式統一（text → outlined）。

無對外破壞性變更。

註：jedi-common 0.0.26 的「最上層租戶＝super_admin」與 jedi-auth 0.1.22 的「角色/部門唯一性 tenant-scoped」屬全 consumer 行為調整，對多租戶語意為正確化，非破壞。

2 支 RLS migration（scripts/sql/，cmmgr、psql --single-transaction -v ON_ERROR_STOP=1）：

檔案	內容	dev	stg	poc	prod
`2026-06-28-fix-app-tenant-allowed-empty-path-allow-all.sql`	空 allowed_tenant_paths 由全部允許改一律拒絕（RLS 安全洞）	✅	✅	✅	⏳
`2026-06-28-fix-tenants-select-inline-path-for-returning.sql`	`tenants_select` 改 row 自身 path inline 比對（修 INSERT…RETURNING 新增租戶）	✅	✅	✅	⏳

無 drop / 無資料破壞；皆冪等可重跑。

套件	版本	變更
jedi-auth	0.1.22	角色/部門唯一性 tenant-scoped；帳號匯入逐列角色 + tenant-scoped 解析
jedi-common	0.0.26	session_scope：最上層租戶成員視為 super_admin（平台管理者）
jedi-survey	0.0.23	問卷清單 list 輕量投影（效能）

主專案 pyproject.toml 已 pin 上述版本；各環境 poetry update jedi-auth jedi-common jedi-survey + 重啟 BE。

symlink 陷阱：path-dep 切 pin 後若 editable symlink 殘留，清 site-packages 對應套件 + poetry install 再驗 realpath。