...
```
Inline `x-data` with `@json()` inside HTML attributes causes parser failures (JS appears as visible text).
**`$el` in child Alpine directives.** Adding `x-data="{}"` to a child element makes it an Alpine micro-component root, so `$el` in its directives refers to that element (not the outer component root). Used in the calendar to bind per-bar search dimming without PHP-in-JS escaping:
```html
```
Child micro-components inherit parent scope (can read `search`, `statuses`, etc.) without re-declaring them.
**Pre-compute `@json()` values in the controller.** Never pass a `->map(closure)` result directly to `@json()` inside a Blade directive — the closure serialises as `{}`. Pre-compute the collection in the controller and pass the result as a plain variable.
**SortableJS + Alpine bridge via CustomEvent.** When SortableJS and Alpine need to communicate, dispatch a `CustomEvent` from SortableJS `onEnd` and catch it in Alpine with `@event-name.window`:
```js
// SortableJS onEnd
window.dispatchEvent(new CustomEvent('cal-transfer', { detail: { ... } }));
```
```html
```
Always revert the DOM in `onEnd` (`evt.to.insertBefore(evt.item, ...)`) — SortableJS moves the element in the DOM but bar positions are determined by CSS `left/width`, so the visual is wrong until a page reload. The revert keeps the DOM consistent while the modal handles the actual submit + reload.
**PHP → JS room status injection.** Inject server-side data for client-side validation using a `window.*` global in a `
```
Read it in SortableJS callbacks or Alpine getters: `(window._calRoomStatuses || {})[roomNo]`.
## Philippine-specific
- Currency: ₱ peso — format with `number_format($val, 0)`
- VAT 12% default, configurable in Settings; BIR registered name, TIN, OR prefix also in Settings
- Senior Citizen / PWD discount fields on reservation create form
## Room Types & Rates
All 16 types and their rack rates (stored per-room in `rooms.rate`):
| Type | Rate | Type | Rate |
|---|---|---|---|
| Economy Junior | _(not set)_ | Junior Deluxe | ₱699 |
| Economy Twin | ₱699 | Superior Deluxe | ₱849 |
| Economy Double | ₱699 | Deluxe Twin | ₱899 |
| Ordinary Twin | ₱549 | Deluxe Double | ₱899 |
| Ordinary Double | ₱549 | Deluxe Trio | ₱1,249 |
| Standard Twin | ₱849 | Barkadahan | ₱1,499 |
| Standard Double | ₱849 | Family Room / Family Room 2 | ₱1,649 |
| Executive Suite | ₱1,749 | | |
## Current State
| Module | Status | Notes |
|---|---|---|
| Dashboard | Done | KPIs, arrivals/departures, room status chart, 7-day revenue, booking sources, recent reservations |
| Room Management | Done | Full CRUD, 63 rooms, 4 floors |
| Property Settings | Done | 22 keys, full form |
| Reservations | Done | List (sortable), detail, create, edit; full status lifecycle with reversals; rate plan integration; soft delete with trash view (restore / force-delete for admins) |
| Payments | Done | Split payments per reservation; `reservation_payments` table; summary bar + per-payment list with delete; dynamic Alpine form |
| Group Bookings | Done | Multi-room bookings under one guest; `reservation_groups` table + `ReservationGroup` model; group show page with per-room totals; purple group badge on reservation list, check-in, check-out pages; group context banner on reservation show |
| Room Transfer | Done | Checked-in room swap: old room → dirty, new room → occupied; room picker modal on reservation show; activity log entry |
| Guest Reminders | Done | `guest_reminders` table; reminders card on reservation show sidebar (add/view/mark-done/delete); amber "Today's Reminders" panel on check-in page (only when pending reminders exist for today) |
| Check-in Queue | Done | Daily arrivals with overdue highlighting, inline Check In button, today's pending reminders panel |
| Check-out Queue | Done | In-house guests due out, balance due column, inline Check Out button |
| Room Rack | Done | Visual grid of all 63 rooms, Alpine filter by status, guest/arrival info on cards |
| Housekeeping | Done | Priority queue (arriving today), dirty-by-floor grid, clean & ready section, maintenance section |
| Maintenance | Done | Work order list (filter tabs, priority sort), create form (room or common area), show/resolve/reopen |
| Rate Plans | Done | CRUD for percent_off / amount_off / fixed plans; `RatePlan::rateFor()` computes adjusted nightly rate; wired into reservation create/edit with live Alpine preview |
| Channel Manager | Done | Source performance table (bookings, revenue, avg stay, share); rate mapping config per channel; "+ Add Channel" form |
| My Calendar | Done | Gantt-style timeline: rooms (Y) × days (X); bars colour-coded by status; sticky room labels; today highlight; hover tooltip; month navigation. Filters: status (multi-select pills), hide empty rows, floor filter, guest name search (dims non-matching bars). Drag-and-drop room transfer: checked-in bars are draggable (SortableJS) with left-side grip handle; dropping opens transfer modal (reason required); blocked client-side + server-side when target room is occupied. |
| Reports | Done | Three tabs: Occupancy (day-by-day occ%, ADR, RevPAR with colour-coded bars + totals), Revenue (by room type, source, rate plan, payment method), Night Audit (arrivals/departures/in-house lists + payments collected). Shared date-range picker with quick presets. |
| Guest Profiles | Done | (from prior sessions) |
| Point of Sale | Done | (from prior sessions) |
| Login & Auth | Done | Session auth via `Auth::attempt()`; `auth` middleware on all routes; inactive account blocked with clear message; `last_login_at` stamped on login |
| Staff & Roles | Done | Dynamic RBAC: `roles` + `permissions` + `role_permission` pivot; 6 system roles; 43 permission keys; `Gate::before` super-admin bypass; staff CRUD with activate/deactivate; My Profile page (name/email/phone/position/password) |
| Password Reset | Done | Forgot password → email link → reset form; `MAIL_MAILER=log` in dev (link in `storage/logs/laravel.log`); password strength meter on reset form |
| Public Website | Done | 6 public pages (home, rooms, room-detail, about, gallery, contact) at `/`, `/rooms-overview`, etc. Guest layout with sticky nav + footer. SEO meta from CMS. |
| Online Booking | Done | Date search → available rooms → guest form → confirmation. Creates `Reservation` with `source='Online'`, `status='pending'`. Booking number on confirmation page. |
| Website CMS | Done | Admin panel at `/website` (requires `website.manage`). Alpine tabs: Homepage, About, Contact, Gallery, Room Photos, Booking Settings, SEO. Image upload to `public` disk. |
| Folio & Billing | Done | `folio_charges` table; `FolioCharge` model; extra charge add/delete on reservation show; `billing/index` list with search/filter/balance stats; `/reservations/{id}/folio` printable folio with VAT breakdown + signature block |
### Reservation Status Lifecycle
```
pending ──confirm──► confirmed ──check-in──► checked_in ──check-out──► checked_out
│ │ │
└──no-show──► no_show ◄──restore──┘ │
└──cancel──► cancelled ◄──restore──┘ │
│
confirmed ◄──undo-checkin───────────┘
checked_in ◄──undo-checkout──────────── checked_out
(blocked if room occupied by another guest)
```
**Room status side-effects:**
| Action | Room change |
|---|---|
| `checkIn` | → `occupied` |
| `checkOut` | → `dirty` |
| `cancel` (from checked_in) | → `available` |
| `undoCheckIn` | → `available` |
| `undoCheckOut` | → `occupied` |
| `restore` (cancel/no_show) | no change |