Keyhost Documentation & User Manual

Comprehensive Guide for Guests, Property Owners, and Administrators • Generated

1. System Overview

Keyhost is a modern, responsive, and robust multi-vendor booking platform specifically designed to bridge the gap between travelers seeking accommodations and property owners looking to monetize their spaces.

Our platform handles end-to-end operational workflows:

Dynamic Property Searching and Filtering (Location, Date, Guests).
Secure Real-time Payment Processing via Digital Gateways (bKash, SSLCommerz).
Granular Dashboard Ecosystems configured respectively for Guests, Owners, and Admins.
Reward Management, Bookings Handling, Live Notifications, and In-app Messaging.

2. User Roles & Capabilities

Guest (Traveler) Guest

The primary consumers of the platform, searching for their next perfect stay.

Empowered Experiences: Guests have access to Advanced Searches, Multi-criteria Filters, Wishlists (Favorites), Reward points, and instant messaging directly with hosts.

Property Owner (Host) Owner

Platform partners listing accommodations ranging from singular rooms to boutique hotels.

Create sophisticated property listings via an intuitive Multi-Step Form.
Manage availability via a centralized Interactive Calendar.
Accept or decline guest booking requests seamlessly.
Track live earnings, occupancy metrics, and request payouts.

Administrator Admin

The operational orchestrator maintaining the health, financials, and configurations of Keyhost.

Dynamic control over branding, SEO, SMS, and Email system via Settings Hub.
Global overview of all properties, user details, bookings, and financial analytics.
Payment gateway credential management using integrated environmental variables workflows.

3. The Dashboard Ecosystem

Each user type experiences a personalized workspace optimized for operational speed and device reactivity (fully mobile responsive).

Core Module	Feature Highlights	Target User
Property Matrix	Responsive Data Tables allowing smooth navigation without horizontal scrolling, including "View More" drilldowns.	Owner, Admin
Booking Engine	Comprehensive timeline of reservations categorized cleanly into Active, Upcoming, Cancelled, and Pending arrays.	All Roles
Analytics Engine	Accurate live charts pulling directly from live databases representing revenue, booking conversions, and property traffic.	Owner, Admin
Settings Hub	A massive categorized section for Admins covering General Setup, Gateways (e.g., SSLCommerz configs), Mail, and Social links.	Admin

4. Detailed Guest Guide

A step-by-step walkthrough covering the entire guest lifecycle from discovery to payment.

The Complete Booking Process

Search & Filtering

Begin on the Home Page. Use the sticky header search bar to input your desired Destination, Check-In/Check-Out Dates, and Guest counts (Adults, Children). Click Search to generate a tailored property list.

Evaluating Properties

Scroll through visual cards showing Key amenities and price per night. Use secondary filters (Price ranges, Rating, Facilities) to narrow choices. Click a property to open its detailed page showing Map Location, precise descriptions, and House Rules.

Initiating Reservation

On the right sidebar of the property page, adjust your dates and guest numbers if needed. The system auto-calculates Total Cost (including system fees and taxes). Click "Request to Book".

Host Approval Matrix

Your request goes into "Pending" status. The Owner is notified and evaluates your request. Once they approve it, the status transitions to "Request Accepted". At this point, the Payment button activates in your Dashboard.

Secure Checkout

Navigate to Dashboard > Bookings. Click "Make Payment to Confirm" on your accepted request. You are redirected to our SSLCommerz/bKash digital gateway.

Enter payment details within the secure portal.
Upon success, the Gateway dynamically redirects you back to the Keyhost confirmation screen.
Booking status upgrades to "Confirmed/Paid".

Managing Favorites (Wishlist)

Click the Heart Icon on any property card or detail page. The heart fills red, instantly storing it in your account's Favorites menu. Visit your Dashboard's Favorite tab to review or effortlessly remove saved properties.

In-App Messaging

Communication is essential for a great stay. You can message the property owner directly before, during, or after your stay. Go to the Messages tab in your Dashboard, or click the "Message Host" button directly on the property listing to ask questions or confirm details. Real-time notifications ensure you never miss a reply.

