Overview
Kin Conecta operates on a dual-role system that connects tourists seeking authentic experiences with local guides offering personalized tours. The platform supports three primary user roles, each with distinct capabilities and profile structures.User Role Types
The platform defines user roles through theUserRole enum:
TOURIST Role
Tourists are travelers seeking authentic local experiences. They can browse tours, book experiences with guides, and build their travel preferences through detailed profiles. Core Capabilities:- Browse and search available tours
- Book tours with local guides
- Create and manage compatibility profiles for better matching
- Save favorite guides and tours
- Review and rate completed experiences
- Manage travel preferences and interests
GUIDE Role
Guides are local experts who create and offer tours in their areas. They showcase their expertise, manage bookings, and earn income through the platform. Core Capabilities:- Create and manage tour offerings
- Set hourly rates and tour pricing
- Manage booking requests and calendar
- Showcase certifications and expertise
- Receive payments and track earnings
- Build reputation through ratings and reviews
ADMIN Role
Administrators manage the platform, moderate content, and ensure quality standards across the marketplace.User Base Model
All users share a common base model regardless of role:Account Status
User accounts progress through different states:Tourist Profile
Tourists must complete their profile to access matching features and receive personalized guide recommendations.
Activity Levels
Activity Levels
Tourist profiles specify their preferred activity intensity:
- BAJO: Low-intensity activities, leisurely pace
- MODERADO: Moderate activity, balanced experiences
- ALTO: High-intensity activities, adventurous pace
Profile Components
Interests
Tourists can select multiple interests that help match them with specialized guides (Gastronomía, Naturaleza, Historia, Arte, Aventura).
Languages
Multi-language support through
tourist_profile_languages junction table enables matching with guides who speak preferred languages.Travel Preferences
Detailed preferences including travel style, trip type, pace, group preferences, and planning level.
Accessibility
Specific accessibility requirements and dietary preferences for personalized experiences.
Guide Profile
Guide profiles showcase expertise, experience, and service offerings:Professional Features
Expertise Areas
Guides declare their areas of expertise (Food Tours, Nature Trails, Historic Walks, Museum Tours, Adventure Trips) through the
guide_profile_expertise table.Certifications
Professional certifications stored in
guide_certifications build credibility and trust.Locations
Multiple service locations managed through
guide_locations table enable guides to offer tours in different cities.Languages
Language capabilities through
guide_profile_languages expand potential tourist matching.Pricing and Ratings
Guides set their base
hourlyRate in their preferred currency. Individual tours can have custom pricing that may differ from the hourly rate.- Hourly Rate: Base rate for services
- Rating Average: Calculated from tourist reviews (0-5 scale)
- Reviews Count: Total number of reviews received
- Experience Level: Professional standing (Beginner, Intermedio, Avanzado, Experto)
Tour Style Attributes
Guides specify their tour characteristics:- Style: Tour delivery approach (educational, casual, interactive)
- Group Size: Preferred group sizes (intimate, small, medium, large)
- Tour Intensity: Physical demand level of tours
- Transport Offered: Transportation options provided
- Photo Style: Photography approach during tours
Profile Relationships
Role-Based Access
The platform implements role-based access control:- Authentication: All roles require authenticated sessions
- Profile Completion: Certain features require completed profiles
- Permission Scopes: API endpoints restrict access based on user role
- Data Visibility: Users can only access data appropriate to their role
A user can only have ONE active role at a time. To switch from TOURIST to GUIDE (or vice versa), a new account registration is required.
Next Steps
Tours
Learn about tour structure and management
Matching Algorithm
Understand how tourists and guides are matched
Authentication
Explore the authentication and security model
API Reference
View API endpoints for user management