Feature/panoramax

apps/common/migrations/0003_alter_announcement_firebase_id.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.2.5 on 2026-02-17 12:03
+
+import ulid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('common', '0002_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='announcement',
+            name='firebase_id',
+            field=models.CharField(default=ulid.ULID, max_length=36, unique=True),
+        ),
+    ]

apps/common/models.py

@@ -139,7 +139,8 @@ class FirebasePushResource(Model):
     # NOTE: We should not directly use old_id. This is ID reference to old system
     old_id = models.CharField[str | None, str | None](max_length=30, db_index=True, null=True, blank=True)
 
-    firebase_id = models.CharField[str, str](max_length=30, unique=True, default=ULID)
+    # NOTE: Panoramax uses UUIDv4 (length 36) for identifiers, which we use as firebase_id for street project tasks
+    firebase_id = models.CharField[str, str](max_length=36, unique=True, default=ULID)
 
     firebase_push_status: int | None = IntegerChoicesField(  # type: ignore[reportAssignmentType]
         choices_enum=FirebasePushStatusEnum,

apps/contributor/migrations/0003_alter_contributorteam_firebase_id_and_more.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.5 on 2026-02-17 12:03
+
+import ulid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('contributor', '0002_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='contributorteam',
+            name='firebase_id',
+            field=models.CharField(default=ulid.ULID, max_length=36, unique=True),
+        ),
+        migrations.AlterField(
+            model_name='contributorusergroup',
+            name='firebase_id',
+            field=models.CharField(default=ulid.ULID, max_length=36, unique=True),
+        ),
+    ]

apps/project/graphql/inputs/project_types/street.py

@@ -1,10 +1,15 @@
 import strawberry
 
 from project_types.street import project as street_project
+from utils.geo.street_image_provider.models import StreetImageProvider
 
 
-@strawberry.experimental.pydantic.input(model=street_project.StreetMapillaryImageFilters, all_fields=True)
-class StreetMapillaryImageFiltersInput: ...
+@strawberry.experimental.pydantic.input(model=street_project.StreetImageFilters, all_fields=True)
+class StreetImageFiltersInput: ...
+
+
+@strawberry.experimental.pydantic.input(model=StreetImageProvider, all_fields=True)
+class StreetImageProviderInput: ...
 
 
 @strawberry.experimental.pydantic.input(model=street_project.StreetProjectProperty, all_fields=True)

apps/project/graphql/types/project_types/street.py

@@ -1,10 +1,15 @@
 import strawberry
 
 from project_types.street import project as street_project
+from utils.geo.street_image_provider.models import StreetImageProvider as StreetImageProviderModel
 
 
-@strawberry.experimental.pydantic.type(model=street_project.StreetMapillaryImageFilters, all_fields=True)
-class StreetMapillaryImageFilters: ...
+@strawberry.experimental.pydantic.type(model=street_project.StreetImageFilters, all_fields=True)
+class StreetImageFilters: ...
+
+
+@strawberry.experimental.pydantic.type(model=StreetImageProviderModel, all_fields=True)
+class StreetImageProvider: ...
 
 
 @strawberry.experimental.pydantic.type(model=street_project.StreetProjectProperty, all_fields=True)

apps/project/migrations/0011_alter_projecttask_firebase_id.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.5 on 2025-11-12 15:12
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('project', '0010_alter_projecttask_unique_together'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='projecttask',
+            name='firebase_id',
+            field=models.CharField(max_length=36),
+        ),
+    ]

apps/project/migrations/0012_alter_organization_firebase_id_and_more.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.5 on 2026-02-17 12:03
+
+import ulid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('project', '0011_alter_projecttask_firebase_id'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='organization',
+            name='firebase_id',
+            field=models.CharField(default=ulid.ULID, max_length=36, unique=True),
+        ),
+        migrations.AlterField(
+            model_name='project',
+            name='firebase_id',
+            field=models.CharField(default=ulid.ULID, max_length=36, unique=True),
+        ),
+    ]

apps/project/migrations/0013_backfill_image_provider_for_street_projects.py

@@ -0,0 +1,32 @@
+# Generated by Django 5.2.5 on 2026-04-28 14:28
+
+from django.db import migrations
+
+def backfill_image_provider(apps, schema_editor):
+    Project = apps.get_model('project', 'Project')
+
+    for project in Project._default_manager.all():
+        if project.project_type != 7:  # STREET type
+            continue
+
+        if project.project_type_specifics is None:
+            project.project_type_specifics = {}
+
+        if 'imageProvider' not in project.project_type_specifics:
+            project.project_type_specifics['imageProvider'] = {
+                'name': 'MAPILLARY'
+            }
+        project.save(update_fields=['project_type_specifics'])
+
+def reverse_backfill(apps, schema_editor):
+    pass
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('project', '0012_alter_organization_firebase_id_and_more'),
+    ]
+
+    operations = [
+        migrations.RunPython(backfill_image_provider, reverse_backfill),
+    ]

apps/project/migrations/0014_migrate_pano_only_for_street_projects.py

