Tourism System Overview

Complete overview of the interactive tourism system for Zongolica

What is the Tourism System?

The Ayuntamiento de Zongolica tourism system is an interactive platform that provides personalized tourism experiences for visitors to the Sierra de Zongolica region. It combines user authentication, personalized recommendations, gamification, and social sharing to create an engaging tourism experience.

Key Components

The tourism system consists of four main components:

Interactive Onboarding

5-step questionnaire that collects user preferences and interests

Recommendation Engine

Algorithm that matches users with personalized tourist attractions

Badge System

Gamification with 29 unique badges to unlock through exploration

Ticket Generation

Visual tickets with QR codes for sharing on social media

User Journey

The complete tourism experience follows this flow:

1. Authentication

   Users sign in with Google or Facebook OAuth to create their profile

2. Onboarding

   Complete a 5-step questionnaire about travel preferences, duration, difficulty level, travel group, and specific interests

3. Recommendations

   Receive personalized recommendations from 17 tourist attractions based on preferences

4. Badge Unlocking

   Earn badges based on profile creation, favorites, and visits to attractions

5. Ticket Creation

   Generate a unique visual ticket with QR code showing their personalized route

6. Social Sharing

   Share tickets on Facebook, Twitter, WhatsApp, or download as PNG

Tourist Attractions

The system features 17 unique attractions across the Sierra de Zongolica:

Categories

• Cascadas (Waterfalls): Natural waterfalls with scenic views
• Grutas (Caves): Underground cave systems
• Miradores (Viewpoints): Mountain viewpoints with panoramic vistas
• Pueblos (Towns): Traditional Náhuatl communities
• Naturaleza (Nature): Natural reserves and hiking trails
• Cultura (Culture): Cultural centers and museums

All attractions include detailed information about location, difficulty level, duration, and safety recommendations.

Features

Xochitlanis Platform

Xochitlanis is the premium tourism landing page that showcases:

• Featured experiences and routes
• Tourism events calendar
• Visitor services (transportation, lodging, emergency contacts)
• Interactive maps and galleries

Learn more about Xochitlanis →

User Profiles

Each authenticated user gets a complete profile with:

• Saved preferences from onboarding
• Favorite attractions
• Created routes
• Unlocked badges
• Visit history

Route Planning

Users can create custom tourism routes by:

1. Selecting attractions from recommendations or full catalog
2. Organizing them into a trip itinerary
3. Generating a shareable route with unique code
4. Sharing with friends and family

Technical Stack

The tourism system is built with:

• Frontend: Astro + React for interactive components
• Authentication: Supabase Auth with OAuth
• Database: PostgreSQL (Supabase) for user data
• Storage: Supabase Storage for ticket images
• APIs: Custom endpoints for ticket generation and verification

Next Steps

Explore Onboarding

Learn how the 5-step onboarding process works

View Attractions

Browse all 17 tourist attractions in the system

Understand Badges

See all 29 badges users can unlock

API Reference

Explore the tourism API endpoints