Screen Specifications & Field Details
Based on the database schema and top 5 services identified in the sources, here is the breakdown of the necessary screens and field details for both the Customer (Guest) and Service Provider (Staff) perspectives.
I. Customer View (Guest App)
The Guest App focuses on ease of request (input) and status tracking (visibility).
1. Service Menu Dashboard (Home Screen)
Purpose: The central hub where guests select which of the 5 services they need.
- Welcome Message: Displays Users.name.
- Room Indicator: Displays Users.room_number.
- Service Category Tiles: Housekeeping, Dining, Transport, Front Desk, Maintenance.
- Active Request Widget: Summary of most recent Master_Requests.status.
2. Housekeeping Request Screen
Purpose: To request towels, toiletries, or refills (Service 1).
- Item Selector: Maps to item_name.
- Quantity: Maps to quantity.
- Allergy/Preferences: Maps to allergy_note.
- Submit Button: Creates request with status 'PENDING'.
3. Dining on Demand Screen
Purpose: To browse menus and order room service (Service 2).
- Menu Browser: Linked to menu_item_id.
- Special Instructions: Maps to special_instructions.
- Delivery Time: Maps to delivery_time.
4. Transport Booking Screen
Purpose: To book taxis or airport shuttles (Service 3).
- Pickup Type: Maps to pickup_type.
- Destination: Maps to destination.
- Pickup Time: Maps to pickup_time.
- Flight Number: Maps to flight_number.
5. Front Desk & Concierge Screen
Purpose: For late check-outs, upgrades, or luggage help (Service 4).
- Request Type: Maps to request_type.
- Requested Time: Maps to requested_time.
- Luggage Count: Maps to luggage_count.
- Upgrade Preference: Maps to upgrade_pref.
6. Maintenance Reporting Screen
Purpose: To report noise or broken items (Service 5).
- Issue Category: Maps to issue_category.
- Description: Maps to description.
- Photo Upload: Attachment for visual proof.
7. "My Activity" (Order History)
Purpose: To track the real-time status of all requests.
- List View: Shows service_type and created_at.
- Status Badge: Displays status (PENDING, IN_PROGRESS, COMPLETED).
- ETA: Calculated based on created_at + SLA.
II. Service Provider View (Staff App)
The Staff App focuses on task management, prioritization, and efficiency.
1. Staff Operations Dashboard
Purpose: Filtered list of open tasks for the department.
- Room Number: From Users table.
- Request Type: From service_type.
- Time Elapsed: Color-coded (Green < 10m, Red > 30m).
- Status Toggle: Change 'PENDING' to 'IN_PROGRESS'.
2. Task Detail Screen (Dynamic)
Purpose: Displays specific details based on request type.
- Housekeeping: item_name, quantity, allergy_note.
- Dining: menu_items, special_instructions, delivery_time.
- Transport: pickup_time, destination, flight_number.
- Front Desk: request_type, requested_time, luggage_count.
- Maintenance: issue_category, description, severity.
3. Maintenance Engineer View
Purpose: Manage repairs and sensors.
- Automated Flag: Indicator if sensor detected issue.
- Severity Level: LOW, MEDIUM, HIGH.
- Resolution Notes: Text field for fix details.
4. Action Bar
Purpose: To update the workflow status.
- "Accept Task": Sets assigned_staff_id and status to 'ASSIGNED'.
- "Mark Complete": Sets status to 'COMPLETED' (Notifies Guest).
I. Customer View (Guest App)
The guest application focuses on ease of access, quick actions ("One-Touch"), and real-time status updates.
1. Service Menu Dashboard
2. Housekeeping Request
3. Dining on Demand
4. Transport Booking
5. Front Desk & Concierge
6. Maintenance Reporting
7. "My Activity" Screen
II. Service Provider View (Staff App)
The staff application focuses on task management, prioritization, and efficient workflow execution.