# 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, 資料庫可以任意改動



