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,30 @@
use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use uuid::Uuid;
/// Zahlungs-Stammdatensatz.
///
/// Bewusst eine Tabelle und kein Enum: neue Anbieter (PayPal, Klarna, …)
/// kommen über den `POST /payment-methods`-Endpoint hinzu. Domain-Code
/// kann trotzdem fachliche Sonderfälle über den stabilen `code` (z. B.
/// `"invoice"` braucht Bonitätsprüfung) referenzieren — die UUID dient
/// nur als FK in `deliveries`.
///
/// `active = false` ist Soft-Delete: die Methode bleibt referenzierbar
/// für historische Lieferungen, taucht aber in der UI-Auswahl nicht
/// mehr auf. Echtes Löschen ist nur möglich, wenn keine Lieferung sie
/// referenziert — Datenbank-Constraint regelt das via
/// `ON DELETE RESTRICT`.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct PaymentMethod {
pub id: Uuid,
/// Stabiler Programm-Identifier — z. B. `"cash"`, `"ec_card"`.
/// Eindeutig pro Eintrag. Wird vom Aufrufer beim Anlegen gesetzt.
pub code: String,
/// Display-Name in der UI — frei via PATCH änderbar.
pub name: String,
pub active: bool,
pub created_at: DateTime<Utc>,
}