Reviews & Feedback

After completing your stay, you can leave a comprehensive review and rating for the property. Navigate to your Dashboard > My Bookings and find your past completed stays to submit a review. Your honest feedback helps other guests make informed decisions and allows hosts to continually improve their services.

Rewards Points System

Loyalty pays off! Earn Rewards Points for every completed booking. Navigate to your Dashboard's Rewards Points section to view your current balance and history. You can redeem these points during checkout for discounts on future stays.

5. Detailed Owner (Host) Guide

Maximize your property portfolio with integrated management tools.

Creating a Listing (Multi-Step Wizard)

We revamped listing creations to reduce cognitive load using a modern Step-by-Step wizard flow:

Step 1 (Basic Details): Title, detailed description, and Property type designation.
Step 2 (Location): Enter exact Address, coordinates, or use Map pinpointing.
Step 3 (Features): Room counts, Bathrooms, Max Guest Capacity limiters.
Step 4 (Amenities): Checkbox grid for WiFi, Pools, Air Conditioning, Kitchen, etc.
Step 5 (Gallery): Drag and drop primary and secondary high-resolution photos.
Step 6 (Pricing): Anchor a base nightly rate.

Validation: The system strictly validates each step before allowing progression. This guarantees high-quality, publish-ready listings!

Calendar & Availability Control

Navigate to the Calendar tab. A full-month graphical view provides a bird's-eye view of your property's schedule. Days marked grey are booked, enabling you to proactively plan turnovers.

Earnings & Requesting Payouts

Hosts possess a dedicated "Earnings" module showing gross revenue minus platform commissions. When "Available Balance" exceeds the withdrawal threshold, utilize the Withdraw Funds trigger, select preferred bank protocols, and submit.

Managing Guests & Messages

Stay connected with your guests through the built-in Messages system. Respond promptly to inquiries, provide check-in instructions, and assist guests during their stay. Fast response rates improve your property's visibility and guest satisfaction.

Handling Reviews

Monitor guest reviews from your Dashboard. Constructive feedback helps you maintain high standards, and responding to reviews publicly (if applicable) shows future guests that you are an engaged and caring host.

iCal Calendar Synchronization

Prevent double-bookings by syncing your Keyhost calendar with external platforms (like Airbnb or Booking.com). Go to the Calendar tab to Import an external iCal link or Export your property's Keyhost iCal link to other services. This ensures your availability is always accurate across the web.

6. Detailed Admin Guide

Mastering backend operations to scale and govern Keyhost.

The Admin Settings Hub

Accessed through the Admin Dashboard, the Settings module is organized via horizontal tabs for laser-focused adjustments.

Branding & SEO

Inject Site titles, meta descriptions, and analytics tracking IDs natively without touching source code. Configure primary brand palettes.

Payment Gateways setup

Securely enter API Keys, Store Passwords, and Store IDs for networks like SSLCommerz directly into encrypted database tables. Toggle "Live/Sandbox" environments with dedicated switches.

Email & Communication

Configure SMTP relays, default mailing addresses, and template configurations to ensure emails (Booking Confirmations, Payout alerts) reach users reliably.

User Management & Reports

Maintain total control over platform participants. View, edit, or suspend Guest and Host accounts. Additionally, generate comprehensive system Reports covering bookings, revenue, and platform growth over specified timeframes.

7. Latest Technological Enhancements

Dynamic Routing in Environments: Post-payment redirections (Success, Fail, Cancel) for SSLCommerz no longer rely on rigid localhost paths. They ingest frontend parameters natively via .env configs.
Advanced Mobile Tables: Implementation of structural CSS modifications allowing Admin/Owner tables to nest deep data (like Property descriptions and IDs) inside elegant toggleable "View More" bays, eliminating horizontal scrolling on smartphones.
Reliable State Flow: Resolved critical logic preventing users from paying after properties achieved 'Requested_Accepted' states.
Robust Backend Validators: Favorites (Wishlist) endpoints reinforced with rigorous type-checking to block param mutations causing generic bad request errors.