# RAIDGuard X Java GUI 重構為 Rust 分析報告

## 1. 現有架構總覽

```
┌─────────────────────────────────────────────────────────────────┐
│                     Java Swing GUI (70,521 行)                  │
├─────────────────────────────────────────────────────────────────┤
│  Main Windows        │  frmMain (7,397 行)                     │
│                      │  frmSettings (2,978 行)                  │
│                      │  frmAdvanced (707 行)                    │
├──────────────────────┼──────────────────────────────────────────┤
│  Dialogs             │  dlgServer (799 行)                     │
│                      │  dlgDumpLog (808 行)                     │
│                      │  dlgEnvInfo (808 行)                     │
│                      │  dlgPasswordCheck                        │
│                      │  dlgProgressCheck                        │
├──────────────────────┼──────────────────────────────────────────┤
│  Panels              │  jpController (3,059 行)                 │
│                      │  jpController2 (3,612 行)                │
├──────────────────────┼──────────────────────────────────────────┤
│  RAID Operations     │  frmCreateArray (2,171 行)              │
│                      │  frmCreateArray2 (2,278 行)              │
│                      │  frmDeleteArray (834 行)                 │
│                      │  frmQuickSetup2 (1,421 行)               │
├──────────────────────┼──────────────────────────────────────────┤
│  Advanced Features   │  frmAdvSnapshot (1,430 行)              │
│                      │  frmAdvMirror (1,552 行)                 │
│                      │  frmAdvSlicing (1,125 行)                │
│                      │  frmAdvMigrate (956 行)                   │
│                      │  frmAdvExpansion (619 行)                │
│                      │  frmAdvLunmap (907 行)                   │
│                      │  frmAdvLunMask (913 行)                  │
├──────────────────────┼──────────────────────────────────────────┤
│  System              │  frmEmail (1,292 行)                     │
│                      │  frmAdvMaintain (1,011 行)               │
├──────────────────────┼──────────────────────────────────────────┤
│  Data Layer          │  PageDataDB (7,322 行) - 全域資料庫       │
│                      │  EventPartition (1,422 行)              │
│                      │  Langs (2,468 行) - 多國語言             │
├──────────────────────┼──────────────────────────────────────────┤
│  Protocol            │  SendCmd.java - TCP 通訊                  │
│                      │  ControllerInfoPage                      │
│                      │  RAIDInfoPage (675 行)                   │
│                      │  DISKInfoPage                            │
│                      │  RAIDEnclosureInfoPage                   │
│                      │  SnapshotInfoPage                         │
├──────────────────────┼──────────────────────────────────────────┤
│  SNMP                │  SNMPv1CommunicationInterface (1,229 行) │
│                      │  SNMPTrapSendTest (653 行)               │
└──────────────────────┴──────────────────────────────────────────┘
                              │
                              ▼
              ┌───────────────────────────────┐
              │   TCP Port 8922 (In-Band)     │
              │   TCP Port 8722 (Finder)      │
              └───────────────────────────────┘
                              │
                              ▼
              ┌───────────────────────────────┐
              │   GS (GUI Server) - C         │
              │   DtrGuiSrv                   │
              └───────────────────────────────┘
```

## 2. 模組分類與重構建議

### 2.1 核心資料層 (Core Data Layer) - 高優先級

| 模組 | 行數 | 功能 | Rust 重構建議 |
|------|------|------|---------------|
| **PageDataDB** | 7,322 | 全域資料庫、快取、SNMP | 使用 `serde` + `rusqlite`，建立 `State` 管理 |
| **EventPartition** | 1,422 | 事件日誌讀寫 | 直接移植，使用 `tokio` 異步 I/O |
| **Langs** | 2,468 | 多國語言 | 改用 JSON/YAML 語言檔 + `fluent-rs` |

**Rust 目標結構:**
```rust
// src/data/mod.rs
pub struct AppState {
    pub controllers: HashMap<String, Controller>,
    pub raids: HashMap<String, RAID>,
    pub disks: HashMap<String, Disk>,
    pub events: Vec<Event>,
    pub config: Config,
}

// src/i18n/mod.rs
pub struct I18n {
    current_locale: String,
    translations: HashMap<String, HashMap<String, String>>,
}
```

