Feature: Extrahierten Belegtext in beleg_text speichern (Migration 021)

Changes.md

@@ -2,6 +2,16 @@
 
 ---
 
+## 2026-04-10 – Belegtext-Speicherung für spätere Volltextsuche
+
+### Neu
+- Migration 021: Spalte `beleg_text MEDIUMTEXT` in `belege` – speichert den per `pdftotext` oder Tesseract-OCR extrahierten Volltext
+- `KontierungsvorschlagService::extractText()`: neue public Methode zur Textextraktion (PDF + Bild), unabhängig vom KI-Vorschlag nutzbar
+- Beim Generieren des KI-Vorschlags wird `beleg_text` automatisch befüllt (einmalig, nur wenn noch leer)
+- `Beleg::saveBelegText()`: neue Methode im Model
+
+---
+
 ## 2026-04-10 – OCR-Schalter unabhängig vom KI-Schalter
 
 ### Neu

migrations/021_beleg_text.sql

@@ -0,0 +1,4 @@
+-- Migration 021: Extrahierter Belegtext als durchsuchbares Metafeld
+ALTER TABLE belege
+    ADD COLUMN IF NOT EXISTS beleg_text MEDIUMTEXT NULL
+        COMMENT 'Per pdftotext oder OCR extrahierter Volltext des Belegs (für Suche)';

src/Models/Beleg.php

@@ -218,6 +218,14 @@ class Beleg
         );
     }
 
+    public static function saveBelegText(int $id, string $text): void
+    {
+        Database::execute(
+            'UPDATE belege SET beleg_text = ? WHERE id = ?',
+            [$text !== '' ? $text : null, $id]
+        );
+    }
+
     public static function verifyIntegrity(int $id): bool
     {
         $beleg = self::find($id);

src/Services/KontierungsvorschlagService.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace Steuerkram\Services;
 
 use Steuerkram\Models\Account;
+use Steuerkram\Models\Beleg;
 use Steuerkram\Models\Setting;
 use Steuerkram\Models\Supplier;
 
@@ -29,19 +30,33 @@ class KontierungsvorschlagService
         return (bool)($s['ocr_aktiv'] ?? 1);
     }
 
-    public function generateForBeleg(array $beleg): ?array
+    public function extractText(array $beleg): string
     {
         $absPath = dirname(__DIR__, 2) . '/public/' . $beleg['storage_path'];
-        if (!file_exists($absPath)) return null;
+        if (!file_exists($absPath)) return '';
 
-        // Inhalt extrahieren
         $mime = strtolower($beleg['mime_type'] ?? '');
 
         if ($mime === 'application/pdf') {
-            $text = $this->extractPdfText($absPath);
+            return $this->extractPdfText($absPath);
         } elseif (in_array($mime, ['image/jpeg', 'image/png', 'image/tiff'], true)) {
-            $text = $this->isOcrEnabled() ? $this->extractImageText($absPath) : '';
+            return $this->isOcrEnabled() ? $this->extractImageText($absPath) : '';
-        } else {
+        }
+
+        return '';
+    }
+
+    public function generateForBeleg(array $beleg): ?array
+    {
+        $text = $this->extractText($beleg);
+
+        // Extrahierten Text dauerhaft am Beleg speichern (für spätere Suche)
+        if ($text !== '' && $beleg['beleg_text'] === null) {
+            Beleg::saveBelegText((int)$beleg['id'], $text);
+        }
+
+        $mime = strtolower($beleg['mime_type'] ?? '');
+        if (!in_array($mime, ['application/pdf', 'image/jpeg', 'image/png', 'image/tiff'], true)) {
             return null;
         }