交接 prompt — bugfix 後驗收 / debug 接手

此檔給 user 貼到新 session 開頭，讓接手的 Claude 立刻進入 context。

我從昨天 (2026-05-21) 的 SSP Excel Import Phase 2 bugfix session 接過來。

請先讀以下兩份文件理解 context：
1. docs/features/FR-011.2-2605-ssp-import-export-phase2/handoff/2026-05-21-bugfix-SUMMARY.md
   — 完整收尾報告，含 commits 清單 / 架構改動 / 已知 follow-up
2. compliance-manager-fe/CLAUDE.md L185+「Loading / 等待狀態規範」⭐
   — 本期強化過的規範

bugfix session 已 ship 28 個 commits (BE 13 + FE 15)，主要做了：
- A5 smoke 後 3 個 issue 修補 (實施狀態 / parties role / 設備資訊系統)
- AO statement_identifier (a)/(b) letter key 對齊
- template-edit 整頁 UX 重構成 TabView (7 tabs)
- 4 個 entity panel UI 統一 DataTable
- Loading 規範強化 + LoadingState 共用元件
- Parties N+1 fix + composable cache

目前狀態：
- 全部 commits 已落地，working tree 乾淨（pyproject.toml path dep dev mode 不 commit）
- BE 需要重啟才生效（path dep 模式不需 poetry update）
- FE 需要重新 build + 瀏覽器 hard refresh

我接下來要：[user 自行填寫，譬如「跑驗收 checklist」/「修我剛測到的 XXX bug」]

A. BE 起來能正常運作

• python main_socketio.py 啟動沒 import error / DI error
• tail -f log/app.log 沒 stack trace
• GET /api/1.0/module-frames 列出 MF 列表正常

B. template-edit 進入頁面

• 進 /module-frame/<uid>/template-edit 看到頁面層級 spinner「載入中...」
• 載入完看到 7 tabs（基本資料 / 適用控制項 / 單位 / 人員 / 設備 / 資訊系統 / 程序書文件池）
• 「編輯」menu 不見了
• 右上「批次維護」menu 順序：從文件匯入 / sep / 從 Excel 匯入+下載 Excel 樣板 / sep / 匯出+匯入現況資料

C. 基本資料 Tab 0

• 顯示 MF 名稱 / version / group / provider / frequency / status / description
• 改名稱後按「儲存」→ toast「儲存成功」+ 上方 header MF 名也更新

D. 適用控制項 Tab

• 顯示 tree（group → control → AO）
• tab 內容上方右側有「編輯適用控制項」outlined button
• 點 button 開 EditIncludeControlsDialog 正常

E. 單位 / 人員 Tab（最需要驗收）

• 切到單位 tab — 沒有一直轉圈圈 ← Stage 4 bugfix
• DataTable 顯示資料，column：單位名稱 / 角色+聯絡 / 鉤稽 / 操作
• 切到人員 tab → 沒有再 call 一次 API（composable cache 命中）
• 編輯 row → form 出現在頂部，鉤稽 picker 第 1 欄
• 儲存後 cache invalidate，新資料即時顯示
• tab badge count 數字正確顯示

F. 設備 / 資訊系統 Tab

• 顯示 Excel 匯入的 device / info_system
• 點「新增設備」→ Dropdown picker (filter typeahead) 撈 tenant /devices
• 選 picker 後 name 自動帶入；可手動 override
• 編輯 / 刪除 row 正常
• 鉤稽 Tag 顯示已連結 tenant entity 名稱

G. AO 實施狀態 / 現況說明（user 報過 bug）

• 點 control → AO 卡片展開
• AO 顯示 Excel 填的「實施狀態」(implementation_status)
• AO 顯示 Excel 填的「現況說明」(implementation_description)

H. UI 統一驗收

• 4 個 panel 視覺一致（同 DataTable 高度 / 同 column header 樣式 / 同 empty message 引導文字）
• 全部 loading spinner 用 LoadingState 元件

I. Loading 規範驗收

• 進頁面有 page-level spinner
• 切 tab 後 panel 內 spinner（如需重抓）正常
• 任何 button 點下後立即 loading 狀態（不會被連點兩次）

1. ssp-resources composable cache 沒做
   • 設備 + 資訊系統 panel 各打一次 /ssp-resources（兩 API call/page enter）
   • 如果 Network tab 看到打 2 次：補 useModuleFrameSspResources composable（pattern 跟 useModuleFrameParties 一樣）
2. jedi-oscal 發版
   • 整個 phase 結束 + user 明確指示後才做
   • bump 0.0.16 → 0.0.17，主專案 pyproject 改回 pin
3. dead code cleanup
   • partiesDialogOpen / sspResourcesDialogOpen / basicEditOpen / editMenuRef / editMenuItems / 對應 imports 都已 unreachable
   • 不影響功能，下個 phase 清

Working tree 該保持乾淨

git status
# 應該只有：
# - 修改: pyproject.toml         ← jedi-oscal path dep dev only，不 commit
# - 刪除: docs/conversation-history/*.zip  ← 看是否要重新加回
# - 未追蹤: docs/features/ssp-import-export-phase2.zip   ← 不該入版控
# - 未追蹤: ...CMMC_Level_1_blank_xxx.xlsx              ← 測試樣板，不該入版控

如果 git diff pyproject.toml 看到的是 dev-mode path dep 改動，不要 commit。

BE 重啟流程

# 1. 找 BE process
lsof -i :8000 | head
# 2. kill -9 (memory: nohup 留 orphan PID 用 kill -9 才殺得乾淨)
kill -9 <pid>
# 3. 重啟
python main_socketio.py
# 4. tail log
tail -f log/app.log

FE rebuild

cd ~/Projects/Billows/Audit-Manager/compliance-manager-fe
npm run build:DEV
# 瀏覽器 Ctrl+Shift+R (hard refresh 清 bundle cache)

接手後第一件事：跑上面 A → I checklist，把卡住的項目記下來，再決定下一步。