手冊首頁 ／ Release Notes ／ Guidant AI v1.8.2 Release Note
Guidant AI v1.8.2 Release Note
| 項目 | 內容 |
|---|---|
| 版本 | 1.8.2（BUG 版號；主軸＝site-regression 全站回歸網收官 + 實測 bug 批次修復） |
| 發布日期 | 2026-07-18 |
| 上一版本 | 1.8.1（2026-07-09） |
| 涵蓋區間 | 2026-07-10 ~ 2026-07-18 |
| 規模 | 全站 E2E 回歸網建置完成（438 scenarios，P0-P2 收攏 + 發版 gate 掛鉤）；實測揪出 18 條產品 bug、本版修復 15 條（含 🔴 安全 5 條），跨 BE + FE + 3 支 jedi-* 套件 |
| 適用部署 | dev / staging（2026-07-18 已部署）；poc / prod 待 |
| 部署性質 | 零 DB migration（純 code 修復）。含 3 支 jedi-*
換版（jedi-login 0.0.21 / jedi-auth 0.1.27 / jedi-survey
0.0.26）。BE 需 poetry update + 重啟；FE
需同版部署（SSP Excel 匯入 guard）。 |
1. 概述
v1.8.2 是 site-regression 全站回歸網的收官版 +
首次「以回歸網揪 bug、按批修復」的實踐。回歸網（test repo
site-regression/）自 07-10 起建置，本區間完成 P2 六包 22
頁量產與發版掛鉤（Phase 3+4），全站 66 頁三級覆蓋收攏為 438
scenarios / 2573 steps；量產過程實測揪出 18 條產品
bug（每條均經源碼核實 root cause），本版修復其中 15 條。
版本定位 1.8.2（BUG 版號）：對 user 無新增功能，全部為缺陷修復；回歸網屬工程資產不影響產品行為。
2. 修復內容（15 條，按批次）
🔴 安全類（5 條，優先等級最高）
| # | 修復 | 位置 / commit |
|---|---|---|
| 1 | 帳號停用＋登入鎖定雙 gate
被繞過：密碼比對正確時無條件重置
status/login_failed_count 於狀態檢查之前 →
停用帳號密碼正確即自動解停用登入、鎖定對「密碼已知」情境無效。修法：鎖定閘門前移至密碼比對前（驗證前快照）＋成功分支只放行
INACTIVE→ACTIVE（REVOKE/DELETED 不解除） |
jedi-login 0.0.21（d4cd986） |
| 2 | 24hr 改密冷卻形同虛設：冷卻查詢誤用
id=（log 表自身 PK）應為 user_id= →
AUTH_429001 永不觸發 |
jedi-auth 0.1.27（d4cd986） |
| 3 | 忘記密碼帳號列舉：不存在信箱回
404「使用者信箱不存在」逐字上畫面 → 可批量探測帳號。修法：route 層攔
AUTH_404002 回與成功相同的 200 空 data（5
分鐘節流保留） |
BE bb0d053d |
| 4 | 無效 reset token 回 500 非
401：expired 欄位 naive/aware datetime 比較
TypeError 逃逸為 COMMON_500001 →
失效連結顯示「內部伺服器錯誤」而非友善提示。修法：比較前正規化
UTC-aware（對齊 sibling 方法既有做法） |
jedi-auth 0.1.27（d4cd986） |
| 5 | 資源庫 defaults 不驗
control∈profile：MODULE_FRAME_400001 定義但零
raise。修法：新建 IR 分支補 guard（既存 23
條違規資料維持可編輯，不連帶鎖死——資料清理另案） |
BE ef87eb84 |
匯入端 500（3 條——壞檔應 graceful failed 卻直接 500）
| # | 修復 | 位置 / commit |
|---|---|---|
| 6 | docx 匯入（module-frame-import ＋ project-ssp-import-docx 兩頁共用
service）：_normalize_docx_revisions 開檔移入 try 範圍 |
BE ef87eb84 |
| 7 | 框架 PDF 匯入：GrcErrorCode Enum 誤當 tuple 拆
TypeError → 改 .value 正確取值 |
BE ef87eb84 |
| 8 | SSP Excel 匯入壞檔繞過：FE 只檢查 parse_uid 忽略
status='failed' → 壞檔進預覽頁。兩處（SspTabPanel /
ImportExcelPage）補 status guard |
FE 911a2f2 |
功能類（7 條）
| # | 修復 | 位置 / commit |
|---|---|---|
| 9 | 新增問卷可同名：verify_survey_exist_by_name create
路徑死碼（if…and uid 永 false）→ create/update 都生效 |
jedi-survey 0.0.26（d4cd986） |
| 10 | 新增資料夾可同名：同款死碼＋順修 add_folder pid 誤塞
uid 參數位 |
jedi-survey 0.0.26（d4cd986） |
| 11 | 空白問卷 POST 500：for page in pages 無 null guard →
新增 SURVEY_400001 擋下 |
jedi-survey 0.0.26（d4cd986） |
| 12 | PSR 版本歷史「目前版本」誤標：histories 查詢無 ORDER BY → repo 層補
created_at DESC（FE i===0 語意隨之正確） |
BE 94d33dda |
| 13 | my-audits 合格圓點恆 0：serializer dump key passed vs
FE 讀 pass → BE 補 data_key="pass" |
BE 94d33dda |
| 14 | remote-agent revoke/unrevoke 靜默重置
enabled=true：entity 建構子非 None 預設值撞
BaseRepositoryImpl 部分更新語意 → 預設值改 None（一點收斂
revoke/unrevoke/rebind/heartbeat 全家族；順修 agent_type
同款） |
BE 94d33dda |
| 15 | tenant 403 文案文不對題：GRC_NOT_PLATFORM_ADMIN
共用文案改中性 |
BE 94d33dda |
未修（3 條，均已記錄）
- survey designer 子題/流程規則存不進去：查證定性為功能缺口非 bug（子題 pid BE 完整、flowRules v2 零持久化、v1 曾有 goto 跳題上線後重寫斷鏈）→ 開 FR-049 正式補回（design 已拍板）。
- 2 條 07-10 舊修復（org-units tenant_id
5a621412、job_title38b38758）已隨本版部署生效。
3. Breaking Changes / 契約變更
無。忘記密碼端點對「不存在信箱」由 404 改 200 空 data（防列舉）——FE 無需配合改動（本來就只處理成功分支）；其餘修復均為行為修正非契約變更。
4. DB Migration
無。本版零 schema/資料變更。
5. 相依套件版本
| 套件 | 版本 | 變更 |
|---|---|---|
| jedi-login | 0.0.20 → 0.0.21 | 安全修復 #1 |
| jedi-auth | 0.1.26 → 0.1.27 | 安全修復 #2/#4 |
| jedi-survey | 0.0.25 → 0.0.26 | 功能修復 #9/#10/#11（新增 SURVEY_400001） |
三套件已發布 Nexus。
6. 部署順序
- BE：拉 code →
poetry update（裝上表三套件新版）→ 重啟（無 hot reload） - FE：部署
911a2f2（同版上線，SSP Excel guard） - 無 migration 步驟
- 部署後驗證：site-regression 移除對應
@known-bugtag 回歸（~14 條）、7 帳號登入手測（修復 #1 重點：鎖定第 4 次正確密碼應被擋、停用帳號應被擋）、過期/無效 reset token 應回 401 非 500（修復 #4 為靜態修復，需 live 確認）
7. 發版 gate 紀錄（version-bump Step 0，本版首次執行）
- Core 檔位（@P0 or @P1，226 scenarios）對已部署新 build 實跑：200 passed / 26 failed（58m02s）
- 26 條失敗經逐條裁決為環境負載假紅非產品回歸（user 明示豁免）：錯誤全為 timeout 型零斷言失敗、失敗集群（SSP 五頁/planning 兩頁）與部署前舊 build 基準輪高度重疊（28 條）、截圖實證卡「載入中」轉圈與「操作成功但畫面刷新慢於斷言」兩型。根因：STG 累積 600+ E2E 專案後 SSP/專案類查詢劣化至 12-15s+（07-11 同頁 2-3s）
- 衍生 follow-up（效能調查，另案）：600 專案量級不應造成此劣化斜率，疑 N+1/缺 index/解析誤用——見 §8
8. 已知 follow-up
- SSP/專案類查詢效能調查（user 拍板，優先）：小資料量下的不合理劣化，疑結構性問題（N+1 / index / ProfileResolution 誤用 / RLS 注入成本）
- STG E2E 殘留清理（600+ 專案，專案類無安全批次刪除機制）＋ SSP 類頁 timeout 校準——gate 假紅止血項
- 23 條既存違規 defaults（CMMC 兩 module frame）清理決策（修復 #5 只擋新建）
- ~15 個 entity「建構子預設值撞部分更新」家族疑慮清單（修復 #14 同款 pattern，需逐一驗 caller）
- agent 自我重註冊顯式復活
enabled行為確認 - FR-049 問卷流程規則補回（design 已拍板，implementation plan 進行中）
- user-log retention 排程未接（15 萬+ 筆只增不減）
9. 相關文件索引
- 回歸網總帳：test repo
site-regression/docs/tracker.md（Phase/WP/bug 表）＋traceability.md（66 頁明細） - Bug
批次修復交接：
docs/issues/pending/2026-07-17-site-regression-bug-batch.md - Spec 同步：
fc04863d（17 頁實測回饋，FR-048 守門實況＋已知 bug 註記） - FR-049
設計：
docs/features/FR-049-2607-survey-flow-rules/design.md - Notion 追蹤：SITE-REG case（4 個細節子頁）