hotel booking softwares

bysyed shameer

Build a polished, fully working hotel direct-booking SaaS MVP called **“VSA DirectStay”** for: **Hotel:** VSA Residency Ariyankuppam **Public name:** VSA Residency Near Eden Beach **Location:** Ariyankuppam, Puducherry **Address:** 15/8 Cuddalore Road, Ariyankuppam, Puducherry 605007, India ## CORE OBJECTIVE Build a presentation-ready MVP for one hotel first. The product must provide: 1. A professional direct-booking website. 2. A guest booking engine with live room availability. 3. An owner/staff dashboard. 4. Room and inventory management. 5. Availability calendar. 6. Booking management. 7. Mock payment flow ready for future Razorpay integration. 8. WhatsApp contact/assistance flow. 9. Reports. 10. Authentication and secure backend validation. **Do NOT build Agoda/Booking.com marketplace functionality. Do NOT build real Agoda, Booking.com or WhatsApp API integrations in this MVP. Do NOT build unnecessary enterprise features.** Use simple, inexpensive architecture and prioritize reliability, visual polish and a complete booking journey. All hotel information must be editable. Never invent real prices, reviews, ratings, amenities, policies, phone numbers, emails or claims. Clearly label seeded information as demo/example data. --- # DESIGN Create a premium but simple hotel design. Use: * Navy blue * White * Warm gold * Light beige * Professional typography * Responsive mobile-first design * Large hotel hero * High-quality image placeholders * Clear “Book Direct” CTA * Clean cards and spacing * No clutter or unnecessary technical terminology Do not show fake ratings, reviews, discounts or “best price” claims. --- # PUBLIC HOTEL WEBSITE Create: ### Hero Show: * VSA Residency Near Eden Beach * Ariyankuppam, Puducherry * Editable short description * Check Availability * Chat on WhatsApp * Call Hotel If contact details are not configured, show “Contact details coming soon” instead of inventing information. ### Benefits Show editable benefits: * Direct booking * Clear pricing * Easy confirmation * Local support ### Rooms Seed 3 editable room types: * Standard Room * Deluxe Room * Family Room Each room supports: * Photos/placeholders * Description * Maximum guests * Amenities * Price/night * Breakfast information * Cancellation policy * Check availability Use approximately 10 total rooms. Prices must be clearly marked: **“Example price — verify with hotel.”** ### Booking Search Guest selects: * Check-in * Check-out * Adults * Children * Number of rooms Display only available room types and calculate: * Number of nights * Price/night * Taxes/fees if enabled * Total * Cancellation policy * Final booking summary ### Guest Details Collect: * Full name * Phone * Email * Special requests * Arrival time ### Confirmation After booking show: * Booking ID * Guest * Room * Dates * Total * Payment status * Hotel contact details * Contact hotel button * Save booking details option --- # OWNER DASHBOARD Create a responsive authenticated dashboard. Header: **“Good morning, VSA Residency”** Summary cards: * Today's arrivals * Today's departures * Confirmed bookings * Pending payments * Available rooms * Estimated direct revenue Add simple charts for: * Direct bookings * Revenue * Booking sources * Confirmed vs pending * Occupancy * 7/30-day activity Show: **“Demo data — connect real payment and channel systems before production use.”** --- # BOOKING MANAGEMENT Create a bookings page with: * Search by booking ID, guest, phone and date * Filters: All, Pending, Confirmed, Cancelled, Expired, Staff-created, Direct Website, WhatsApp, Agoda, Booking.com * Table and mobile card views * Booking details * Guest information * Room/dates * Payment status * Booking source * Notes * Audit history Staff can: * Add offline booking * Edit permitted guest details * Cancel with reason * Add notes * Mark payment manually received * Flag for manual review Never delete bookings; use status changes. --- # AVAILABILITY CALENDAR Create a visual calendar with: * Rooms/room types as rows * Dates as columns * Confirmed bookings * Payment holds * Maintenance blocks * Offline bookings * Colour/status legend Staff can: * Block rooms for maintenance * Add offline bookings * Edit availability * See overlapping bookings Statuses: **AVAILABLE, PAYMENT_PENDING, CONFIRMED, BLOCKED, EXPIRED, CANCELLED** The guest booking engine and owner dashboard must use the same underlying availability data. --- # DOUBLE-BOOKING PROTECTION This is critical. Implement backend validation when creating a booking: 1. Check current availability immediately before booking. 2. Consider confirmed bookings, active payment holds and blocked dates. 3. Use database transaction/locking where supported. 4. Two guests must never successfully book the last available room. 5. Create a **15-minute payment hold**. 6. Automatically expire unpaid holds. 7. Payment confirmation must be idempotent. 8. Record every booking status change in audit history. Create tests for: * Two users booking the last room simultaneously. * Staff blocking a room during booking. * Expired payment hold. * Duplicate payment event. * Cancelled booking becoming available again. --- # PAYMENT Use a **mock payment provider** only. Flow: Guest selects room → booking created as PAYMENT_PENDING → mock payment page → “Simulate successful payment” → booking becomes CONFIRMED → confirmation page Also provide: “Simulate failed payment” Failed payment becomes FAILED or EXPIRED. Show a clear placeholder: **“Razorpay Payment Links — future integration.”** Do not claim real payments are active and never store card details. --- # WHATSAPP Do not build real WhatsApp API integration. Add: * Configurable WhatsApp number * Chat on WhatsApp button * Pre-filled message: “Hello, I want to check room availability at VSA Residency Ariyankuppam.” Create a demo assistant page that: * Asks for dates and guests * Requests missing information * Reads available rooms from the same database * Provides the direct booking page link * Offers human assistance The assistant must only use stored hotel data and must never invent prices, availability, policies or facilities. Escalate refunds, complaints, discounts, group bookings and uncertain questions to staff. --- # HOTEL SETTINGS Create editable settings for: * Hotel name * Public name * Address * Phone * WhatsApp * Email * Logo * Photos * Description * Check-in/out time * Room types * Prices * Taxes * Amenities * Breakfast * Cancellation policy * Booking instructions * Payment instructions * Direct-booking message Allow owner to preview the public website after editing. --- # ROOM MANAGEMENT Create a room setup interface: 1. Add room types 2. Set number of rooms 3. Set capacity 4. Set price 5. Add amenities 6. Publish/save draft Show setup progress: * Hotel profile * Room setup * Availability * Payment setup * Contact setup * Website preview --- # OWNER ONBOARDING On first login show: **“Set up your direct booking page in 5 minutes.”** Steps: 1. Hotel details 2. Rooms/prices 3. Policies 4. Phone/WhatsApp 5. Preview 6. Run demo booking Include a **“Run Demo Booking”** button. --- # REPORTS Create reports showing: * Booking count * Direct revenue * Pending payment amount * Bookings by source * Most-booked room type * Upcoming check-ins * Cancellation count * Occupancy estimate Clearly label seeded information as demo data. --- # SECURITY / ARCHITECTURE Prepare the database for multiple hotels even though only one hotel is seeded. Hotel-specific records must contain `hotel_id`. Every hotel-specific query must be scoped by `hotel_id`. Implement: * Authentication * Protected admin/staff routes * Backend validation * Audit logs * No secrets in source code * No card storage * Hotel data isolation For this MVP seed only VSA Residency Ariyankuppam. --- # DEMO DATA Seed: * 1 hotel * 3 room types * Approximately 10 rooms * Demo guest records clearly marked DEMO DATA * Example bookings * 1 confirmed booking * 1 pending payment * 1 cancelled booking * 1 maintenance block * Demo revenue data Initial hotel data: Hotel: VSA Residency Ariyankuppam Public name: VSA Residency Near Eden Beach Location: Ariyankuppam, Puducherry Address: 15/8 Cuddalore Road, Ariyankuppam, Puducherry 605007, India All other real hotel details must remain editable and clearly marked for verification. --- # IMPORTANT SCOPE LIMITS Do NOT spend development effort on: * Real WhatsApp API * Agoda API * Booking.com API * Voice AI * Automatic refunds * Advanced AI agents * Subscription billing * Multi-hotel marketplace * Complex external PMS integrations Instead, structure the application so these can be integrated later. --- # REQUIRED DELIVERABLES Deliver a working application containing: 1. Public hotel website 2. Guest booking flow 3. Authentication 4. Owner/staff dashboard 5. Room management 6. Price management 7. Availability calendar 8. Booking management 9. Double-booking protection 10. Mock payment flow 11. WhatsApp contact/demo assistant 12. Reports 13. Demo data 14. Backend validation 15. Audit history 16. Automated booking/availability tests 17. README with setup instructions 18. Demo login credentials 19. Production-readiness checklist 20. List of integrations not yet connected All major buttons and flows must actually work. Avoid static mock screens where functionality is required. Before coding, internally establish: * Database schema * User/guest journey * Page structure * MVP acceptance criteria Then build the application. Focus on **working functionality first, visual polish second, and unnecessary features last.**