Overview
Tours are the core offering of Kin Conecta, representing curated experiences created by local guides. Each tour is a structured product with detailed information about activities, destinations, pricing, and logistics.Tour Data Model
The central tour entity contains all essential information:Tour Status
Tours progress through different lifecycle states:Only tours with
ACTIVE status appear in search results and can receive new bookings. Guides can pause tours without losing existing bookings.Tour Categories
Tours are organized into categories for easier discovery:- Food & Gastronomy Tours
- Nature & Outdoor Adventures
- Historical & Cultural Walks
- Art & Museum Tours
- Photography Expeditions
- Adventure & Sports
- Urban Exploration
- Nightlife & Entertainment
Categories help tourists filter tours by their interests and enable the matching algorithm to recommend relevant experiences.
Destinations
Destinations represent geographical locations where tours take place:Tour-Destination Relationship
Tours can cover multiple destinations through thetour_destinations junction table:
Multi-Destination Tours
Multi-Destination Tours
Tours can visit multiple locations in a specific sequence. The
visitOrder field defines the itinerary flow:- Order 1: First stop (meeting point)
- Order 2: Second location
- Order N: Final destination
Included Items
Tours specify what’s included in the experience:- Professional guide services
- Entrance fees to attractions
- Local transportation
- Food and beverage tastings
- Photography services
- Safety equipment
- Souvenir or takeaway item
Transparency
Clear listing of included items helps tourists understand exactly what they’re paying for and reduces booking friction.
Value Communication
Detailed inclusions showcase the tour’s value proposition and justify pricing.
Pricing Structure
Tour Pricing
Each tour has independent pricing:Tour prices are separate from the guide’s hourly rate. Guides can price tours based on value, complexity, and included items rather than just time.
Pricing Considerations
- Fixed Price: Tours use fixed pricing per person
- Group Discounts: Can be implemented through custom booking logic
- Currency Support: Multi-currency support for international tourists
- Inclusive Pricing: Price includes items listed in
tour_included_items
Tour Booking Flow
The booking process connects tourists with guide experiences:Trip Bookings
Bookings are tracked through theTripBooking entity:
Booking Status Lifecycle
Status Transitions
Status Transitions
Valid Status Flows:
- PENDING → CONFIRMED (Guide accepts)
- PENDING → CANCELLED (Guide/Tourist declines)
- CONFIRMED → CANCELLED (Cancellation before tour)
- CONFIRMED → CHANGE_REQUESTED (Rescheduling)
- CHANGE_REQUESTED → CONFIRMED (Change accepted)
- CONFIRMED → COMPLETED (Tour finishes)
Trip Status History
All status changes are tracked for auditing:Status history enables dispute resolution, performance analytics, and provides transparency for both tourists and guides.
Tour Discovery Features
Search and Filtering
Tourists discover tours through multiple methods:- Category Browsing: Filter by tour category
- Destination Search: Find tours in specific locations
- Guide Profiles: View all tours by a specific guide
- Featured Tours: Highlighted popular or high-quality tours
- Price Range: Filter within budget constraints
- Duration: Find tours matching available time
- Rating: Sort by average rating
Tour Metrics
Guide Calendar Integration
Guides manage availability through calendar events:- BOOKING: Confirmed tour booking
- BLOCKED: Unavailable time period
- TENTATIVE: Pending booking request
The calendar system prevents double-booking and helps guides manage their schedule across multiple tours.
Tour Creation Best Practices
Compelling Descriptions
Detailed, engaging descriptions that paint a picture of the experience increase booking rates.
Quality Images
High-quality cover images (
coverImageUrl) significantly impact click-through rates.Clear Inclusions
Explicit listing of what’s included reduces pre-booking questions and builds trust.
Accurate Duration
Honest duration estimates help set proper tourist expectations and prevent negative reviews.
Strategic Pricing
Competitive pricing relative to included value and local market rates.
Meeting Point Clarity
Precise meeting point descriptions reduce confusion and late starts.
Next Steps
User Roles
Learn about guide and tourist profiles
Matching Algorithm
Discover how tours are matched to tourists
API - Tours
Explore tour management API endpoints
API - Bookings
View booking API documentation