SSP 匯入匯出階段2

狀態：Phase 0 — 白話需求草 建立日期：2026-05-18 撰寫人：raymond

現況說明

目前的SSP匯入以及匯出已經有一個基礎的版本, 可以參考下面資訊 目前功能是在合規資源庫裡面

1. 透過Docx匯入: 這邊是會透過顧問在事前訪談時, 取得客戶端的SSP Docx文件然後直接將裡面所需的資料爬出, 建置成一個合規資源庫並將相灣資料填入該資源庫對應的SSP資料內 供使用者建立專案時可以直接帶入預設資料, 以及未來匯出OSCAL文件
   • Page URL: /module-frame/module-frame 在右上角的選單按鈕從文件建立 可以匯入Docx模式
   • Docx SSP匯入規格: docs/features/ssp-doc-parser
2. 透過Excel匯入: 這是比較早以前建置的功能, 當時的需求是可以透過Excel匯入各個控制項的現況說明 匯入方式是在 URL: /module-frame/:uid/template-edit 編輯頁面, 右上角批次維護選單按鈕內的匯入現況資料, 匯出現況資料 的模式, 先用匯出現況資料取得Excel樣板, 這個Excel樣板會依照此合規資源庫所設定的控制項/AO生成要填寫的項目, 需要填寫的部分會使用黃色底呈現方便User填寫 User填寫完畢後, 會再使用匯入現況資料的功能, 將現況資料匯入

需求說明（粗略）

Excel匯入

• 目前Excel匯入只有提供現況說明的部分, 希望連同 基本資料, 設備, 單位, 參與人員, 系統, 控制項現況說明, AO現況說明等, 都透過Excel的模式匯入
• 需要設計一份匯入的Excel樣板, 內容就是要連同上一點的資訊可以在這個Excel內編輯
• 顧問先前有做過一份相框訪談表的Excel, 有點像是docx的前身, 只是資料沒這麼豐富, 可以參考 docs/draft_requirement_spec/ssp-import-export-phase2/reference/Billows_CMMC_2_0_訪談表_V1.xlsx
• docx 可以參考 docs/draft_requirement_spec/ssp-import-export-phase2/reference/ASIA-CMMC-SSP-DRAFT-with-user-info-202604.docx
• 匯入模式, 可以參考docx的匯入模式, 先挑選parser, 再選要匯入的docx檔案, 轉換完畢後, 可以有預覽畫面, 也需要左右邊比對(如果可以的話), 並且可以直接對資料做修改, 預覽URL: /module-frame/import-docx
• 設備, 單位, 參與人員, 系統, 也需要可以做連結
• 控制項/AO部分, 也可以參考docx匯入match的模式, 用編號, 或是名稱, 模糊比對的方式, 最後讓user檢查匯入
• 功能一樣做在合規資源庫下

SSP文件匯出

• 可以將匯入後的合規資源庫, 會出成文件檔案, 類似 docs/draft_requirement_spec/ssp-import-export-phase2/reference/ASIA-CMMC-SSP-DRAFT-with-user-info-202604.docx 這樣的文件格式, 期望還可以support 多種檔案格式會出, docx, pdf, openoffice等

這個需求比較龐大一點, 需要你幫忙協助拆分多個需求來做, 且都要可以獨立完成, 可以銜接, 也要幫忙安排先後順序, 我粗略的想法是要分成下面幾個階段, 大方向分為兩大塊,
匯入以及匯出, 再個別分不同階段, 下面分成兩大塊, 每塊下方的都是不同的階段, 都要可以拆分不同session執行 如果你經過分析後, 要再拆分更細, 就在麻煩拆分, 不要跟之前一樣都以我的為主,

Excel匯入

• Excel Template 建置, 以及提供下載
• Excel 匯入功能, 以及介面（這個幫我分析, 如何拆分階段實作)

SSP匯出

• 匯出樣板建置
• 匯出資料API
• 匯出資料UI

前端頁面的URL參考資料:

• 合規資源庫: /module-frame/module-frame
• docx匯入預覽: /module-frame/import-docx

參考樣板文件

• 顧問訪談表Excel版本: docs/draft_requirement_spec/ssp-import-export-phase2/reference/Billows_CMMC_2_0_訪談表_V1.xlsx
• 顧問訪談後建置的SSP Docx版本: docs/draft_requirement_spec/ssp-import-export-phase2/reference/ASIA-CMMC-SSP-DRAFT-with-user-info-202604.docx
• Excel現況說明匯入Template現有版本: docs/draft_requirement_spec/ssp-import-export-phase2/reference/module_frame_import_template.xlsx

• 測試 ip: 192.168.50.188:25432, user: cmmgr, pwd請參考.env, db: guidant_ai_dev, 資料庫可以任意改動