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/application/src/dto/tour_sync.rs

@@ -13,7 +13,7 @@
 use chrono::NaiveDate;
 use serde::{Deserialize, Serialize};
 
-use holzleitner_domain::Address;
+use holzleitner_domain::{Address, ContactKind, ContactRole};
 
 #[derive(Debug, Clone, Deserialize, Serialize)]
 #[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
@@ -29,6 +29,12 @@ pub struct SyncTourRequest {
 #[serde(rename_all = "camelCase")]
 pub struct SyncDelivery {
     pub belegart_id: i64,
+    /// Belegart-Kurzcode (z. B. „VL5"), aus `Belegarten.Belegart` (getrimmt).
+    #[serde(default)]
+    pub belegart_code: Option<String>,
+    /// Belegart-Klartext (z. B. „Lieferschein EH"), aus `Belegarten.Bezeichnung`.
+    #[serde(default)]
+    pub belegart_name: Option<String>,
     pub belegnummer: String,
 
     pub erp_customer_id: i64,
@@ -44,7 +50,62 @@ pub struct SyncDelivery {
     pub desired_time: Option<String>,
     pub special_agreements: Option<String>,
 
+    /// Bei Bestellung schon bezahlter Betrag in EUR. Default `0.0`,
+    /// wenn der Kunde alles bei Lieferung zahlt. Der ERP-Sync liefert
+    /// den Wert mit.
+    #[serde(default)]
+    pub prepaid_amount: f64,
+
+    /// Für den Restbetrag gewählte Zahlungsart — Referenz per
+    /// `code` (z. B. `"cash"`, `"invoice"`). Das ERP kennt seine
+    /// Standard-Codes, der Sync-Code resolvet sie zur UUID. Wenn
+    /// `None`, fällt der Backend-Code auf `"cash"` zurück.
+    #[serde(default)]
+    pub payment_method_code: Option<String>,
+
     pub items: Vec<SyncDeliveryItem>,
+
+    /// Alle vom ERP an diesem Beleg hängenden Kontakt-Adressen (Beleg-/
+    /// Liefer-/Rechnungsadresse, Ansprechpartner, Kundenstamm). Leere
+    /// Quellen (kein einziger ausgefüllter Kanal *und* kein Name) lässt
+    /// der Sync weg.
+    #[serde(default)]
+    pub contact_sources: Vec<SyncContactSource>,
+}
+
+/// Eine Adress-Rolle eines Belegs mit Namensblock und allen ausgefüllten
+/// Telefon-/Mobil-/E-Mail-/Web-Einträgen.
+#[derive(Debug, Clone, Deserialize, Serialize)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct SyncContactSource {
+    pub role: ContactRole,
+    #[serde(default)]
+    pub anrede: Option<String>,
+    #[serde(default)]
+    pub titel: Option<String>,
+    #[serde(default)]
+    pub name1: Option<String>,
+    #[serde(default)]
+    pub name2: Option<String>,
+    #[serde(default)]
+    pub name3: Option<String>,
+    #[serde(default)]
+    pub abteilung: Option<String>,
+    #[serde(default)]
+    pub funktion: Option<String>,
+    #[serde(default)]
+    pub channels: Vec<SyncContactChannel>,
+}
+
+#[derive(Debug, Clone, Deserialize, Serialize)]
+#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct SyncContactChannel {
+    pub kind: ContactKind,
+    /// 1-basiert: spiegelt ERP-Spaltenposition (Telefon → 1, Telefon2 → 2, …).
+    pub position: i16,
+    pub value: String,
 }
 
 #[derive(Debug, Clone, Deserialize, Serialize)]
@@ -53,7 +114,13 @@ pub struct SyncDelivery {
 pub struct SyncDeliveryItem {
     pub belegzeilen_nr: i32,
     /// Komponenten-Artikelnummer bei aufgelösten Stücklisten, sonst leer.
+    /// Trägt die **eigene** Nummer der Komponente (eindeutig je Belegzeile).
     pub komponenten_artikel_nr: Option<String>,
+    /// Artikelnummer des **Oberartikels**, zu dem diese Komponente gehört.
+    /// `None` bei Oberartikeln/regulären Zeilen. Erlaubt der App, Komponenten
+    /// unter ihrem Oberartikel einzurücken.
+    #[serde(default)]
+    pub parent_artikel_nr: Option<String>,
 
     pub article_number: String,
     pub article_name: String,
@@ -65,4 +132,9 @@ pub struct SyncDeliveryItem {
     pub warehouse_name: String,
 
     pub required_quantity: i32,
+
+    /// Stückpreis (brutto, EUR). Default `0.0`. Liefert der ERP-Sync mit;
+    /// die App rechnet daraus den Warenwert.
+    #[serde(default)]
+    pub unit_price: f64,
 }