feat(program_v2): add self-linkage to program links

Author: japsu

backend/program_v2/graphql/program_links.py

@@ -1,3 +1,7 @@
+from __future__ import annotations
+
+from typing import Self
+
 import graphene
 from django.conf import settings
 from django.http import HttpRequest
@@ -22,6 +26,8 @@ class ProgramLinkType(graphene.Enum):
     FEEDBACK = "FEEDBACK"
     CALENDAR = "CALENDAR"
     OTHER = "OTHER"
+    GUIDE_V2_LIGHT = "GUIDE_V2_LIGHT"
+    GUIDE_V2_EMBEDDED = "GUIDE_V2_EMBEDDED"
 
 
 # This is an interim solution until Program V2 has an editing UI.
@@ -31,11 +37,13 @@ class ProgramLinkType(graphene.Enum):
         ProgramLinkType.RESERVATION: "Reserve seats",
         ProgramLinkType.TICKETS: "Buy tickets",
         ProgramLinkType.RECORDING: "Watch recording",
-        ProgramLinkType.MATERIAL: "Katso esitysmateriaalit",
+        ProgramLinkType.MATERIAL: "View presentation materials",
         ProgramLinkType.REMOTE: "Participate remotely",
         ProgramLinkType.FEEDBACK: "Give feedback",
         ProgramLinkType.OTHER: "Link",
         ProgramLinkType.CALENDAR: "Add to calendar",
+        ProgramLinkType.GUIDE_V2_LIGHT: "This program in Kompassi",
+        ProgramLinkType.GUIDE_V2_EMBEDDED: "This program at the event website",
     },
     fi={
         ProgramLinkType.SIGNUP: "Ilmoittaudu",
@@ -47,6 +55,8 @@ class ProgramLinkType(graphene.Enum):
         ProgramLinkType.FEEDBACK: "Anna palautetta",
         ProgramLinkType.OTHER: "Linkki",
         ProgramLinkType.CALENDAR: "Lisää kalenteriin",
+        ProgramLinkType.GUIDE_V2_LIGHT: "Tämä ohjelma Kompassissa",
+        ProgramLinkType.GUIDE_V2_EMBEDDED: "Tämä ohjelma tapahtuman web-sivuilla",
     },
     sv={
         ProgramLinkType.SIGNUP: "Anmäl dig",
@@ -58,6 +68,8 @@ class ProgramLinkType(graphene.Enum):
         ProgramLinkType.FEEDBACK: "Ge feedback",
         ProgramLinkType.OTHER: "Länk",
         ProgramLinkType.CALENDAR: "Lägg till i kalendern",
+        ProgramLinkType.GUIDE_V2_LIGHT: "Detta program i programguiden",
+        ProgramLinkType.GUIDE_V2_EMBEDDED: "Detta program på evenemangets webbsida",
     },
 )
 
@@ -75,11 +87,21 @@ def from_program(
         link_type: ProgramLinkType,
         language: str = DEFAULT_LANGUAGE,
         include_expired: bool = False,
-    ):
+    ) -> Self | None:
         """
         TODO should this be pushed into the Program model?
         TODO should this be cached? (probably not, as some links are time-sensitive)
+
+        params:
+            event - performance optimization to avoid O(n) queries
         """
+        event = program.event
+        meta = event.program_v2_event_meta
+
+        if meta is None:
+            # This should not happen, but appease the type checker
+            return None
+
         link_type_str = link_type.value  # type: ignore[attr-defined]
         title_specifier = ""
         link_annotation = f"internal:links:{link_type_str.lower()}"
@@ -106,13 +128,17 @@ def from_program(
                 href = (
                     program.annotations.get(
                         link_annotation,
-                        settings.KOMPASSI_V2_BASE_URL
-                        + f"/events/{program.event.slug}/programs/{program.slug}/feedback",
+                        settings.KOMPASSI_V2_BASE_URL + f"/events/{event.slug}/programs/{program.slug}/feedback",
                     )
                     if program.is_accepting_feedback
                     else ""
                 )
-
+            case ProgramLinkType.GUIDE_V2_LIGHT:
+                href = settings.KOMPASSI_V2_BASE_URL + f"/{event.slug}/programs/{program.slug}"
+            case ProgramLinkType.GUIDE_V2_EMBEDDED:
+                href = program.annotations.get(link_annotation, "")
+                if not href and meta.guide_v2_embedded_url:
+                    href = meta.guide_v2_embedded_url + "#prog:" + program.slug
             case _:
                 href = program.annotations.get(link_annotation, "")
 

backend/program_v2/migrations/0037_programv2eventmeta_guide_v2_embedded_url.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.1.5 on 2025-04-22 16:09
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("program_v2", "0036_remove_programv2eventmeta_location_dimension"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="programv2eventmeta",
+            name="guide_v2_embedded_url",
+            field=models.CharField(
+                blank=True, help_text="URL to the embedded guide. This is used to form program links.", max_length=255
+            ),
+        ),
+    ]

backend/program_v2/models/meta.py

@@ -25,6 +25,12 @@ class ProgramV2EventMeta(ContactEmailMixin, EventMetaBase):
         help_text="Foo Bar <foo.bar@example.com>",
     )
 
+    guide_v2_embedded_url = models.CharField(
+        max_length=255,
+        blank=True,
+        help_text="URL to the embedded guide. This is used to form program links.",
+    )
+
     use_cbac = True
 
     def __str__(self):