//! OpenAPI-Aggregation: zieht alle annotierten Handler und Schemata in
//! ein einziges Dokument zusammen, das der `/openapi.json`-Endpoint
//! serviert und Swagger-UI darstellt.
//!
//! Neue Endpoints werden hier in `paths(...)` registriert, neue Schemata
//! in `components(schemas(...))`. Die Annotation am Handler (via
//! `#[utoipa::path(...)]`) liefert die eigentliche Beschreibung.

use utoipa::Modify;
use utoipa::OpenApi;
use utoipa::openapi::security::{HttpAuthScheme, HttpBuilder, SecurityScheme};

#[derive(OpenApi)]
#[openapi(
    info(
        title = "Holzleitner Backend API",
        version = "0.1.0",
        description = "Backend für die Holzleitner-Lieferservice-App — Tour, Beladung, Ausführung."
    ),
    paths(
        crate::routes::health::health,
        crate::routes::accounts::get_account,
        crate::routes::tours::list_my_tours_today,
        crate::routes::tours::get_tour,
        crate::routes::tours::set_delivery_order,
        crate::routes::tours::sync_tour,
        crate::routes::scans::apply_scans,
        crate::routes::deliveries::hold,
        crate::routes::deliveries::resume,
        crate::routes::deliveries::cancel,
        crate::routes::deliveries::complete,
        crate::routes::deliveries::create_note,
        crate::routes::deliveries::assign_car,
        crate::routes::cars::list_my_cars,
        crate::routes::cars::create_my_car,
        crate::routes::cars::update_my_car,
    ),
    components(
        schemas(
            holzleitner_domain::Account,
            holzleitner_domain::Address,
            holzleitner_domain::Article,
            holzleitner_domain::AuditAction,
            holzleitner_domain::Car,
            holzleitner_domain::Customer,
            holzleitner_domain::CustomerContact,
            holzleitner_domain::Delivery,
            holzleitner_domain::DeliveryItem,
            holzleitner_domain::DeliveryNote,
            holzleitner_domain::DeliveryState,
            holzleitner_domain::ScanState,
            holzleitner_domain::ScanStatus,
            holzleitner_domain::Tour,
            holzleitner_domain::Warehouse,
            holzleitner_application::dto::TourDetails,
            holzleitner_application::dto::DeliveryWithItems,
            holzleitner_application::dto::TourSummary,
            holzleitner_application::dto::SyncTourRequest,
            holzleitner_application::dto::SyncDelivery,
            holzleitner_application::dto::SyncDeliveryItem,
            holzleitner_application::dto::SetDeliveryOrderRequest,
            holzleitner_application::dto::SetDeliveryOrderResponse,
            holzleitner_application::dto::DeliveryOrderEntry,
            holzleitner_application::dto::ApplyScansRequest,
            holzleitner_application::dto::ApplyScansResponse,
            holzleitner_application::dto::ScanEvent,
            holzleitner_application::dto::ScanResult,
            holzleitner_application::dto::ScanResultStatus,
            holzleitner_application::dto::HoldDeliveryRequest,
            holzleitner_application::dto::CancelDeliveryRequest,
            holzleitner_application::dto::DeliveryResponse,
            holzleitner_application::dto::CreateDeliveryNoteRequest,
            holzleitner_application::dto::DeliveryNoteResponse,
            holzleitner_application::dto::CreateCarRequest,
            holzleitner_application::dto::UpdateCarRequest,
            holzleitner_application::dto::CarResponse,
            holzleitner_application::dto::CarsList,
            holzleitner_application::dto::AssignCarRequest,
            crate::routes::tours::TourSummaryList,
            crate::routes::tours::SyncTourResponse,
        )
    ),
    modifiers(&SecurityAddon),
    tags(
        (name = "health", description = "Health- und Status-Endpoints"),
        (name = "accounts", description = "Account-Stammdaten"),
        (name = "tours", description = "Touren der Fahrer"),
        (name = "sync", description = "ERP-Sync-Endpunkte"),
        (name = "scans", description = "Scan-Events (Beladung & Auslieferung)"),
        (name = "deliveries", description = "Delivery-Lifecycle (hold / resume / cancel / complete)"),
        (name = "cars", description = "Fahrzeug-Stammdaten pro Fahrer"),
    ),
    security(
        ("bearer_auth" = [])
    )
)]
pub struct ApiDoc;

/// Hängt das `bearer_auth`-Security-Scheme nachträglich in die Spec ein —
/// das geht nur über einen `Modify`-Hook, weil derive-Macros das nicht
/// direkt erlauben.
struct SecurityAddon;

impl Modify for SecurityAddon {
    fn modify(&self, openapi: &mut utoipa::openapi::OpenApi) {
        if let Some(components) = openapi.components.as_mut() {
            components.add_security_scheme(
                "bearer_auth",
                SecurityScheme::Http(
                    HttpBuilder::new()
                        .scheme(HttpAuthScheme::Bearer)
                        .bearer_format("JWT")
                        .build(),
                ),
            );
        }
    }
}