Files
Holzleitner---Backend--aktu…/crates/domain/src/contact.rs
Dennis Nemec 6a9b5872e1 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>
2026-06-01 17:52:58 +02:00

67 lines
2.4 KiB
Rust

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,
}