Smart Grid & Calendar

The Smart Grid is the central dashboard of the StaYantra PMS. It displays a live map of your rooms across a rolling date range, showing reservations, occupancy, and each room's physical status.

The Smart Grid — your live room map. Each coloured block is a reservation; the left column shows each room's current status.

1. The calendar grid

The grid lists your rooms down the side and dates across the top:

• Reservations appear as blocks spanning check-in to check-out.
• Tap a reservation block to open its detail panel — guest name, booking source (Direct, eSewa, Booking.com, and so on), folio balance, and check-in status. Tap again to close it.
• Use the date navigation (previous / next / today) to move the window forward and back.

2. Room status lifecycle

Every room carries one of five live statuses, and they move in a fixed cycle so the front desk and housekeeping never disagree:

• Available — clean, inspected, and ready to sell.
• Occupied — a guest is currently in the room.
• Dirty — the guest has checked out (or needs a stayover clean); housekeeping is required.
• Inspected — cleaned and awaiting a final check before it returns to sellable.
• Blocked — held out of inventory for maintenance or an owner hold; not bookable until released.

The allowed transitions are deliberately one-way around the loop:

Available → Occupied → Dirty → Inspected → Available (and Available ⇄ Blocked for maintenance holds).

Staff advance a room by acting on it — a housekeeper marks a Dirty room Inspected from the Connect app, and the front desk (or an inspector) moves Inspected → Available. The grid exposes these as one-tap status buttons on each room; the system rejects any jump that isn't a valid step in the cycle.

[!TIP] Housekeeping and maintenance tasks are dispatched to the Connect mobile app. The moment a housekeeper advances a room's status there, the grid reflects it.

3. Real-time synchronization

The Smart Grid is powered by Supabase Realtime:

• When a guest books online through your booking engine or an OTA, the block appears on the grid without a refresh.
• When a receptionist changes a room or reservation on the desktop, every other open dashboard updates immediately — which is what prevents two staff from double-committing the same room.