Erweitere Regression Test (Bildvergleich) aber deaktiviere ihn default, weil das diff noch zu groß ist.

README.md

@@ -37,6 +37,59 @@ Vor dem ersten Start müssen zwei Werte in `config.json` eingetragen werden:
 
 Alle anderen Felder sind vorbelegt und müssen nur bei abweichender Excel-Struktur angepasst werden.
 
+### Erweiterte PDF-Optionen
+
+Diese Schalter steuern das interne Verhalten beim PDF-Befüllen und müssen in der Regel nicht verändert werden.
+
+#### `pdf_use_display_values` (Standard: `true`)
+
+Steuert, welche Werte in Dropdown- und Auswahlfelder geschrieben werden.
+
+| Wert | Verhalten |
+|---|---|
+| `true` | Lesbare Anzeigewerte (z. B. `"X = anwesend"`, `"mind. 6 h"`, `"8,60"`) werden ins PDF geschrieben. Der PDF-Viewer zeigt den Text direkt an. |
+| `false` | Rohe Export-Werte (z. B. `"X"`, `"6"`, `"1"`) werden verwendet — so wie es das JavaScript im Originalformular intern macht. Sinnvoll, wenn ein externer Viewer (z. B. Adobe Acrobat) die Werte selbst aufzulösen soll. |
+
+#### `pdf_need_appearances` (Standard: `false`)
+
+Steuert das `NeedAppearances`-Flag in der erzeugten PDF-Datei.
+
+| Wert | Verhalten |
+|---|---|
+| `false` | Der PDF-Renderer nutzt die im PDF gespeicherten Appearance-Streams (AP) direkt. Buttons, Footer und Summenfelder werden korrekt angezeigt. **Empfohlene Einstellung.** |
+| `true` | Der PDF-Viewer regeneriert alle Darstellungen aus den Felddefinitionen (`/DA`). Kann helfen, wenn ein externer Viewer einzelne Felder leer anzeigt — kann aber dazu führen, dass Buttons und Footer ausgeblendet werden. |
+
+> **Hinweis:** Die Summenfelder erhalten beim Generieren eigene Appearance-Streams (Zwei-Pass-Schreibstrategie), sodass `pdf_need_appearances: false` für alle Felder funktioniert.
+
+#### `regression` (Objekt)
+
+Einstellungen für den automatisierten Regressions-Bildvergleich (`pytest`). Alle Unterfelder befinden sich in diesem Objekt.
+
+```json
+"regression": {
+    "enabled": false,
+    "mask_footer": true
+}
+```
+
+##### `regression.enabled` (Standard: `false`)
+
+Aktiviert oder deaktiviert den Bildvergleich.
+
+| Wert | Verhalten |
+|---|---|
+| `false` | Regression-Tests werden übersprungen (`pytest.skip`). **Standard.** |
+| `true` | Bildvergleich wird ausgeführt. Erfordert Referenz-PDFs in `tests/fixtures/`. |
+
+##### `regression.mask_footer` (Standard: `true`)
+
+Steuert, ob der untere Bereich (Footer) beim Pixel-Vergleich ignoriert wird.
+
+| Wert | Verhalten |
+|---|---|
+| `true` | Die untere ~20% jeder PDF-Seite wird ignoriert. Sinnvoll, da Template-PDFs je nach Vorlage unterschiedlich viele Footer-Zeilen (2 oder 3) haben können. |
+| `false` | Vollständiger Pixel-by-Pixel-Vergleich inkl. Footer-Bereich. |
+
 ---
 
 ## Verzeichnisstruktur