### 2.2 通訊層 (Protocol Layer) - 高優先級

| 模組 | 功能 | Rust 重構建議 |
|------|------|---------------|
| **SendCmd** | TCP 通訊、指令發送 | 使用 `tokio::net::TcpStream` + 自訂通訊協定 |
| **InBandAPI (22 個類別)** | 頁面資料解析 | 移植為 Rust struct derive `Serialize` |

**Rust 目標結構:**
```rust
// src/protocol/mod.rs
pub struct InBandProtocol {
    socket: TcpStream,
}

impl InBandProtocol {
    pub async fn connect(&mut self, addr: &str) -> Result<()>;
    pub async fn send_cmd(&mut self, opcode: OpCode, data: &[u8]) -> Result<Vec<u8>>;
}

// src/protocol/pages.rs
#[derive(Serialize, Deserialize)]
pub struct ControllerInfoPage {
    pub serial_number: [u8; 16],
    pub model_name: [u8; 32],
    pub firmware_version: [u8; 8],
    pub status: u8,
    // ...
}
```

### 2.3 主視窗 (Main Window) - 中優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| **frmMain** | 7,397 | 主視窗、選單、標題列 |
| **frmSettings** | 2,978 | 系統設定 |

**重構建議:** 使用 **Slint** (現有專案已採用)

```rust
// ui/main_window.slint (已存在)
export component AppWindow inherits Window {
    // 現有的 Slint 定義
}
```

### 2.4 RAID 作業模組 - 中優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| frmCreateArray | 2,171 | 建立 RAID |
| frmCreateArray2 | 2,278 | 建立 RAID (進階) |
| frmDeleteArray | 834 | 刪除 RAID |
| frmQuickSetup2 | 1,421 | 快速設定 |

**Rust 重構建議:**
```rust
// src/handlers/raid_ops.rs
pub async fn create_raid(level: RaidLevel, disks: Vec<u8>) -> Result<()>;
pub async fn delete_raid(raid_id: u8) -> Result<()>;
pub async fn rebuild_raid(raid_id: u8) -> Result<()>;
```

### 2.5 進階功能模組 - 低優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| frmAdvSnapshot | 1,430 | Snapshot 管理 |
| frmAdvMirror | 1,552 | Mirror 鏡像 |
| frmAdvSlicing | 1,125 | 切片 |
| frmAdvMigrate | 956 | 遷移 |
| frmAdvExpansion | 619 | 擴展 |
| frmAdvLunmap | 907 | LUN 對應 |
| frmAdvLunMask | 913 | LUN 遮罩 |

**重構建議:** 這些功能較少使用，可放在第二階段實作。

### 2.6 對話框 (Dialogs) - 低優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| dlgServer | 799 | 伺服器連線 |
| dlgEnvInfo | 808 | 環境資訊 |
| dlgDumpLog | 808 | 日誌傾印 |
| dlgPasswordCheck | - | 密碼驗證 |
| dlgProgressCheck | - | 進度顯示 |

**重構建議:** 改為 Slint 元件或使用 `rfd` 對話框庫。

### 2.7 系統模組 - 中優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| frmEmail | 1,292 | 郵件通知 |
| frmAdvMaintain | 1,011 | 維護功能 |

**Rust 重構建議:**
```rust
// src/email/mod.rs
pub async fn send_email(config: &EmailConfig, subject: &str, body: &str) -> Result<()>;
```

使用 `lettre` crate 實現 SMTP。

### 2.8 SNMP 模組 - 低優先級

| 模組 | 行數 | 功能 |
|------|------|------|
| SNMPv1CommunicationInterface | 1,229 | SNMP v1/v2c 通訊 |
| SNMPTrapSendTest | 653 | Trap 發送測試 |

**Rust 重構建議:** 使用 `snmp` crate 或自訂實作 (取決於需求)。

## 3. 重構優先順序

```
Phase 1: 基礎設施 (最優先)
├── 通訊層 (SendCmd → InBandProtocol)
├── 資料層 (PageDataDB → AppState)
└── UI 框架 (Slint 整合)

Phase 2: 核心功能
├── 主視窗 (frmMain → Slint)
├── RAID 操作 (Create/Delete/Query)
└── 事件處理 (EventPartition)

Phase 3: 進階功能
├── Snapshot / Mirror / Migration
├── LUN Map/Mask
└── Email 通知

Phase 4: 優化
├── SNMP Trap
├── 效能調優
└── 單元測試
```

