Fehlende Dateien und Ordner hinzugefügt

2026-06-10 21:20:03 +02:00
parent 1d8ca0b908
commit 3278e57334
217 changed files with 9168 additions and 592 deletions
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Printservice Standalone Java 25 v2.3
+# Printservice Standalone Java 25 v2.5

 Eigenständiger Druckservice ohne GlassFish/Payara. Die Anwendung läuft als normale Java-Applikation oder über WinSW als Windows-Dienst und stellt ein Webfrontend plus REST-API bereit.

@@ -387,7 +387,7 @@ ZPL direkt:

 ## DOCX -> PDF -> Druck ohne LibreOffice: DOCX4J_FO

-Ab v2.3 gibt es zusätzlich zum externen LibreOffice-Weg den Java-only-Konverter:
+Ab v2.5 gibt es zusätzlich zum externen LibreOffice-Weg den Java-only-Konverter:

 ```json
 {
@@ -491,7 +491,7 @@ Empfehlung: `DOCX4J_FO` als optionale Alternative einbauen, aber pro Vorlage in
 - `C:\printservice` regelmäßig sichern, besonders `templates`, `printers.json`, `auth.json` und `queue/print-jobs.json`.


-## HTML→PDF: robuste XHTML-Normalisierung ab v2.3
+## HTML→PDF: robuste XHTML-Normalisierung ab v2.5

 Der HTML→PDF-Druckpfad normalisiert HTML-Vorlagen jetzt vor dem PDF-Renderer automatisch zu XHTML. Hintergrund: `openhtmltopdf` ist deutlich strenger als ein Browser. Normales Browser-HTML wie `<br>`, `<img>`, fehlende `</td>` oder ein UTF-8-BOM vor `<html>` kann sonst mit einem XML-Fehler abbrechen, zum Beispiel:

@@ -540,7 +540,7 @@ Eine erfolgreiche Antwort enthält unter anderem:
 Wenn die Vorlage versehentlich JSON oder PDF-Inhalt enthält, gibt der Service nun eine verständlichere Fehlermeldung aus, statt nur den SAX/XML-Fehler des Renderers weiterzugeben.


-## v2.4: Lieferschein-Demos und HTML->PDF Fehlerbehebung
+## v2.5: Lieferschein-Demos und HTML->PDF Fehlerbehebung

 ### HTML->PDF Fehler "Markup im Dokument vor dem Root-Element"
 Der HTML->PDF Pfad normalisiert HTML jetzt vor dem openhtmltopdf Renderer. Dadurch werden typische Ursachen abgefangen: UTF-8 BOM, HTML-Fragmente ohne Root-Element, nicht XML-konforme Tags wie `<br>`, `<hr>` oder `<img>` ohne schließenden Slash.
@@ -584,3 +584,53 @@ Barcode-/QR-Platzhalter in DOCX müssen alleine in einem Absatz stehen:
 ```

 Für Druck ohne LibreOffice verwendet das Beispiel `docxConverter=DOCX4J_FO`. Jede DOCX-Vorlage sollte vor produktiver Nutzung validiert werden.
+
+## v2.5: Windows-Assistent uebersichtlicher und Queue-Datenschutz
+
+Der Windows-/Drucker-Assistent trennt die Bereiche:
+
+- **A. Gefundene Windows-Spooler-/CUPS-Drucker** bleibt als breite, scrollbar lesbare Liste sichtbar.
+- **B. RAW_TCP fuer ZPL/EPL** ist jetzt ein Button mit Modal-Dialog.
+- **C. Windows-Kommandos** ist jetzt ein Button mit Modal-Dialog.
+
+Die Druckwarteschlange des Printservice ist unter `<configDir>/queue/print-jobs.json` gespeichert. Sie kann aus Datenschutzgruenden deaktiviert werden.
+
+### Queue-Einstellungen
+
+```json
+{
+  "enabled": true,
+  "storeRequestsForReprint": true,
+  "autoCleanupEnabled": true,
+  "retentionDays": 30,
+  "maxStoredJobs": 5000
+}
+```
+
+### Queue deaktivieren
+
+```json
+{
+  "enabled": false,
+  "storeRequestsForReprint": false,
+  "autoCleanupEnabled": false,
+  "retentionDays": 0,
+  "maxStoredJobs": 0
+}
+```
+
+### REST: Queue komplett leeren
+
+```bash
+curl -X DELETE http://localhost:8080/api/queue \
+  -H "X-Printservice-Token: YOUR_ADMIN_TOKEN"
+```
+
+### REST: Jobs aelter als X Tage loeschen
+
+```bash
+curl -X POST "http://localhost:8080/api/queue/cleanup?olderThanDays=30" \
+  -H "Content-Type: application/json" \
+  -H "X-Printservice-Token: YOUR_ADMIN_TOKEN" \
+  -d "{}"
+```