Rename Adventures to Locations (#696)

* Refactor user_id to user in adventures and related models, views, and components

- Updated all instances of user_id to user in the adventures app, including models, serializers, views, and frontend components.
- Adjusted queries and filters to reflect the new user field naming convention.
- Ensured consistency across the codebase for user identification in adventures, collections, notes, and transportation entities.
- Modified frontend components to align with the updated data structure, ensuring proper access control and rendering based on user ownership.

* Refactor adventure-related views and components to use "Location" terminology

- Updated GlobalSearchView to replace AdventureSerializer with LocationSerializer.
- Modified IcsCalendarGeneratorViewSet to use LocationSerializer instead of AdventureSerializer.
- Created new LocationImageViewSet for managing location images, including primary image toggling and image deletion.
- Introduced LocationViewSet for managing locations with enhanced filtering, sorting, and sharing capabilities.
- Updated ReverseGeocodeViewSet to utilize LocationSerializer.
- Added ActivityTypesView to retrieve distinct activity types from locations.
- Refactored user views to replace AdventureSerializer with LocationSerializer.
- Updated frontend components to reflect changes from "adventure" to "location", including AdventureCard, AdventureLink, AdventureModal, and others.
- Adjusted API endpoints in frontend routes to align with new location-based structure.
- Ensured all references to adventures are replaced with locations across the codebase.

* refactor: rename adventures to locations across the application

- Updated localization files to replace adventure-related terms with location-related terms.
- Refactored TypeScript types and variables from Adventure to Location in various routes and components.
- Adjusted UI elements and labels to reflect the change from adventures to locations.
- Ensured all references to adventures in the codebase are consistent with the new location terminology.

* Refactor code structure for improved readability and maintainability

* feat: Implement location details page with server-side loading and deletion functionality

- Added +page.server.ts to handle server-side loading of additional location info.
- Created +page.svelte for displaying location details, including images, visits, and maps.
- Integrated GPX file handling and rendering on the map.
- Updated map route to link to locations instead of adventures.
- Refactored profile and search routes to use LocationCard instead of AdventureCard.

* docs: Update terminology from "Adventure" to "Location" and enhance project overview

* docs: Clarify collection examples in usage documentation

* feat: Enable credentials for GPX file fetch and add CORS_ALLOW_CREDENTIALS setting

* Refactor adventure references to locations across the backend and frontend

- Updated CategoryViewSet to reflect location context instead of adventures.
- Modified ChecklistViewSet to include locations in retrieval logic.
- Changed GlobalSearchView to search for locations instead of adventures.
- Adjusted IcsCalendarGeneratorViewSet to handle locations instead of adventures.
- Refactored LocationImageViewSet to remove unused import.
- Updated LocationViewSet to clarify public access for locations.
- Changed LodgingViewSet to reference locations instead of adventures.
- Modified NoteViewSet to prevent listing all locations.
- Updated RecommendationsViewSet to handle locations in parsing and response.
- Adjusted ReverseGeocodeViewSet to search through user locations.
- Updated StatsViewSet to count locations instead of adventures.
- Changed TagsView to reflect activity types for locations.
- Updated TransportationViewSet to reference locations instead of adventures.
- Added new translations for search results related to locations in multiple languages.
- Updated dashboard and profile pages to reflect location counts instead of adventure counts.
- Adjusted search routes to handle locations instead of adventures.

* Update banner image

* style: Update stats component background and border for improved visibility

* refactor: Rename AdventureCard and AdventureModal to LocationCard and LocationModal for consistency

backend/server/worldtravel/management/commands/bulk-adventure-geocode.py

@@ -1,12 +1,12 @@
 from django.core.management.base import BaseCommand
-from adventures.models import Adventure
+from adventures.models import Location
 import time
 
 class Command(BaseCommand):
 	help = 'Bulk geocode all adventures by triggering save on each one'
 
 	def handle(self, *args, **options):
-		adventures = Adventure.objects.all()
+		adventures = Location.objects.all()
 		total = adventures.count()
 		
 		self.stdout.write(self.style.SUCCESS(f'Starting bulk geocoding of {total} adventures'))

backend/server/worldtravel/migrations/0017_rename_user_id_visitedregion_user.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.1 on 2025-06-19 20:24
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('worldtravel', '0016_remove_city_insert_id_remove_country_insert_id_and_more'),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name='visitedregion',
+            old_name='user_id',
+            new_name='user',
+        ),
+    ]

backend/server/worldtravel/migrations/0018_rename_user_id_visitedcity_user.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.1 on 2025-06-19 20:24
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('worldtravel', '0017_rename_user_id_visitedregion_user'),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name='visitedcity',
+            old_name='user_id',
+            new_name='user',
+        ),
+    ]

