🔧(backend) add view to manage footer json

We added the `FRONTEND_URL_JSON_FOOTER` environment
variable. It will give the possibility to generate
your own footer content in the frontend.
If the variable is not set, the footer will not
be displayed.

src/backend/core/api/viewsets.py

@@ -16,8 +16,10 @@ from django.db import transaction
 from django.db.models.expressions import RawSQL
 from django.db.models.functions import Left, Length
 from django.http import Http404, StreamingHttpResponse
+from django.utils.decorators import method_decorator
 from django.utils.text import capfirst
 from django.utils.translation import gettext_lazy as _
+from django.views.decorators.cache import cache_page
 
 import requests
 import rest_framework as drf
@@ -30,6 +32,7 @@ from rest_framework.throttling import UserRateThrottle
 from core import authentication, enums, models
 from core.services.ai_services import AIService
 from core.services.collaboration_services import CollaborationService
+from core.services.config_services import get_footer_json
 from core.utils import extract_attachments, filter_descendants
 
 from . import permissions, serializers, utils
@@ -1688,8 +1691,8 @@ class ConfigView(drf.views.APIView):
             "COLLABORATION_WS_URL",
             "CRISP_WEBSITE_ID",
             "ENVIRONMENT",
-            "FRONTEND_THEME",
             "FRONTEND_CSS_URL",
+            "FRONTEND_THEME",
             "MEDIA_BASE_URL",
             "POSTHOG_KEY",
             "LANGUAGES",
@@ -1702,3 +1705,22 @@ class ConfigView(drf.views.APIView):
                 dict_settings[setting] = getattr(settings, setting)
 
         return drf.response.Response(dict_settings)
+
+
+class FooterView(drf.views.APIView):
+    """API ViewSet for sharing the footer JSON."""
+
+    permission_classes = [AllowAny]
+
+    @method_decorator(cache_page(settings.FRONTEND_FOOTER_VIEW_CACHE_TIMEOUT))
+    def get(self, request):
+        """
+        GET /api/v1.0/footer/
+            Return the footer JSON.
+        """
+        json_footer = (
+            get_footer_json(settings.FRONTEND_URL_JSON_FOOTER)
+            if settings.FRONTEND_URL_JSON_FOOTER
+            else {}
+        )
+        return drf.response.Response(json_footer)

src/backend/core/services/config_services.py

@@ -0,0 +1,25 @@
+"""Config services."""
+
+import logging
+
+import requests
+
+logger = logging.getLogger(__name__)
+
+
+def get_footer_json(footer_json_url: str) -> dict:
+    """
+    Fetches the footer JSON from the given URL."
+    """
+    try:
+        response = requests.get(
+            footer_json_url, timeout=5, headers={"User-Agent": "Docs-Application"}
+        )
+        response.raise_for_status()
+
+        footer_json = response.json()
+
+        return footer_json
+    except (requests.RequestException, ValueError) as e:
+        logger.error("Failed to fetch footer JSON: %s", e)
+        return {}

src/backend/core/tests/test_api_footer.py

@@ -0,0 +1,81 @@
+"""Test the footer API."""
+
+import responses
+from rest_framework.test import APIClient
+
+
+def test_api_footer_without_settings_configured(settings):
+    """Test the footer API without settings configured."""
+    settings.FRONTEND_URL_JSON_FOOTER = None
+    client = APIClient()
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {}
+
+
+@responses.activate
+def test_api_footer_with_invalid_request(settings):
+    """Test the footer API with an invalid request."""
+    settings.FRONTEND_URL_JSON_FOOTER = "https://invalid-request.com"
+
+    footer_response = responses.get(settings.FRONTEND_URL_JSON_FOOTER, status=404)
+
+    client = APIClient()
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {}
+    assert footer_response.call_count == 1
+
+
+@responses.activate
+def test_api_footer_with_invalid_json(settings):
+    """Test the footer API with an invalid JSON response."""
+    settings.FRONTEND_URL_JSON_FOOTER = "https://valid-request.com"
+
+    footer_response = responses.get(
+        settings.FRONTEND_URL_JSON_FOOTER, status=200, body="invalid json"
+    )
+
+    client = APIClient()
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {}
+    assert footer_response.call_count == 1
+
+
+@responses.activate
+def test_api_footer_with_valid_json(settings):
+    """Test the footer API with an invalid JSON response."""
+    settings.FRONTEND_URL_JSON_FOOTER = "https://valid-request.com"
+
+    footer_response = responses.get(
+        settings.FRONTEND_URL_JSON_FOOTER, status=200, json={"foo": "bar"}
+    )
+
+    client = APIClient()
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {"foo": "bar"}
+    assert footer_response.call_count == 1
+
+
+@responses.activate
+def test_api_footer_with_valid_json_and_cache(settings):
+    """Test the footer API with an invalid JSON response."""
+    settings.FRONTEND_URL_JSON_FOOTER = "https://valid-request.com"
+
+    footer_response = responses.get(
+        settings.FRONTEND_URL_JSON_FOOTER, status=200, json={"foo": "bar"}
+    )
+
+    client = APIClient()
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {"foo": "bar"}
+    assert footer_response.call_count == 1
+
+    response = client.get("/api/v1.0/footer/")
+    assert response.status_code == 200
+    assert response.json() == {"foo": "bar"}
+    # The cache should have been used
+    assert footer_response.call_count == 1

src/backend/core/urls.py

@@ -56,4 +56,5 @@ urlpatterns = [
         ),
     ),
     path(f"api/{settings.API_VERSION}/config/", viewsets.ConfigView.as_view()),
+    path(f"api/{settings.API_VERSION}/footer/", viewsets.FooterView.as_view()),
 ]