Worklog

2026-07-17 - T03: OCR-Erfassung via OpenRouter Vision + OCR UI

backend/app/models/ocr_result.py - OCRResult model (UUID, vehicle_id FK, file_path, status enum, raw_text, structured_data JSONB, confidence_score, error_message, timestamps)
backend/app/schemas/ocr.py - OCRUploadResponse, OCRResultResponse, OCRResultListResponse, OCRApplyResponse, OCRStructuredData
backend/app/utils/openrouter.py - OpenRouter API client for Qwen2.5-VL vision model (base64 encoding, prompt engineering, JSON parsing, confidence extraction)
backend/app/services/ocr_service.py - upload_file, get_result, list_results, apply_to_vehicle, process_ocr (async), MIME/size validation, confidence threshold logic
backend/app/tasks/ocr_processing.py - Async background task with independent DB session
backend/app/tasks/__init__.py - Tasks package init
backend/app/routers/ocr.py - POST /upload, GET /results/:id, GET /results, POST /results/:id/apply
backend/tests/test_ocr.py - 33 tests (service unit tests, router integration tests, OpenRouter client tests)

frontend/lib/ocr.ts - OCR API client (uploadOCRScan, getOCRResult, listOCRResults, applyOCRToVehicle)
frontend/components/ocr/OCRUpload.tsx - Drag-and-drop file upload component
frontend/components/ocr/OCRResults.tsx - Results list with pagination and status badges
frontend/components/ocr/OCRDetail.tsx - Side-by-side original scan + extracted data with apply button
frontend/app/[locale]/ocr/page.tsx - OCR page combining upload, results, and detail
frontend/tests/ocr.test.tsx - 18 frontend tests

backend/app/config.py - Added OPENROUTER_API_KEY, OPENROUTER_BASE_URL, OPENROUTER_OCR_MODEL, MAX_FILE_SIZE_MB
backend/app/main.py - Registered OCR router under /api/v1/ocr

Used FastAPI BackgroundTasks for async processing (Redis Queue noted for production)
Confidence threshold: 0.7 (below → manual_review, above → completed)
structured_data JSONB contains: brand, model, vin, first_registration, mileage, power_kw, fuel_type
OpenRouter model: qwen/qwen2.5-vl-72b-instruct (configurable via env)
File validation: image/* MIME types only, max 50 MB