SSP OSCAL Alignment — Phase 4 COMPLETE SUMMARY — 2026-05-25

Phase 4 demo gap 全收尾：FE v3 樣板上傳 preview 不再空（L5）+ SSP 編輯第四 tab 可 inline CRUD（L2）+ BE write endpoints 對外暴露（L1a）+ 舊 3 tab 從 SSP edit 移除（L3）+ i18n keys 從 fallback 移到正規 namespace（L6）。L4 5-tab 結構因 spec under-defined + user 拍板「控制項本來就沒有」維持現狀 4 tab。

FE（3 commits，baseline bd23047）

BE（2 commits，baseline c3c94473）

Memory 更新：無新增（本期沒新行為規範可記入）。

3.1 Excel 上傳 preview 不再空（L5）

• v3.0.0 樣板上傳後進入 preview，「元件清冊 / 利用授權 / 資產清冊」三 tab 顯示完整內容（不再空白）
• v1.x in-flight parse_jobs 也走 v3 preview（v2_bundle.py 對 v1 樣板 derive v3 keys）
• 「devices / info_systems / leveraged」舊 tab 從 preview wrapper 消失

3.2 SSP 編輯第四 tab 可 inline CRUD（L2）

• 「元件 + 授權 + 資產」整合 tab 加 3 個 Add/Edit Dialog + per-row Edit/Delete + 新增 Button
• Component dialog 9 fields（含 14 OSCAL component_type enum + 5 status enum + leveraged_authorization Dropdown）
• LeveragedAuth dialog 8 fields（含 date_authorized Calendar + 4 category enum）
• Inventory dialog 10 fields（含 implemented_components MultiSelect chip picker；Edit mode 對 M2M field disabled + hint）

3.3 SSP 編輯舊 3 tab 全消失（L3）

• 「設備（舊）/ 資訊系統（舊）/ 外部利用服務（舊）」3 tab 從 SspTabPanel 移除
• 舊 deep-link query string (?section=scope_devices etc.) 仍可用 — redirect 到整合 tab (index 3) 保留書籤兼容
• MF /template-edit 仍用舊三檔 vue 元件（apiBase='module-frame'），不受影響

3.4 BE 新 endpoints（L1a）

• inventory.update_item 對 M2M (implemented_component_uids) silent skip + log warning（per entity §Mutation contract — 改 M2M 必須 delete + recreate）

3.5 i18n keys cleanup（L6）

• 新 lang.ssp_components_leveraged_inventory.* namespace（zh-tw + en），約 30 key
• lang.common.action 補進 common.json（兩 locale）
• vue 檔 missing key 不再依賴 fallback —— missing key 走 vue-i18n fallbackLocale='en' 接住 + console warning

L4 5-tab 結構 sub-item 全 skip — 未來 phase 才做

per §11.20，三個 sub-item 都需要 spec 先補才能 execute：

1. SC 拆 (從 SspBasicSection 拆出獨立 tab) — 需 user 對 UX 對齊「拆」的具體意思
2. 單位 + 參與人員合併 — 需 UX 設計（兩 party_type 在一個 panel 怎麼 filter / switch）
3. 控制項 tab — user 拍板維持「沒有」（TaskSetupView 是控制項編輯主場）

→ L4 不在 Phase 4 收尾 scope；維持現狀 4-tab。

L7 Bug B docx parties 全 skip — ⚠️ 更新 2026-05-25 收尾後 — 改為現在優先 fix

前期 (Phase 1+2 SUMMARY §8 L2) 描述過時 — 寫「Phase 5+ FE 改 stepper UX 時順手釐清」+「BE 不主動改」。

實際情況：

• 本 session user 做 Phase 4 ship 後手動 docx 驗證即踩到，每次 import 都中 — 不能等 Phase 5+
• BE log 已 confirmed root cause 在 FE diff stepper 預設值（不是「推測」）
• L4 5-tab 全 skip 連帶 L7 也沒在 Phase 4 處理 — handoff 給下個 session

接手 session 看這份：docs/features/FR-028-2605-ssp-oscal-alignment/handoff/2026-05-25-bug-b-and-parties-stepper-handoff.md（完整 diagnosis + fix plan A/B + verify checklist）

優先度：最高 — 跟 Issue 1（parties preview 缺電話/職稱/地址欄位）同 stepper component 一起 fix。

L8 jedi-oscal 進版 — 等 user 拍板

per Phase 1+2 SUMMARY §7.1（user 2026-05-25 拍板「進版不用做，等測完才會說」）。 執行步驟見該 SUMMARY §7.1。

