feat(api): Docker Compose 整合與補充文件 - Docker Compose profiles 支援選用 API Server - API Server Dockerfile (多階段建置) - .env.api.example 環境變數範本 - integration_tests.rs 完整整合測試 - health_check.sh 健康檢查腳本 - 主專案 README 新增 API Server 說明區塊

api-server/docs/ARCHITECTURE.md

@@ -59,12 +59,14 @@
 負責所有請求的 JWT 驗證。
 
 **職責**：
+
 - 解析 Authorization Header
 - 驗證 JWT Token 簽名
 - 檢查 Token 是否過期
 - 提取使用者資訊
 
 **不負責**：
+
 - 產生 JWT Token（由外部認證服務處理）
 - 使用者管理
 
@@ -73,6 +75,7 @@
 提供 RESTful HTTP 端點。
 
 **端點**：
+
 - `GET /health` - 健康檢查
 - `GET /api/v1/engines` - 列出引擎
 - `POST /api/v1/convert` - 建立轉檔任務
@@ -86,6 +89,7 @@
 提供 GraphQL 查詢與變更。
 
 **Queries**：
+
 - `health` - 健康檢查
 - `engines` - 列出引擎
 - `engine(id)` - 取得特定引擎
@@ -95,6 +99,7 @@
 - `suggestions` - 取得建議
 
 **Mutations**：
+
 - `createJob` - 建立任務
 - `deleteJob` - 刪除任務
 
@@ -103,11 +108,13 @@
 管理所有可用的轉換引擎及其能力。
 
 **職責**：
+
 - 註冊引擎及其支援的格式
 - 驗證轉換是否可行
 - 提供替代方案建議
 
 **設計原則**：
+
 - 引擎必須明確指定，不自動選擇
 - 不支援的轉換必須回傳建議
 
@@ -116,6 +123,7 @@
 處理轉檔任務的核心邏輯。
 
 **職責**：
+
 - 建立和管理轉檔任務
 - 儲存上傳的檔案
 - 呼叫外部轉換程式
@@ -126,6 +134,7 @@
 統一的錯誤處理機制。
 
 **特色**：
+
 - 結構化的錯誤回應
 - 錯誤碼分類
 - 轉換建議整合