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

Guidant AI v1.10.0 Release Note

項目 內容
版本 1.10.0（功能版號；主軸＝輪次隔離任務執行 FR-053/053.1 + 推進前置檢核 FR-051 + Notion bug-loop 大規模修復批）
發布日期 2026-07-24
上一版本 1.9.0（2026-07-20）
涵蓋區間 2026-07-20 ~ 2026-07-24
規模 4 個新功能案（FR-053 輪次隔離任務執行三刀 / FR-053.1 覆核輪承襲與脈絡 / FR-051 規劃推進前置檢核 / FR-052 雲端整合 Tab gate）+ 47 筆 bug 修復（Notion bug-loop 三 session 架構產出，涵蓋權限守門、匯入匯出、i18n、UX 提示等）+ 16 組 error code 撞號清理，跨 BE + FE + jedi-auth/jedi-issue 套件
適用部署 dev / staging（2026-07-24 已部署驗收，migration 已套）；poc / prod 待
部署性質 新增 5 支 DB migration（wecm round_id + 承襲標記欄 + 待辦 VIEW 輪次 + org_units RLS 對齊 + system-menu platform capability，均 additive/policy 級、零資料遺失）。含 jedi-auth 0.1.30→0.1.31、jedi-issue 0.0.12→0.0.13 換版（已推 Nexus）。BE 需 poetry update + 重啟；FE 需同版部署。

1. 概述

v1.10.0 是功能版號，兩條主線：

  1. 輪次隔離任務執行（FR-053 三刀 + FR-053.1 承襲）：根治「第二輪操作污染第一輪歷史」的結構性問題——job 過去全專案僅生成一批、任務狀態/證據/聊天/問卷跨輪共用覆寫。FR-053 三刀：①workflow_execution_control_mapping 加 round_id（接線 truth 落地）②launch_reverify 對 narrowed scope 生成新輪 execution+job ③讀取端（control-tree/dashboard/AR匯入/匯出）按輪過濾。FR-053.1 接力補承襲：覆核輪任務 clone 上輪配置（指派/問卷綁定/設備綁定）+ 證據/問卷填答 clone 帶「承襲自第 N 輪」標記 + 控制項卡上輪判定參照。
  2. Notion bug-loop 修復批：三 session 架構（調查/修復/裁決分工）四天內收斂 47 筆 fix，重點含多起權限守門修正（租戶 CRUD 下放、選單管理收歸 root、審閱權限 FE/BE 對齊）、匯入匯出管線修復（程序書關聯孤兒化、Excel 同名去重、樣板欄位補齊）、回饋附件租戶儲存管線接線、BE 密碼政策驗證（安全 finding）。

2. 新功能

FR-053 輪次隔離任務執行（三刀）

  • wecm 加 round_id，專案啟動回填 initial round；接線 truth 從 catalog AO props 轉移至 wecm（props 保留相容）。
  • 發起覆核（launch_reverify）對母輪 not_met 控制項生成新輪專屬 execution/job/wecm，不再共用母輪 job。
  • 讀取端全面按輪過濾：control-tree / AR 匯入 / dashboard / 匯出走 wecm-by-round；凍結輪控制母體改讀本輪 AP reviewed_controls（拆 profile 共用潛伏雷）。

FR-053.1 覆核輪承襲與脈絡

  • 覆核輪任務 clone 上輪配置：指派 / 問卷綁定 / 設備綁定，狀態一律 TODO 起手。
  • 證據 clone（新 row 同檔案）+ 問卷含填答 clone，均帶「承襲自第 N 輪」標記——稽核員可分清沿用 vs 新補。
  • 控制樹「上輪未通過」badge + 控制項卡上輪判定/缺失參照（讀母輪 AR）；task-execution/progress 統計補輪次。

FR-051 規劃階段推進前置檢核

  • 規劃→稽核（launch_audit）前兩項軟提醒（confirm 放行非硬擋）：本輪證據蒐集 job 未完成 / 流程模板 userTask 角色未指派，聚合單一彌窗。

FR-052 雲端整合 Tab 顯示 gate

  • 專案規劃頁「雲端整合」tab 僅在 tenant drive 已連接時顯示（fail-closed）。

其他能力

  • 待辦任務清單加輪次欄（含篩選；round_id NULL 舊資料顯示第 1 輪）。
  • 輪次名稱雙語化：顯示端改 round_no + round_type 依語系動態組字（FE composable 唯一出口），DB 零異動。
  • 建租戶自動 seed 部門/角色的 UI 告知 + 刪除被擋原因人話化（三個 409 文案）。