backend/server/worldtravel/models.py

@@ -6,7 +6,7 @@ from django.contrib.gis.db import models as gis_models
 
 User = get_user_model()
 
-default_user_id = 1  # Replace with an actual user ID
+default_user = 1  # Replace with an actual user ID
 
 class Country(models.Model):
 
@@ -50,29 +50,29 @@ class City(models.Model):
 
 class VisitedRegion(models.Model):
     id = models.AutoField(primary_key=True)
-    user_id = models.ForeignKey(
-        User, on_delete=models.CASCADE, default=default_user_id)
+    user = models.ForeignKey(
+        User, on_delete=models.CASCADE, default=default_user)
     region = models.ForeignKey(Region, on_delete=models.CASCADE)
 
     def __str__(self):
-        return f'{self.region.name} ({self.region.country.country_code}) visited by: {self.user_id.username}'
+        return f'{self.region.name} ({self.region.country.country_code}) visited by: {self.user.username}'
     
     def save(self, *args, **kwargs):
-        if VisitedRegion.objects.filter(user_id=self.user_id, region=self.region).exists():
+        if VisitedRegion.objects.filter(user=self.user, region=self.region).exists():
             raise ValidationError("Region already visited by user.")
         super().save(*args, **kwargs)
 
 class VisitedCity(models.Model):
     id = models.AutoField(primary_key=True)
-    user_id = models.ForeignKey(
-        User, on_delete=models.CASCADE, default=default_user_id)
+    user = models.ForeignKey(
+        User, on_delete=models.CASCADE, default=default_user)
     city = models.ForeignKey(City, on_delete=models.CASCADE)
 
     def __str__(self):
-        return f'{self.city.name} ({self.city.region.name}) visited by: {self.user_id.username}'
+        return f'{self.city.name} ({self.city.region.name}) visited by: {self.user.username}'
     
     def save(self, *args, **kwargs):
-        if VisitedCity.objects.filter(user_id=self.user_id, city=self.city).exists():
+        if VisitedCity.objects.filter(user=self.user, city=self.city).exists():
             raise ValidationError("City already visited by user.")
         super().save(*args, **kwargs)
 

backend/server/worldtravel/serializers.py

@@ -25,7 +25,7 @@ class CountrySerializer(serializers.ModelSerializer):
         user = getattr(request, 'user', None)
         
         if user and user.is_authenticated:
-            return VisitedRegion.objects.filter(region__country=obj, user_id=user).count()
+            return VisitedRegion.objects.filter(region__country=obj, user=user).count()
         
         return 0
 
@@ -62,8 +62,8 @@ class VisitedRegionSerializer(CustomModelSerializer):
 
     class Meta:
         model = VisitedRegion
-        fields = ['id', 'user_id', 'region', 'longitude', 'latitude', 'name']
-        read_only_fields = ['user_id', 'id', 'longitude', 'latitude', 'name']
+        fields = ['id', 'user', 'region', 'longitude', 'latitude', 'name']
+        read_only_fields = ['user', 'id', 'longitude', 'latitude', 'name']
 
 class VisitedCitySerializer(CustomModelSerializer):
     longitude = serializers.DecimalField(source='city.longitude', max_digits=9, decimal_places=6, read_only=True)
@@ -72,5 +72,5 @@ class VisitedCitySerializer(CustomModelSerializer):
 
     class Meta:
         model = VisitedCity
-        fields = ['id', 'user_id', 'city', 'longitude', 'latitude', 'name']
-        read_only_fields = ['user_id', 'id', 'longitude', 'latitude', 'name']
+        fields = ['id', 'user', 'city', 'longitude', 'latitude', 'name']
+        read_only_fields = ['user', 'id', 'longitude', 'latitude', 'name']

backend/server/worldtravel/views.py

@@ -13,7 +13,7 @@ from django.contrib.gis.geos import Point
 from django.conf import settings
 from rest_framework.decorators import action
 from django.contrib.staticfiles import finders
-from adventures.models import Adventure
+from adventures.models import Location
 
 @api_view(['GET'])
 @permission_classes([IsAuthenticated])
@@ -28,7 +28,7 @@ def regions_by_country(request, country_code):
 @permission_classes([IsAuthenticated])
 def visits_by_country(request, country_code):
     country = get_object_or_404(Country, country_code=country_code)
-    visits = VisitedRegion.objects.filter(region__country=country, user_id=request.user.id)
+    visits = VisitedRegion.objects.filter(region__country=country, user=request.user.id)
 
     serializer = VisitedRegionSerializer(visits, many=True)
     return Response(serializer.data)
@@ -45,7 +45,7 @@ def cities_by_region(request, region_id):
 @permission_classes([IsAuthenticated])
 def visits_by_region(request, region_id):
     region = get_object_or_404(Region, id=region_id)
