feat: OCR engine abstraction layer and PaddleOCR integration (#115) #116

New Issue

2026-02-07T16:12:46Z

egullickson commented

2026-02-07 16:12:46 +00:00

Relates to #115

Create an OCR engine abstraction layer in ocr/app/engines/ to decouple extractors from Tesseract. Implement PaddleOCR as the primary engine using PP-OCRv4 models.

Changes

Create ocr/app/engines/base_engine.py - OcrEngine ABC with recognize(image_bytes, config) method
Create ocr/app/engines/paddle_engine.py - PaddleOCR wrapper with PP-OCRv4, angle classification, CPU-only
Create ocr/app/engines/engine_factory.py - Factory to instantiate configured engine
Update ocr/app/config.py - Add OCR_PRIMARY_ENGINE, OCR_CONFIDENCE_THRESHOLD env vars
Update ocr/requirements.txt - Add paddlepaddle, paddleocr dependencies

Acceptance Criteria

OcrEngine ABC defines recognize() returning structured OcrEngineResult (text, confidence, word boxes)
PaddleOcrEngine wraps paddleocr with PP-OCRv4 models
Engine supports VIN character whitelist mode and PSM-equivalent configurations
Engine factory reads config to instantiate correct engine
Existing Tesseract functionality preserved (TesseractEngine wrapper for backward compat)

Relates to #115 Create an OCR engine abstraction layer in `ocr/app/engines/` to decouple extractors from Tesseract. Implement PaddleOCR as the primary engine using PP-OCRv4 models. ## Changes - Create `ocr/app/engines/base_engine.py` - `OcrEngine` ABC with `recognize(image_bytes, config)` method - Create `ocr/app/engines/paddle_engine.py` - PaddleOCR wrapper with PP-OCRv4, angle classification, CPU-only - Create `ocr/app/engines/engine_factory.py` - Factory to instantiate configured engine - Update `ocr/app/config.py` - Add `OCR_PRIMARY_ENGINE`, `OCR_CONFIDENCE_THRESHOLD` env vars - Update `ocr/requirements.txt` - Add `paddlepaddle`, `paddleocr` dependencies ## Acceptance Criteria - [ ] OcrEngine ABC defines `recognize()` returning structured OcrEngineResult (text, confidence, word boxes) - [ ] PaddleOcrEngine wraps paddleocr with PP-OCRv4 models - [ ] Engine supports VIN character whitelist mode and PSM-equivalent configurations - [ ] Engine factory reads config to instantiate correct engine - [ ] Existing Tesseract functionality preserved (TesseractEngine wrapper for backward compat)

egullickson added the

labels 2026-02-07 16:13:22 +00:00

egullickson added this to the Sprint 2026-02-02 milestone 2026-02-07 16:13:30 +00:00

egullickson referenced this issue

2026-02-07 16:14:33 +00:00

feat: Improve OCR process - replace Tesseract with PaddleOCR and add cloud fallback for VIN scanning #115

egullickson referenced this issue

2026-02-07 16:21:54 +00:00