## 4. Rust 專案結構建議

```
raidguard_x_gui/
├── Cargo.toml
├── build.rs
├── src/
│   ├── main.rs              # 入口點
│   ├── lib.rs               # 庫入口
│   │
│   ├── protocol/            # 通訊協定
│   │   ├── mod.rs
│   │   ├── client.rs        # TCP 客戶端
│   │   ├── messages.rs      # 訊息定義
│   │   └── pages.rs         # 頁面資料結構
│   │
│   ├── data/               # 資料層
│   │   ├── mod.rs
│   │   ├── state.rs         # 全域狀態
│   │   ├── cache.rs         # 快取
│   │   └── db.rs            # SQLite 儲存
│   │
│   ├── handlers/            # 業務邏輯
│   │   ├── mod.rs
│   │   ├── raid.rs          # RAID 操作
│   │   ├── disk.rs          # 磁碟操作
│   │   ├── controller.rs    # 控制器操作
│   │   └── event.rs         # 事件處理
│   │
│   ├── email/              # 郵件通知
│   │   └── mod.rs
│   │
│   ├── snmp/               # SNMP (可選)
│   │   └── mod.rs
│   │
│   └── ui/                 # UI 整合
│       └── mod.rs
│
└── ui/                     # Slint UI 檔案
    ├── main_window.slint
    ├── components/
    └── styles/
```

## 5. 依賴套件建議

| 功能 | Rust Crate | 備註 |
|------|------------|------|
| UI Framework | `slint` | 現已採用 |
| 非同步執行 | `tokio` | 現已採用 |
| 序列/反序列化 | `serde`, `serde_json` | 現已採用 |
| TCP 通訊 | `tokio::net` | 標準庫 |
| 資料庫 | `rusqlite` | SQLite |
| 日期時間 | `chrono` | 現已採用 |
| 日誌 | `tracing` | 現已採用 |
| SMTP | `lettre` | 郵件發送 |
| 指令列解析 | `clap` | 選項解析 |
| 錯誤處理 | `anyhow`, `thiserror` | 現已採用 |

## 6. 現有 Rust 程式碼整合

現有 Rust 專案 (`raidguard_x_gui_server/`) 可作為基礎：

```rust
// 現有結構
raidguard_x_gui_server/
├── src/
│   ├── main.rs              ✅ 入口點
│   ├── server.rs            ✅ TCP 伺服器
│   ├── protocol/messages.rs ✅ 訊息定義
│   ├── mock/data.rs         ✅ 模擬資料
│   └── handlers/            ✅ 業務處理
└── Cargo.toml
```

**整合策略:**
1. 將 `raidguard_x_gui_server` 改為 `raidguard_x_gui` (合併 client + server)
2. 新增 Slint UI 整合 (`ui/` 目錄 → Slint 編譯)
3. 新增 `protocol/client.rs` 實現 TCP 客戶端
4. 新增 `data/state.rs` 實現全域狀態

## 7. 風險與挑戰

| 風險 | 緩解措施 |
|------|----------|
| Swing → Slint 遷移複雜度 | 分階段進行，先實現核心 UI |
| 執行緒模型差異 | 使用 `tokio` 模擬 Swing EDT 概念 |
| 效能考量 | Rust效能通常優於 Java，但仍需優化 |
| 測試覆蓋率 | 建立完整單元測試與整合測試 |
| Java/Swing 依賴 | 保留 Java 版本，逐步替換 |

## 8. 結論

### 重構可行性: ✅ 高

- **總行數**: 70,521 行 Java → 預估 30,000 行 Rust
- **預期效能提升**: 2-5x
- **維護性提升**: 顯著改善 (型別安全、記憶體安全)

### 建議策略

1. **先完成 Phase 1-2** (通訊 + 資料 + 核心 UI)
2. **保留 Java 版本** 同步運行，逐步替換
3. **使用 Mock Driver** 進行離線測試
4. **建立 CI/CD** 確保重構正確性

---

*Generated: 2026-03-29*
*Based on: RAIDGuard X Java GUI (v3.8.0)*