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/usecases/apply_scans.rs

@@ -99,8 +99,21 @@ impl ApplyScansUseCase {
 }
 
 /// Validiert Pflichtfelder ohne DB-Aufruf. Liefert `Some(reason)`,
-/// wenn das Event verworfen werden soll.
+/// wenn das Event verworfen werden soll. Mengen- und Status-abhängige
+/// Bounds (z. B. `credited + quantity <= required`, scannbar ⇒ done,
+/// Lieferung aktiv) prüft erst das Repository mit dem gelockten Item.
 fn pre_validate(event: &ScanEvent) -> Option<String> {
+    // Eine gesetzte Menge muss positiv sein — und ist nur für die
+    // Mengen-Gutschrift (Remove/Unremove) überhaupt sinnvoll.
+    if let Some(q) = event.quantity {
+        match event.action {
+            AuditAction::Remove | AuditAction::Unremove if q <= 0 => {
+                return Some("quantity must be > 0".into());
+            }
+            _ => {}
+        }
+    }
+
     match event.action {
         AuditAction::Hold | AuditAction::Remove => {
             let trimmed = event.reason.as_deref().map(str::trim).unwrap_or("");
@@ -113,6 +126,9 @@ fn pre_validate(event: &ScanEvent) -> Option<String> {
                 None
             }
         }
-        AuditAction::Scan | AuditAction::Unscan | AuditAction::Unhold => None,
+        AuditAction::Scan
+        | AuditAction::Unscan
+        | AuditAction::Unhold
+        | AuditAction::Unremove => None,
     }
 }