Diagrama de secuencia: Crear Reserva - MiguelAngelMarinMejia1/ArquitecturaDeSoftware-Proyecto GitHub Wiki

sequenceDiagram
    autonumber
    actor Huesped
    participant View as ReservationPageView<br/>(web) / APIView
    participant Serial as ReservationCreateSerializer
    participant Svc as ReservationService
    participant CSvc as CustomerService
    participant Gen as ConfirmationCodeGenerator
    participant Builder as ReservationBuilder
    participant Policy as PricingPolicy / TaxPolicy
    participant Sel as selectors
    participant DB as Base de datos
    participant PFac as PaymentGatewayFactory
    participant PSvc as PaymentService
    participant ISvc as InvoiceService
    participant NFac as NotifierFactory
    participant Notif as BaseNotifier

    Huesped->>View: POST datos de la reserva
    View->>Serial: validar forma del payload
    Serial-->>View: datos validados

    View->>Svc: create_reservation(data)
    activate Svc
    Note over Svc,DB: @transaction.atomic

    Svc->>CSvc: get_or_create_profile(data)
    CSvc->>DB: buscar Customer por email
    alt el huesped ya reservo antes
        DB-->>CSvc: Customer existente
        CSvc->>DB: actualizar datos de contacto
    else primera vez
        CSvc->>DB: crear Customer (user = NULL)
    end
    CSvc-->>Svc: customer

    Svc->>DB: cargar habitaciones por id
    alt alguna no existe
        DB-->>Svc: faltan ids
        Svc-->>View: RoomNotFoundError
        View-->>Huesped: 404 Not Found
    end
    DB-->>Svc: rooms

    Svc->>Gen: generate_unique(existe?)
    Gen->>DB: comprobar unicidad del codigo
    Gen-->>Svc: MDJ-XXXXXXXX

    Svc->>Builder: for_customer().add_rooms().with_dates()<br/>.with_guests().with_confirmation_code()
    Svc->>Builder: build()
    activate Builder

    Builder->>Builder: validar completitud
    Builder->>Builder: validar al menos una habitacion
    Builder->>Builder: validar rango de fechas
    Builder->>Builder: validar capacidad (CapacityPolicy)

    Builder->>Sel: is_room_available(room, entrada, salida)
    Sel->>DB: buscar reservas solapadas
    DB-->>Sel: resultado
    Sel-->>Builder: disponible / ocupada

    alt alguna validacion falla
        Builder-->>Svc: excepcion de dominio
        Svc-->>View: propaga
        View-->>Huesped: 400 / 409
    end

    Builder->>Policy: quote(rooms, entrada, salida)
    Policy->>Policy: tarifa por noche por habitacion
    Policy->>Policy: subtotal, impuestos, total
    Policy-->>Builder: PriceBreakdown

    Builder-->>Svc: ReservationDraft (sin persistir)
    deactivate Builder

    Svc->>DB: guardar Reservation
    Svc->>DB: bulk_create ReservationRoom

    Svc->>PSvc: charge(reservation, metodo)
    PSvc->>PFac: create()
    PFac-->>PSvc: SimulatedGateway
    PSvc->>PSvc: gateway.charge(total)
    PSvc->>DB: crear Payment
    alt pago rechazado
        PSvc-->>Svc: PaymentDeclinedError
        Note over Svc,DB: rollback completo
        Svc-->>View: propaga
        View-->>Huesped: 402 Payment Required
    end
    PSvc-->>Svc: payment

    Svc->>ISvc: issue(payment)
    ISvc->>DB: crear Invoice
    ISvc-->>Svc: invoice

    Svc->>DB: Reservation.status = CONFIRMED
    Note over Svc,DB: commit de la transaccion
    deactivate Svc

    Svc->>NFac: create()
    NFac-->>Svc: ConsoleNotifier / EmailNotifier
    Svc->>Notif: send_confirmation(reservation)

    Svc-->>View: reservation
    View-->>Huesped: 201 Created + codigo de confirmacion