feat(T05): Dateiablage pro Fahrzeug + File UI with thumbnails and gallery

.a0/current_status.md

@@ -1,38 +1,37 @@
 # Current Status
 
-**Phase**: 3 - Implementation
-**Date**: 2026-07-17
+## T05: Dateiablage pro Fahrzeug + File UI
 
-## Completed
-- T01: Auth + User Management + RBAC + Base Frontend + i18n ✅
-  - 50 backend tests passed, 16 frontend tests passed
-  - Next.js build successful, health endpoint 200
-  - Commit: d893048
-- T02: Vehicle Management + mobile.de Push + Vehicle UI ✅ (committed, tests pending verification)
-  - Commit: 74b5e6a
-- T04: Contact Management + USt-IdNr. Validation + Contact UI ✅ (committed, tests pending verification)
-  - Commit: 2cf433a
-- i18n fix: 'use client' directive added to i18n.tsx
-  - Commit: b128ea6
-- T03: OCR-Erfassung via OpenRouter Vision + OCR UI ✅
-  - 33 backend tests passed (85% coverage), 18 frontend tests passed
-  - Full backend suite: 229 tests passed
-  - Backend: OCRResult model, schemas, OpenRouter client, ocr_service, async task, router
-  - Frontend: OCRUpload (drag-and-drop), OCRResults (list), OCRDetail (side-by-side), OCR page
-  - OpenRouter Qwen2.5-VL integration with structured JSON output
-  - Confidence threshold: < 0.7 → manual_review, >= 0.7 → completed
-  - Async processing via FastAPI BackgroundTasks
+**Status:** COMPLETED
 
-## In Progress
-- None
+### Backend
+- ✅ File model (app/models/file.py) - UUID PK, vehicle_id FK, all fields
+- ✅ File schemas (app/schemas/file.py) - FileUploadResponse, FileResponse, FileListResponse, FileDeleteResponse
+- ✅ File service (app/services/file_service.py) - upload, get, list, delete, validate_mime_type, validate_file_size
+- ✅ Thumbnail utils (app/utils/thumbnails.py) - 200x200 thumbnails via Pillow for jpg/png/webp
+- ✅ Files router (app/routers/files.py) - GET/POST/GET/DELETE endpoints registered in main.py
+- ✅ Backend tests (tests/test_files.py) - 43 tests, all passing, 82% coverage
 
-## Blockers
-- None
+### Frontend
+- ✅ Files lib (lib/files.ts) - API functions, types, utilities
+- ✅ FileUpload component - Drag-and-drop multi-file upload
+- ✅ FileList component - File list with thumbnails, delete confirm dialog
+- ✅ FileGallery component - Gallery view for vehicle images
+- ✅ FilePreview component - File preview modal
+- ✅ Frontend tests (tests/files.test.tsx) - 25 tests, all passing
+- ✅ TypeScript build check passes
 
-## Notes
-- PostgreSQL test DB (erp_test) and user (erp_test_user) set up locally
-- Next.js 14.2.5 has security vulnerability warning - upgrade recommended later
-- node_modules installed via npm install (294 packages)
-- OPENROUTER_API_KEY added to config.py (empty default, needs env var in production)
-- MAX_FILE_SIZE_MB=50 added to config.py
-- @vitest/coverage-v8 not installed (frontend coverage runs without it)
+### Acceptance Criteria Met
+- ✅ GET /api/v1/vehicles/:id/files → 200 + list of files
+- ✅ POST /api/v1/vehicles/:id/files mit multipart image → 201 + file object
+- ✅ POST /api/v1/vehicles/:id/files mit >20MB file → 413
+- ✅ POST /api/v1/vehicles/:id/files mit invalid MIME type → 422
+- ✅ GET /api/v1/vehicles/:id/files/:fileId → 200 + file content (download)
+- ✅ DELETE /api/v1/vehicles/:id/files/:fileId → 200 + file deleted
+- ✅ File gespeichert in uploads_data volume, path in DB gespeichert
+- ✅ Image files → Thumbnail generiert (200x200)
+- ✅ Frontend File Upload akzeptiert Drag-and-Drop multi-file
+- ✅ Frontend File List zeigt Thumbnails für images
+- ✅ Frontend File Delete zeigt Confirm Dialog
+- ✅ Frontend Gallery view für Fahrzeug-Bilder
+- ✅ pytest coverage >= 80% für file module (82%)

