Booking

Descripción

El módulo Booking gestiona la creación, visualización y cancelación de reservas. Soporta tres tipos de operación: reserva directa, intercambio y alquiler.

Ubicación: src/modules/booking/

Los usuarios visitantes y aquellos sin propiedades registradas solo tienen acceso a la pantalla de alquiler (RentScreen).

Screens

Screen	Ruta	Descripción
`BookScreen`	`/(tabs)/02_book/book-stays`	Lista de propiedades disponibles para reservar
`ExchangeScreen`	`/(tabs)/02_book/exchange-stays`	Propiedades disponibles para intercambio
`RentScreen`	`/(tabs)/02_book/rent-stays`	Propiedades disponibles para alquiler
`BookingCreationScreen`	`/booking/new`	Crear nueva reserva
`BookingConfirmationScreen`	`/booking/review`	Confirmación de reserva

API Endpoints

Método	Path	Descripción
`GET`	`/v2/bookings/{id}`	Detalle de una reserva
`GET`	`/v2/homes/{id}`	Propiedad asociada a reserva
`POST`	`/v2/bookings/stay/{id}/update`	Actualizar datos de la estancia
`POST`	`/v1/bookings/{id}/reviews`	Enviar reseña
`POST`	`/v2/bookings/book`	Crear reserva (por slots V2)
`PUT`	`/v2/bookings/{id}/request-rent`	Crear reserva de alquiler
`PUT`	`/v2/bookings/{id}/exchange`	Crear reserva de intercambio
`POST`	`/v2/bookings/exchange-last-hour`	Intercambio de última hora
`DELETE`	`/v2/bookings/{id}/cancel`	Cancelar reserva
`DELETE`	`/v2/bookings/stay/{id}/cancel`	Cancelar la propia estancia (asistente)
`PUT`	`/v2/bookings/{id}/change`	Modificar tipo de reserva

Hooks

Hook	Descripción
`useBooking(bookingId, propertyId)`	Fetch de reserva y propiedad
`useCancelBooking()`	Cancelar con invalidación de cache
`useModifyBooking()`	Modificar tipo de reserva
`useBookingDetail(bookingId)`	Detalle de una reserva
`useBookingReviews()`	Enviar reseña
`useCreateBooking()`	Crear reserva directa
`useCreateBookingToRent()`	Crear reserva de alquiler
`useCreateBookingToExchange()`	Crear reserva de intercambio
`useCreateBookingToExchangeLastHour()`	Intercambio última hora
`useBookingUpdate({ enableAutoUpdate })`	Autoguardado con debounce del formulario de reserva

Tipos principales

BookingInfo
Estados y tipos
Guest

interface BookingInfo {
  checkIn: string;
  checkOut: string;
  adults: number;
  kids: number;
  pets: number;
  requests: string;
  cleaning: boolean;
  rental: boolean;
  reservations: Reservation[];
  crib: boolean;
}

// Estados de reserva
type BookingStatus = "ACTIVE" | "CANCELLED" | "PAST";

// Tipos de reserva
type BookingType = "EXCHANGE" | "RENT";

// Estados de aprobación
type ApprovalStatus = "APPROVED" | "REJECTED" | "PENDING" | "FREE";

Una reserva de alquiler, intercambio o ThirdHome publicada (sin estancia asociada) queda en estado FREE, no APPROVED: aún no hay una solicitud aceptada, por lo que no debe mostrarse como “Alquilada”, “Intercambiada” ni “Confirmada”. Solo las reservas de tipo enjoy sin estancia permanecen en APPROVED.

// Información del huésped asociado a la reserva
interface Guest {
  name: string;
  email: string;
  phone: string;
  // ...campos adicionales
}

Componentes destacados

booking-creation

Flujo completo de creación de reserva: selección de propiedad, fechas, huéspedes y confirmación.

calendar

Componente de selección de fechas con soporte para rangos, disponibilidad y bloqueos.

Queries

Todas las consultas de reservas utilizan React Query (bookingQueries) para fetching y caching. No realizar llamadas directas al API fuera de este sistema de queries.

El módulo define bookingQueries con claves de cache estructuradas para:

Listado de reservas del usuario
Detalle de reserva individual
Propiedades asociadas
Invalidación automática tras mutaciones (crear, cancelar, modificar)

Overview

Architecture

Modules

Shared

Integrations

Guides

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Componentes destacados

booking-creation

calendar

Queries

​Descripción

​Screens

​API Endpoints

​Hooks

​Tipos principales

​Componentes destacados

booking-creation

calendar

​Queries

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Componentes destacados

Queries