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>
This commit is contained in:
Dennis Nemec
2026-06-01 17:52:58 +02:00
parent 438040acce
commit 6a9b5872e1
137 changed files with 13700 additions and 218 deletions

View File

@ -0,0 +1,45 @@
use serde::{Deserialize, Serialize};
use uuid::Uuid;
/// Eingabetyp eines Service (früher „Lieferoption"). `Boolean` rendert als
/// Checkbox, `Numeric` als Zahlenfeld mit optionalen Grenzen.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "snake_case")]
pub enum ServiceKind {
Boolean,
Numeric,
}
/// Service-Stammdatensatz — admin-konfigurierbar (Muster wie `PaymentMethod`).
///
/// `key` ist der stabile Programm-Identifier (eindeutig), `name` der
/// Anzeige-Name. `min_value`/`max_value` sind nur für `Numeric` relevant.
/// `active = false` ist Soft-Delete (bleibt für historische Lieferungen
/// referenzierbar, fällt aus dem Default-Listing).
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct Service {
pub id: Uuid,
pub key: String,
pub name: String,
pub kind: ServiceKind,
pub min_value: Option<i32>,
pub max_value: Option<i32>,
pub active: bool,
pub sort_order: i32,
}
/// Pro-Lieferung gewählter Wert eines Service. Genau einer der beiden
/// Wert-Slots ist je nach `ServiceKind` gesetzt; per `service_id`/`delivery_id`
/// clientseitig join-bar (wie Notizen/Gutschriften).
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct DeliveryServiceValue {
pub delivery_id: Uuid,
pub service_id: Uuid,
pub bool_value: Option<bool>,
pub numeric_value: Option<i32>,
}