Backend-Arbeitsstand: ERP-Sync, Lieferlebenszyklus, Reports + config.toml

Bringt das Backend vom initialen Skeleton auf den aktuellen Arbeitsstand
(Clean Architecture: domain → application → infrastructure → api).

Wesentliche Bereiche:
- ERP-Anbindung (MSSQL-Pull der Touren, Import-Scheduler, Rückschreiben)
- Lieferlebenszyklus: Scan/Hold/Cancel/Complete, Gutschriften, Notizen,
  Bild-Anhänge, Unterschriften, PDF-Lieferreport → DOCUframe
- Stammdaten: Kunden, Artikel, Lager, Zahlungsarten, Services
- Keycloak-JWT-Gate + Fahrer-Provisionierung via Admin-API
- Admin-API-Key-Gate (X-Admin-Api-Key) für Maschinen-Endpunkte

Jüngste Änderungen dieser Session:
- Belegspezifische Kontaktdaten: alle ERP-Adressen (Beleg-/Liefer-/
  Rechnungsadresse, Ansprechpartner, Kundenstamm) mit Telefon/Mobil/
  E-Mail werden gesynct (Migration 0029, MSSQL-Query, TourDetails)
- Konfiguration von .env (envy/dotenvy) auf config.toml (toml/serde)
  umgestellt; Vorlage config.example.toml, Pfad via HOLZLEITNER_CONFIG

Nicht im Repo (per .gitignore): config.toml (Secrets), data/ (Laufzeit-/
Kundendaten), demo.mp4, .claude/, variocontrol-ai/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

migrations/0028_completion_mail_sent.sql

@@ -0,0 +1,20 @@
+-- 0028_completion_mail_sent.sql
+--
+-- Markierung, ob für eine ausgelieferte (abgeschlossene) Lieferung die
+-- Liefer-/Belegmail bereits versendet wurde. Der externe Mailclient pollt die
+-- noch NICHT versendeten Belege (GET /admin/delivered-belegnummern liefert nur
+-- `mail_sent_at IS NULL`), stößt ERPframe an (das die Mails verschickt) und
+-- markiert sie anschließend über POST /admin/mark-mail-sent als versendet.
+--
+-- NULL  = noch nicht versendet (offen).
+-- Wert  = Zeitstempel, wann markiert wurde (Audit + server-seitiges Dedup,
+--         damit derselbe Beleg nicht alle 5 Minuten erneut eine Mail auslöst).
+
+ALTER TABLE delivery_completions
+    ADD COLUMN mail_sent_at TIMESTAMPTZ;
+
+-- Partieller Index: der Mailclient fragt praktisch immer nur die offenen
+-- (mail_sent_at IS NULL) Belege ab.
+CREATE INDEX delivery_completions_mail_unsent
+    ON delivery_completions (completed_at)
+    WHERE mail_sent_at IS NULL;