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>

crates/domain/src/contact.rs

@@ -0,0 +1,66 @@
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+/// Rolle, mit der ein Kontakt-Datensatz an einer Lieferung hängt. Spiegelt
+/// die fünf Adress-FKs von `Belegkopf` (bzw. den Umweg über den Kunden):
+/// `header` = Belegadresse, `delivery` = Lieferadresse, `billing` =
+/// Rechnungsadresse, `contact_person` = Ansprechpartner, `customer_master`
+/// = Stammadresse des Kunden über `Kunden.AdressId`.
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Hash)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "snake_case")]
+pub enum ContactRole {
+    Header,
+    Delivery,
+    Billing,
+    ContactPerson,
+    CustomerMaster,
+}
+
+/// Art eines Kommunikationskanals. `fax` bewusst nicht mitgeführt — in der
+/// App nicht verwendet.
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Hash)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "snake_case")]
+pub enum ContactKind {
+    Phone,
+    Mobile,
+    Email,
+    Web,
+}
+
+/// Snapshot eines ERP-Adress-Datensatzes, der zum Zeitpunkt des Tour-Syncs
+/// an einer Lieferung hing — Namensblock ohne Anschrift, weil die Adresse
+/// ihrerseits schon im Lieferungs-Snapshot steckt (`snap_*`-Spalten). Die
+/// eigentlichen Telefonnummern, E-Mails etc. liegen in den
+/// zugehörigen [`ContactChannel`]s.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct ContactSource {
+    pub id: Uuid,
+    pub delivery_id: Uuid,
+    pub role: ContactRole,
+    pub anrede: Option<String>,
+    pub titel: Option<String>,
+    pub name1: Option<String>,
+    pub name2: Option<String>,
+    pub name3: Option<String>,
+    pub abteilung: Option<String>,
+    pub funktion: Option<String>,
+}
+
+/// Ein einzelner Kontaktkanal (Telefonnummer / Mobil / E-Mail / Web).
+/// Mehrere pro [`ContactSource`] möglich, die `position` hält die
+/// 1-basierte ERP-Reihenfolge (`Telefon` → 1, `Telefon2` → 2 usw.) fest,
+/// damit der „primäre" Kanal je Art stabil identifizierbar bleibt.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct ContactChannel {
+    pub id: Uuid,
+    pub source_id: Uuid,
+    pub kind: ContactKind,
+    pub position: i16,
+    pub value: String,
+}