Struct ResourceBooking 

pub struct ResourceBooking {

    pub id: Uuid,
    pub building_id: Uuid,
    pub resource_type: ResourceType,
    pub resource_name: String,
    pub booked_by: Uuid,
    pub start_time: DateTime<Utc>,
    pub end_time: DateTime<Utc>,
    pub status: BookingStatus,
    pub notes: Option<String>,
    pub recurring_pattern: RecurringPattern,
    pub recurrence_end_date: Option<DateTime<Utc>>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Resource booking entity for community space reservations

Represents a booking for shared building resources (meeting rooms, laundry, gym, etc.) with conflict detection, duration limits, and recurring booking support.

Belgian Legal Context

• Common spaces in Belgian copropriétés are shared property (Article 3 Loi Copropriété)
• Syndic can regulate usage to ensure fair access for all co-owners
• Booking system provides transparent allocation and prevents conflicts

Business Rules

• start_time must be < end_time
• start_time must be in the future (no past bookings)
• Duration must not exceed max_duration_hours (configurable per resource)
• No overlapping bookings for the same resource
• Advance booking limit (e.g., max 30 days ahead)
• Only booking owner can cancel their own bookings

Fields

id: Uuid

building_id: Uuid

resource_type: ResourceType

resource_name: String

booked_by: Uuid

start_time: DateTime<Utc>

end_time: DateTime<Utc>

status: BookingStatus

notes: Option<String>

recurring_pattern: RecurringPattern

recurrence_end_date: Option<DateTime<Utc>>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl ResourceBooking

pub const DEFAULT_MAX_DURATION_HOURS: i64 = 4i64

Maximum duration in hours per booking (default: 4 hours)

pub const DEFAULT_MAX_ADVANCE_DAYS: i64 = 30i64

Maximum advance booking in days (default: 30 days)

pub const MIN_DURATION_MINUTES: i64 = 30i64

Minimum booking duration in minutes (default: 30 minutes)

pub fn new( building_id: Uuid, resource_type: ResourceType, resource_name: String, booked_by: Uuid, start_time: DateTime<Utc>, end_time: DateTime<Utc>, notes: Option<String>, recurring_pattern: RecurringPattern, recurrence_end_date: Option<DateTime<Utc>>, max_duration_hours: Option<i64>, max_advance_days: Option<i64>, ) -> Result<Self, String>

Create a new resource booking

Validation

• resource_name must be 3-100 characters
• start_time must be < end_time
• start_time must be in the future
• Duration must be >= MIN_DURATION_MINUTES
• Duration must be <= max_duration_hours
• start_time must be <= max_advance_days in the future
• For recurring bookings, recurrence_end_date must be provided

Arguments

• building_id - Building where resource is located
• resource_type - Type of resource being booked
• resource_name - Specific resource name (e.g., “Meeting Room A”)
• booked_by - Owner ID making the booking
• start_time - Booking start time
• end_time - Booking end time
• notes - Optional notes for the booking
• recurring_pattern - Recurring pattern (None, Daily, Weekly, Monthly)
• recurrence_end_date - End date for recurring bookings
• max_duration_hours - Max duration allowed (defaults to 4 hours)
• max_advance_days - Max advance booking allowed (defaults to 30 days)

pub fn cancel(&mut self, canceller_id: Uuid) -> Result<(), String>

Cancel this booking

Only allowed for Pending or Confirmed bookings. Cannot cancel Completed, Cancelled, or NoShow bookings.

Arguments

• canceller_id - User ID requesting cancellation

Returns

• Ok(()) if cancellation successful
• Err if booking cannot be cancelled

pub fn complete(&mut self) -> Result<(), String>

Mark booking as completed

Typically called automatically after end_time passes. Only Confirmed bookings can be marked as completed.

pub fn mark_no_show(&mut self) -> Result<(), String>

Mark booking as no-show

Called when user doesn’t show up for their booking. Only Confirmed bookings can be marked as no-show.

pub fn confirm(&mut self) -> Result<(), String>

Confirm a pending booking

Only Pending bookings can be confirmed.

pub fn update_details( &mut self, resource_name: Option<String>, notes: Option<String>, ) -> Result<(), String>

Update booking details (resource_name, notes)

Only allowed for Pending or Confirmed bookings. Time changes require cancellation and rebooking to ensure conflict detection.

pub fn is_active(&self) -> bool

Check if booking is currently active (now is between start_time and end_time)

pub fn is_past(&self) -> bool

Check if booking is in the past (end_time has passed)

pub fn is_future(&self) -> bool

Check if booking is in the future (start_time hasn’t arrived yet)

pub fn duration_hours(&self) -> f64

Calculate booking duration in hours

pub fn conflicts_with(&self, other: &ResourceBooking) -> bool

Check if this booking conflicts with another booking

Conflict occurs if:

• Same building_id, resource_type, resource_name
• Time ranges overlap
• Other booking is Pending or Confirmed (not Cancelled/Completed/NoShow)

Time overlap logic:

• Bookings overlap if: start1 < end2 AND start2 < end1

pub fn is_modifiable(&self) -> bool

Check if booking is modifiable (Pending or Confirmed)

pub fn is_recurring(&self) -> bool

Check if booking is recurring

Trait Implementations

impl Clone for ResourceBooking

fn clone(&self) -> ResourceBooking

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResourceBooking

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResourceBooking

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ResourceBooking

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.