Dashboard
Purpose and who uses it
ReceptionistHotel ManagerAccountantA one-glance picture of the house for everyone; what you see depends on your module levels.
The Dashboard is the app's start page (and the page a phone opens when the app is installed). It greets you by first name, “Good morning, Fatima”: shows today's date, and lays out the numbers a front desk or manager needs before doing anything else. Nothing on it is edited; every tile and card links onward to the module that owns the data.
Every role can open the Dashboard. Which tiles and charts appear is decided by your levels for Rooms, Bookings, Payments and Staff, an Accountant sees revenue but no room tiles; a Maintenance user sees the room tiles and little else.
Screen anatomy
Greeting and New Booking, the role banner, a KPI row, two chart rows, then arrivals, quick actions and housekeeping.
- 1GreetingTime-of-day greeting with your first name and today's date.
- 8New BookingJumps to the Bookings screen where the wizard lives.
- 2Available rooms“of N total · M in maintenance”.
- 3Occupied roomswith the occupancy percentage.
- 4Arriving today“N in-house now” underneath.
- 5Pending reservations / Pipeline value / Staff on dutyThe row wraps to fit; tiles appear per module access.
- 6Charts and Today's arrivalsRevenue, Occupancy, Check-ins & outs, Room type performance, Booking sources; then the arrivals list and Quick actions.
- 7Housekeeping statusReady for guest, Cleaning in progress, Occupied, Maintenance / out as bars over the room count.
The role banner
Under the greeting a card shows your role, “Signed in as …” and one tag per permission module (Dashboard, Bookings, Rooms, Guests, Payments, Staff, Reports, Settings) coloured by level, grey with a lock for no access, blue for view, amber for edit, green for full. Hover a tag to read the level. It is the quickest way to see why a module is missing from your sidebar.
KPI tiles
Live counts from the room grid and the bookings board; the staff tile is derived from the rota and attendance.
- Available rooms (Rooms = View), rooms whose projected status is Available, “of N total · M in maintenance”.
- Occupied rooms: rooms with a checked-in guest; the sub-line is occupied ÷ all rooms as a percentage.
- Arriving today (Bookings = View), bookings in the board's Arriving Today column: confirmed, check-in today or earlier, not yet checked in. Sub-line: how many guests are in-house now.
- Pending reservations: bookings still in New Reservation, “awaiting confirmation”.
- Pipeline value: the stay totals of every booking on the board (the seven days either side of today plus everyone in-house) added together, in the hotel currency.
- Staff on duty (Staff = View), “on duty / total”, derived at the moment you load the page from approved leave, today's attendance sheet and rostered shift windows. It is never stored; see the Staff chapter for the reasons shown per person.
Charts
Five trend cards, bucketed on the hotel's local calendar, each gated by a module level.
- Revenue (Payments = View), “Collections · last 14 days vs previous 14”. Payments received per hotel-local day, refunds subtracted; the purple line is the 14 days before that.
- Occupancy (Bookings = View), “Rooms occupied per night · last 14 nights”, as a percentage of all rooms. Only bookings that have a room assigned count.
- Check-ins & outs: “Last 7 days”: stacked bars of actual check-in and check-out times per day.
- Room type performance: “Occupied nights · last 30 days”: for each type, occupied nights as a percentage of rooms × 30. Types with no rooms are hidden.
- Booking sources: “Last 90 days”: a donut of bookings created per source (Direct, Walk-in, Booking.com…), largest first, with the total in the middle.
Cards you are not allowed to see are simply absent; the remaining cards stretch to fill the row.
Today's arrivals and quick actions
ReceptionistThe arrivals list is the morning checklist; quick actions are shortcuts into modules you can open.
Today's arrivals
“N guests expected” lists every booking in the Arriving Today column: guest name, “Room 204 · Deluxe” (or just the type when no room is assigned yet), a Pending tag and the number of nights. Click Board to open the Bookings pipeline and check them in. The empty state reads “No arrivals expected today.” Late arrivals from earlier days stay on this list until they are checked in or marked no-show.
Quick actions
New Booking, Check In and Check Out open Bookings; Add Guest opens Guests; Create Invoice opens Payments; Assign Room opens Rooms; Report Issue opens Maintenance; Add Staff opens Staff; Notifications opens the alert feed. Only the actions whose module your role can open are shown.
Housekeeping status
Four bars over the total room count: Ready for guest (Available rooms), Cleaning in progress, Occupied, and Maintenance / out. The last bar counts rooms whose projected status is Maintenance; rooms flagged out of service are excluded from every bar.
Live updates and the offline snapshot
The page re-renders on any change in the house, and shows its last good copy when the network is gone.
Whenever a room, booking, invoice, housekeeping task, work order or staff record changes anywhere in the hotel, the Dashboard silently refreshes. You never need to reload it.
Each visit also saves a snapshot (rooms, board, summary) on the device. If you open the Dashboard with no connection, the snapshot is shown with an amber banner: “You're offline. Showing cached data from 4 Sep, 07:12.” When queued offline actions are sent, the page refreshes again.
Permissions
Dashboard is always visible; each section follows the level of the module it reports on.
| Role | Dashboard | Rooms | Bookings | Payments | Staff |
|---|---|---|---|---|---|
| Super Admin | Full | Full | Full | Full | Full |
| Hotel Manager | Full | Full | Full | Full | Full |
| Receptionist | View | Edit | Full | View | None |
| Accountant | View | None | View | Full | None |
| Housekeeping Mgr | View | Full | View | None | Edit |
| Maintenance | View | Edit | None | None | None |
| Restaurant Mgr | View | None | View | Edit | View |
| HR Manager | View | None | None | View | Full |
| Security | View | View | View | None | View |
- Rooms ≥ View: Available / Occupied tiles, Housekeeping status, the room counts in the KPI row.
- Bookings ≥ View: Arriving today, Pending reservations, Pipeline value, Occupancy, Check-ins & outs, Room type performance, Booking sources, Today's arrivals.
- Payments ≥ View: the Revenue chart.
- Staff ≥ View: the Staff on duty tile.
The Dashboard reads only; it has no actions of its own and returns no module-specific errors.