# HotelPlus Administrator Guide

## First login

1. Open `/login`
2. Use the admin account created during install (or seeded `admin@hotelplus.test` / `password`)
3. Change the password under Users

## Recommended setup order

1. **Hotel Settings** — name, logo, currency, tax, check-in/out times, document prefixes
2. **Amenities** — Wi-Fi, AC, etc.
3. **Room Types** — rates, occupancy, images
4. **Rooms** — numbers, floors, types
5. **Rate Plans / Packages** — seasonal and package pricing
6. **Users & Roles** — assign staff to the 16 built-in roles or create custom roles
7. **Corporate / Travel Agents** — optional negotiated accounts

## Daily front-office flow

1. Review **Dashboard** for arrivals, departures, dirty rooms, alerts
2. Create or confirm **Reservations** (system blocks double bookings)
3. Use **Calendar** for room timeline and moves
4. **Check-in** arrivals into clean/inspected rooms only
5. Post charges / take payments on the **Folio**
6. **Check-out** — settle balance (override requires authorization path), room goes dirty + HK task
7. Run **Night Audit** once per business date

## Housekeeping

- After checkout, rooms are marked dirty and a housekeeping task is created
- Update statuses through Dirty → Cleaning → Clean → Inspected
- Rooms should not be available for check-in while dirty or under maintenance

## Maintenance

- Create work orders and set **blocks room** when the room cannot be sold
- Blocked / under-maintenance / OOS rooms are excluded from availability

## Inventory

- Maintain products, reorder levels, and stock movements
- Every movement creates an inventory transaction record

## Public booking

- Guests use `/book`
- Same availability engine as internal reservations

## Security

- Prefer least-privilege roles
- Review audit logs for refunds, reversals, night-audit reopen, permission changes
- Keep backups of the database and `storage/app`