@@ -0,0 +1,75 @@
+# Generated by Django 5.2.5 on 2026-04-28 14:59
+
+import logging
+
+from django.db import migrations
+
+logger = logging.getLogger(__name__)
+
+
+def migrate_is_pano_to_pano_only(apps, schema_editor):
+    """
+    Migrate isPano field to panoOnly in mapillaryImageFilters
+    for all STREET-type projects to conform with updated schema.
+    """
+    Project = apps.get_model('project', 'Project')
+
+    migrated_count = 0
+
+    for project in Project._default_manager.all():
+        if project.project_type != 7:  # STREET type
+            continue
+
+        if project.project_type_specifics is None:
+            continue
+
+        if 'mapillaryImageFilters' in project.project_type_specifics:
+            filters = project.project_type_specifics['mapillaryImageFilters']
+            if isinstance(filters, dict) and 'isPano' in filters:
+                logger.info(
+                    f"Migrating isPano to panoOnly for project {project.id} ({project.name})"
+                )
+                filters['panoOnly'] = filters.pop('isPano')
+                project.save(update_fields=['project_type_specifics'])
+                migrated_count += 1
+
+    logger.info(f"Field migration completed: {migrated_count} projects migrated isPano to panoOnly")
+
+
+def reverse_pano_migration(apps, schema_editor):
+    """
+    Revert panoOnly back to isPano for compatibility.
+    """
+    Project = apps.get_model('project', 'Project')
+
+    reverted_count = 0
+
+    for project in Project._default_manager.all():
+        if project.project_type != 7:  # STREET type
+            continue
+
+        if project.project_type_specifics is None:
+            continue
+
+        if 'mapillaryImageFilters' in project.project_type_specifics:
+            filters = project.project_type_specifics['mapillaryImageFilters']
+            if isinstance(filters, dict) and 'panoOnly' in filters:
+                logger.info(
+                    f"Reverting panoOnly to isPano for project {project.id} ({project.name})"
+                )
+                filters['isPano'] = filters.pop('panoOnly')
+                project.save(update_fields=['project_type_specifics'])
+                reverted_count += 1
+
+    logger.info(f"Reverse migration completed: {reverted_count} projects reverted panoOnly to isPano")
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('project', '0013_backfill_image_provider_for_street_projects'),
+    ]
+
+    operations = [
+        migrations.RunPython(migrate_is_pano_to_pano_only, reverse_pano_migration),
+    ]

apps/project/models.py

@@ -671,7 +671,7 @@ class ProjectTask(FirebasePushResource):
     in the context of a larger mapping or data collection project.
     """
 
-    firebase_id = models.CharField[str, str](max_length=30)
+    firebase_id = models.CharField[str, str](max_length=36)
 
     task_group: ProjectTaskGroup = models.ForeignKey[ProjectTaskGroup, ProjectTaskGroup](  # type: ignore[reportAssignmentType]
         ProjectTaskGroup,

apps/project/tests/e2e_create_street_project_test.py

@@ -572,6 +572,12 @@ def _test_project(self, filename: str):
         sanitized_tasks_actual = project_tasks_fb_data
         sanitized_tasks_expected = test_data["expected_project_tasks_data"]
 
+        for tasks in sanitized_tasks_expected.values():
+            for task in tasks:
+                task_id = task.get("taskId")
+                if isinstance(task_id, str) and task_id.isdigit():
+                    task["taskId"] = int(task_id)
+
         assert sanitized_tasks_actual == sanitized_tasks_expected, (
             "Differences found between expected and actual tasks on project in firebase."
         )

apps/project/tests/mutation_test.py

@@ -1652,14 +1652,17 @@ def test_project_street(self, mock_requests):  # type: ignore[reportMissingParam
                         ],
                     },
                     "mapillaryImageFilters": {
-                        "isPano": True,
+                        "panoOnly": True,
                         "creatorId": None,
                         "organizationId": None,
                         "startTime": None,
                         "endTime": None,
                         "randomizeOrder": False,
                         "samplingThreshold": None,
                     },
+                    "imageProvider": {
+                        "name": "MAPILLARY",
+                    },
                 },
             },
         }

main/config.py

@@ -44,6 +44,7 @@ class Config:
     # NOTE: We get mapillary data from mapillary
     MAPILLARY_API_LINK = "https://tiles.mapillary.com/maps/vtp/mly1_computed_public/2/"
     MAPILLARY_API_KEY = typing.cast("str", settings.MAPILLARY_API_KEY)
+    PANORAMAX_API_LINK = "https://api.panoramax.xyz/"
 
     FIREBASE_HELPER = typing.cast("FirebaseHelper", settings.FIREBASE_HELPER)
     FIREBASE_EMULATOR_USE = typing.cast("str | None", settings.FIREBASE_EMULATOR_USE)

main/graphql/enums.py

@@ -11,10 +11,12 @@
 from project_types.validate.project import ValidateObjectSourceTypeEnum
 from project_types.validate_image.project import ValidateImageSourceTypeEnum
 from utils.geo.raster_tile_server.config import RasterTileServerNameEnum
+from utils.geo.street_image_provider.models import StreetImageProviderNameEnum
 from utils.geo.vector_tile_server.config import VectorTileServerNameEnum
 
 ENUM_TO_STRAWBERRY_ENUMS: list[type] = [
     RasterTileServerNameEnum,
+    StreetImageProviderNameEnum,
     VectorTileServerNameEnum,
     ValidateObjectSourceTypeEnum,
     ValidateImageSourceTypeEnum,