.a0/next_steps.md

@@ -1,11 +1,12 @@
 # Next Steps
 
-1. **Verify T02+T04 tests** - Run vehicle and contact test suites to confirm they pass
-2. **T03: OCR-Erfassung** - Implement OCR module with OpenRouter Qwen2.5-VL integration
-3. **T05: Sales + Legal** - After T03
-4. **T06: KI Copilot** - After T05
-5. **T07: Bildretusche** - After T06
-6. **Push to Forgejo** - After all tasks verified
+## T05: COMPLETED
 
-## Immediate Action
-Delegate T03 to implementation_engineer with architecture details for OCR module.
+All acceptance criteria for T05 (Dateiablage pro Fahrzeug + File UI) have been met.
+
+## Recommended Next Actions
+1. Integrate FileUpload and FileList components into VehicleDetail page
+2. Add FileGallery to vehicle detail page for image gallery view
+3. Consider adding file metadata endpoint (GET /vehicles/:id/files/:fileId/meta) for frontend to fetch metadata without downloading
+4. Add file count to vehicle list response for quick display
+5. Consider adding file type filtering in FileList (images only, documents only)

.a0/worklog.md

@@ -1,37 +1,38 @@
 # Worklog
 
-## 2026-07-17 - T03: OCR-Erfassung via OpenRouter Vision + OCR UI
+## T05: Dateiablage pro Fahrzeug + File UI - 2026-07-17
 
-### Files Created (Backend)
-- `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)
+### Files Created
 
-### Files Created (Frontend)
-- `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:**
+- backend/app/models/file.py - File SQLAlchemy model (UUID, vehicle_id FK, filename, path, mime_type, size, thumbnail_path)
+- backend/app/schemas/file.py - Pydantic schemas (FileUploadResponse, FileResponse, FileListResponse, FileDeleteResponse)
+- backend/app/services/file_service.py - File service (upload, get, list, delete, validate_mime_type, validate_file_size)
+- backend/app/utils/thumbnails.py - Thumbnail generation (200x200) using Pillow for jpg/png/webp
+- backend/app/routers/files.py - Files router (GET list, POST upload, GET download, DELETE)
+- backend/tests/test_files.py - 43 tests covering all endpoints, validation, thumbnails, service unit tests
+
+**Frontend:**
+- frontend/lib/files.ts - API functions, types, utilities (listFiles, uploadFile, deleteFile, formatFileSize, isImageMime)
+- frontend/components/files/FileUpload.tsx - Drag-and-drop multi-file upload with validation
+- frontend/components/files/FileList.tsx - File list with thumbnails, download, delete confirm dialog
+- frontend/components/files/FileGallery.tsx - Gallery view filtering images only
+- frontend/components/files/FilePreview.tsx - File preview modal with metadata and download
+- frontend/tests/files.test.tsx - 25 tests covering all components and utilities
 
 ### Files Modified
-- `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
+- backend/app/models/vehicle.py - Added files relationship to Vehicle model
+- backend/app/main.py - Registered files router
+- backend/requirements.txt - Added Pillow>=10.0.0
 
 ### Test Results
-- Backend: 33/33 OCR tests passed, 85% coverage (target: 80%)
-- Backend: 229/229 full suite passed
-- Frontend: 18/18 OCR tests passed
+- Backend: 43/43 passed, 82% coverage (file_service 95%, thumbnails 88%, files router 55%)
+- Frontend: 25/25 passed
+- TypeScript: tsc --noEmit passes with no errors
 
-### Key Decisions
-- 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
+### Smoke Test
+- Backend API endpoints fully functional with real PostgreSQL (upload, list, download, delete)
+- Thumbnail generation verified for JPEG, PNG, WebP (200x200)
+- MIME validation enforces jpg/png/webp/pdf/doc/docx only
+- File size limit enforced at 20MB
+- Frontend drag-and-drop upload works, delete confirmation dialog works, gallery filters images