Lokalen Rechnungsassistenten mit Vorlagen und PDF-Vorschau ergänzen

README.md

@@ -1,4 +1,49 @@
-# einvoice – Rechnung mit einem Konsolenaufruf
+# einvoice – Rechnungen per Oberfläche oder Konsolenaufruf
+
+## Desktop-Oberfläche
+
+**Vorlage laden → Daten prüfen und ergänzen → E-Rechnung erstellen → fertige PDF im Fenster ansehen.**
+Die lokale Anwendung verwendet dieselbe Berechnung, Nummernvergabe und technische
+Validierung wie die Konsole. Ein separates Repository ist deshalb nicht erforderlich.
+
+```bash
+# Auf diesem Rechner eingerichtet:
+einvoice-ui
+# Alternativ:
+einvoice --gui
+```
+
+Im Anwendungsmenü steht **JR eInvoice**. Kunden lassen sich wiederverwenden oder
+neu erfassen. Mehrere Positionen mit mehrzeiliger Beschreibung, Mengen, deutschen
+Nettopreisen, Steuersätzen, Leistungszeitraum und Zahlungsziel sind bearbeitbar.
+Die Betragsübersicht rechnet sofort mit. „Entwurf ansehen“ zeigt eine PDF ohne
+Nummernreservierung; „E-Rechnung erstellen“ speichert und validiert die endgültige
+ZUGFeRD-PDF und zeigt sie direkt an. Ordner und Prüfbericht sind per Knopf erreichbar.
+
+Eigene YAML-Vorlagen und frühere `invoice.yaml`-Dateien können geladen werden.
+Dabei werden Nummer und Datumsfelder für eine **neue** Rechnung zurückgesetzt.
+Leistungsbeschreibung, Referenzen, Mengen, Preise und Zeitraum vor Erstellung prüfen.
+Vorlagen ändern das Rechnungsdaten-Gerüst; das Layout kommt weiterhin aus der
+gemeinsamen HTML/Jinja2-Vorlage. Die PDF-Ansicht ist schreibgeschützt.
+
+![Desktop-Oberfläche mit fiktiver Beispielrechnung](docs/assets/einvoice-ui.png)
+
+Erstinstallation / anderer Rechner:
+
+```bash
+# Bestehendes Checkout mit funktionierender Laufzeit:
+einvoice --update --apply --with-gui
+python3 scripts/install_commands.py --desktop
+
+# Entwicklerumgebung (Java und Mustang wie unten einrichten):
+pip install -e '.[pdf,gui]'
+.venv/bin/einvoice-ui
+```
+
+Die GUI ist optional; reine Konsoleninstallationen benötigen Qt nicht. Nach einem
+Update mit `--with-gui` behalten weitere Updates die Oberfläche bei. Rechnungs- und
+Kundendaten bleiben lokal; die Anwendung versendet keine E-Mails.
+[Bedienung, Installation und technische Details](docs/desktop-ui.md).
 
 Kundenname, Leistung, Menge und Nettopreis eingeben: `einvoice --create` erledigt
 Rechnungsnummer, Berechnung, PDF/A-Erstellung, Einbettung des EN16931-XML und
@@ -114,7 +159,7 @@ einvoice --update --rollback
 jr-einvoice --help
 ```
 
-Der Installer verlinkt beide Starter nach `~/.local/bin` und prüft ihre Funktion.
+Der Installer verlinkt die Konsolen- und GUI-Starter nach `~/.local/bin` und prüft die Konsole.
 Dort vorhandene andere Befehle werden vor dem Ersetzen gesichert. Wiederholtes
 Ausführen ist möglich. Auf diesem Rechner ist das Verzeichnis bereits im PATH.
 Bei einem gespeicherten alten Shell-Pfad einmal `rehash` (zsh) bzw. `hash -r`