Schema Initializer DryRun 實作前確認

1. 確認目的

本文件用來確認下一步 Schema Initializer DryRun 第一版實作範圍。

前一份設計文件已定義 Initializer 應負責協調 SchemaDefinition、ISchemaInspector、SchemaDryRunPlanner 與 ConsoleHost 顯示層。本次確認的重點是把程式實作切小，避免一次導入真實 MySQL、DDL executor 或 ConsoleHost 啟動參數。

2. 本次建議結論

建議採用「小步第一版」：

1. 在 HS.DeviceControl.Core 建立 SchemaInitializer。
2. 第一版只支援 RunDryRun。
3. 第一版以 SchemaDefinition 作為 request 輸入，不先實作 SchemaDefinitionProvider。
4. 第一版仍使用 MockSchemaInspector 測試，不連真實 MySQL。
5. 第一版不修改 ConsoleHost 啟動方式。
6. 第一版不實作 Apply，也不建立 DDL executor。

此做法可先驗證 Initializer 協調層是否乾淨，再進入真實 MySQL Inspector 或 attribute provider。

3. 範圍確認表

4. 建議 class 邊界

4.1 SchemaInitializer

建議職責：

• 驗證 request。
• 呼叫 SchemaDryRunPlanner.GenerateDryRunPlan。
• 將 planner result 包裝成 initializer result。
• 保留 warnings、manual review、error、correlation id。

不應負責：

• 組 SQL。
• 讀取 MySQL metadata。
• 執行 DDL。
• 顯示 Console 文字。
• 決定 ConsoleHost 啟動模式。

4.2 SchemaInitializerDryRunRequest

建議欄位：

4.3 SchemaInitializerResult

建議欄位：

5. 建議流程

flowchart TD
    A["呼叫 RunDryRun(request)"] --> B{"request 是否有效"}
    B -- "否" --> C["回傳 SchemaDefinitionInvalid"]
    B -- "是" --> D["建立 SchemaDryRunRequest"]
    D --> E["呼叫 SchemaDryRunPlanner"]
    E --> F{"planner result 是否成功"}
    F -- "否" --> G["回傳 initializer fail result"]
    F -- "是" --> H["回傳 initializer success result"]

6. 測試清單

下一步程式實作至少要補以下測試：

7. 禁止事項

本次程式實作不得：

• 新增 MySQL package。
• 連線 MySQL。
• 讀取 information_schema。
• 執行 CREATE TABLE、ALTER TABLE 或任何 DDL。
• 修改 ConsoleHost 啟動方式。
• 導入 SchemaExecutor。
• 實作 Apply。
• 變更既有 public method 簽章。

8. 驗收標準

完成下一步程式實作後，至少需符合：

9. 建議下一步

建議下一步進入：

Schema Initializer DryRun 第一版實作

實作順序建議：

1. 建立 SchemaInitializerDryRunRequest。
2. 建立 SchemaInitializerResult。
3. 建立 SchemaInitializer。
4. 新增 SchemaInitializerTests。
5. 執行 Core tests 與全專案測試。
6. 補實作紀錄並同步文件網站。