feat: install user console commands and document Office independence

README.md

@@ -11,7 +11,7 @@ Auf diesem Rechner sind Python-Umgebung, Absenderdaten und Mustang eingerichtet.
 
 ```bash
 cd /home/johannes/localdev/einvoice
-export PATH="$PWD/bin:$PATH"
+python3 scripts/install_commands.py  # einmalig; auf diesem Rechner bereits eingerichtet
 
 einvoice --create \
   --Customer "Meine Kundenfirma GmbH" \
@@ -103,21 +103,50 @@ Die Konsole zeigt Schritte, Versionsänderungen und Fehler; vollständige Logs l
 in `.runtime/logs/`. Netzwerk ist nur für neue Kandidaten nötig. Ohne `--apply`
 werden Downloads, Installation und Tests ausgeführt, aber keine Umschaltung.
 
-**Für die verwaltete Laufzeit die Starter aus `bin/` verwenden:**
+**Konsolenbefehle einmalig im Benutzer-Suchpfad einrichten:**
 
 ```bash
-export PATH="/home/johannes/localdev/einvoice/bin:$PATH" # bei Bedarf in ~/.zshrc aufnehmen
-# alternativ ohne PATH-Einrichtung:
-./bin/einvoice --customers
-./bin/einvoice --update --apply
+python3 scripts/install_commands.py
+# Danach aus jedem Verzeichnis, ohne venv-Aktivierung:
+einvoice --customers
+einvoice --update --apply
+einvoice --update --rollback
+jr-einvoice --help
 ```
 
-Diese PATH-Zeile nach einer eventuellen venv-Aktivierung ausführen. Direkte Aufrufe
-von `.venv/bin/einvoice` verwenden weiterhin die ursprüngliche Entwicklerumgebung.
+Der Installer verlinkt beide Starter nach `~/.local/bin` und prüft ihre Funktion.
+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`
+(bash) ausführen. Eine aktivierte `.venv` kann die Befehle überdecken: dann
+`deactivate` ausführen. Direkte Aufrufe von `.venv/bin/einvoice` verwenden weiterhin
+die ursprüngliche Entwicklerumgebung.
 Java und native Bibliotheken werden mitgetestet, aber über den Systempaketmanager
 aktualisiert; dessen Änderungen kann dieser Updater nicht zurückrollen.
 Details und Grenzen: [Update-Betrieb](Documentation.md#updates-und-rollback).
 
+## Ohne Microsoft Office / Microsoft 365
+
+Die Rechnungslösung benötigt weder Word, Excel, Outlook noch Microsoft 365.
+Es gibt keine DOC/DOCX-, XLS/XLSX- oder PPT/PPTX-Vorlagen und keine Office-Automation.
+Auch LibreOffice muss zur Rechnungserstellung nicht installiert sein.
+
+| Zweck | Verwendetes Format |
+| --- | --- |
+| Rechnungsdaten und Stammdaten | YAML (`.yaml`) |
+| Layout | HTML/Jinja2 (`.html.j2`), Logo als SVG |
+| Fertige E-Rechnung | PDF/A-3 mit eingebettetem EN16931-XML |
+| Optionaler Mailentwurf | EML (`.eml`), ohne Outlook-Anbindung |
+| Dokumentation | Markdown (`.md`) |
+
+Ein Wechsel auf LibreOffice erfordert für dieses Projekt keine Dateikonvertierung.
+ODT-/ODS-Dateien werden aktuell weder eingelesen noch erzeugt. Layoutänderungen
+finden in der HTML-Vorlage statt. Das fertige E-Rechnungs-PDF direkt versenden;
+nicht zum Bearbeiten konvertieren oder neu als PDF exportieren, da eingebettete
+Rechnungsdaten oder die geprüfte PDF/A-Struktur verloren gehen können.
+Die tatsächliche E-Mail-Zustellung erfolgt weiterhin über dein separat eingerichtetes
+Mailprogramm bzw. Konto; sie wird von diesem Tool nicht bereitgestellt.
+
 ## Daten und Einrichtung
 
 - Absender: **johannes@jr-it-services.de**, lokale Vorlage `private/presets/seller.default.yaml`.