-    visits = VisitedCity.objects.filter(city__region=region, user_id=request.user.id)
+    visits = VisitedCity.objects.filter(city__region=region, user=request.user.id)
 
     serializer = VisitedCitySerializer(visits, many=True)
     return Response(serializer.data)
@@ -71,7 +71,7 @@ class CountryViewSet(viewsets.ReadOnlyModelViewSet):
     # make a post action that will get all of the users adventures and check if the point is in any of the regions if so make a visited region object for that user if it does not already exist
     @action(detail=False, methods=['post'])
     def region_check_all_adventures(self, request):
-        adventures = Adventure.objects.filter(user_id=request.user.id, type='visited')
+        adventures = Location.objects.filter(user=request.user.id, type='visited')
         count = 0
         for adventure in adventures:
             if adventure.latitude is not None and adventure.longitude is not None:
@@ -79,8 +79,8 @@ class CountryViewSet(viewsets.ReadOnlyModelViewSet):
                     point = Point(float(adventure.longitude), float(adventure.latitude), srid=4326)
                     region = Region.objects.filter(geometry__contains=point).first()
                     if region:
-                        if not VisitedRegion.objects.filter(user_id=request.user.id, region=region).exists():
-                            VisitedRegion.objects.create(user_id=request.user, region=region)
+                        if not VisitedRegion.objects.filter(user=request.user.id, region=region).exists():
+                            VisitedRegion.objects.create(user=request.user, region=region)
                             count += 1
                 except Exception as e:
                     print(f"Error processing adventure {adventure.id}: {e}")
@@ -97,14 +97,14 @@ class VisitedRegionViewSet(viewsets.ModelViewSet):
     permission_classes = [IsAuthenticated]
 
     def get_queryset(self):
-        return VisitedRegion.objects.filter(user_id=self.request.user.id)
+        return VisitedRegion.objects.filter(user=self.request.user.id)
     
     def perform_create(self, serializer):
-        serializer.save(user_id=self.request.user)
+        serializer.save(user=self.request.user)
 
     def create(self, request, *args, **kwargs):
-        request.data['user_id'] = request.user
-        if VisitedRegion.objects.filter(user_id=request.user.id, region=request.data['region']).exists():
+        request.data['user'] = request.user
+        if VisitedRegion.objects.filter(user=request.user.id, region=request.data['region']).exists():
             return Response({"error": "Region already visited by user."}, status=400)
         serializer = self.get_serializer(data=request.data)
         serializer.is_valid(raise_exception=True)
@@ -115,7 +115,7 @@ class VisitedRegionViewSet(viewsets.ModelViewSet):
     def destroy(self, request, **kwargs):
         # delete by region id
         region = get_object_or_404(Region, id=kwargs['pk'])
-        visited_region = VisitedRegion.objects.filter(user_id=request.user.id, region=region)
+        visited_region = VisitedRegion.objects.filter(user=request.user.id, region=region)
         if visited_region.exists():
             visited_region.delete()
             return Response(status=status.HTTP_204_NO_CONTENT)
@@ -127,27 +127,27 @@ class VisitedCityViewSet(viewsets.ModelViewSet):
     permission_classes = [IsAuthenticated]
 
     def get_queryset(self):
-        return VisitedCity.objects.filter(user_id=self.request.user.id)
+        return VisitedCity.objects.filter(user=self.request.user.id)
     
     def perform_create(self, serializer):
-        serializer.save(user_id=self.request.user)
+        serializer.save(user=self.request.user)
 
     def create(self, request, *args, **kwargs):
-        request.data['user_id'] = request.user
+        request.data['user'] = request.user
         serializer = self.get_serializer(data=request.data)
         serializer.is_valid(raise_exception=True)
         self.perform_create(serializer)
         # if the region is not visited, visit it
         region = serializer.validated_data['city'].region
-        if not VisitedRegion.objects.filter(user_id=request.user.id, region=region).exists():
-            VisitedRegion.objects.create(user_id=request.user, region=region)
+        if not VisitedRegion.objects.filter(user=request.user.id, region=region).exists():
+            VisitedRegion.objects.create(user=request.user, region=region)
         headers = self.get_success_headers(serializer.data)
         return Response(serializer.data, status=status.HTTP_201_CREATED, headers=headers)
     
     def destroy(self, request, **kwargs):
         # delete by city id
         city = get_object_or_404(City, id=kwargs['pk'])
-        visited_city = VisitedCity.objects.filter(user_id=request.user.id, city=city)
+        visited_city = VisitedCity.objects.filter(user=request.user.id, city=city)
         if visited_city.exists():
             visited_city.delete()
             return Response(status=status.HTTP_204_NO_CONTENT)