✨ [#728] Add endpoint to retrieve version info

Author: SilviaAmAm

backend/src/openarchiefbeheer/api/urls.py

@@ -9,6 +9,7 @@
 
 from openarchiefbeheer.accounts.api.views import UsersView, WhoAmIView
 from openarchiefbeheer.config.api.views import (
+    ApplicationInfoView,
     ArchiveConfigView,
     HealthCheckView,
     OIDCInfoView,
@@ -122,6 +123,7 @@
                     name="users",
                 ),
                 path("whoami/", WhoAmIView.as_view(), name="whoami"),
+                path("app-info/", ApplicationInfoView.as_view(), name="app-info"),
                 path(
                     "destruction-list-statuses/",
                     ListStatusesListView.as_view(),

backend/src/openarchiefbeheer/config/api/serializers.py

@@ -1,3 +1,4 @@
+from django.conf import settings
 from django.utils.translation import gettext_lazy as _
 
 from drf_spectacular.utils import extend_schema_field
@@ -52,3 +53,26 @@ def get_login_url(self, config: OpenIDConnectConfig) -> str:
 
         request = self.context.get("request")
         return reverse("oidc_authentication_init", request=request)
+
+
+class ApplicationInfoSerializer(serializers.Serializer):
+    release = serializers.SerializerMethodField(
+        label=_("Application version"),
+        help_text=_(
+            "This uses the git tag if one is present, otherwise it defaults to the git commit hash. "
+            "If the commit hash cannot be resolved, it will be empty."
+        ),
+    )
+    git_sha = serializers.SerializerMethodField(
+        label=_("Application git commit hash"),
+        help_text=_(
+            "This returns the git commit hash if it can be resolved. "
+            "Otherwise, it will be empty."
+        ),
+    )
+
+    def get_release(self, data) -> str:
+        return settings.RELEASE
+
+    def get_git_sha(self, data) -> str:
+        return settings.GIT_SHA

backend/src/openarchiefbeheer/config/api/views.py

@@ -11,7 +11,11 @@
 
 from ..health_checks import is_configuration_complete
 from ..models import ArchiveConfig
-from .serializers import ArchiveConfigSerializer, OIDCInfoSerializer
+from .serializers import (
+    ApplicationInfoSerializer,
+    ArchiveConfigSerializer,
+    OIDCInfoSerializer,
+)
 
 
 class ArchiveConfigView(APIView):
@@ -128,3 +132,19 @@ class HealthCheckView(APIView):
     def get(self, request: Request, *args, **kwargs):
         results = is_configuration_complete()
         return Response(results)
+
+
+@extend_schema(
+    tags=["Configuration"],
+    summary=_("App info"),
+    description=_("Returns information about the application."),
+    responses={
+        200: ApplicationInfoSerializer(),
+    },
+)
+class ApplicationInfoView(APIView):
+    def get(self, request: Request, *args, **kwargs):
+        serializer = ApplicationInfoSerializer(data={})
+        serializer.is_valid()
+
+        return Response(serializer.data)