🔧(project) add DJANGO_EMAIL_URL_APP environment variable

Most of Docs app is configured thanks to environment
variables, except the url in the email that
was from the django site table.
Now we can set it with DJANGO_EMAIL_URL_APP
environment variable to have a better consistency.
We keep the previous way to avoid breaking
changes.

src/backend/core/models.py

@@ -817,7 +817,7 @@ class Document(MP_Node, BaseModel):
     def send_email(self, subject, emails, context=None, language=None):
         """Generate and send email from a template."""
         context = context or {}
-        domain = Site.objects.get_current().domain
+        domain = settings.EMAIL_URL_APP or Site.objects.get_current().domain
         language = language or get_language()
         context.update(
             {

src/backend/core/tests/test_models_documents.py

@@ -1024,6 +1024,39 @@ def test_models_documents__email_invitation__success():
     assert f"docs/{document.id}/" in email_content
 
 
+@pytest.mark.parametrize(
+    "email_url_app",
+    [
+        "https://test-example.com",  # Test with EMAIL_URL_APP set
+        None,  # Test fallback to Site domain
+    ],
+)
+def test_models_documents__email_invitation__url_app_param(email_url_app):
+    """
+    Test that email invitation uses EMAIL_URL_APP when set, or falls back to Site domain.
+    """
+    with override_settings(EMAIL_URL_APP=email_url_app):
+        document = factories.DocumentFactory()
+
+        sender = factories.UserFactory(
+            full_name="Test Sender", email="sender@example.com"
+        )
+        document.send_invitation_email(
+            "guest@example.com", models.RoleChoices.EDITOR, sender, "en"
+        )
+
+        # pylint: disable-next=no-member
+        email = mail.outbox[0]
+        email_content = " ".join(email.body.split())
+
+        # Determine expected domain
+        if email_url_app:
+            assert f"https://test-example.com/docs/{document.id}/" in email_content
+        else:
+            # Default Site domain is example.com
+            assert f"example.com/docs/{document.id}/" in email_content
+
+
 def test_models_documents__email_invitation__success_empty_title():
     """
     The email invitation is sent successfully.

src/backend/impress/settings.py

@@ -459,6 +459,7 @@ class Base(Configuration):
     EMAIL_HOST_PASSWORD = SecretFileValue(None)
     EMAIL_LOGO_IMG = values.Value(None)
     EMAIL_PORT = values.PositiveIntegerValue(None)
+    EMAIL_URL_APP = values.Value(None)
     EMAIL_USE_TLS = values.BooleanValue(False)
     EMAIL_USE_SSL = values.BooleanValue(False)
     EMAIL_FROM = values.Value("from@example.com")

src/helm/env.d/dev/values.impress.yaml.gotmpl

@@ -27,6 +27,7 @@ backend:
     DJANGO_EMAIL_HOST: "mailcatcher"
     DJANGO_EMAIL_LOGO_IMG: https://docs.127.0.0.1.nip.io/assets/logo-suite-numerique.png
     DJANGO_EMAIL_PORT: 1025
+    DJANGO_EMAIL_URL_APP: https://docs.127.0.0.1.nip.io
     DJANGO_EMAIL_USE_SSL: False
     LOGGING_LEVEL_HANDLERS_CONSOLE: ERROR
     LOGGING_LEVEL_LOGGERS_ROOT: INFO

src/helm/env.d/feature/values.impress.yaml.gotmpl

@@ -28,6 +28,7 @@ backend:
     DJANGO_EMAIL_HOST: "mailcatcher"
     DJANGO_EMAIL_LOGO_IMG: https://{{ .Values.feature }}-docs.{{ .Values.domain }}/assets/logo-suite-numerique.png
     DJANGO_EMAIL_PORT: 1025
+    DJANGO_EMAIL_URL_APP: https://{{ .Values.feature }}-docs.{{ .Values.domain }}
     DJANGO_EMAIL_USE_SSL: False
     LOGGING_LEVEL_HANDLERS_CONSOLE: ERROR
     LOGGING_LEVEL_LOGGERS_ROOT: INFO