3. 重要修補（47 筆節錄，完整見 git log）

權限 / 安全：

  • 租戶管理：POST/DELETE 下放子樹管理員（capability 守門取代 platform-admin 硬門檻）+ 禁刪自己所在租戶（jedi-auth 0.1.31）。
  • 選單管理整個功能收歸 root tenant：system-menu.* capability 翻 is_platform + 清非 root 角色殘留掛載 + 管理端點 platform-admin 守門（前台下拉消費端點不受影響）。
  • 重設密碼 BE 補密碼政策驗證（≥12+大小寫+數字；政策可注入為未來動態化鋪路）——繞過前端設弱密碼的安全洞關閉（jedi-auth 0.1.31）。
  • 標記已審閱 reviewer 被 403：BE 對齊 FE 的 manager+reviewer 判斷。
  • org_units INSERT RLS 對齊其他三政策（租戶管理員可在非自掛部門下新增子部門）。

匯入 / 匯出管線：

  • 資源庫 Excel 覆蓋匯入不再孤兒化程序書關聯（snapshot-and-restore，CM-844/856）。
  • 現況樣板「適用控制項」sheet 補齊參考程序書欄（原硬編 None，CM-843）。
  • Excel/docx 匯入同批次同名去重全類型補齊；SSP 手動新增 dialog 同名查重（元件/外部授權/系統資產）。

檔案 / 附件：

  • 回饋附件上傳接上租戶儲存管線（原硬編 local /tmp，jedi-issue 0.0.13）+ remote_agent seek 潛伏 bug 修復 + 讀取端 fallback 防呆（缺同型 STORAGE_CONFIG 明確報錯不再抓錯租戶設定）。

基礎品質：

  • 16 組 BE error code 撞號清理（同碼不同語意）+ 全域唯一性 pytest 回歸鎖。
  • 全站錯誤 toast 去重（40 檔 147 處元件重複 toast 移除，全域攔截器唯一出口）。
  • 全站 SelectButton 改 outline 視覺 + 待辦任務分段按鈕統一。

4. Breaking Changes

無對外 breaking。error code 撞號清理僅改號不回溯（歷史 DB/log 舊碼不動）；選單管理收歸 root 屬權限收緊（非 root 租戶原可誤操作共用選單，收緊為修正）。

5. DB Migration（部署必套，依日期序）

檔名 內容
2026-07-22-fr053-wecm-round-id.sql wecm 加 round_id + initial round 回填
2026-07-22-org-units-insert-rls-align.sql org_units INSERT policy 對齊
2026-07-23-fr0531-inherited-from-round.sql 承襲標記欄
2026-07-23-vw-user-job-queue-add-round-info.sql 待辦 VIEW 輪次欄
2026-07-24-cm779-system-menu-platform-capability.sql system-menu capability 翻 is_platform + 掛載清理

一律 psql --single-transaction -v ON_ERROR_STOP=1 以 cmmgr 套用；dev/stg 已套，poc/prod 部署時補。

6. 相依套件版本

套件 版本 變更
jedi-auth 0.1.31 禁刪自身租戶 + 密碼政策驗證（policy 可注入）
jedi-issue 0.0.13 附件上傳服務可注入（向後相容）+ RemoteAgent seek 修復
其餘 jedi-* 同 1.9.0 pin 無變更

7. 部署順序

  1. DB migration（§5 五支，依日期序）
  2. BE：poetry update（拉 jedi-auth 0.1.31 / jedi-issue 0.0.13）→ 重啟
  3. FE：同版 build 部署（1.10.0）

8. 已知 follow-up

  • FR-054 租戶生命週期（軟刪除/復原/一條龍 admin 帳號）已登記待開工——本版揭露「provisioning seed × FK RESTRICT 致租戶天生不可硬刪」為其設計輸入。
  • FR-055 問卷匯出已登記待開工。
  • CM-719 BE 併發模型（gunicorn multi-worker 路線已定，待排程）。
  • 密碼政策動態調整（root 設定 UI）待登記 FR。
  • jedi monorepo push 因 GitLab 認證問題未完成，release commit 在本地待推。

9. 相關文件

  • spec 快照：docs/specs/v1.10.0/
  • FR 登記：docs/features/README.md（FR-051~055）
  • Notion bug-loop 戰況：docs/features/notion-bug-loop/loop-log.md
Guidant AI 功能 SPEC 手冊 v1.10.0｜本頁由 render_html.py 產生，內容源：specs/v1.10.0/release-notes/v1.10.0.md