feat(i18n): add multilingual support with translations for English, Japanese, and Simplified Chinese

- Create README.md for internationalization (i18n) documentation - Add English translation for main README and quick start guide - Add Japanese translation for main README - Add Simplified Chinese translation for main README - Introduce sample Docker Compose configurations for various deployment scenarios - Implement CI/CD documentation for testing and deployment workflows - Establish end-to-end testing guidelines and strategies - Create test strategy documentation outlining unit, integration, and E2E tests
2026-01-23 14:32:27 +08:00 · 2026-01-23 14:32:27 +08:00 · da856d89ff
commit da856d89ff
parent b3b382d1e0
42 changed files with 4901 additions and 263 deletions
--- a/docs/testing/test-strategy.md
+++ b/docs/testing/test-strategy.md
@ -0,0 +1,211 @@
+# 測試策略
+
+本文件說明 ConvertX-CN 的測試策略與方法。
+
+---
+
+## 測試類型
+
+### 單元測試
+
+測試獨立的函數與模組。
+
+**涵蓋範圍：**
+
+- 轉換器邏輯
+- 工具函數
+- 資料處理
+
+### 整合測試
+
+測試模組之間的協作。
+
+**涵蓋範圍：**
+
+- API 端點
+- 資料庫操作
+- 檔案處理
+
+### E2E 測試
+
+模擬使用者操作的完整流程測試。
+
+**涵蓋範圍：**
+
+- 上傳檔案
+- 轉換流程
+- 下載結果
+
+---
+
+## 執行測試
+
+### 前端測試
+
+```bash
+# 執行所有測試
+bun run test
+
+# 監視模式
+bun run test:watch
+
+# 覆蓋率報告
+bun run test:coverage
+```
+
+### API Server 測試（Rust）
+
+```bash
+cd api-server
+
+# 執行所有測試
+cargo test
+
+# 詳細輸出
+cargo test -- --nocapture
+```
+
+### E2E 測試
+
+```bash
+# 執行 E2E 測試
+bun run test:e2e
+
+# 或使用腳本
+./scripts/run-e2e-tests.sh
+```
+
+---
+
+## 測試結構
+
+```
+tests/
+├── converters/      # 轉換器測試
+├── e2e/             # 端對端測試
+└── transfer/        # 傳輸模組測試
+
+api-server/tests/
+├── api_tests.rs     # REST API 測試
+├── graphql_tests.rs # GraphQL 測試
+└── integration_tests.rs # 整合測試
+```
+
+---
+
+## 測試範例
+
+### 前端單元測試
+
+```typescript
+// tests/converters/ffmpeg.test.ts
+import { describe, it, expect } from "bun:test";
+import { ffmpegConverter } from "../../src/converters/ffmpeg";
+
+describe("FFmpeg Converter", () => {
+  it("should support mp4 input", () => {
+    expect(ffmpegConverter.inputFormats).toContain("mp4");
+  });
+
+  it("should support webm output", () => {
+    expect(ffmpegConverter.outputFormats).toContain("webm");
+  });
+});
+```
+
+### API 整合測試
+
+```rust
+// api-server/tests/api_tests.rs
+#[tokio::test]
+async fn test_health_endpoint() {
+    let response = client.get("/health").send().await.unwrap();
+    assert_eq!(response.status(), StatusCode::OK);
+}
+```
+
+### E2E 測試
+
+```typescript
+// tests/e2e/upload.test.ts
+import { test, expect } from "@playwright/test";
+
+test("should upload and convert file", async ({ page }) => {
+  await page.goto("/");
+
+  // 上傳檔案
+  await page.setInputFiles("#file-input", "test.docx");
+
+  // 選擇格式
+  await page.selectOption("#format", "pdf");
+
+  // 點擊轉換
+  await page.click("#convert-button");
+
+  // 驗證結果
+  await expect(page.locator(".download-link")).toBeVisible();
+});
+```
+
+---
+
+## 測試資料
+
+### 測試檔案
+
+放置在 `tests/fixtures/` 目錄：
+
+```
+tests/fixtures/
+├── documents/
+│   ├── sample.docx
+│   ├── sample.pdf
+│   └── sample.txt
+├── images/
+│   ├── sample.png
+│   └── sample.jpg
+└── audio/
+    └── sample.mp3
+```
+
+### Mock 資料
+
+使用 Mock 避免依賴外部服務：
+
+```typescript
+import { mock } from "bun:test";
+
+const mockConverter = mock(() => ({
+  convert: async () => "output.pdf",
+}));
+```
+
+---
+
+## 持續整合
+
+### GitHub Actions
+
+```yaml
+# .github/workflows/test.yml
+name: Test
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+      - run: bun install
+      - run: bun run test
+```
+
+---
+
+## 相關文件
+
+- [CI/CD](ci-cd.md)
+- [E2E 測試](e2e-tests.md)
+- [本地開發](../development/local-development.md)