L9 BE/FE 版號 1:1 對齊 — 等 user 拍板

per memory feedback_be_fe_version_alignment。Phase 4 完工後同 L8 一起 bump。 建議版號：v1.1.0 → v1.2.0（Phase 3+4 含 v3.0.0 Excel BREAKING + Phase 4 新 UX，functional 範圍夠 functional bump；不是 major bump 因為對外 API 沒 breaking — /ssp/<uid>/components 等新 endpoint 是 additive）。

3 個 changelog 應補（user 收尾完手動補或下次 session）

per memory feedback_changelog_subagent + CLAUDE.md「收尾才寫 batch」：

1. docs/changelog/2026-05-25-feat-ssp-oscal-alignment-phase4-l5.md — FE Excel preview v3 對齊
2. docs/changelog/2026-05-25-feat-ssp-oscal-alignment-phase4-l1a-l2-l3.md — BE CRUD endpoints + FE inline CRUD + 移除舊 tab
3. docs/changelog/2026-05-25-feat-ssp-oscal-alignment-phase4-l6.md — i18n keys cleanup

或合併成單一 docs/changelog/2026-05-25-feat-ssp-oscal-alignment-phase4.md 涵蓋全部。本 SUMMARY 已具備 changelog 等同訊息量，user 可選擇是否另寫 changelog。

6.1 部署順序（user 拍板 push 後）

1. jedi-oscal 進版（若 user 拍板 L8）— 套件本身沒改但 caller 用法有改 → 看 user 拍板「進版 vs 不進版」
2. 主專案 deploy（含 Phase 4 L5 BE _ROW_OVERRIDE_SHEETS 擴 + L1a CRUD endpoints + 既有 Phase 3 v3.0.0 樣板）
3. FE 同步 deploy（含 L5 v3 preview + L2 inline CRUD + L3 移除舊 tab + L6 i18n）
4. 重要：user 必須先「下載 v3.0.0 樣板」再上傳 — 現有 v2.x 樣板會被 parser reject（per Phase 3.1 commit f7eaa09f）

6.2 BE 重啟必做

per memory feedback_be_restart_after_service_change：

本期改動的 BE service / route：

• app/oscal/service/ssp_excel_import_app_service.py (_ROW_OVERRIDE_SHEETS)
• app/oscal/service/ssp_inventory_items_app_service.py（新加 add_item / update_item / delete_item / helpers）
• api/oscal/routes/ssp/ssp_components_route.py（加 post + DetailResource）
• api/oscal/routes/ssp/ssp_inventory_items_route.py（加 post + DetailResource）
• api/oscal/__init__.py（add_resource 兩條 detail route）

# 重啟前 kill 舊 process（per memory feedback_backend_restart_orphan_pids）
lsof -t -i:8000 | xargs -r kill -9
# 重啟（看你跑哪個）
python main_socketio.py  # 或 python main_app.py

6.3 兩 repo git push

兩 repo 都還 local（主專案 33 commits ahead / FE 5 commits ahead）。Push 需 user 明確指示。

6.4 手動測試 checklist（user 重啟後）

SSP OSCAL Alignment Phase 4 已完工（L5/L1a/L2/L3/L6 done；L4 skip；L7/L8/L9 等
user 拍板）。本期 5 commits 跨兩 repo（FE 3 + BE 2）。詳見：
docs/features/FR-028-2605-ssp-oscal-alignment/handoff/2026-05-25-phase4-COMPLETE-SUMMARY.md

下個 session 可能要做（按優先順序）：
1. user 拍板進版 → L8 (jedi-oscal bump + Nexus push + 主專案 pin 還原) + L9
   (BE/FE 版號對齊 v1.1.0 → v1.2.0?)
2. L7 排查 Bug B (docx parties 全 skip) — Phase 5+ FE 改 stepper UX 時順手做
3. L4 5-tab 結構 (SC 拆 / parties 合併) — 需先補 UX spec 才能 execute
4. Phase 5 OSCAL Export — 整個 feature 收尾 (round-trip e2e)

開工前 pre-flight：
- git branch --show-current → feature/ssp-oscal-alignment（兩 repo 一致）
- BE working tree: M pyproject.toml only (dev-only path-dep)
- BE test smoke：poetry run pytest tests/test_excel_parser_v2_bundle.py
  tests/test_ssp_excel_import_app_service.py — 106 passed
- FE build smoke：cd ~/Projects/Billows/Audit-Manager/compliance-manager-fe
  && npx vite build → 通