Skip to main content

MVP - Villas Foundation Platform

Timeline: Weeks 1-24 (6 months) Goal: Property managers can distribute villa listings to channels from one central platform Status: In Design

Vision​

Build a foundation property management platform where villa owners and managers can:

  • ✅ Manage all properties in one place
  • ✅ Automatically distribute listings to Hostaway, Airbnb, VRBO
  • ✅ View all bookings from channels in unified system
  • ✅ Track sync status and troubleshoot issues

What MVP is NOT:

  • ❌ Direct booking engine (that's V1.0)
  • ❌ Payment processing (that's V1.0)
  • ❌ Dynamic pricing (that's V1.0)
  • ❌ Events/experiences (that's V2.0)

MVP Sub-Versions (3 Deployable Increments)​

MVP.0 - Foundation + One-Way Distribution (Weeks 1-10)​

Business Value: Single source of truth, automated Hostaway distribution

Capabilities:

  • Google SSO authentication
  • Multi-tenant organization management
  • Space and Unit CRUD
  • One-way sync: TVL → Hostaway
  • Manual sync retry
  • Audit logging

Domains Used:

  • Identity & Tenancy ✅
  • Authorization & Access ✅
  • Supply ✅
  • Channels & Distribution (one-way only) ✅
  • Analytics & Audit (basic) ✅

Tables: 14 total

See mvp.0_specification.md for details.

MVP.1 - Two-Way Sync + Booking Awareness (Weeks 11-16)​

Business Value: Unified view of all bookings, occupancy visibility

NEW Capabilities (beyond MVP.0):

  • Ingest bookings from Hostaway → TVL
  • Read-only availability calendar display
  • Booking list view (external bookings)
  • Basic pricing display (no dynamic rules)

NEW Domains:

  • Availability & Calendar (read-only) ✅
  • Bookings (external only) ✅
  • Pricing (display only) ✅

Tables: +5 tables (19 total)

See mvp.1_specification.md for details.

MVP.2 - Multi-Channel Distribution (Weeks 17-24)​

Business Value: Reach more guests across multiple OTAs, prevent double-bookings

NEW Capabilities (beyond MVP.1):

  • Airbnb API integration (listings + bookings)
  • VRBO API integration (listings + bookings)
  • Unified availability calendar across all channels
  • Conflict detection and prevention
  • Channel-specific field mappings

Updated Domains:

  • Channels & Distribution (multi-channel) ✅
  • Availability (conflict prevention) ✅

Tables: +2 tables (21 total)

See mvp.2_specification.md for details.

End State: What You Have After MVP.2​

As a Property Manager:

  • ✅ Manage 100+ villas in one system
  • ✅ Auto-sync to Hostaway, Airbnb, VRBO
  • ✅ All bookings from all channels visible in TVL
  • ✅ Prevent double-bookings with unified calendar
  • ✅ Track sync status per channel
  • ✅ Basic pricing display

NOT Yet Available (requires V1.0):

  • ❌ Guests can't book directly on TVL
  • ❌ No payment processing
  • ❌ No dynamic pricing rules
  • ❌ No owner financial reports
  • ❌ No unified guest inbox
  • ❌ No task automation

Path to V1.0​

After MVP.2, we build V1.0 "Villas Complete" which adds:

  • Direct booking engine on TVL
  • Payment processing (Stripe Connect)
  • Dynamic pricing rules
  • Owner portal with financials
  • Unified guest inbox
  • Task automation (cleaning, maintenance)

See v1_product-specification.md for full V1 vision.

Success Metrics for MVP (all 3 versions)​

MVP.0:

  • ✅ 10+ properties managed in TVL
  • ✅ 100% sync success rate to Hostaway
  • ✅ <1 minute sync latency

MVP.1:

  • ✅ 50+ properties with multi-channel presence
  • ✅ All bookings from Hostaway visible in TVL
  • ✅ Zero data loss on booking ingestion

MVP.2:

  • ✅ 100+ properties distributed to 3+ channels
  • ✅ Zero double-bookings
  • ✅ <5 minute cross-channel sync latency

Technical Architecture​

Stack:

  • Backend: Node.js + TypeScript + Express
  • Database: PostgreSQL 15+ with RLS
  • Auth: Google OIDC
  • Queue: BullMQ + Redis
  • Deployment: Docker, Kubernetes

Multi-Tenancy:

  • 3-tier: Organization → Account → User
  • Row-Level Security (RLS) at database layer
  • All entities scoped by org_id + account_id

See mvp_data-model.md for complete schemas.