feat: 新增 OCRmyPDF 轉換引擎 (v0.1.14)
## 新功能 - OCRmyPDF 轉換引擎:將掃描版 PDF 轉換為可搜尋 PDF - 支援 7 種語言:en, zh-TW, zh, ja, ko, de, fr - 與 PDFMathTranslate 風格一致的 UI 格式 (pdf-<lang>) - 自動偵測頁面方向並旋轉 - 自動校正傾斜 - 跳過已有文字層的頁面 - 詳細的 5 階段處理進度輸出 ## 建置 - Dockerfile:安裝 ocrmypdf 與 Tesseract OCR 語言包 ## 文件 - 更新 OCR 功能文件 - 文件目錄結構改為中文名稱 ## 測試 - 修復 BabelDOC 和 PDFMathTranslate 測試的 OCR mock - 所有 345 個測試通過
This commit is contained in:
parent
f24eec070c
commit
a06df23b1d
53 changed files with 1427 additions and 675 deletions
|
|
@ -1,211 +0,0 @@
|
|||
# 測試策略
|
||||
|
||||
本文件說明 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)
|
||||
Loading…
Add table
Add a link
Reference in a new issue