438040acce
Vier-Crate-Workspace mit:
- Domain: Account, Car, Tour, Delivery, DeliveryItem, DeliveryNote, Customer,
Article, Warehouse, ScanState, AuditAction — alle mit serde + feature-gated
utoipa::ToSchema.
- Application: Ports (TourRepository, DeliveryRepository, ScanRepository,
DeliveryNoteRepository, CarRepository, AuthService) und Use Cases.
- Infrastructure: Postgres-Adapter via sqlx (PgTourRepository etc.) +
Keycloak-AuthService mit JWKS-Cache + OIDC-Discovery.
- API: Axum 0.8, utoipa-OpenAPI + Swagger-UI, JWT-Bearer-Middleware,
AuthenticatedUser-Extractor.
Endpoints:
- GET /me/tours/today, /tours/{id}, /accounts/{pn}, /me/cars, /health
- POST /sync/tour, /scans (bulk + idempotent via clientScanId),
/deliveries/{id}/{hold,resume,cancel,complete,notes}, /me/cars
- PUT /tours/{id}/delivery-order, /deliveries/{id}/assigned-car, /me/cars/{id}
- PATCH /me/cars/{id}
Datenmodell:
- 6 Migrationen (accounts, tours/deliveries/items + Stammdaten,
scan_audit mit clientScanId-UNIQUE, state_reason refactor,
delivery_notes, cars + FKs nachziehen).
- Business-stabile Beleg-Keys (belegart_id, belegnummer) für ERP-Sync.
- Append-only scan_audit + embedded scan_state als doppelte Wahrheit.
Dev-Setup:
- docker-compose mit Postgres 17 + Keycloak 26
- Keycloak-Realm 'holzleitner' mit Public-Client (PKCE), Testfahrer
(PN 1001) + Audience-/Personalnummer-Mapper
59 lines
1.8 KiB
Rust
59 lines
1.8 KiB
Rust
//! Port für Fahrzeug-Stammdaten.
|
|
//!
|
|
//! Alle Lese- und Schreibzugriffe gehen über `account_id` (=
|
|
//! Personalnummer aus dem JWT). Es gibt **keine** Methode, die
|
|
//! Fahrzeuge ohne Account-Filter zurückgibt — so ist die Isolation
|
|
//! zwischen Subunternehmer-Accounts strukturell garantiert.
|
|
|
|
use async_trait::async_trait;
|
|
use uuid::Uuid;
|
|
|
|
use holzleitner_domain::Car;
|
|
|
|
use crate::error::ApplicationError;
|
|
|
|
#[async_trait]
|
|
pub trait CarRepository: Send + Sync {
|
|
/// Liste der Fahrzeuge eines Accounts. `include_inactive = false`
|
|
/// blendet deaktivierte Fahrzeuge aus (Default für die App).
|
|
async fn find_by_account(
|
|
&self,
|
|
personalnummer: i64,
|
|
include_inactive: bool,
|
|
) -> Result<Vec<Car>, ApplicationError>;
|
|
|
|
/// Sucht ein Fahrzeug, das einem Account gehört. `None` wenn es
|
|
/// das Fahrzeug nicht gibt **oder** zu einem anderen Account
|
|
/// gehört — beides sieht für den Caller gleich aus, das ist
|
|
/// gewollt (kein Account-Probing).
|
|
async fn find_by_id_for_account(
|
|
&self,
|
|
car_id: Uuid,
|
|
personalnummer: i64,
|
|
) -> Result<Option<Car>, ApplicationError>;
|
|
|
|
async fn create(
|
|
&self,
|
|
personalnummer: i64,
|
|
plate: &str,
|
|
) -> Result<Car, ApplicationError>;
|
|
|
|
/// Optional-Patch. `None` heißt "unverändert".
|
|
async fn update(
|
|
&self,
|
|
car_id: Uuid,
|
|
personalnummer: i64,
|
|
plate: Option<&str>,
|
|
active: Option<bool>,
|
|
) -> Result<Car, ApplicationError>;
|
|
|
|
/// Validiert, dass alle übergebenen IDs zum Account gehören. Nutzt
|
|
/// der Use-Case beim Bulk-Scan, um die `actor_car_id`-Werte
|
|
/// einmalig vor dem Verarbeiten zu prüfen.
|
|
async fn assert_owned_by_account(
|
|
&self,
|
|
car_ids: &[Uuid],
|
|
personalnummer: i64,
|
|
) -> Result<(), ApplicationError>;
|
|
}
|