Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Jesus-Puertos/h-ayuntamiento/llms.txt
Use this file to discover all available pages before exploring further.
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:Onboarding
Complete a 5-step questionnaire about travel preferences, duration, difficulty level, travel group, and specific interests
Recommendations
Receive personalized recommendations from 17 tourist attractions based on preferences
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
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:- Selecting attractions from recommendations or full catalog
- Organizing them into a trip itinerary
- Generating a shareable route with unique code
- 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