Calendar Rates, Minimum Stay & Availability

Overview

The Multi Calendar visually displays daily rates, minimum stay, and availability for each unit. This data helps landlords and operations teams quickly understand pricing, restrictions, and sell-out status directly from the calendar grid — without opening separate views.

Each date cell can show:

• 💵 Rate — displayed at the top (e.g., £120)

• 🌙 Minimum Stay — displayed at the bottom with a moon icon (e.g., “2”)

• ⛔ Zero Availability — represented by a subtle hatched gray background pattern

These indicators combine live data from the property’s connected rate plans and availability channels.

How It Works

🧭 Data Sources

• The system automatically fetches rates, restrictions, and availability for the visible date range as you scroll.

• These values are fetched only for the visible “window” to keep the calendar fast and responsive.

• Once loaded, they are cached locally to prevent flickering when scrolling between months.

🏷️ Rate Plan Selection

Each unit (room) can have multiple rate plans. Hububb automatically selects:

1. The first connected rate plan that has at least one valid OTA channel mapping.

2. If no mappings exist, the first available rate plan for that room is used as fallback.

💵 Display on Calendar Cells

Element	Description
Rate	Shown at the top of the cell with a currency symbol (e.g., £120).
Minimum Stay	Shown at the bottom next to a 🌙 Moon icon (e.g., “2”).
Style	Light gray text, minimal design to avoid clashing with reservations or blocks.
Placement	Rate → top of the cell; Min Stay → bottom of the cell.
Visibility	Shown only when data for that date and rate plan exists.

⛔ Zero Availability (Sold Out)

When a room has zero availability for a date:

• The cell background shows a diagonal light gray hatch pattern.

• This acts as a subtle visual warning that the room cannot be booked.

• The hatch layer sits under all other elements — it does not block interactions with reservations or blocks.

⚙️ Calendar Settings Popup (Editing Rates, Restrictions & Availability)

Opening the Popup

• First click: Selects the date cell.

  • The border highlights the selected cell.

• Second click on the same cell: Opens the Calendar Settings popup with that property, room, and date pre-filled.

Clicking on reservations or blocks won’t open the settings popup — only the empty calendar surface responds.

📋 What You Can Update

When the popup opens, you’ll choose between two modes:

1️⃣ Room Availability

Update how many rooms are available for specific dates.

Fields:

• From / To (dates)

• Room (select)

• Available Rooms (number)

You can add multiple periods before saving.

2️⃣ Rates & Restrictions

Update pricing and rules for one or more date ranges.

Fields:

• From / To (dates)

• Rate Plan (select)

• Rate (per night)

• Minimum Stay / Maximum Stay

• Stop Sell (Block Bookings)

• Closed to Arrival / Closed to Departure (check-ins/outs not allowed)

You can add or remove multiple ranges before submitting.

💾 Saving Changes

When you click Save Changes:

• Availability updates are sent as /update-availability

• Rates & Restrictions updates are sent as /update-restrictions

• A success toast confirms the update:

  • “Availability successfully updated” or

  • “Restrictions successfully updated”

• The popup closes automatically and the calendar refreshes to show the new values.

If something goes wrong, an error toast will appear (e.g., “Failed to update availability”).

🧩 Form Behavior

• The popup is scrollable and responsive.

• You can submit multiple periods at once.

• The default “From/To” dates are pre-filled based on the selected cell.

• Rates are converted into minor units (e.g., £120 → 12000) before sending, but always display in normal currency format in the UI.

🧪 QA Testing Checklist

This section is meant for QA testers and internal reviewers to verify that the Rates, Minimum Stay & Availability logic works correctly across scenarios. It focuses on data accuracy, visual representation, and interaction flow.

🔹 Data Display & Accuracy

• Rates and restrictions load automatically when scrolling into view.

• Each room displays the correct rate plan data for the visible period.

• The currency symbol matches the property’s currency.

• The minimum stay (number) matches the connected OTA data.

• Cells with no restriction data show no rate/min-stay overlay.

• When availability = 0, a diagonal gray pattern appears behind the cell content.

• The hatch background never blocks clicks or hover events.

🔹 Visual Consistency

• Rate text is positioned at the top of each cell.

• Minimum stay (🌙) appears at the bottom.

• Both texts use subtle gray styling for readability.

• Overlays stay visible but do not overlap with reservations or blocks.

• Reservations and blocks always render above rates and availability indicators.

• Hatch pattern (for zero availability) is subtle, consistent, and full-width within the cell.

• Layout is preserved when scrolling or resizing the window.

🔹 Interaction: Opening the Calendar Settings Popup

• First click on an empty date cell selects the cell (visible border highlight).

• Second click on the same cell opens the settings popup.

• Clicking a reservation or blocked date does not open the popup.

• The popup pre-fills Property, Room, and Date correctly.

• Popup opens smoothly and closes with Cancel or Save.

🔹 Editing Availability

• Selecting Room Availability mode enables the correct fields.

• Updating “Available Rooms” and saving triggers a success toast.

• The calendar refreshes immediately with updated availability.

• Error scenarios show an error toast with an explanatory message.

🔹 Editing Rates & Restrictions

• Selecting Rates & Restrictions mode enables the correct fields.

• Updating Rate, Min Stay, or Stop Sell saves correctly with a success toast.

• Updating for multiple date ranges in one submission works as expected.

• The popup closes and calendar data refreshes automatically.

• Validation prevents invalid ranges (End before Start).

🔹 Error Handling

• API or network errors show clear error toasts and leave the popup open.

• Empty or missing fields show inline validation errors.

• Popup form resets correctly after Cancel or successful Save.

🔹 Permissions & Roles

• Landlords can open and edit their own property’s availability and restrictions.

• Operations (Admin) can open/edit if they have access-availability permission or full access.

• Users without this permission can view rates/min stay but cannot edit values.

• The settings popup and button behave consistently across both roles.

🔹 Data Refresh & Sync

• After saving, the Multi Calendar refetches rates and availability data automatically.

• Newly updated rates and min stay values appear immediately.

• Scrolling or changing month preserves visible data (no flicker).

• All connected rooms reflect their respective data correctly.

Summary

The Rates, Minimum Stay & Availability overlay makes the Multi Calendar a powerful, visual management tool. It provides instant insight into each unit’s pricing, stay rules, and booking availability — while enabling quick, in-context updates directly from the grid.

It ensures:

• Transparent day-by-day visibility of rate and restriction data

• Clear marking of sold-out dates

• Smooth inline editing for both landlords and operations

• Reliable data syncing and instant visual feedback