🎨 Classification Legend
Client Requested
Features explicitly requested by the client
Mandatory Platform Feature
Essential for stability, security, compliance
Kimit Suggestion
Strategic enhancements from Kimit team
Optional Growth Feature
Future phase enhancements
📊 Development Phases
Core Booking Marketplace
- Guest discovery + smart search
- Listing pages + room comparison
- Customer accounts + booking
- Vendor onboarding + wizard
- Admin moderation
- Commission + payouts
- Support tickets
- ✨ Travel Circle Invitations V1.01
- ✨ User Dashboard V1.01
- ✨ OTP-Verified Invites V1.01
- ✨ HyperGuest API V1.01
Growth Add-ons
- Wallet (refund-based)
- Loyalty program
- AI FAQ assistant
- Analytics dashboards
Community + Trust
- Community posts
- Meet & Travel matching
- Trust scores
Advanced Systems
- Emergency system
- Digital passport
- Full accounting
🗺️ Platform Architecture Mind Map
🔍 Guest Experience — Discovery
Landing pages, search, browsing, property profiles, reviews
Discovery & Search
Landing pages, search, browsing, property profiles, reviews
Public pages to introduce platform and drive discovery via search engines.
💡 Business Case
SEO-optimized landing pages are critical for organic acquisition. Well-structured homepage with destination highlights and trust signals significantly increases conversion rates.
- Homepage hero with integrated search module
- Destination highlights carousel
- Trust badges + benefits section
- Mobile-responsive design
Core search with filters, availability validation, and real-time pricing.
💡 Business Case
Search is the heart of any booking platform. Fast, intuitive search with smart auto-suggestions directly impacts conversion rates.
- Destination auto-suggest
- Date range picker
- Guest selector (adults/children)
- Filters: price, rating, amenities, property type
- Sort: price, rating, popularity
Property detail page showing all room/unit types with pricing comparison.
💡 Business Case
Allowing users to compare room options (Standard vs Deluxe vs Suite) increases booking value. Clear policy display reduces disputes.
- Photo gallery with lightbox
- Property overview + location map
- Room/unit comparison table
- Policies section (min-stay, cancellation)
- Clear CTA: "Select Room"
Guests view rating summary and reviews on property pages.
💡 Business Case
Social proof through reviews is a primary conversion driver. Properties with reviews have significantly higher booking rates.
Optional invite-only access. Decision needed: Public listings (SEO-friendly) vs. invite-only.
⚠️ Decision Required
Recommendation: Public listings for SEO benefits. Invite gate adds friction and reduces discoverability. Can add premium tiers later.
👤 Customer Accounts
Registration, login, profile management, authentication & security
Authentication & Profile
Registration, login, profile management
Secure customer authentication with email verification and password reset.
💡 Business Case
Secure authentication is foundational. Email verification reduces fake accounts and fraud. Brute-force protection is mandatory for PCI compliance.
- Token-based sessions with secure cookies
- Rate limiting on auth endpoints
- Brute-force protection with lockout
- Password strength requirements
- Verification token expiry (24h)
Customer profile management and travel preferences.
- Profile page with personal details
- Edit profile with validation
- Travel preferences (future personalization)
- Audit logs for changes (admin-visible)
📅 Booking & Checkout
Validation, checkout, payment processing, cancellation & refunds
Booking Flow & Payment
Validation, checkout, payment, cancellation
Min-stay, guest count pricing, extra guest fees with transparent breakdown.
💡 Business Case
Proper validation prevents disputes and chargebacks. Transparent pricing builds trust—hidden fees are the #1 cause of cart abandonment.
- Base price × nights
- Extra guest fees (above base occupancy)
- Long-stay discounts (7+ nights)
- Promotional discounts
- Taxes and platform fees
Configurable per vendor: instant confirmation or approval required.
💡 Business Case
Hotels want instant booking for volume. Boutique properties may prefer approval. Supporting both maximizes platform appeal.
Default: Support both modes, configurable per vendor.
Payment collection with authorization holds, webhooks, fraud prevention.
- Payment provider integration
- Webhook listener with signature verification
- Idempotency keys for all requests
- Chargeback handling
- PCI-compliant card handling
Policy-based cancellation rules with refund processing.
- Flexible: Full refund up to 24h before
- Moderate: Full refund up to 5 days before
- Strict: 50% refund up to 1 week before
- Non-refundable: No refund after booking
Booking dashboard, history, and post-checkout review submission.
- Bookings list with status filters
- Booking detail with timeline
- Review form (1-5 stars + text)
- Eligibility: only after checkout
👥 Travel Circle & User Dashboard V1.01
Invite friends to travel together, manage your circle, OTP-verified invitations
Travel Circle Invitations
Invite friends & family to travel together with secure OTP verification
Personal dashboard for customers to manage profile, travel circle, invitations, and bookings.
💡 Business Case
A comprehensive user dashboard increases engagement and retention by giving customers control over their travel planning and social connections.
- Profile Management
- My Bookings (Active/Past)
- Travel Circle (Friends List)
- Sent Invitations (Status tracking)
- Received Invitations
- Saved Properties (Wishlist)
- Payment Methods
- Notification Preferences
Allow users to invite their circle of people to travel together with secure invitation links.
💡 Business Case
Social travel invitations increase organic user acquisition and group bookings, driving higher revenue per transaction.
- Add friends by mobile number or email
- Generate unique invitation links per trip/group
- Track invitation status (sent, viewed, accepted)
- Invitation expiry management
- Group travel coordination
Secure invitation system ensuring only intended recipients can use the invite link via OTP verification.
💡 Business Case
OTP verification prevents invitation abuse and ensures invitations are used only by intended recipients, maintaining platform security.
- Invitation link contains unique token (UUID)
- Recipient clicks link → enters mobile number
- 6-digit OTP sent via SMS to verify
- OTP must match the mobile number invitation was sent to
- Double verification: Token + OTP = Authorized signup
- Configurable invitation validity (default 7 days)
🔌 HyperGuest API Integration V1.01
Third-party inventory access, property sync, booking integration
HyperGuest Platform Integration
Access additional property inventory via HyperGuest API
Integration with HyperGuest platform to access additional property inventory and booking capabilities.
💡 Business Case
HyperGuest integration expands available inventory without requiring direct vendor onboarding, accelerating platform growth and offering users more choices.
- API authentication and connection setup (OAuth 2.0 / API Key)
- Property search and availability sync
- Booking creation and confirmation flow
- Rate and inventory mapping
- Cancellation policy synchronization
- Real-time availability updates
- Graceful fallback to local inventory on API errors
- RESTful API integration layer
- Real-time availability polling
- Data transformation and mapping
- Error handling and retry logic
- Caching strategy for performance
🏨 Vendor Portal
Registration, KYC verification, listing wizard, calendar & availability management
Onboarding & Listings
Registration, KYC, listing wizard, calendar
Vendors register, verify identity, submit documents for approval.
💡 Business Case
KYC verification is essential for marketplace trust and regulatory compliance. Verified vendors reduce fraud and build customer confidence.
- Email/phone verification
- Company profile creation
- Document upload (business reg, ID)
- Admin approval workflow
- Verified badge on approval
Step-by-step property creation with rooms, pricing, amenities, policies.
- Step 1: Property details (name, location, description)
- Step 2: Room/unit types with capacities
- Step 3: Pricing (base, extra guest, discounts)
- Step 4: Amenities (property + room level)
- Step 5: Policies (min-stay, cancellation)
- Step 6: Photos (drag-drop upload)
- Step 7: Review & submit
Visual calendar for availability management, prevents overbooking.
- Visual calendar with bookings
- Block/unblock dates
- Bulk date management
- Inventory adjustments per unit
- Real-time sync with search
Revenue, payouts, commissions, transaction history, invoices.
💡 Business Case
Financial transparency builds vendor trust and reduces support inquiries. Clear commission breakdowns are essential for retention.
- Revenue summary (weekly/monthly)
- Payouts list (pending/processing/paid)
- Commission breakdown
- Transaction history with filters
- Invoice downloads (PDF)
⚙️ Admin Operations
Listings moderation, vendor management, user support, bookings oversight
Moderation & Management
Listings, vendors, users, bookings, support
Admin reviews and approves vendor listings before publication.
💡 Business Case
Content moderation is primary defense against fraudulent or low-quality listings. Preview capability ensures admin sees exactly what customers will see.
- Pending listings queue
- Customer-view preview
- Approve / Reject / Request Changes
- Vendor notifications
- Full audit logs
Manage users/vendors with "Login as User" for support.
💡 Business Case
Impersonation is incredibly useful for support—when vendor says "I can't upload photos," support can log in as them and see exactly what they see. All sessions are logged.
Curate featured collections for homepage and marketing.
💡 Kimit Enhancement
Curated collections ("Top Picks in Kuwait") improve conversion. Admin control without developer involvement speeds marketing campaigns.
Track all critical events: logins, approvals, payouts, config changes.
💡 Kimit MPF
Audit logs are mandatory for security, compliance, and dispute resolution. Every critical admin action must produce a tamper-evident record.
FAQ knowledge base and ticket system for support.
💡 Business Case
Self-service support reduces ticket volume by 60-80%. Well-organized help center builds confidence and reduces costs.
💳 Admin Finance
Commission rules, payout management, invoices generation, financial reports
Commission & Payouts
Commission rules, payout management, invoices, reports
Global default with vendor-specific overrides.
💡 Business Case
Flexible commission structure allows competitive vendor negotiations. Global default (e.g., 15%) with per-vendor overrides enables premium partnerships.
- Global commission rate setting
- Vendor-specific overrides
- Change history with audit trail
Generate payout batches, approve, track, and process.
- Eligible payouts list
- Batch creation with line items
- Approve/reject payouts
- Status: pending → processing → paid
- Handle refunds affecting earnings
Auto-generated invoices and financial KPI dashboard.
- Total GMV (Gross Merchandise Value)
- Commission earned by period
- Payouts due and processed
- Refunds issued
- CSV export
COA, journals, trial balance — Phase 4 or integrate with accounting software.
📋 Not in MVP
Full double-entry accounting is typically handled by dedicated accounting software (QuickBooks, Xero). Recommended as Phase 4 or integration rather than custom build.