Struct ResourceBookingUseCases 

pub struct ResourceBookingUseCases { /* private fields */ }

Use cases for resource booking operations

Orchestrates business logic for community space bookings with conflict detection, owner name enrichment, and authorization checks.

Implementations

impl ResourceBookingUseCases

pub fn new( booking_repo: Arc<dyn ResourceBookingRepository>, owner_repo: Arc<dyn OwnerRepository>, ) -> Self

pub async fn create_booking( &self, booked_by: Uuid, dto: CreateResourceBookingDto, ) -> Result<ResourceBookingResponseDto, String>

Create a new resource booking with conflict detection

Steps

1. Create booking entity (validates business rules)
2. Check for conflicts (overlapping bookings for same resource)
3. Persist booking
4. Enrich response with owner name

Authorization

• Any authenticated owner can create bookings

pub async fn get_booking( &self, booking_id: Uuid, ) -> Result<ResourceBookingResponseDto, String>

Get booking by ID with owner name enrichment

pub async fn list_building_bookings( &self, building_id: Uuid, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List all bookings for a building

pub async fn list_by_resource_type( &self, building_id: Uuid, resource_type: ResourceType, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List bookings by building and resource type

pub async fn list_by_resource( &self, building_id: Uuid, resource_type: ResourceType, resource_name: String, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List bookings for a specific resource (building + type + name)

pub async fn list_user_bookings( &self, user_id: Uuid, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List bookings by user (owner who made the booking)

pub async fn list_user_bookings_by_status( &self, user_id: Uuid, status: BookingStatus, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List bookings by user and status

pub async fn list_building_bookings_by_status( &self, building_id: Uuid, status: BookingStatus, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List bookings by building and status

pub async fn list_upcoming_bookings( &self, building_id: Uuid, limit: Option<i64>, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List upcoming bookings (future, confirmed or pending)

pub async fn list_active_bookings( &self, building_id: Uuid, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List active bookings (currently in progress)

pub async fn list_past_bookings( &self, building_id: Uuid, limit: Option<i64>, ) -> Result<Vec<ResourceBookingResponseDto>, String>

List past bookings

pub async fn update_booking( &self, booking_id: Uuid, updater_id: Uuid, dto: UpdateResourceBookingDto, ) -> Result<ResourceBookingResponseDto, String>

Update booking details (resource_name, notes)

Time changes require cancellation and rebooking to ensure conflict detection.

Authorization

• Only booking owner can update their booking

pub async fn cancel_booking( &self, booking_id: Uuid, canceller_id: Uuid, ) -> Result<ResourceBookingResponseDto, String>

Cancel a booking

Authorization

• Only booking owner can cancel their booking

pub async fn complete_booking( &self, booking_id: Uuid, ) -> Result<ResourceBookingResponseDto, String>

Complete a booking (typically auto-called after end_time)

Authorization

• Admin only (for manual completion)

pub async fn mark_no_show( &self, booking_id: Uuid, ) -> Result<ResourceBookingResponseDto, String>

Mark booking as no-show

Authorization

• Admin only

pub async fn confirm_booking( &self, booking_id: Uuid, ) -> Result<ResourceBookingResponseDto, String>

Confirm a pending booking

Authorization

• Admin only (for approval workflow)

pub async fn delete_booking( &self, booking_id: Uuid, deleter_id: Uuid, ) -> Result<(), String>

Delete a booking

Authorization

• Only booking owner can delete their booking
• Or admin for any booking

pub async fn check_conflicts( &self, building_id: Uuid, resource_type: ResourceType, resource_name: String, start_time: DateTime<Utc>, end_time: DateTime<Utc>, exclude_booking_id: Option<Uuid>, ) -> Result<Vec<ResourceBookingResponseDto>, String>

Check for booking conflicts

Useful for frontend to preview conflicts before creating booking.

Returns list of conflicting bookings with owner names.

pub async fn get_statistics( &self, building_id: Uuid, ) -> Result<BookingStatisticsDto, String>

Get booking statistics for a building