6a9b5872e1
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>
46 lines
1.6 KiB
Rust
46 lines
1.6 KiB
Rust
//! Request/Response für `POST /deliveries/{id}/credit` — die
|
|
//! Betrags-Gutschrift (append-only, idempotent über `client_event_id`).
|
|
|
|
use serde::{Deserialize, Serialize};
|
|
use uuid::Uuid;
|
|
|
|
use holzleitner_domain::DeliveryCredit;
|
|
|
|
/// Art des Gutschrift-Ereignisses.
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize, Serialize)]
|
|
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
|
|
#[serde(rename_all = "snake_case")]
|
|
pub enum CreditAction {
|
|
/// Gutschrift setzen/ändern — `amount_cents` und `reason` Pflicht.
|
|
Set,
|
|
/// Gutschrift entfernen — `amount_cents`/`reason` werden ignoriert.
|
|
Remove,
|
|
}
|
|
|
|
#[derive(Debug, Clone, Deserialize, Serialize)]
|
|
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct DeliveryCreditEventRequest {
|
|
/// Idempotenz-Schlüssel — pro erzeugtem Ereignis genau einmal vergeben.
|
|
/// Ein Retry mit derselben Id wendet nichts erneut an.
|
|
pub client_event_id: Uuid,
|
|
pub action: CreditAction,
|
|
/// Bei `Set` Pflicht: Betrag in Cent (> 0, ≤ 15000, Vielfaches von 1000).
|
|
#[serde(default)]
|
|
pub amount_cents: Option<i64>,
|
|
/// Bei `Set` Pflicht: Begründung.
|
|
#[serde(default)]
|
|
pub reason: Option<String>,
|
|
/// Fahrzeug des Akteurs (Audit-Spur). Muss zum Account gehören.
|
|
#[serde(default)]
|
|
pub author_car_id: Option<Uuid>,
|
|
}
|
|
|
|
#[derive(Debug, Clone, Serialize, Deserialize)]
|
|
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct DeliveryCreditResponse {
|
|
/// Aktueller Stand nach dem Ereignis — `None`, wenn (zuletzt) entfernt.
|
|
pub credit: Option<DeliveryCredit>,
|
|
}
|