Booking & Maintenance Portals
Relevant source files
The following files were used as context for generating this wiki page:
The Booking and Maintenance Portals serve as the primary interfaces for property management operations within the Monarch platform. The Booking Portal handles residential guest reservations and property showcases, while the Maintenance system facilitates complex Request for Quotation (RFQ) workflows, vendor bidding, and emergency repair coordination.
Booking Portal Architecture
The booking system is designed to handle both property discovery and reservation processing. It utilizes a structured flow from property selection to confirmation, supported by localized strings and real-time availability checks.
Guest Interface and Interaction
The user interface provides detailed property views, including features, amenities, and house rules. It integrates a BookingForm component to collect guest data and stay dates.
The workflow involves navigating from the properties list to a specific ApartmentBookingPage, which displays localized descriptions and pricing.
Sources: src/pages/ApartmentBooking.tsx:45-70, src/locales/en.ts:98-120
Key Data Structures
| Field | Type | Description |
|---|---|---|
name | string | The localized name of the property/suite. |
price | number | Nightly rate for the accommodation. |
capacity | number | Maximum guest occupancy allowed. |
features | string[] | List of amenities (e.g., Wi-Fi, Kitchen, AC). |
Sources: src/pages/ApartmentBooking.tsx:14-25, src/locales/en.ts:160-170
Maintenance & RFQ System
The maintenance infrastructure is built around a comprehensive Request for Quotation (RFQ) system. This system allows administrators to create detailed project specifications, which verified vendors can then bid on.
RFQ Creation and Management
Administrators use a multi-tab interface to define project scope, technical specifications, and budget guidance. The system supports autosaving drafts and importing/exporting templates via JSON or CSV.
Maintenance Service Categories
The system categorizes maintenance into four primary sectors for both routine and emergency response.
| Category | Typical Items | Response Priority |
|---|---|---|
| Plumbing | Leak repairs, Water heaters | High/Emergency |
| Electrical | Safety inspections, Circuit breakers | High/Emergency |
| HVAC | AC repair, Duct cleaning | Medium/High |
| General | Painting, Flooring, Drywall | Low/Medium |
Sources: src/pages/services/Maintenance.tsx:32-60
Vendor Bidding Workflow
The vendor portal provides a specialized view for contractors to review project requirements and submit formal bids.
Bidding Sequence
Vendors must navigate through design finality statements and technical Bill of Quantities (BOQ) before submitting a bid.
Security and Validation
- Role Protection: Both portals are wrapped in
OptimizedProtectedRoutecomponents to ensure only authorized users (e.g.,adminorvendor) can access specific management functions. - Deadline Enforcement: The vendor portal UI dynamically disables bid submissions once the RFQ
deadlinehas passed. - Document Control: Project documents are managed via signed URLs and categorized by type (e.g., blueprints, MEP designs).
Sources: src/pages/vendor/ComprehensiveRFQDetail.tsx:112-115, src/pages/admin/RFQEdit.tsx:325-345, src/App.tsx:210-230
Technical Specifications & BOQ
The maintenance system uses a structured Bill of Quantities (BOQ) to define material and labor requirements.
Summary
The Booking and Maintenance Portals provide a dual-layered approach to property oversight. While the Booking Portal focuses on guest experience and revenue generation, the Maintenance and RFQ system ensures property longevity through rigorous vendor management and standardized technical specifications. Both systems are integrated with Supabase for real-time data persistence and role-based access control.