# Property Management System (PMS) Operations

The Calian PMS provides the operational backbone for front desk agents, housekeeping managers, and revenue supervisors.

---

## 1. Front Desk Dashboard (`/staff/front-desk`)

The front desk interface prioritizes instant situational awareness:
- **Arrivals Today:** Expected guest list, estimated arrival times, pre-assigned rooms, payment status.
- **Departures Today:** Due-out rooms, outstanding folio balances, scheduled airport transfers.
- **In-House Guests:** Active room occupants, VIP flags, special notes.
- **Room Status Summary:** Quick metrics showing Available, Occupied, Dirty, Cleaning, Clean, and Out of Order rooms.
- **Quick Action Bar:** "New Walk-In Booking", "Check In Guest", "Post Folio Charge", "Record Payment", "Assign Room".

---

## 2. Visual Room Rack Calendar

- Matrix view of Physical Rooms (Y-axis) vs Calendar Dates (X-axis).
- Visual color codes:
  - **Gold / Slate:** Confirmed & In-House Stays.
  - **Green:** Clean / Ready for assignment.
  - **Amber:** Dirty / Housekeeping Cleaning.
  - **Red / Gray Stripes:** Out of Order (OOO) or Maintenance Block.
- Supports clicking any reservation block to open the Guest Folio, change dates, or perform room re-assignments.

---

## 3. Check-In & Check-Out SOPs

### 3.1 Check-In Workflow
1. Front desk locates reservation by guest name or booking reference.
2. Verify guest ID / passport and contact information.
3. Select and assign a `Clean` or `Inspected` physical room.
4. Capture vehicle license plate and accompanying guests if applicable.
5. Collect security deposit / pre-payment if not prepaid.
6. Issue branded registration card / keycard. Room status moves from `Available/Reserved` to `Occupied`.

### 3.2 Check-Out Workflow
1. Pull up Guest Folio; review all posted charges (room, restaurant, spa, minibar).
2. Post any final minibar or late departure fees.
3. Settle remaining folio balance via Cash, Credit Card, Mobile Money, or Corporate Direct Bill.
4. Issue branded PDF tax invoice and receipt.
5. Mark reservation `Checked Out`. Room status automatically transitions to `Dirty`, and a housekeeping cleaning task is generated.