♿️(frontend) auto-focus on title when opening a doc or sub-doc

improves keyboard navigation and accessibility when content is displayed

.github/workflows/docker-hub.yml

@@ -6,7 +6,6 @@ on:
   push:
     branches:
       - 'main'
-      - 'refacto/blocknote-ai'
     tags:
       - 'v*'
   pull_request:

.github/workflows/impress-frontend.yml

@@ -19,8 +19,6 @@ jobs:
   test-front:
     needs: install-dependencies
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -43,8 +41,6 @@ jobs:
   lint-front:
     runs-on: ubuntu-latest
     needs: install-dependencies
-    permissions:
-      contents: read
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -197,38 +193,3 @@ jobs:
           strip-hash: "[-_.][a-f0-9]{8,}(?=\\.(?:js|css|html)$)"
           omit-unchanged: true
           install-script: "yarn install --frozen-lockfile"
-
-  uikit-theme-checker:
-    runs-on: ubuntu-latest
-    needs: install-dependencies
-    permissions:
-      contents: read
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22.x"
-      - name: Restore the frontend cache
-        uses: actions/cache@v4
-        with:
-          path: "src/frontend/**/node_modules"
-          key: front-node_modules-${{ hashFiles('src/frontend/**/yarn.lock') }}
-          fail-on-cache-miss: true
-
-      - name: Build theme
-        run: cd src/frontend/apps/impress && yarn build-theme
-
-      - name: Ensure theme is up to date
-        shell: bash
-        run: |
-          if [[ -n "$(git status --porcelain)" ]]; then
-            echo "Error: build-theme produced git changes (tracked or untracked)."
-            echo "--- git status --porcelain ---"
-            git status --porcelain
-            echo "--- git diff ---"
-            git --no-pager diff
-            exit 1
-          fi

CHANGELOG.md

@@ -9,32 +9,18 @@ and this project adheres to
 ### Added 
 
 - ✨(frontend) integrate configurable Waffle #1795
-- ✨ Import of documents #1609
-- 🚨(CI) gives warning if theme not updated #1811
-- 🔧(project) add DJANGO_EMAIL_URL_APP environment variable #1825
-- ✨(frontend) integrate new Blocknote AI feature #1016
+
+### Fixed
+
+- ✅(e2e) fix e2e test for other browsers #1799
+- 🐛(frontend) add fallback for unsupported Blocknote languages #1810
+- 🐛(frontend) fix emojipicker closing in tree #1808
 
 ### Changed
 
 - ♿(frontend) improve accessibility:
   - ♿️(frontend) fix subdoc opening and emoji pick focus #1745
-- ✨(backend) add field for button label in email template #1817
-
-### Fixed
-
-- ✅(e2e) fix e2e test for other browsers #1799
-- 🐛(export) fix export column NaN #1819
-- 🐛(frontend) add fallback for unsupported Blocknote languages #1810
-- 🐛(frontend) fix emojipicker closing in tree #1808
-- 🐛(frontend) display children in favorite #1782
-
-### Removed
-
-- 🔥(project) remove all code related to template #1780
-
-### Security
-
-- 🔒️(trivy) fix vulnerability about jaraco.context #1806
+  - ♿️(frontend) Keyboard focus Fixes for docs Tree/Editor #1816
 
 ## [4.4.0] - 2026-01-13
 

Dockerfile

@@ -4,7 +4,7 @@
 FROM python:3.13.3-alpine AS base
 
 # Upgrade pip to its latest release to speed up dependencies installation
-RUN python -m pip install --upgrade pip
+RUN python -m pip install --upgrade pip setuptools
 
 # Upgrade system packages to install security updates
 RUN apk update && apk upgrade --no-cache

Makefile

@@ -213,7 +213,6 @@ logs: ## display app-dev logs (follow mode)
 .PHONY: logs
 
 run-backend: ## Start only the backend application and all needed services
-	@$(COMPOSE) up --force-recreate -d docspec
 	@$(COMPOSE) up --force-recreate -d celery-dev
 	@$(COMPOSE) up --force-recreate -d y-provider-development
 	@$(COMPOSE) up --force-recreate -d nginx

bin/Tiltfile

@@ -8,7 +8,6 @@ docker_build(
     dockerfile='../Dockerfile',
     only=['./src/backend', './src/mail', './docker'],
     target = 'backend-production',
-    build_args={'DOCKER_USER': '1000:1000'},
     live_update=[
         sync('../src/backend', '/app'),
         run(
@@ -24,7 +23,6 @@ docker_build(
     dockerfile='../src/frontend/servers/y-provider/Dockerfile',
     only=['./src/frontend/', './docker/', './.dockerignore'],
     target = 'y-provider',
-    build_args={'DOCKER_USER': '1000:1000'},
     live_update=[
         sync('../src/frontend/servers/y-provider/src', '/home/frontend/servers/y-provider/src'),
     ]
@@ -36,7 +34,6 @@ docker_build(
     dockerfile='../src/frontend/Dockerfile',
     only=['./src/frontend', './docker', './.dockerignore'],
     target = 'impress',
-    build_args={'DOCKER_USER': '1000:1000'},
     live_update=[
         sync('../src/frontend', '/home/frontend'),
     ]

compose.yml

@@ -231,11 +231,6 @@ services:
         condition: service_healthy
         restart: true
 
-  docspec:
-    image: ghcr.io/docspecio/api:2.6.3
-    ports:
-      - "4000:4000"
-
 networks:
   lasuite:
     name: lasuite-network

docs/env.md

@@ -11,7 +11,6 @@ These are the environment variables you can set for the `impress-backend` contai
 | AI_ALLOW_REACH_FROM                             | Users that can use AI must be this level. options are "public", "authenticated", "restricted"                                                                              | authenticated                                                           |
 | AI_API_KEY                                      | AI key to be used for AI Base url                                                                                                                                          |                                                                         |
 | AI_BASE_URL                                     | OpenAI compatible AI base url                                                                                                                                              |                                                                         |
-| AI_BOT                                          | Information to give to the frontend about the AI bot                                          | { "name": "Docs AI", "color": "#8bc6ff" } 
 | AI_FEATURE_ENABLED                              | Enable AI options                                                                                                                                                          | false                                                                   |
 | AI_MODEL                                        | AI Model to use                                                                                                                                                            |                                                                         |
 | ALLOW_LOGOUT_GET_METHOD                         | Allow get logout method                                                                                                                                                    | true                                                                    |
@@ -33,8 +32,6 @@ These are the environment variables you can set for the `impress-backend` contai
 | CONVERSION_API_ENDPOINT                         | Conversion API endpoint                                                                                                                                                    | convert                                                                 |
 | CONVERSION_API_SECURE                           | Require secure conversion api                                                                                                                                              | false                                                                   |
 | CONVERSION_API_TIMEOUT                          | Conversion api timeout                                                                                                                                                     | 30                                                                      |
-| CONVERSION_FILE_MAX_SIZE                        | The file max size allowed when uploaded to convert it                                                                                                                      | 20971520 (20MB)                                                         |
-| CONVERSION_FILE_EXTENSIONS_ALLOWED              | Extension list managed by the conversion service                                                                                                                           | [".docx", ".md"]
 | CRISP_WEBSITE_ID                                | Crisp website id for support                                                                                                                                               |                                                                         |
 | DB_ENGINE                                       | Engine to use for database connections                                                                                                                                     | django.db.backends.postgresql_psycopg2                                  |
 | DB_HOST                                         | Host of the database                                                                                                                                                       | localhost                                                               |
@@ -57,12 +54,10 @@ These are the environment variables you can set for the `impress-backend` contai
 | DJANGO_EMAIL_HOST_USER                          | User to authenticate with on the email host                                                                                                                                |                                                                         |
 | DJANGO_EMAIL_LOGO_IMG                           | Logo for the email                                                                                                                                                         |                                                                         |
 | DJANGO_EMAIL_PORT                               | Port used to connect to email host                                                                                                                                         |                                                                         |
-| DJANGO_EMAIL_URL_APP                            | Url used in the email to go to the app                                                                                                                                         |                                                                         |
 | DJANGO_EMAIL_USE_SSL                            | Use ssl for email host connection                                                                                                                                          | false                                                                   |
 | DJANGO_EMAIL_USE_TLS                            | Use tls for email host connection                                                                                                                                          | false                                                                   |
 | DJANGO_SECRET_KEY                               | Secret key                                                                                                                                                                 |                                                                         |
 | DJANGO_SERVER_TO_SERVER_API_TOKENS              |                                                                                                                                                                            | []                                                                      |
-| DOCSPEC_API_URL                               | URL to endpoint of DocSpec conversion API    |            |
 | DOCUMENT_IMAGE_MAX_SIZE                         | Maximum size of document in bytes                                                                                                                                          | 10485760                                                                |
 | FRONTEND_CSS_URL                                | To add a external css file to the app                                                                                                                                      |                                                                         |
 | FRONTEND_JS_URL                                | To add a external js file to the app                                                                                                                                      |                                                                         |

docs/examples/helm/impress.values.yaml

@@ -27,7 +27,6 @@ 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

docs/installation/compose.md

@@ -127,7 +127,6 @@ DJANGO_EMAIL_FROM=<your email address>
 
 DJANGO_EMAIL_BRAND_NAME=<brand name used in email templates> # e.g. "La Suite Numérique"
 DJANGO_EMAIL_LOGO_IMG=<logo image to use in email templates.> # e.g. "https://docs.yourdomain.tld/assets/logo-suite-numerique.png" 
-DJANGO_EMAIL_URL_APP=<url used in email templates to go to the app> # e.g. "https://docs.yourdomain.tld"
 ```
 
 ### AI

env.d/development/common

@@ -20,7 +20,6 @@ DJANGO_EMAIL_BRAND_NAME="La Suite Numérique"
 DJANGO_EMAIL_HOST="mailcatcher"
 DJANGO_EMAIL_LOGO_IMG="http://localhost:3000/assets/logo-suite-numerique.png"
 DJANGO_EMAIL_PORT=1025
-DJANGO_EMAIL_URL_APP="http://localhost:3000"
 
 # Backend url
 IMPRESS_BASE_URL="http://localhost:8072"
@@ -77,8 +76,6 @@ DJANGO_SERVER_TO_SERVER_API_TOKENS=server-api-token
 Y_PROVIDER_API_BASE_URL=http://y-provider-development:4444/api/
 Y_PROVIDER_API_KEY=yprovider-api-key
 
-DOCSPEC_API_URL=http://docspec:4000/conversion
-
 # Theme customization
 THEME_CUSTOMIZATION_CACHE_TIMEOUT=15
 

env.d/development/common.e2e

@@ -6,4 +6,4 @@ Y_PROVIDER_API_BASE_URL=http://y-provider:4444/api/
 
 # Throttle
 API_DOCUMENT_THROTTLE_RATE=1000/min
-API_CONFIG_THROTTLE_RATE=1000/min
+API_CONFIG_THROTTLE_RATE=1000/min

env.d/production.dist/backend

@@ -24,8 +24,7 @@ DJANGO_EMAIL_FROM=<your email address>
 #DJANGO_EMAIL_USE_SSL=true # A flag to enable or disable SSL for email sending.
 
 DJANGO_EMAIL_BRAND_NAME="La Suite Numérique" 
-DJANGO_EMAIL_LOGO_IMG="https://${DOCS_HOST}/assets/logo-suite-numerique.png"
-DJANGO_EMAIL_URL_APP="https://${DOCS_HOST}"
+DJANGO_EMAIL_LOGO_IMG="https://${DOCS_HOST}/assets/logo-suite-numerique.png"  
 
 # Media
 AWS_S3_ENDPOINT_URL=https://${S3_HOST}

src/backend/core/admin.py

@@ -9,6 +9,14 @@ from treebeard.admin import TreeAdmin
 from . import models
 
 
+class TemplateAccessInline(admin.TabularInline):
+    """Inline admin class for template accesses."""
+
+    autocomplete_fields = ["user"]
+    model = models.TemplateAccess
+    extra = 0
+
+
 @admin.register(models.User)
 class UserAdmin(auth_admin.UserAdmin):
     """Admin class for the User model"""
@@ -61,6 +69,7 @@ class UserAdmin(auth_admin.UserAdmin):
             },
         ),
     )
+    inlines = (TemplateAccessInline,)
     list_display = (
         "id",
         "sub",
@@ -95,8 +104,15 @@ class UserAdmin(auth_admin.UserAdmin):
     search_fields = ("id", "sub", "admin_email", "email", "full_name")
 
 
+@admin.register(models.Template)
+class TemplateAdmin(admin.ModelAdmin):
+    """Template admin interface declaration."""
+
+    inlines = (TemplateAccessInline,)
+
+
 class DocumentAccessInline(admin.TabularInline):
-    """Inline admin class for document accesses."""
+    """Inline admin class for template accesses."""
 
     autocomplete_fields = ["user"]
     model = models.DocumentAccess

src/backend/core/api/permissions.py

@@ -98,10 +98,10 @@ class CanCreateInvitationPermission(permissions.BasePermission):
 
 
 class ResourceWithAccessPermission(permissions.BasePermission):
-    """A permission class for invitations."""
+    """A permission class for templates and invitations."""
 
     def has_permission(self, request, view):
-        """check create permission."""
+        """check create permission for templates."""
         return request.user.is_authenticated or view.action != "create"
 
     def has_object_permission(self, request, view, obj):

src/backend/core/api/serializers.py

@@ -4,7 +4,6 @@
 import binascii
 import mimetypes
 from base64 import b64decode
-from os.path import splitext
 
 from django.conf import settings
 from django.db.models import Q
@@ -16,10 +15,10 @@ import magic
 from rest_framework import serializers
 
 from core import choices, enums, models, utils, validators
-from core.services import mime_types
+from core.services.ai_services import AI_ACTIONS
 from core.services.converter_services import (
     ConversionError,
-    Converter,
+    YdocConverter,
 )
 
 
@@ -60,6 +59,30 @@ class UserLightSerializer(UserSerializer):
         read_only_fields = ["full_name", "short_name"]
 
 
+class TemplateAccessSerializer(serializers.ModelSerializer):
+    """Serialize template accesses."""
+
+    abilities = serializers.SerializerMethodField(read_only=True)
+
+    class Meta:
+        model = models.TemplateAccess
+        resource_field_name = "template"
+        fields = ["id", "user", "team", "role", "abilities"]
+        read_only_fields = ["id", "abilities"]
+
+    def get_abilities(self, instance) -> dict:
+        """Return abilities of the logged-in user on the instance."""
+        request = self.context.get("request")
+        if request:
+            return instance.get_abilities(request.user)
+        return {}
+
+    def update(self, instance, validated_data):
+        """Make "user" field is readonly but only on update."""
+        validated_data.pop("user", None)
+        return super().update(instance, validated_data)
+
+
 class ListDocumentSerializer(serializers.ModelSerializer):
     """Serialize documents with limited fields for display in lists."""
 
@@ -165,9 +188,6 @@ class DocumentSerializer(ListDocumentSerializer):
 
     content = serializers.CharField(required=False)
     websocket = serializers.BooleanField(required=False, write_only=True)
-    file = serializers.FileField(
-        required=False, write_only=True, allow_null=True, max_length=255
-    )
 
     class Meta:
         model = models.Document
@@ -184,7 +204,6 @@ class DocumentSerializer(ListDocumentSerializer):
             "deleted_at",
             "depth",
             "excerpt",
-            "file",
             "is_favorite",
             "link_role",
             "link_reach",
@@ -254,30 +273,6 @@ class DocumentSerializer(ListDocumentSerializer):
 
         return value
 
-    def validate_file(self, file):
-        """Add file size and type constraints as defined in settings."""
-        if not file:
-            return None
-
-        # Validate file size
-        if file.size > settings.CONVERSION_FILE_MAX_SIZE:
-            max_size = settings.CONVERSION_FILE_MAX_SIZE // (1024 * 1024)
-            raise serializers.ValidationError(
-                f"File size exceeds the maximum limit of {max_size:d} MB."
-            )
-
-        _name, extension = splitext(file.name)
-
-        if extension.lower() not in settings.CONVERSION_FILE_EXTENSIONS_ALLOWED:
-            raise serializers.ValidationError(
-                (
-                    f"File extension {extension} is not allowed. Allowed extensions"
-                    f" are: {settings.CONVERSION_FILE_EXTENSIONS_ALLOWED}."
-                )
-            )
-
-        return file
-
     def save(self, **kwargs):
         """
         Process the content field to extract attachment keys and update the document's
@@ -466,9 +461,7 @@ class ServerCreateDocumentSerializer(serializers.Serializer):
             language = user.language or language
 
         try:
-            document_content = Converter().convert(
-                validated_data["content"], mime_types.MARKDOWN, mime_types.YJS
-            )
+            document_content = YdocConverter().convert(validated_data["content"])
         except ConversionError as err:
             raise serializers.ValidationError(
                 {"content": ["Could not convert content"]}
@@ -667,6 +660,52 @@ class FileUploadSerializer(serializers.Serializer):
         return attrs
 
 
+class TemplateSerializer(serializers.ModelSerializer):
+    """Serialize templates."""
+
+    abilities = serializers.SerializerMethodField(read_only=True)
+    accesses = TemplateAccessSerializer(many=True, read_only=True)
+
+    class Meta:
+        model = models.Template
+        fields = [
+            "id",
+            "title",
+            "accesses",
+            "abilities",
+            "css",
+            "code",
+            "is_public",
+        ]
+        read_only_fields = ["id", "accesses", "abilities"]
+
+    def get_abilities(self, document) -> dict:
+        """Return abilities of the logged-in user on the instance."""
+        request = self.context.get("request")
+        if request:
+            return document.get_abilities(request.user)
+        return {}
+
+
+# pylint: disable=abstract-method
+class DocumentGenerationSerializer(serializers.Serializer):
+    """Serializer to receive a request to generate a document on a template."""
+
+    body = serializers.CharField(label=_("Body"))
+    body_type = serializers.ChoiceField(
+        choices=["html", "markdown"],
+        label=_("Body type"),
+        required=False,
+        default="html",
+    )
+    format = serializers.ChoiceField(
+        choices=["pdf", "docx"],
+        label=_("Format"),
+        required=False,
+        default="pdf",
+    )
+
+
 class InvitationSerializer(serializers.ModelSerializer):
     """Serialize invitations."""
 
@@ -791,38 +830,33 @@ class VersionFilterSerializer(serializers.Serializer):
     )
 
 
-class AIProxySerializer(serializers.Serializer):
-    """Serializer for AI proxy requests."""
+class AITransformSerializer(serializers.Serializer):
+    """Serializer for AI transform requests."""
 
-    messages = serializers.ListField(
-        required=True,
-        child=serializers.DictField(
-            child=serializers.CharField(required=True),
-        ),
-        allow_empty=False,
+    action = serializers.ChoiceField(choices=AI_ACTIONS, required=True)
+    text = serializers.CharField(required=True)
+
+    def validate_text(self, value):
+        """Ensure the text field is not empty."""
+
+        if len(value.strip()) == 0:
+            raise serializers.ValidationError("Text field cannot be empty.")
+        return value
+
+
+class AITranslateSerializer(serializers.Serializer):
+    """Serializer for AI translate requests."""
+
+    language = serializers.ChoiceField(
+        choices=tuple(enums.ALL_LANGUAGES.items()), required=True
     )
-    model = serializers.CharField(required=True)
+    text = serializers.CharField(required=True)
 
-    def validate_messages(self, messages):
-        """Validate messages structure."""
-        # Ensure each message has the required fields
-        for message in messages:
-            if (
-                not isinstance(message, dict)
-                or "role" not in message
-                or "content" not in message
-            ):
-                raise serializers.ValidationError(
-                    "Each message must have 'role' and 'content' fields"
-                )
-
-        return messages
-
-    def validate_model(self, value):
-        """Validate model value is the same than settings.AI_MODEL"""
-        if value != settings.AI_MODEL:
-            raise serializers.ValidationError(f"{value} is not a valid model")
+    def validate_text(self, value):
+        """Ensure the text field is not empty."""
 
+        if len(value.strip()) == 0:
+            raise serializers.ValidationError("Text field cannot be empty.")
         return value
 
 

src/backend/core/api/viewsets.py

@@ -43,19 +43,17 @@ from rest_framework.permissions import AllowAny
 
 from core import authentication, choices, enums, models
 from core.api.filters import remove_accents
-from core.services import mime_types
 from core.services.ai_services import AIService
 from core.services.collaboration_services import CollaborationService
-from core.services.converter_services import (
-    ConversionError,
-    Converter,
-)
 from core.services.converter_services import (
     ServiceUnavailableError as YProviderServiceUnavailableError,
 )
 from core.services.converter_services import (
     ValidationError as YProviderValidationError,
 )
+from core.services.converter_services import (
+    YdocConverter,
+)
 from core.services.search_indexers import (
     get_document_indexer,
     get_visited_document_ids_of,
@@ -338,8 +336,21 @@ class DocumentViewSet(
     9. **Media Auth**: Authorize access to document media.
         Example: GET /documents/media-auth/
 
-    10. **AI Proxy**: Proxy an AI request to an external AI service.
-        Example: POST /api/v1.0/documents/<resource_id>/ai-proxy
+    10. **AI Transform**: Apply a transformation action on a piece of text with AI.
+        Example: POST /documents/{id}/ai-transform/
+        Expected data:
+        - text (str): The input text.
+        - action (str): The transformation type, one of [prompt, correct, rephrase, summarize].
+        Returns: JSON response with the processed text.
+        Throttled by: AIDocumentRateThrottle, AIUserRateThrottle.
+
+    11. **AI Translate**: Translate a piece of text with AI.
+        Example: POST /documents/{id}/ai-translate/
+        Expected data:
+        - text (str): The input text.
+        - language (str): The target language, chosen from settings.LANGUAGES.
+        Returns: JSON response with the translated text.
+        Throttled by: AIDocumentRateThrottle, AIUserRateThrottle.
 
     ### Ordering: created_at, updated_at, is_favorite, title
 
@@ -378,6 +389,7 @@ class DocumentViewSet(
     throttle_scope = "document"
     queryset = models.Document.objects.select_related("creator").all()
     serializer_class = serializers.DocumentSerializer
+    ai_translate_serializer_class = serializers.AITranslateSerializer
     all_serializer_class = serializers.ListDocumentSerializer
     children_serializer_class = serializers.ListDocumentSerializer
     descendants_serializer_class = serializers.ListDocumentSerializer
@@ -515,28 +527,6 @@ class DocumentViewSet(
                 "IN SHARE ROW EXCLUSIVE MODE;"
             )
 
-        # Remove file from validated_data as it's not a model field
-        # Process it if present
-        uploaded_file = serializer.validated_data.pop("file", None)
-
-        # If a file is uploaded, convert it to Yjs format and set as content
-        if uploaded_file:
-            try:
-                file_content = uploaded_file.read()
-
-                converter = Converter()
-                converted_content = converter.convert(
-                    file_content,
-                    content_type=uploaded_file.content_type,
-                    accept=mime_types.YJS,
-                )
-                serializer.validated_data["content"] = converted_content
-                serializer.validated_data["title"] = uploaded_file.name
-            except ConversionError as err:
-                raise drf.exceptions.ValidationError(
-                    {"file": ["Could not convert file content"]}
-                ) from err
-
         obj = models.Document.add_root(
             creator=self.request.user,
             **serializer.validated_data,
@@ -638,29 +628,12 @@ class DocumentViewSet(
         """Get list of favorite documents for the current user."""
         user = request.user
 
-        queryset = self.get_queryset()
-
-        # Among the results, we may have documents that are ancestors/descendants
-        # of each other. In this case we want to keep only the highest ancestors.
-        root_paths = utils.filter_root_paths(
-            queryset.order_by("path").values_list("path", flat=True),
-            skip_sorting=True,
-        )
-
-        path_list = db.Q()
-        for path in root_paths:
-            path_list |= db.Q(path__startswith=path)
-
         favorite_documents_ids = models.DocumentFavorite.objects.filter(
             user=user
         ).values_list("document_id", flat=True)
 
-        queryset = self.queryset.filter(path_list)
+        queryset = self.filter_queryset(self.get_queryset())
         queryset = queryset.filter(id__in=favorite_documents_ids)
-        queryset = queryset.annotate_user_roles(user)
-        queryset = queryset.annotate(
-            is_favorite=db.Value(True, output_field=db.BooleanField())
-        )
         return self.get_response_for_queryset(queryset)
 
     @drf.decorators.action(
@@ -1631,42 +1604,58 @@ class DocumentViewSet(
     @drf.decorators.action(
         detail=True,
         methods=["post"],
-        name="Proxy AI requests to the AI provider",
-        url_path="ai-proxy",
-        # throttle_classes=[utils.AIDocumentRateThrottle, utils.AIUserRateThrottle],
+        name="Apply a transformation action on a piece of text with AI",
+        url_path="ai-transform",
+        throttle_classes=[utils.AIDocumentRateThrottle, utils.AIUserRateThrottle],
     )
-    def ai_proxy(self, request, *args, **kwargs):
+    def ai_transform(self, request, *args, **kwargs):
         """
-        POST /api/v1.0/documents/<resource_id>/ai-proxy
-        Proxy AI requests to the configured AI provider.
-        This endpoint forwards requests to the AI provider and returns the complete response.
+        POST /api/v1.0/documents/<resource_id>/ai-transform
+        with expected data:
+        - text: str
+        - action: str [prompt, correct, rephrase, summarize]
+        Return JSON response with the processed text.
         """
         # Check permissions first
         self.get_object()
 
-        if not settings.AI_FEATURE_ENABLED:
-            raise ValidationError("AI feature is not enabled.")
+        serializer = serializers.AITransformSerializer(data=request.data)
+        serializer.is_valid(raise_exception=True)
 
-        ai_service = AIService()
+        text = serializer.validated_data["text"]
+        action = serializer.validated_data["action"]
 
-        if settings.AI_STREAM:
-            stream_gen = ai_service.stream_proxy(
-                url=settings.AI_BASE_URL.rstrip("/") + "/chat/completions",
-                method="POST",
-                headers={"Content-Type": "application/json"},
-                body=json.dumps(request.data, ensure_ascii=False).encode("utf-8"),
-            )
+        response = AIService().transform(text, action)
 
-            resp = StreamingHttpResponse(
-                streaming_content=stream_gen,
-                content_type="text/event-stream",
-                status=200,
-            )
-            resp["X-Accel-Buffering"] = "no"
-            resp["Cache-Control"] = "no-cache"
-            return resp
+        return drf.response.Response(response, status=drf.status.HTTP_200_OK)
 
+    @drf.decorators.action(
+        detail=True,
+        methods=["post"],
+        name="Translate a piece of text with AI",
+        url_path="ai-translate",
+        throttle_classes=[utils.AIDocumentRateThrottle, utils.AIUserRateThrottle],
+    )
+    def ai_translate(self, request, *args, **kwargs):
+        """
+        POST /api/v1.0/documents/<resource_id>/ai-translate
+        with expected data:
+        - text: str
+        - language: str [settings.LANGUAGES]
+        Return JSON response with the translated text.
+        """
+        # Check permissions first
+        self.get_object()
 
+        serializer = self.get_serializer(data=request.data)
+        serializer.is_valid(raise_exception=True)
+
+        text = serializer.validated_data["text"]
+        language = serializer.validated_data["language"]
+
+        response = AIService().translate(text, language)
+
+        return drf.response.Response(response, status=drf.status.HTTP_200_OK)
 
     def _reject_invalid_ips(self, ips):
         """
@@ -1875,14 +1864,14 @@ class DocumentViewSet(
         if base64_content is not None:
             # Convert using the y-provider service
             try:
-                yprovider = Converter()
+                yprovider = YdocConverter()
                 result = yprovider.convert(
                     base64.b64decode(base64_content),
-                    mime_types.YJS,
+                    "application/vnd.yjs.doc",
                     {
-                        "markdown": mime_types.MARKDOWN,
-                        "html": mime_types.HTML,
-                        "json": mime_types.JSON,
+                        "markdown": "text/markdown",
+                        "html": "text/html",
+                        "json": "application/json",
                     }[content_format],
                 )
                 content = result
@@ -2103,6 +2092,64 @@ class DocumentAccessViewSet(
         )
 
 
+class TemplateViewSet(
+    drf.mixins.RetrieveModelMixin,
+    viewsets.GenericViewSet,
+):
+    """Template ViewSet"""
+
+    filter_backends = [drf.filters.OrderingFilter]
+    permission_classes = [
+        permissions.IsAuthenticatedOrSafe,
+        permissions.ResourceWithAccessPermission,
+    ]
+    throttle_scope = "template"
+    ordering = ["-created_at"]
+    ordering_fields = ["created_at", "updated_at", "title"]
+    serializer_class = serializers.TemplateSerializer
+    queryset = models.Template.objects.all()
+
+    def get_queryset(self):
+        """Custom queryset to get user related templates."""
+        queryset = super().get_queryset()
+        user = self.request.user
+
+        if not user.is_authenticated:
+            return queryset
+
+        user_roles_query = (
+            models.TemplateAccess.objects.filter(
+                db.Q(user=user) | db.Q(team__in=user.teams),
+                template_id=db.OuterRef("pk"),
+            )
+            .values("template")
+            .annotate(roles_array=ArrayAgg("role"))
+            .values("roles_array")
+        )
+        return queryset.annotate(user_roles=db.Subquery(user_roles_query)).distinct()
+
+    def list(self, request, *args, **kwargs):
+        """Restrict templates returned by the list endpoint"""
+        queryset = self.filter_queryset(self.get_queryset())
+        user = self.request.user
+        if user.is_authenticated:
+            queryset = queryset.filter(
+                db.Q(accesses__user=user)
+                | db.Q(accesses__team__in=user.teams)
+                | db.Q(is_public=True)
+            )
+        else:
+            queryset = queryset.filter(is_public=True)
+
+        page = self.paginate_queryset(queryset)
+        if page is not None:
+            serializer = self.get_serializer(page, many=True)
+            return self.get_paginated_response(serializer.data)
+
+        serializer = self.get_serializer(queryset, many=True)
+        return drf.response.Response(serializer.data)
+
+
 class InvitationViewset(
     drf.mixins.CreateModelMixin,
     drf.mixins.ListModelMixin,
@@ -2307,14 +2354,9 @@ class ConfigView(drf.views.APIView):
             Return a dictionary of public settings.
         """
         array_settings = [
-            "AI_BOT",
             "AI_FEATURE_ENABLED",
-            "AI_MODEL",
-            "AI_STREAM",
             "COLLABORATION_WS_URL",
             "COLLABORATION_WS_NOT_CONNECTED_READY_ONLY",
-            "CONVERSION_FILE_EXTENSIONS_ALLOWED",
-            "CONVERSION_FILE_MAX_SIZE",
             "CRISP_WEBSITE_ID",
             "ENVIRONMENT",
             "FRONTEND_CSS_URL",

src/backend/core/factories.py

@@ -53,6 +53,15 @@ class UserFactory(factory.django.DjangoModelFactory):
         if create and (extracted is True):
             UserDocumentAccessFactory(user=self, role="owner")
 
+    @factory.post_generation
+    def with_owned_template(self, create, extracted, **kwargs):
+        """
+        Create a template for which the user is owner to check
+        that there is no interference
+        """
+        if create and (extracted is True):
+            UserTemplateAccessFactory(user=self, role="owner")
+
 
 class ParentNodeFactory(factory.declarations.ParameteredAttribute):
     """Custom factory attribute for setting the parent node."""
@@ -193,6 +202,50 @@ class DocumentAskForAccessFactory(factory.django.DjangoModelFactory):
     role = factory.fuzzy.FuzzyChoice([r[0] for r in models.RoleChoices.choices])
 
 
+class TemplateFactory(factory.django.DjangoModelFactory):
+    """A factory to create templates"""
+
+    class Meta:
+        model = models.Template
+        django_get_or_create = ("title",)
+        skip_postgeneration_save = True
+
+    title = factory.Sequence(lambda n: f"template{n}")
+    is_public = factory.Faker("boolean")
+
+    @factory.post_generation
+    def users(self, create, extracted, **kwargs):
+        """Add users to template from a given list of users with or without roles."""
+        if create and extracted:
+            for item in extracted:
+                if isinstance(item, models.User):
+                    UserTemplateAccessFactory(template=self, user=item)
+                else:
+                    UserTemplateAccessFactory(template=self, user=item[0], role=item[1])
+
+
+class UserTemplateAccessFactory(factory.django.DjangoModelFactory):
+    """Create fake template user accesses for testing."""
+
+    class Meta:
+        model = models.TemplateAccess
+
+    template = factory.SubFactory(TemplateFactory)
+    user = factory.SubFactory(UserFactory)
+    role = factory.fuzzy.FuzzyChoice([r[0] for r in models.RoleChoices.choices])
+
+
+class TeamTemplateAccessFactory(factory.django.DjangoModelFactory):
+    """Create fake template team accesses for testing."""
+
+    class Meta:
+        model = models.TemplateAccess
+
+    template = factory.SubFactory(TemplateFactory)
+    team = factory.Sequence(lambda n: f"team{n}")
+    role = factory.fuzzy.FuzzyChoice([r[0] for r in models.RoleChoices.choices])
+
+
 class InvitationFactory(factory.django.DjangoModelFactory):
     """A factory to create invitations for a user"""
 

src/backend/core/migrations/0028_remove_templateaccess_template_and_more.py

@@ -1,26 +0,0 @@
-# Generated by Django 5.2.9 on 2026-01-09 14:18
-
-from django.db import migrations
-
-
-class Migration(migrations.Migration):
-    dependencies = [
-        ("core", "0027_auto_20251120_0956"),
-    ]
-
-    operations = [
-        migrations.RemoveField(
-            model_name="templateaccess",
-            name="template",
-        ),
-        migrations.RemoveField(
-            model_name="templateaccess",
-            name="user",
-        ),
-        migrations.DeleteModel(
-            name="Template",
-        ),
-        migrations.DeleteModel(
-            name="TemplateAccess",
-        ),
-    ]

src/backend/core/models.py

@@ -1,7 +1,6 @@
 """
 Declare and configure the models for the impress core application
 """
-
 # pylint: disable=too-many-lines
 
 import hashlib
@@ -783,7 +782,8 @@ class Document(MP_Node, BaseModel):
         return {
             "accesses_manage": is_owner_or_admin,
             "accesses_view": has_access_role,
-            "ai_proxy": ai_access,
+            "ai_transform": ai_access,
+            "ai_translate": ai_access,
             "attachment_upload": can_update,
             "media_check": can_get,
             "can_edit": can_update,
@@ -816,7 +816,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 = settings.EMAIL_URL_APP or Site.objects.get_current().domain
+        domain = Site.objects.get_current().domain
         language = language or get_language()
         context.update(
             {
@@ -824,8 +824,7 @@ class Document(MP_Node, BaseModel):
                 "document": self,
                 "domain": domain,
                 "link": f"{domain}/docs/{self.id}/",
-                "link_label": self.title or str(_("Untitled Document")),
-                "button_label": _("Open"),
+                "document_title": self.title or str(_("Untitled Document")),
                 "logo_img": settings.EMAIL_LOGO_IMG,
             }
         )
@@ -1429,6 +1428,163 @@ class Reaction(BaseModel):
         return f"Reaction {self.emoji} on comment {self.comment.id}"
 
 
+class Template(BaseModel):
+    """HTML and CSS code used for formatting the print around the MarkDown body."""
+
+    title = models.CharField(_("title"), max_length=255)
+    description = models.TextField(_("description"), blank=True)
+    code = models.TextField(_("code"), blank=True)
+    css = models.TextField(_("css"), blank=True)
+    is_public = models.BooleanField(
+        _("public"),
+        default=False,
+        help_text=_("Whether this template is public for anyone to use."),
+    )
+
+    class Meta:
+        db_table = "impress_template"
+        ordering = ("title",)
+        verbose_name = _("Template")
+        verbose_name_plural = _("Templates")
+
+    def __str__(self):
+        return self.title
+
+    def get_role(self, user):
+        """Return the roles a user has on a resource as an iterable."""
+        if not user.is_authenticated:
+            return None
+
+        try:
+            roles = self.user_roles or []
+        except AttributeError:
+            try:
+                roles = self.accesses.filter(
+                    models.Q(user=user) | models.Q(team__in=user.teams),
+                ).values_list("role", flat=True)
+            except (models.ObjectDoesNotExist, IndexError):
+                roles = []
+
+        return RoleChoices.max(*roles)
+
+    def get_abilities(self, user):
+        """
+        Compute and return abilities for a given user on the template.
+        """
+        role = self.get_role(user)
+        is_owner_or_admin = role in PRIVILEGED_ROLES
+        can_get = self.is_public or bool(role)
+        can_update = is_owner_or_admin or role == RoleChoices.EDITOR
+
+        return {
+            "destroy": role == RoleChoices.OWNER,
+            "generate_document": can_get,
+            "accesses_manage": is_owner_or_admin,
+            "update": can_update,
+            "partial_update": can_update,
+            "retrieve": can_get,
+        }
+
+
+class TemplateAccess(BaseAccess):
+    """Relation model to give access to a template for a user or a team with a role."""
+
+    template = models.ForeignKey(
+        Template,
+        on_delete=models.CASCADE,
+        related_name="accesses",
+    )
+
+    class Meta:
+        db_table = "impress_template_access"
+        ordering = ("-created_at",)
+        verbose_name = _("Template/user relation")
+        verbose_name_plural = _("Template/user relations")
+        constraints = [
+            models.UniqueConstraint(
+                fields=["user", "template"],
+                condition=models.Q(user__isnull=False),  # Exclude null users
+                name="unique_template_user",
+                violation_error_message=_("This user is already in this template."),
+            ),
+            models.UniqueConstraint(
+                fields=["team", "template"],
+                condition=models.Q(team__gt=""),  # Exclude empty string teams
+                name="unique_template_team",
+                violation_error_message=_("This team is already in this template."),
+            ),
+            models.CheckConstraint(
+                condition=models.Q(user__isnull=False, team="")
+                | models.Q(user__isnull=True, team__gt=""),
+                name="check_template_access_either_user_or_team",
+                violation_error_message=_("Either user or team must be set, not both."),
+            ),
+        ]
+
+    def __str__(self):
+        return f"{self.user!s} is {self.role:s} in template {self.template!s}"
+
+    def get_role(self, user):
+        """
+        Get the role a user has on a resource.
+        """
+        if not user.is_authenticated:
+            return None
+
+        try:
+            roles = self.user_roles or []
+        except AttributeError:
+            teams = user.teams
+            try:
+                roles = self.template.accesses.filter(
+                    models.Q(user=user) | models.Q(team__in=teams),
+                ).values_list("role", flat=True)
+            except (Template.DoesNotExist, IndexError):
+                roles = []
+
+        return RoleChoices.max(*roles)
+
+    def get_abilities(self, user):
+        """
+        Compute and return abilities for a given user on the template access.
+        """
+        role = self.get_role(user)
+        is_owner_or_admin = role in PRIVILEGED_ROLES
+
+        if self.role == RoleChoices.OWNER:
+            can_delete = (role == RoleChoices.OWNER) and self.template.accesses.filter(
+                role=RoleChoices.OWNER
+            ).count() > 1
+            set_role_to = (
+                [RoleChoices.ADMIN, RoleChoices.EDITOR, RoleChoices.READER]
+                if can_delete
+                else []
+            )
+        else:
+            can_delete = is_owner_or_admin
+            set_role_to = []
+            if role == RoleChoices.OWNER:
+                set_role_to.append(RoleChoices.OWNER)
+            if is_owner_or_admin:
+                set_role_to.extend(
+                    [RoleChoices.ADMIN, RoleChoices.EDITOR, RoleChoices.READER]
+                )
+
+        # Remove the current role as we don't want to propose it as an option
+        try:
+            set_role_to.remove(self.role)
+        except ValueError:
+            pass
+
+        return {
+            "destroy": can_delete,
+            "update": bool(set_role_to),
+            "partial_update": bool(set_role_to),
+            "retrieve": bool(role),
+            "set_role_to": set_role_to,
+        }
+
+
 class Invitation(BaseModel):
     """User invitation to a document."""
 

src/backend/core/services/ai_services.py

@@ -1,168 +1,98 @@
-# core/services/ai_services.py
-from __future__ import annotations
+"""AI services."""
 
-import json
-from typing import Any, Dict, Generator
-from urllib.parse import urlparse
-
-import httpx
 from django.conf import settings
 from django.core.exceptions import ImproperlyConfigured
 
+from core import enums
 
-BLOCKNOTE_TOOL_STRICT_PROMPT = """You are editing a BlockNote document via the tool applyDocumentOperations.
-
-You MUST respond ONLY by calling applyDocumentOperations.
-The tool input MUST be valid JSON:
-{ "operations": [ ... ] }
-
-Each operation MUST include "type" and it MUST be one of:
-- "update" (requires: id, block)
-- "add"    (requires: referenceId, position, blocks)
-- "delete" (requires: id)
-
-VALID SHAPES (FOLLOW EXACTLY):
-
-Update:
-{ "type":"update", "id":"<id$>", "block":"<p>...</p>" }
-IMPORTANT: "block" MUST be a STRING containing a SINGLE valid HTML element.
-
-Add:
-{ "type":"add", "referenceId":"<id$>", "position":"before|after", "blocks":["<p>...</p>"] }
-IMPORTANT: "blocks" MUST be an ARRAY OF STRINGS.
-Each item MUST be a STRING containing a SINGLE valid HTML element.
-
-Delete:
-{ "type":"delete", "id":"<id$>" }
-
-IDs ALWAYS end with "$". Use ids EXACTLY as provided.
-
-Return ONLY the JSON tool input. No prose, no markdown.
-"""
+if settings.LANGFUSE_PUBLIC_KEY:
+    from langfuse.openai import OpenAI
+else:
+    from openai import OpenAI
 
 
-def _drop_nones(obj: Any) -> Any:
-    if isinstance(obj, dict):
-        return {k: _drop_nones(v) for k, v in obj.items() if v is not None}
-    if isinstance(obj, list):
-        return [_drop_nones(v) for v in obj]
-    return obj
+AI_ACTIONS = {
+    "prompt": (
+        "Answer the prompt using markdown formatting for structure and emphasis. "
+        "Return the content directly without wrapping it in code blocks or markdown delimiters. "
+        "Preserve the language and markdown formatting. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+    "correct": (
+        "Correct grammar and spelling of the markdown text, "
+        "preserving language and markdown formatting. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+    "rephrase": (
+        "Rephrase the given markdown text, "
+        "preserving language and markdown formatting. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+    "summarize": (
+        "Summarize the markdown text, preserving language and markdown formatting. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+    "beautify": (
+        "Add formatting to the text to make it more readable. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+    "emojify": (
+        "Add emojis to the important parts of the text. "
+        "Do not provide any other information. "
+        "Preserve the language."
+    ),
+}
+
+AI_TRANSLATE = (
+    "Keep the same html structure and formatting. "
+    "Translate the content in the html to the specified language {language:s}. "
+    "Check the translation for accuracy and make any necessary corrections. "
+    "Do not provide any other information."
+)
 
 
 class AIService:
-    """
-    Backward-compatible proxy service for your existing viewset:
+    """Service class for AI-related operations."""
 
-        stream_proxy(provider, url, method, headers, body) -> yields bytes
+    def __init__(self):
+        """Ensure that the AI configuration is set properly."""
+        if (
+            settings.AI_BASE_URL is None
+            or settings.AI_API_KEY is None
+            or settings.AI_MODEL is None
+        ):
+            raise ImproperlyConfigured("AI configuration not set")
+        self.client = OpenAI(base_url=settings.AI_BASE_URL, api_key=settings.AI_API_KEY)
 
-    Plus: hardening payload so BlockNote tool calls are valid.
-    """
+    def call_ai_api(self, system_content, text):
+        """Helper method to call the OpenAI API and process the response."""
+        response = self.client.chat.completions.create(
+            model=settings.AI_MODEL,
+            messages=[
+                {"role": "system", "content": system_content},
+                {"role": "user", "content": text},
+            ],
+        )
 
-    def __init__(self) -> None:
-        if not settings.AI_BASE_URL or not settings.AI_API_KEY:
-            raise ImproperlyConfigured("AI_BASE_URL and AI_API_KEY must be set")
+        content = response.choices[0].message.content
 
-        self.base_url = str(settings.AI_BASE_URL).rstrip("/")
-        self.api_key = str(settings.AI_API_KEY)
-        self.allowed_host = urlparse(self.base_url).netloc
+        if not content:
+            raise RuntimeError("AI response does not contain an answer")
 
-    def _assert_allowed_target(self, target_url: str) -> None:
-        t = urlparse(target_url)
-        if t.scheme not in ("http", "https"):
-            raise ValueError("Target URL not allowed")
-        if t.netloc != self.allowed_host:
-            raise ValueError("Target URL not allowed")
+        return {"answer": content}
 
-    def _filtered_headers(self, incoming_headers: Dict[str, str]) -> Dict[str, str]:
-        hop_by_hop = {"host", "connection", "content-length", "accept-encoding"}
-        out: Dict[str, str] = {}
-        for k, v in incoming_headers.items():
-            lk = k.lower()
-            if lk in hop_by_hop:
-                continue
-            if lk == "authorization":
-                # Client auth is for Django only, not upstream
-                continue
-            out[k] = v
+    def transform(self, text, action):
+        """Transform text based on specified action."""
+        system_content = AI_ACTIONS[action]
+        return self.call_ai_api(system_content, text)
 
-        out["Authorization"] = f"Bearer {self.api_key}"
-        return out
-
-    def _normalize_tools(self, tools: list) -> list:
-        normalized = []
-        for tool in tools:
-            if isinstance(tool, dict) and tool.get("type") == "function":
-                fn = tool.get("function") or {}
-                if isinstance(fn, dict) and not fn.get("description"):
-                    fn["description"] = f"Tool {fn.get('name', 'unknown')}."
-                tool["function"] = fn
-            normalized.append(_drop_nones(tool))
-        return normalized
-
-    def _harden_payload(self, payload: Dict[str, Any]) -> Dict[str, Any]:
-        payload = dict(payload)
-
-        # Enforce server model (important with Albert routing)
-        if getattr(settings, "AI_MODEL", None):
-            payload["model"] = settings.AI_MODEL
-
-        # Compliance
-        payload["temperature"] = 0
-
-        # Tools normalization
-        if isinstance(payload.get("tools"), list):
-            payload["tools"] = self._normalize_tools(payload["tools"])
-
-        # Force tool call if tools exist
-        if payload.get("tools"):
-            payload["tool_choice"] = {"type": "function", "function": {"name": "applyDocumentOperations"}}
-
-        # Convert non-standard "required"
-        if payload.get("tool_choice") == "required":
-            payload["tool_choice"] = {"type": "function", "function": {"name": "applyDocumentOperations"}}
-
-        # Inject strict system prompt once
-        msgs = payload.get("messages")
-        if isinstance(msgs, list):
-            need = True
-            if msgs and isinstance(msgs[0], dict) and msgs[0].get("role") == "system":
-                c = msgs[0].get("content") or ""
-                if isinstance(c, str) and "applyDocumentOperations" in c and "blocks" in c:
-                    need = False
-            if need:
-                payload["messages"] = [{"role": "system", "content": BLOCKNOTE_TOOL_STRICT_PROMPT}] + msgs
-
-        return _drop_nones(payload)
-
-    def _maybe_harden_json_body(self, body: bytes, headers: Dict[str, str]) -> bytes:
-        ct = (headers.get("Content-Type") or headers.get("content-type") or "").lower()
-        if "application/json" not in ct:
-            return body
-        try:
-            payload = json.loads(body.decode("utf-8"))
-        except Exception:
-            return body
-        if isinstance(payload, dict):
-            payload = self._harden_payload(payload)
-            return json.dumps(payload, ensure_ascii=False).encode("utf-8")
-        return body
-
-    def stream_proxy(
-        self,
-        *,
-        url: str,
-        method: str,
-        headers: Dict[str, str],
-        body: bytes,
-    ) -> Generator[bytes, None, None]:
-        self._assert_allowed_target(url)
-
-        req_headers = self._filtered_headers(dict(headers))
-        req_body = self._maybe_harden_json_body(body, req_headers)
-
-        timeout = httpx.Timeout(connect=10.0, read=300.0, write=60.0, pool=10.0)
-        with httpx.Client(timeout=timeout, follow_redirects=False) as client:
-            with client.stream(method.upper(), url, headers=req_headers, content=req_body) as r:
-                for chunk in r.iter_bytes():
-                    if chunk:
-                        yield chunk
+    def translate(self, text, language):
+        """Translate text to a specified language."""
+        language_display = enums.ALL_LANGUAGES.get(language, language)
+        system_content = AI_TRANSLATE.format(language=language_display)
+        return self.call_ai_api(system_content, text)

src/backend/core/services/converter_services.py

@@ -1,17 +1,11 @@
 """Y-Provider API services."""
 
-import logging
-import typing
 from base64 import b64encode
 
 from django.conf import settings
 
 import requests
 
-from core.services import mime_types
-
-logger = logging.getLogger(__name__)
-
 
 class ConversionError(Exception):
     """Base exception for conversion-related errors."""
@@ -25,81 +19,8 @@ class ServiceUnavailableError(ConversionError):
     """Raised when the conversion service is unavailable."""
 
 
-class ConverterProtocol(typing.Protocol):
-    """Protocol for converter classes."""
-
-    def convert(self, data, content_type, accept):
-        """Convert content from one format to another."""
-
-
-class Converter:
-    """Orchestrates conversion between different formats using specialized converters."""
-
-    docspec: ConverterProtocol
-    ydoc: ConverterProtocol
-
-    def __init__(self):
-        self.docspec = DocSpecConverter()
-        self.ydoc = YdocConverter()
-
-    def convert(self, data, content_type, accept):
-        """Convert input into other formats using external microservices."""
-
-        if content_type == mime_types.DOCX and accept == mime_types.YJS:
-            blocknote_data = self.docspec.convert(
-                data, mime_types.DOCX, mime_types.BLOCKNOTE
-            )
-            return self.ydoc.convert(
-                blocknote_data, mime_types.BLOCKNOTE, mime_types.YJS
-            )
-
-        return self.ydoc.convert(data, content_type, accept)
-
-
-class DocSpecConverter:
-    """Service class for DocSpec conversion-related operations."""
-
-    def _request(self, url, data, content_type):
-        """Make a request to the DocSpec API."""
-
-        response = requests.post(
-            url,
-            headers={"Accept": mime_types.BLOCKNOTE},
-            files={"file": ("document.docx", data, content_type)},
-            timeout=settings.CONVERSION_API_TIMEOUT,
-            verify=settings.CONVERSION_API_SECURE,
-        )
-        if not response.ok:
-            logger.error(
-                "DocSpec API error: url=%s, status=%d, response=%s",
-                url,
-                response.status_code,
-                response.text[:200] if response.text else "empty",
-            )
-        response.raise_for_status()
-        return response
-
-    def convert(self, data, content_type, accept):
-        """Convert a Document to BlockNote."""
-        if not data:
-            raise ValidationError("Input data cannot be empty")
-
-        if content_type != mime_types.DOCX or accept != mime_types.BLOCKNOTE:
-            raise ValidationError(
-                f"Conversion from {content_type} to {accept} is not supported."
-            )
-
-        try:
-            return self._request(settings.DOCSPEC_API_URL, data, content_type).content
-        except requests.RequestException as err:
-            logger.exception("DocSpec service error: url=%s", settings.DOCSPEC_API_URL)
-            raise ServiceUnavailableError(
-                "Failed to connect to DocSpec conversion service",
-            ) from err
-
-
 class YdocConverter:
-    """Service class for YDoc conversion-related operations."""
+    """Service class for conversion-related operations."""
 
     @property
     def auth_header(self):
@@ -120,34 +41,32 @@ class YdocConverter:
             timeout=settings.CONVERSION_API_TIMEOUT,
             verify=settings.CONVERSION_API_SECURE,
         )
-        if not response.ok:
-            logger.error(
-                "Y-Provider API error: url=%s, status=%d, response=%s",
-                url,
-                response.status_code,
-                response.text[:200] if response.text else "empty",
-            )
         response.raise_for_status()
         return response
 
-    def convert(self, data, content_type=mime_types.MARKDOWN, accept=mime_types.YJS):
+    def convert(
+        self, text, content_type="text/markdown", accept="application/vnd.yjs.doc"
+    ):
         """Convert a Markdown text into our internal format using an external microservice."""
 
-        if not data:
-            raise ValidationError("Input data cannot be empty")
+        if not text:
+            raise ValidationError("Input text cannot be empty")
 
-        url = f"{settings.Y_PROVIDER_API_BASE_URL}{settings.CONVERSION_API_ENDPOINT}/"
         try:
-            response = self._request(url, data, content_type, accept)
-            if accept == mime_types.YJS:
+            response = self._request(
+                f"{settings.Y_PROVIDER_API_BASE_URL}{settings.CONVERSION_API_ENDPOINT}/",
+                text,
+                content_type,
+                accept,
+            )
+            if accept == "application/vnd.yjs.doc":
                 return b64encode(response.content).decode("utf-8")
-            if accept in {mime_types.MARKDOWN, "text/html"}:
+            if accept in {"text/markdown", "text/html"}:
                 return response.text
-            if accept == mime_types.JSON:
+            if accept == "application/json":
                 return response.json()
             raise ValidationError("Unsupported format")
         except requests.RequestException as err:
-            logger.exception("Y-Provider service error: url=%s", url)
             raise ServiceUnavailableError(
-                f"Failed to connect to YDoc conversion service {content_type}, {accept}",
+                "Failed to connect to conversion service",
             ) from err

src/backend/core/services/mime_types.py

@@ -1,8 +0,0 @@
-"""MIME type constants for document conversion."""
-
-BLOCKNOTE = "application/vnd.blocknote+json"
-YJS = "application/vnd.yjs.doc"
-MARKDOWN = "text/markdown"
-JSON = "application/json"
-DOCX = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
-HTML = "text/html"

src/backend/core/templates/core/generate_document.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Generate Document</title>
+</head>
+<body>
+    <h2>Generate Document</h2>
+    <form method="post" enctype="multipart/form-data">
+        {% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit">Generate PDF</button>
+    </form>
+</body>
+</html>

src/backend/core/templatetags/extra_tags.py

@@ -1,4 +1,4 @@
-"""Custom template tags for the core application of Docs."""
+"""Custom template tags for the core application of People."""
 
 import base64
 

src/backend/core/tests/documents/test_api_documents_ai_proxy.py

@@ -1,686 +0,0 @@
-"""
-Test AI proxy API endpoint for users in impress's core app.
-"""
-
-import random
-from unittest.mock import MagicMock, patch
-
-from django.test import override_settings
-
-import pytest
-from rest_framework.test import APIClient
-
-from core import factories
-from core.tests.conftest import TEAM, USER, VIA
-
-pytestmark = pytest.mark.django_db
-
-
-@pytest.fixture(autouse=True)
-def ai_settings(settings):
-    """Fixture to set AI settings."""
-    settings.AI_MODEL = "llama"
-    settings.AI_BASE_URL = "http://example.com"
-    settings.AI_API_KEY = "test-key"
-    settings.AI_FEATURE_ENABLED = True
-
-
-@override_settings(
-    AI_ALLOW_REACH_FROM=random.choice(["public", "authenticated", "restricted"])
-)
-@pytest.mark.parametrize(
-    "reach, role",
-    [
-        ("restricted", "reader"),
-        ("restricted", "editor"),
-        ("authenticated", "reader"),
-        ("authenticated", "editor"),
-        ("public", "reader"),
-    ],
-)
-def test_api_documents_ai_proxy_anonymous_forbidden(reach, role):
-    """
-    Anonymous users should not be able to request AI proxy if the link reach
-    and role don't allow it.
-    """
-    document = factories.DocumentFactory(link_reach=reach, link_role=role)
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = APIClient().post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 401
-    assert response.json() == {
-        "detail": "Authentication credentials were not provided."
-    }
-
-
-@override_settings(AI_ALLOW_REACH_FROM="public")
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_anonymous_success(mock_create):
-    """
-    Anonymous users should be able to request AI proxy to a document
-    if the link reach and role permit it.
-    """
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {
-        "id": "chatcmpl-123",
-        "object": "chat.completion",
-        "created": 1677652288,
-        "model": "llama",
-        "choices": [
-            {
-                "index": 0,
-                "message": {
-                    "role": "assistant",
-                    "content": "Hello! How can I help you?",
-                },
-                "finish_reason": "stop",
-            }
-        ],
-        "usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21},
-    }
-    mock_create.return_value = mock_response
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = APIClient().post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    response_data = response.json()
-    assert response_data["id"] == "chatcmpl-123"
-    assert response_data["model"] == "llama"
-    assert len(response_data["choices"]) == 1
-    assert (
-        response_data["choices"][0]["message"]["content"]
-        == "Hello! How can I help you?"
-    )
-
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "Hello"}],
-        model="llama",
-        stream=False,
-    )
-
-
-@override_settings(AI_ALLOW_REACH_FROM=random.choice(["authenticated", "restricted"]))
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_anonymous_limited_by_setting(mock_create):
-    """
-    Anonymous users should not be able to request AI proxy to a document
-    if AI_ALLOW_REACH_FROM setting restricts it.
-    """
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {"content": "Hello!"}
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = APIClient().post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 401
-
-
-@pytest.mark.parametrize(
-    "reach, role",
-    [
-        ("restricted", "reader"),
-        ("restricted", "editor"),
-        ("authenticated", "reader"),
-        ("public", "reader"),
-    ],
-)
-def test_api_documents_ai_proxy_authenticated_forbidden(reach, role):
-    """
-    Users who are not related to a document can't request AI proxy if the
-    link reach and role don't allow it.
-    """
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach=reach, link_role=role)
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 403
-
-
-@pytest.mark.parametrize(
-    "reach, role",
-    [
-        ("authenticated", "editor"),
-        ("public", "editor"),
-    ],
-)
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_authenticated_success(mock_create, reach, role):
-    """
-    Authenticated users should be able to request AI proxy to a document
-    if the link reach and role permit it.
-    """
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach=reach, link_role=role)
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {
-        "id": "chatcmpl-456",
-        "object": "chat.completion",
-        "model": "llama",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Hi there!"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    response_data = response.json()
-    assert response_data["id"] == "chatcmpl-456"
-    assert response_data["choices"][0]["message"]["content"] == "Hi there!"
-
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "Hello"}],
-        model="llama",
-        stream=False,
-    )
-
-
-@pytest.mark.parametrize("via", VIA)
-def test_api_documents_ai_proxy_reader(via, mock_user_teams):
-    """Users with reader access should not be able to request AI proxy."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="restricted")
-    if via == USER:
-        factories.UserDocumentAccessFactory(document=document, user=user, role="reader")
-    elif via == TEAM:
-        mock_user_teams.return_value = ["lasuite", "unknown"]
-        factories.TeamDocumentAccessFactory(
-            document=document, team="lasuite", role="reader"
-        )
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 403
-
-
-@pytest.mark.parametrize("role", ["editor", "administrator", "owner"])
-@pytest.mark.parametrize("via", VIA)
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_success(mock_create, via, role, mock_user_teams):
-    """Users with sufficient permissions should be able to request AI proxy."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="restricted")
-    if via == USER:
-        factories.UserDocumentAccessFactory(document=document, user=user, role=role)
-    elif via == TEAM:
-        mock_user_teams.return_value = ["lasuite", "unknown"]
-        factories.TeamDocumentAccessFactory(
-            document=document, team="lasuite", role=role
-        )
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {
-        "id": "chatcmpl-789",
-        "object": "chat.completion",
-        "model": "llama",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Success!"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Test message"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    response_data = response.json()
-    assert response_data["id"] == "chatcmpl-789"
-    assert response_data["choices"][0]["message"]["content"] == "Success!"
-
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "Test message"}],
-        model="llama",
-        stream=False,
-    )
-
-
-def test_api_documents_ai_proxy_empty_messages():
-    """The messages should not be empty when requesting AI proxy."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(url, {"messages": [], "model": "llama"}, format="json")
-
-    assert response.status_code == 400
-    assert response.json() == {"messages": ["This list may not be empty."]}
-
-
-def test_api_documents_ai_proxy_missing_model():
-    """The model should be required when requesting AI proxy."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url, {"messages": [{"role": "user", "content": "Hello"}]}, format="json"
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {"model": ["This field is required."]}
-
-
-def test_api_documents_ai_proxy_invalid_message_format():
-    """Messages should have the correct format when requesting AI proxy."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-
-    # Test with invalid message format (missing role)
-    response = client.post(
-        url,
-        {
-            "messages": [{"content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {
-        "messages": ["Each message must have 'role' and 'content' fields"]
-    }
-
-    # Test with invalid message format (missing content)
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {
-        "messages": ["Each message must have 'role' and 'content' fields"]
-    }
-
-    # Test with non-dict message
-    response = client.post(
-        url,
-        {
-            "messages": ["invalid"],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {
-        "messages": {"0": ['Expected a dictionary of items but got type "str".']}
-    }
-
-
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_stream_disabled(mock_create):
-    """Stream should be automatically disabled in AI proxy requests."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {"content": "Success!"}
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-            "stream": True,  # This should be overridden to False
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    # Verify that stream was set to False
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "Hello"}],
-        model="llama",
-        stream=False,
-    )
-
-
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_additional_parameters(mock_create):
-    """AI proxy should pass through additional parameters to the AI service."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {"content": "Success!"}
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-            "temperature": 0.7,
-            "max_tokens": 100,
-            "top_p": 0.9,
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    # Verify that additional parameters were passed through
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "Hello"}],
-        model="llama",
-        temperature=0.7,
-        max_tokens=100,
-        top_p=0.9,
-        stream=False,
-    )
-
-
-@override_settings(AI_DOCUMENT_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_throttling_document(mock_create):
-    """
-    Throttling per document should be triggered on the AI transform endpoint.
-    For full throttle class test see: `test_api_utils_ai_document_rate_throttles`
-    """
-    client = APIClient()
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {"content": "Success!"}
-    mock_create.return_value = mock_response
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    for _ in range(3):
-        user = factories.UserFactory()
-        client.force_login(user)
-        response = client.post(
-            url,
-            {
-                "messages": [{"role": "user", "content": "Test message"}],
-                "model": "llama",
-            },
-            format="json",
-        )
-        assert response.status_code == 200
-        assert response.json() == {"content": "Success!"}
-
-    user = factories.UserFactory()
-    client.force_login(user)
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Test message"}],
-            "model": "llama",
-        },
-    )
-
-    assert response.status_code == 429
-    assert response.json() == {
-        "detail": "Request was throttled. Expected available in 60 seconds."
-    }
-
-
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_complex_conversation(mock_create):
-    """AI proxy should handle complex conversations with multiple messages."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {
-        "id": "chatcmpl-complex",
-        "object": "chat.completion",
-        "model": "llama",
-        "choices": [
-            {
-                "index": 0,
-                "message": {
-                    "role": "assistant",
-                    "content": "I understand your question about Python.",
-                },
-                "finish_reason": "stop",
-            }
-        ],
-    }
-    mock_create.return_value = mock_response
-
-    complex_messages = [
-        {"role": "system", "content": "You are a helpful programming assistant."},
-        {"role": "user", "content": "How do I write a for loop in Python?"},
-        {
-            "role": "assistant",
-            "content": "You can write a for loop using: for item in iterable:",
-        },
-        {"role": "user", "content": "Can you give me a concrete example?"},
-    ]
-
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": complex_messages,
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 200
-    response_data = response.json()
-    assert response_data["id"] == "chatcmpl-complex"
-    assert (
-        response_data["choices"][0]["message"]["content"]
-        == "I understand your question about Python."
-    )
-
-    mock_create.assert_called_once_with(
-        messages=complex_messages,
-        model="llama",
-        stream=False,
-    )
-
-
-@override_settings(AI_USER_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
-@patch("openai.resources.chat.completions.Completions.create")
-def test_api_documents_ai_proxy_throttling_user(mock_create):
-    """
-    Throttling per user should be triggered on the AI proxy endpoint.
-    For full throttle class test see: `test_api_utils_ai_user_rate_throttles`
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    mock_response = MagicMock()
-    mock_response.model_dump.return_value = {"content": "Success!"}
-    mock_create.return_value = mock_response
-
-    for _ in range(3):
-        document = factories.DocumentFactory(link_reach="public", link_role="editor")
-        url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-        response = client.post(
-            url,
-            {
-                "messages": [{"role": "user", "content": "Hello"}],
-                "model": "llama",
-            },
-            format="json",
-        )
-        assert response.status_code == 200
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-    url = f"/api/v1.0/documents/{document.id!s}/ai-proxy/"
-    response = client.post(
-        url,
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 429
-    assert response.json() == {
-        "detail": "Request was throttled. Expected available in 60 seconds."
-    }
-
-
-@override_settings(AI_USER_RATE_THROTTLE_RATES={"minute": 10, "hour": 6, "day": 10})
-def test_api_documents_ai_proxy_different_models():
-    """AI proxy should work with different AI models."""
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    models_to_test = ["gpt-3.5-turbo", "gpt-4", "claude-3", "llama-2"]
-
-    for model_name in models_to_test:
-        response = client.post(
-            f"/api/v1.0/documents/{document.id!s}/ai-proxy/",
-            {
-                "messages": [{"role": "user", "content": "Hello"}],
-                "model": model_name,
-            },
-            format="json",
-        )
-
-        assert response.status_code == 400
-        assert response.json() == {"model": [f"{model_name} is not a valid model"]}
-
-
-def test_api_documents_ai_proxy_ai_feature_disabled(settings):
-    """When the settings AI_FEATURE_ENABLED is set to False, the endpoint is not reachable."""
-    settings.AI_FEATURE_ENABLED = False
-
-    user = factories.UserFactory()
-
-    client = APIClient()
-    client.force_login(user)
-
-    document = factories.DocumentFactory(link_reach="public", link_role="editor")
-
-    response = client.post(
-        f"/api/v1.0/documents/{document.id!s}/ai-proxy/",
-        {
-            "messages": [{"role": "user", "content": "Hello"}],
-            "model": "llama",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == ["AI feature is not enabled."]

src/backend/core/tests/documents/test_api_documents_ai_transform.py

@@ -0,0 +1,362 @@
+"""
+Test AI transform API endpoint for users in impress's core app.
+"""
+
+import random
+from unittest.mock import MagicMock, patch
+
+from django.test import override_settings
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories
+from core.tests.conftest import TEAM, USER, VIA
+
+pytestmark = pytest.mark.django_db
+
+
+@pytest.fixture
+def ai_settings():
+    """Fixture to set AI settings."""
+    with override_settings(
+        AI_BASE_URL="http://example.com", AI_API_KEY="test-key", AI_MODEL="llama"
+    ):
+        yield
+
+
+@override_settings(
+    AI_ALLOW_REACH_FROM=random.choice(["public", "authenticated", "restricted"])
+)
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("restricted", "reader"),
+        ("restricted", "editor"),
+        ("authenticated", "reader"),
+        ("authenticated", "editor"),
+        ("public", "reader"),
+    ],
+)
+def test_api_documents_ai_transform_anonymous_forbidden(reach, role):
+    """
+    Anonymous users should not be able to request AI transform if the link reach
+    and role don't allow it.
+    """
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = APIClient().post(url, {"text": "hello", "action": "prompt"})
+
+    assert response.status_code == 401
+    assert response.json() == {
+        "detail": "Authentication credentials were not provided."
+    }
+
+
+@override_settings(AI_ALLOW_REACH_FROM="public")
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_anonymous_success(mock_create):
+    """
+    Anonymous users should be able to request AI transform to a document
+    if the link reach and role permit it.
+    """
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = APIClient().post(url, {"text": "Hello", "action": "summarize"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Salut"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Summarize the markdown text, preserving language and markdown formatting. "
+                    "Do not provide any other information. Preserve the language."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+@override_settings(AI_ALLOW_REACH_FROM=random.choice(["authenticated", "restricted"]))
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_anonymous_limited_by_setting(mock_create):
+    """
+    Anonymous users should be able to request AI transform to a document
+    if the link reach and role permit it.
+    """
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    answer = '{"answer": "Salut"}'
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content=answer))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = APIClient().post(url, {"text": "Hello", "action": "summarize"})
+
+    assert response.status_code == 401
+
+
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("restricted", "reader"),
+        ("restricted", "editor"),
+        ("authenticated", "reader"),
+        ("public", "reader"),
+    ],
+)
+def test_api_documents_ai_transform_authenticated_forbidden(reach, role):
+    """
+    Users who are not related to a document can't request AI transform if the
+    link reach and role don't allow it.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "prompt"})
+
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("authenticated", "editor"),
+        ("public", "editor"),
+    ],
+)
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_authenticated_success(mock_create, reach, role):
+    """
+    Authenticated who are not related to a document should be able to request AI transform
+    if the link reach and role permit it.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "prompt"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Salut"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Answer the prompt using markdown formatting for structure and emphasis. "
+                    "Return the content directly without wrapping it in code blocks or markdown delimiters. "
+                    "Preserve the language and markdown formatting. "
+                    "Do not provide any other information. "
+                    "Preserve the language."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+@pytest.mark.parametrize("via", VIA)
+def test_api_documents_ai_transform_reader(via, mock_user_teams):
+    """
+    Users who are simple readers on a document should not be allowed to request AI transform.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_role="reader")
+    if via == USER:
+        factories.UserDocumentAccessFactory(document=document, user=user, role="reader")
+    elif via == TEAM:
+        mock_user_teams.return_value = ["lasuite", "unknown"]
+        factories.TeamDocumentAccessFactory(
+            document=document, team="lasuite", role="reader"
+        )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "prompt"})
+
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+@pytest.mark.parametrize("role", ["editor", "administrator", "owner"])
+@pytest.mark.parametrize("via", VIA)
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_success(mock_create, via, role, mock_user_teams):
+    """
+    Editors, administrators and owners of a document should be able to request AI transform.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory()
+    if via == USER:
+        factories.UserDocumentAccessFactory(document=document, user=user, role=role)
+    elif via == TEAM:
+        mock_user_teams.return_value = ["lasuite", "unknown"]
+        factories.TeamDocumentAccessFactory(
+            document=document, team="lasuite", role=role
+        )
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "prompt"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Salut"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Answer the prompt using markdown formatting for structure and emphasis. "
+                    "Return the content directly without wrapping it in code blocks or markdown delimiters. "
+                    "Preserve the language and markdown formatting. "
+                    "Do not provide any other information. "
+                    "Preserve the language."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+def test_api_documents_ai_transform_empty_text():
+    """The text should not be empty when requesting AI transform."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": " ", "action": "prompt"})
+
+    assert response.status_code == 400
+    assert response.json() == {"text": ["This field may not be blank."]}
+
+
+def test_api_documents_ai_transform_invalid_action():
+    """The action should valid when requesting AI transform."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "invalid"})
+
+    assert response.status_code == 400
+    assert response.json() == {"action": ['"invalid" is not a valid choice.']}
+
+
+@override_settings(AI_DOCUMENT_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_throttling_document(mock_create):
+    """
+    Throttling per document should be triggered on the AI transform endpoint.
+    For full throttle class test see: `test_api_utils_ai_document_rate_throttles`
+    """
+    client = APIClient()
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    for _ in range(3):
+        user = factories.UserFactory()
+        client.force_login(user)
+        response = client.post(url, {"text": "Hello", "action": "summarize"})
+        assert response.status_code == 200
+        assert response.json() == {"answer": "Salut"}
+
+    user = factories.UserFactory()
+    client.force_login(user)
+    response = client.post(url, {"text": "Hello", "action": "summarize"})
+
+    assert response.status_code == 429
+    assert response.json() == {
+        "detail": "Request was throttled. Expected available in 60 seconds."
+    }
+
+
+@override_settings(AI_USER_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_transform_throttling_user(mock_create):
+    """
+    Throttling per user should be triggered on the AI transform endpoint.
+    For full throttle class test see: `test_api_utils_ai_user_rate_throttles`
+    """
+    user = factories.UserFactory()
+    client = APIClient()
+    client.force_login(user)
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    for _ in range(3):
+        document = factories.DocumentFactory(link_reach="public", link_role="editor")
+        url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+        response = client.post(url, {"text": "Hello", "action": "summarize"})
+        assert response.status_code == 200
+        assert response.json() == {"answer": "Salut"}
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+    url = f"/api/v1.0/documents/{document.id!s}/ai-transform/"
+    response = client.post(url, {"text": "Hello", "action": "summarize"})
+
+    assert response.status_code == 429
+    assert response.json() == {
+        "detail": "Request was throttled. Expected available in 60 seconds."
+    }

src/backend/core/tests/documents/test_api_documents_ai_translate.py

@@ -0,0 +1,384 @@
+"""
+Test AI translate API endpoint for users in impress's core app.
+"""
+
+import random
+from unittest.mock import MagicMock, patch
+
+from django.test import override_settings
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories
+from core.tests.conftest import TEAM, USER, VIA
+
+pytestmark = pytest.mark.django_db
+
+
+@pytest.fixture
+def ai_settings():
+    """Fixture to set AI settings."""
+    with override_settings(
+        AI_BASE_URL="http://example.com", AI_API_KEY="test-key", AI_MODEL="llama"
+    ):
+        yield
+
+
+def test_api_documents_ai_translate_viewset_options_metadata():
+    """The documents endpoint should give us the list of available languages."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    response = APIClient().options("/api/v1.0/documents/")
+
+    assert response.status_code == 200
+    metadata = response.json()
+    assert metadata["name"] == "Document List"
+    assert metadata["actions"]["POST"]["language"]["choices"][0] == {
+        "value": "af",
+        "display_name": "Afrikaans",
+    }
+
+
+@override_settings(
+    AI_ALLOW_REACH_FROM=random.choice(["public", "authenticated", "restricted"])
+)
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("restricted", "reader"),
+        ("restricted", "editor"),
+        ("authenticated", "reader"),
+        ("authenticated", "editor"),
+        ("public", "reader"),
+    ],
+)
+def test_api_documents_ai_translate_anonymous_forbidden(reach, role):
+    """
+    Anonymous users should not be able to request AI translate if the link reach
+    and role don't allow it.
+    """
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = APIClient().post(url, {"text": "hello", "language": "es"})
+
+    assert response.status_code == 401
+    assert response.json() == {
+        "detail": "Authentication credentials were not provided."
+    }
+
+
+@override_settings(AI_ALLOW_REACH_FROM="public")
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_anonymous_success(mock_create):
+    """
+    Anonymous users should be able to request AI translate to a document
+    if the link reach and role permit it.
+    """
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Ola"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = APIClient().post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Ola"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Keep the same html structure and formatting. "
+                    "Translate the content in the html to the specified language Spanish. "
+                    "Check the translation for accuracy and make any necessary corrections. "
+                    "Do not provide any other information."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+@override_settings(AI_ALLOW_REACH_FROM=random.choice(["authenticated", "restricted"]))
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_anonymous_limited_by_setting(mock_create):
+    """
+    Anonymous users should be able to request AI translate to a document
+    if the link reach and role permit it.
+    """
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    answer = '{"answer": "Salut"}'
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content=answer))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = APIClient().post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 401
+
+
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("restricted", "reader"),
+        ("restricted", "editor"),
+        ("authenticated", "reader"),
+        ("public", "reader"),
+    ],
+)
+def test_api_documents_ai_translate_authenticated_forbidden(reach, role):
+    """
+    Users who are not related to a document can't request AI translate if the
+    link reach and role don't allow it.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+@pytest.mark.parametrize(
+    "reach, role",
+    [
+        ("authenticated", "editor"),
+        ("public", "editor"),
+    ],
+)
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_authenticated_success(mock_create, reach, role):
+    """
+    Authenticated who are not related to a document should be able to request AI translate
+    if the link reach and role permit it.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach=reach, link_role=role)
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "es-co"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Salut"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Keep the same html structure and formatting. "
+                    "Translate the content in the html to the "
+                    "specified language Colombian Spanish. "
+                    "Check the translation for accuracy and make any necessary corrections. "
+                    "Do not provide any other information."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+@pytest.mark.parametrize("via", VIA)
+def test_api_documents_ai_translate_reader(via, mock_user_teams):
+    """
+    Users who are simple readers on a document should not be allowed to request AI translate.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_role="reader")
+    if via == USER:
+        factories.UserDocumentAccessFactory(document=document, user=user, role="reader")
+    elif via == TEAM:
+        mock_user_teams.return_value = ["lasuite", "unknown"]
+        factories.TeamDocumentAccessFactory(
+            document=document, team="lasuite", role="reader"
+        )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+@pytest.mark.parametrize("role", ["editor", "administrator", "owner"])
+@pytest.mark.parametrize("via", VIA)
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_success(mock_create, via, role, mock_user_teams):
+    """
+    Editors, administrators and owners of a document should be able to request AI translate.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory()
+    if via == USER:
+        factories.UserDocumentAccessFactory(document=document, user=user, role=role)
+    elif via == TEAM:
+        mock_user_teams.return_value = ["lasuite", "unknown"]
+        factories.TeamDocumentAccessFactory(
+            document=document, team="lasuite", role=role
+        )
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "es-co"})
+
+    assert response.status_code == 200
+    assert response.json() == {"answer": "Salut"}
+    mock_create.assert_called_once_with(
+        model="llama",
+        messages=[
+            {
+                "role": "system",
+                "content": (
+                    "Keep the same html structure and formatting. "
+                    "Translate the content in the html to the "
+                    "specified language Colombian Spanish. "
+                    "Check the translation for accuracy and make any necessary corrections. "
+                    "Do not provide any other information."
+                ),
+            },
+            {"role": "user", "content": "Hello"},
+        ],
+    )
+
+
+def test_api_documents_ai_translate_empty_text():
+    """The text should not be empty when requesting AI translate."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": " ", "language": "es"})
+
+    assert response.status_code == 400
+    assert response.json() == {"text": ["This field may not be blank."]}
+
+
+def test_api_documents_ai_translate_invalid_action():
+    """The action should valid when requesting AI translate."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "invalid"})
+
+    assert response.status_code == 400
+    assert response.json() == {"language": ['"invalid" is not a valid choice.']}
+
+
+@override_settings(AI_DOCUMENT_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_throttling_document(mock_create):
+    """
+    Throttling per document should be triggered on the AI translate endpoint.
+    For full throttle class test see: `test_api_utils_ai_document_rate_throttles`
+    """
+    client = APIClient()
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    for _ in range(3):
+        user = factories.UserFactory()
+        client.force_login(user)
+        response = client.post(url, {"text": "Hello", "language": "es"})
+        assert response.status_code == 200
+        assert response.json() == {"answer": "Salut"}
+
+    user = factories.UserFactory()
+    client.force_login(user)
+    response = client.post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 429
+    assert response.json() == {
+        "detail": "Request was throttled. Expected available in 60 seconds."
+    }
+
+
+@override_settings(AI_USER_RATE_THROTTLE_RATES={"minute": 3, "hour": 6, "day": 10})
+@pytest.mark.usefixtures("ai_settings")
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_documents_ai_translate_throttling_user(mock_create):
+    """
+    Throttling per user should be triggered on the AI translate endpoint.
+    For full throttle class test see: `test_api_utils_ai_user_rate_throttles`
+    """
+    user = factories.UserFactory()
+    client = APIClient()
+    client.force_login(user)
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
+    )
+
+    for _ in range(3):
+        document = factories.DocumentFactory(link_reach="public", link_role="editor")
+        url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+        response = client.post(url, {"text": "Hello", "language": "es"})
+        assert response.status_code == 200
+        assert response.json() == {"answer": "Salut"}
+
+    document = factories.DocumentFactory(link_reach="public", link_role="editor")
+    url = f"/api/v1.0/documents/{document.id!s}/ai-translate/"
+    response = client.post(url, {"text": "Hello", "language": "es"})
+
+    assert response.status_code == 429
+    assert response.json() == {
+        "detail": "Request was throttled. Expected available in 60 seconds."
+    }

src/backend/core/tests/documents/test_api_documents_create_for_owner.py

@@ -16,7 +16,6 @@ from rest_framework.test import APIClient
 from core import factories
 from core.api.serializers import ServerCreateDocumentSerializer
 from core.models import Document, Invitation, User
-from core.services import mime_types
 from core.services.converter_services import ConversionError, YdocConverter
 
 pytestmark = pytest.mark.django_db
@@ -192,9 +191,7 @@ def test_api_documents_create_for_owner_existing(mock_convert_md):
 
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     document = Document.objects.get()
     assert response.json() == {"id": str(document.id)}
@@ -239,9 +236,7 @@ def test_api_documents_create_for_owner_new_user(mock_convert_md):
 
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     document = Document.objects.get()
     assert response.json() == {"id": str(document.id)}
@@ -302,9 +297,7 @@ def test_api_documents_create_for_owner_existing_user_email_no_sub_with_fallback
 
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     document = Document.objects.get()
     assert response.json() == {"id": str(document.id)}
@@ -400,9 +393,7 @@ def test_api_documents_create_for_owner_new_user_no_sub_no_fallback_allow_duplic
         HTTP_AUTHORIZATION="Bearer DummyToken",
     )
     assert response.status_code == 201
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     document = Document.objects.get()
     assert response.json() == {"id": str(document.id)}
@@ -483,9 +474,7 @@ def test_api_documents_create_for_owner_with_default_language(
     )
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
     assert mock_send.call_args[0][3] == "de-de"
 
 
@@ -512,9 +501,7 @@ def test_api_documents_create_for_owner_with_custom_language(mock_convert_md):
 
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     assert len(mail.outbox) == 1
     email = mail.outbox[0]
@@ -550,9 +537,7 @@ def test_api_documents_create_for_owner_with_custom_subject_and_message(
 
     assert response.status_code == 201
 
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     assert len(mail.outbox) == 1
     email = mail.outbox[0]
@@ -586,9 +571,7 @@ def test_api_documents_create_for_owner_with_converter_exception(
         format="json",
         HTTP_AUTHORIZATION="Bearer DummyToken",
     )
-    mock_convert_md.assert_called_once_with(
-        "Document content", mime_types.MARKDOWN, mime_types.YJS
-    )
+    mock_convert_md.assert_called_once_with("Document content")
 
     assert response.status_code == 400
     assert response.json() == {"content": ["Could not convert content"]}

src/backend/core/tests/documents/test_api_documents_create_with_file.py

@@ -1,413 +0,0 @@
-"""
-Tests for Documents API endpoint in impress's core app: create with file upload
-"""
-
-from base64 import b64decode, binascii
-from io import BytesIO
-from unittest.mock import patch
-
-import pytest
-from rest_framework.test import APIClient
-
-from core import factories
-from core.models import Document
-from core.services import mime_types
-from core.services.converter_services import (
-    ConversionError,
-    ServiceUnavailableError,
-)
-
-pytestmark = pytest.mark.django_db
-
-
-def test_api_documents_create_with_file_anonymous():
-    """Anonymous users should not be allowed to create documents with file upload."""
-    # Create a fake DOCX file
-    file_content = b"fake docx content"
-    file = BytesIO(file_content)
-    file.name = "test_document.docx"
-
-    response = APIClient().post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 401
-    assert not Document.objects.exists()
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_docx_file_success(mock_convert):
-    """
-    Authenticated users should be able to create documents by uploading a DOCX file.
-    The file should be converted to YJS format and the title should be set from filename.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion
-    converted_yjs = "base64encodedyjscontent"
-    mock_convert.return_value = converted_yjs
-
-    # Create a fake DOCX file
-    file_content = b"fake docx content"
-    file = BytesIO(file_content)
-    file.name = "My Important Document.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    assert document.title == "My Important Document.docx"
-    assert document.content == converted_yjs
-    assert document.accesses.filter(role="owner", user=user).exists()
-
-    # Verify the converter was called correctly
-    mock_convert.assert_called_once_with(
-        file_content,
-        content_type=mime_types.DOCX,
-        accept=mime_types.YJS,
-    )
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_markdown_file_success(mock_convert):
-    """
-    Authenticated users should be able to create documents by uploading a Markdown file.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion
-    converted_yjs = "base64encodedyjscontent"
-    mock_convert.return_value = converted_yjs
-
-    # Create a fake Markdown file
-    file_content = b"# Test Document\n\nThis is a test."
-    file = BytesIO(file_content)
-    file.name = "readme.md"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    assert document.title == "readme.md"
-    assert document.content == converted_yjs
-    assert document.accesses.filter(role="owner", user=user).exists()
-
-    # Verify the converter was called correctly
-    mock_convert.assert_called_once_with(
-        file_content,
-        content_type=mime_types.MARKDOWN,
-        accept=mime_types.YJS,
-    )
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_and_explicit_title(mock_convert):
-    """
-    When both file and title are provided, the filename should override the title.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion
-    converted_yjs = "base64encodedyjscontent"
-    mock_convert.return_value = converted_yjs
-
-    # Create a fake DOCX file
-    file_content = b"fake docx content"
-    file = BytesIO(file_content)
-    file.name = "Uploaded Document.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-            "title": "This should be overridden",
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    # The filename should take precedence
-    assert document.title == "Uploaded Document.docx"
-
-
-def test_api_documents_create_with_empty_file():
-    """
-    Creating a document with an empty file should fail with a validation error.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Create an empty file
-    file = BytesIO(b"")
-    file.name = "empty.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {"file": ["The submitted file is empty."]}
-    assert not Document.objects.exists()
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_conversion_error(mock_convert):
-    """
-    When conversion fails, the API should return a 400 error with appropriate message.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion to raise an error
-    mock_convert.side_effect = ConversionError("Failed to convert document")
-
-    # Create a fake DOCX file
-    file_content = b"fake invalid docx content"
-    file = BytesIO(file_content)
-    file.name = "corrupted.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {"file": ["Could not convert file content"]}
-    assert not Document.objects.exists()
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_service_unavailable(mock_convert):
-    """
-    When the conversion service is unavailable, appropriate error should be returned.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion to raise ServiceUnavailableError
-    mock_convert.side_effect = ServiceUnavailableError(
-        "Failed to connect to conversion service"
-    )
-
-    # Create a fake DOCX file
-    file_content = b"fake docx content"
-    file = BytesIO(file_content)
-    file.name = "document.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {"file": ["Could not convert file content"]}
-    assert not Document.objects.exists()
-
-
-def test_api_documents_create_without_file_still_works():
-    """
-    Creating a document without a file should still work as before (backward compatibility).
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "title": "Regular document without file",
-        },
-        format="json",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    assert document.title == "Regular document without file"
-    assert document.content is None
-    assert document.accesses.filter(role="owner", user=user).exists()
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_null_value(mock_convert):
-    """
-    Passing file=null should be treated as no file upload.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "title": "Document with null file",
-            "file": None,
-        },
-        format="json",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    assert document.title == "Document with null file"
-    # Converter should not have been called
-    mock_convert.assert_not_called()
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_preserves_content_format(mock_convert):
-    """
-    Verify that the converted content is stored correctly in the document.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion with realistic base64-encoded YJS data
-    converted_yjs = "AQMEBQYHCAkKCwwNDg8QERITFBUWFxgZGhscHR4fICA="
-    mock_convert.return_value = converted_yjs
-
-    # Create a fake DOCX file
-    file_content = b"fake docx with complex formatting"
-    file = BytesIO(file_content)
-    file.name = "complex_document.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-
-    # Verify the content is stored as returned by the converter
-    assert document.content == converted_yjs
-
-    # Verify it's valid base64 (can be decoded)
-    try:
-        b64decode(converted_yjs)
-    except binascii.Error:
-        pytest.fail("Content should be valid base64-encoded data")
-
-
-@patch("core.services.converter_services.Converter.convert")
-def test_api_documents_create_with_file_unicode_filename(mock_convert):
-    """
-    Test that Unicode characters in filenames are handled correctly.
-    """
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    # Mock the conversion
-    converted_yjs = "base64encodedyjscontent"
-    mock_convert.return_value = converted_yjs
-
-    # Create a file with Unicode characters in the name
-    file_content = b"fake docx content"
-    file = BytesIO(file_content)
-    file.name = "文档-télécharger-документ.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 201
-    document = Document.objects.get()
-    assert document.title == "文档-télécharger-документ.docx"
-
-
-def test_api_documents_create_with_file_max_size_exceeded(settings):
-    """
-    The uploaded file should not exceed the maximum size in settings.
-    """
-    settings.CONVERSION_FILE_MAX_SIZE = 1  # 1 byte for test
-
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    file = BytesIO(b"a" * (10))
-    file.name = "test.docx"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 400
-
-    assert response.json() == {"file": ["File size exceeds the maximum limit of 0 MB."]}
-
-
-def test_api_documents_create_with_file_extension_not_allowed(settings):
-    """
-    The uploaded file should not have an allowed extension.
-    """
-    settings.CONVERSION_FILE_EXTENSIONS_ALLOWED = [".docx"]
-
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    file = BytesIO(b"fake docx content")
-    file.name = "test.md"
-
-    response = client.post(
-        "/api/v1.0/documents/",
-        {
-            "file": file,
-        },
-        format="multipart",
-    )
-
-    assert response.status_code == 400
-    assert response.json() == {
-        "file": [
-            "File extension .md is not allowed. Allowed extensions are: ['.docx']."
-        ]
-    }

src/backend/core/tests/documents/test_api_documents_favorite_list.py

@@ -83,34 +83,3 @@ def test_api_document_favorite_list_authenticated_with_favorite():
             }
         ],
     }
-
-
-def test_api_document_favorite_list_with_favorite_children():
-    """Authenticated users should receive their favorite documents, including children."""
-
-    user = factories.UserFactory()
-    client = APIClient()
-    client.force_login(user)
-
-    root = factories.DocumentFactory(creator=user, users=[user])
-    children = factories.DocumentFactory.create_batch(
-        2, parent=root, favorited_by=[user]
-    )
-
-    access = factories.UserDocumentAccessFactory(
-        user=user, role=models.RoleChoices.READER, document__favorited_by=[user]
-    )
-
-    other_root = factories.DocumentFactory(creator=user, users=[user])
-    factories.DocumentFactory.create_batch(2, parent=other_root)
-
-    response = client.get("/api/v1.0/documents/favorite_list/")
-
-    assert response.status_code == 200
-    assert response.json()["count"] == 3
-
-    content = response.json()["results"]
-
-    assert content[0]["id"] == str(children[0].id)
-    assert content[1]["id"] == str(children[1].id)
-    assert content[2]["id"] == str(access.document.id)

src/backend/core/tests/documents/test_api_documents_retrieve.py

@@ -29,7 +29,8 @@ def test_api_documents_retrieve_anonymous_public_standalone():
         "abilities": {
             "accesses_manage": False,
             "accesses_view": False,
-            "ai_proxy": False,
+            "ai_transform": False,
+            "ai_translate": False,
             "attachment_upload": document.link_role == "editor",
             "can_edit": document.link_role == "editor",
             "children_create": False,
@@ -106,7 +107,8 @@ def test_api_documents_retrieve_anonymous_public_parent():
         "abilities": {
             "accesses_manage": False,
             "accesses_view": False,
-            "ai_proxy": False,
+            "ai_transform": False,
+            "ai_translate": False,
             "attachment_upload": grand_parent.link_role == "editor",
             "can_edit": grand_parent.link_role == "editor",
             "children_create": False,
@@ -213,7 +215,8 @@ def test_api_documents_retrieve_authenticated_unrelated_public_or_authenticated(
         "abilities": {
             "accesses_manage": False,
             "accesses_view": False,
-            "ai_proxy": document.link_role == "editor",
+            "ai_transform": document.link_role == "editor",
+            "ai_translate": document.link_role == "editor",
             "attachment_upload": document.link_role == "editor",
             "can_edit": document.link_role == "editor",
             "children_create": document.link_role == "editor",
@@ -297,7 +300,8 @@ def test_api_documents_retrieve_authenticated_public_or_authenticated_parent(rea
         "abilities": {
             "accesses_manage": False,
             "accesses_view": False,
-            "ai_proxy": grand_parent.link_role == "editor",
+            "ai_transform": grand_parent.link_role == "editor",
+            "ai_translate": grand_parent.link_role == "editor",
             "attachment_upload": grand_parent.link_role == "editor",
             "can_edit": grand_parent.link_role == "editor",
             "children_create": grand_parent.link_role == "editor",
@@ -494,7 +498,6 @@ def test_api_documents_retrieve_authenticated_related_parent():
         "abilities": {
             "accesses_manage": access.role in ["administrator", "owner"],
             "accesses_view": True,
-            "ai_proxy": access.role not in ["reader", "commenter"],
             "ai_transform": access.role not in ["reader", "commenter"],
             "ai_translate": access.role not in ["reader", "commenter"],
             "attachment_upload": access.role not in ["reader", "commenter"],

src/backend/core/tests/documents/test_api_documents_trashbin.py

@@ -72,7 +72,8 @@ def test_api_documents_trashbin_format():
         "abilities": {
             "accesses_manage": False,
             "accesses_view": False,
-            "ai_proxy": False,
+            "ai_transform": False,
+            "ai_translate": False,
             "attachment_upload": False,
             "can_edit": False,
             "children_create": False,

src/backend/core/tests/templates/test_api_templates_create.py

@@ -0,0 +1,46 @@
+"""
+Tests for Templates API endpoint in impress's core app: create
+"""
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories
+from core.models import Template
+
+pytestmark = pytest.mark.django_db
+
+
+def test_api_templates_create_anonymous():
+    """Anonymous users should not be allowed to create templates."""
+    response = APIClient().post(
+        "/api/v1.0/templates/",
+        {
+            "title": "my template",
+        },
+    )
+
+    assert response.status_code == 401
+    assert not Template.objects.exists()
+
+
+def test_api_templates_create_authenticated():
+    """
+    Authenticated users should be able to create templates and should automatically be declared
+    as the owner of the newly created template.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    response = client.post(
+        "/api/v1.0/templates/",
+        {
+            "title": "my template",
+        },
+        format="json",
+    )
+
+    assert response.status_code == 405
+    assert not Template.objects.exists()

src/backend/core/tests/templates/test_api_templates_delete.py

@@ -0,0 +1,45 @@
+"""
+Tests for Templates API endpoint in impress's core app: delete
+"""
+
+import random
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories, models
+
+pytestmark = pytest.mark.django_db
+
+
+def test_api_templates_delete_anonymous():
+    """Anonymous users should not be allowed to destroy a template."""
+    template = factories.TemplateFactory()
+
+    response = APIClient().delete(
+        f"/api/v1.0/templates/{template.id!s}/",
+    )
+
+    assert response.status_code == 401
+    assert models.Template.objects.count() == 1
+
+
+def test_api_templates_delete_not_implemented():
+    """
+    Authenticated users should not be allowed to delete a template to which they are not
+    related.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    is_public = random.choice([True, False])
+    template = factories.TemplateFactory(is_public=is_public, users=[(user, "owner")])
+
+    response = client.delete(
+        f"/api/v1.0/templates/{template.id!s}/",
+    )
+
+    assert response.status_code == 405
+    assert models.Template.objects.count() == 1

src/backend/core/tests/templates/test_api_templates_list.py

@@ -0,0 +1,237 @@
+"""
+Tests for Templates API endpoint in impress's core app: list
+"""
+
+from unittest import mock
+
+import pytest
+from rest_framework.pagination import PageNumberPagination
+from rest_framework.test import APIClient
+
+from core import factories
+
+pytestmark = pytest.mark.django_db
+
+
+def test_api_templates_list_anonymous():
+    """Anonymous users should only be able to list public templates."""
+    factories.TemplateFactory.create_batch(2, is_public=False)
+    public_templates = factories.TemplateFactory.create_batch(2, is_public=True)
+    expected_ids = {str(template.id) for template in public_templates}
+
+    response = APIClient().get("/api/v1.0/templates/")
+
+    assert response.status_code == 200
+    results = response.json()["results"]
+    assert len(results) == 2
+    results_id = {result["id"] for result in results}
+    assert expected_ids == results_id
+
+
+def test_api_templates_list_authenticated_direct():
+    """
+    Authenticated users should be able to list templates they are a direct
+    owner/administrator/member of or that are public.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    related_templates = [
+        access.template
+        for access in factories.UserTemplateAccessFactory.create_batch(5, user=user)
+    ]
+    public_templates = factories.TemplateFactory.create_batch(2, is_public=True)
+    factories.TemplateFactory.create_batch(2, is_public=False)
+
+    expected_ids = {
+        str(template.id) for template in related_templates + public_templates
+    }
+
+    response = client.get(
+        "/api/v1.0/templates/",
+    )
+
+    assert response.status_code == 200
+    results = response.json()["results"]
+    assert len(results) == 7
+    results_id = {result["id"] for result in results}
+    assert expected_ids == results_id
+
+
+def test_api_templates_list_authenticated_via_team(mock_user_teams):
+    """
+    Authenticated users should be able to list templates they are a
+    owner/administrator/member of via a team or that are public.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    mock_user_teams.return_value = ["team1", "team2", "unknown"]
+
+    templates_team1 = [
+        access.template
+        for access in factories.TeamTemplateAccessFactory.create_batch(2, team="team1")
+    ]
+    templates_team2 = [
+        access.template
+        for access in factories.TeamTemplateAccessFactory.create_batch(3, team="team2")
+    ]
+    public_templates = factories.TemplateFactory.create_batch(2, is_public=True)
+    factories.TemplateFactory.create_batch(2, is_public=False)
+
+    expected_ids = {
+        str(template.id)
+        for template in templates_team1 + templates_team2 + public_templates
+    }
+
+    response = client.get("/api/v1.0/templates/")
+
+    assert response.status_code == 200
+    results = response.json()["results"]
+    assert len(results) == 7
+    results_id = {result["id"] for result in results}
+    assert expected_ids == results_id
+
+
+@mock.patch.object(PageNumberPagination, "get_page_size", return_value=2)
+def test_api_templates_list_pagination(
+    _mock_page_size,
+):
+    """Pagination should work as expected."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template_ids = [
+        str(access.template_id)
+        for access in factories.UserTemplateAccessFactory.create_batch(3, user=user)
+    ]
+
+    # Get page 1
+    response = client.get(
+        "/api/v1.0/templates/",
+    )
+
+    assert response.status_code == 200
+    content = response.json()
+
+    assert content["count"] == 3
+    assert content["next"] == "http://testserver/api/v1.0/templates/?page=2"
+    assert content["previous"] is None
+
+    assert len(content["results"]) == 2
+    for item in content["results"]:
+        template_ids.remove(item["id"])
+
+    # Get page 2
+    response = client.get(
+        "/api/v1.0/templates/?page=2",
+    )
+
+    assert response.status_code == 200
+    content = response.json()
+
+    assert content["count"] == 3
+    assert content["next"] is None
+    assert content["previous"] == "http://testserver/api/v1.0/templates/"
+
+    assert len(content["results"]) == 1
+    template_ids.remove(content["results"][0]["id"])
+    assert template_ids == []
+
+
+def test_api_templates_list_authenticated_distinct():
+    """A template with several related users should only be listed once."""
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    other_user = factories.UserFactory()
+
+    template = factories.TemplateFactory(users=[user, other_user], is_public=True)
+
+    response = client.get(
+        "/api/v1.0/templates/",
+    )
+
+    assert response.status_code == 200
+    content = response.json()
+    assert len(content["results"]) == 1
+    assert content["results"][0]["id"] == str(template.id)
+
+
+def test_api_templates_list_order_default():
+    """The templates list should be sorted by 'created_at' in descending order by default."""
+    user = factories.UserFactory()
+    client = APIClient()
+    client.force_login(user)
+
+    template_ids = [
+        str(access.template.id)
+        for access in factories.UserTemplateAccessFactory.create_batch(5, user=user)
+    ]
+
+    response = client.get(
+        "/api/v1.0/templates/",
+    )
+
+    assert response.status_code == 200
+
+    response_data = response.json()
+    response_template_ids = [template["id"] for template in response_data["results"]]
+
+    template_ids.reverse()
+    assert response_template_ids == template_ids, (
+        "created_at values are not sorted from newest to oldest"
+    )
+
+
+def test_api_templates_list_order_param():
+    """
+    The templates list is sorted by 'created_at' in ascending order when setting
+    the "ordering" query parameter.
+    """
+    user = factories.UserFactory()
+    client = APIClient()
+    client.force_login(user)
+
+    templates_ids = [
+        str(access.template.id)
+        for access in factories.UserTemplateAccessFactory.create_batch(5, user=user)
+    ]
+
+    response = client.get(
+        "/api/v1.0/templates/?ordering=created_at",
+    )
+    assert response.status_code == 200
+
+    response_data = response.json()
+
+    response_template_ids = [template["id"] for template in response_data["results"]]
+
+    assert response_template_ids == templates_ids, (
+        "created_at values are not sorted from oldest to newest"
+    )
+
+
+def test_api_template_throttling(settings):
+    """Test api template throttling."""
+    current_rate = settings.REST_FRAMEWORK["DEFAULT_THROTTLE_RATES"]["template"]
+    settings.REST_FRAMEWORK["DEFAULT_THROTTLE_RATES"]["template"] = "2/minute"
+    client = APIClient()
+    for _i in range(2):
+        response = client.get("/api/v1.0/templates/")
+        assert response.status_code == 200
+    with mock.patch("core.api.throttling.capture_message") as mock_capture_message:
+        response = client.get("/api/v1.0/templates/")
+        assert response.status_code == 429
+        mock_capture_message.assert_called_once_with(
+            "Rate limit exceeded for scope template", "warning"
+        )
+    settings.REST_FRAMEWORK["DEFAULT_THROTTLE_RATES"]["template"] = current_rate

src/backend/core/tests/templates/test_api_templates_retrieve.py

@@ -0,0 +1,522 @@
+"""
+Tests for Templates API endpoint in impress's core app: retrieve
+"""
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories
+
+pytestmark = pytest.mark.django_db
+
+
+def test_api_templates_retrieve_anonymous_public():
+    """Anonymous users should be allowed to retrieve public templates."""
+    template = factories.TemplateFactory(is_public=True)
+
+    response = APIClient().get(f"/api/v1.0/templates/{template.id!s}/")
+
+    assert response.status_code == 200
+    assert response.json() == {
+        "id": str(template.id),
+        "abilities": {
+            "destroy": False,
+            "generate_document": True,
+            "accesses_manage": False,
+            "partial_update": False,
+            "retrieve": True,
+            "update": False,
+        },
+        "accesses": [],
+        "title": template.title,
+        "is_public": True,
+        "code": template.code,
+        "css": template.css,
+    }
+
+
+def test_api_templates_retrieve_anonymous_not_public():
+    """Anonymous users should not be able to retrieve a template that is not public."""
+    template = factories.TemplateFactory(is_public=False)
+
+    response = APIClient().get(f"/api/v1.0/templates/{template.id!s}/")
+
+    assert response.status_code == 401
+    assert response.json() == {
+        "detail": "Authentication credentials were not provided."
+    }
+
+
+def test_api_templates_retrieve_authenticated_unrelated_public():
+    """
+    Authenticated users should be able to retrieve a public template to which they are
+    not related.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=True)
+
+    response = client.get(
+        f"/api/v1.0/templates/{template.id!s}/",
+    )
+    assert response.status_code == 200
+    assert response.json() == {
+        "id": str(template.id),
+        "abilities": {
+            "destroy": False,
+            "generate_document": True,
+            "accesses_manage": False,
+            "partial_update": False,
+            "retrieve": True,
+            "update": False,
+        },
+        "accesses": [],
+        "title": template.title,
+        "is_public": True,
+        "code": template.code,
+        "css": template.css,
+    }
+
+
+def test_api_templates_retrieve_authenticated_unrelated_not_public():
+    """
+    Authenticated users should not be allowed to retrieve a template that is not public and
+    to which they are not related.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=False)
+
+    response = client.get(
+        f"/api/v1.0/templates/{template.id!s}/",
+    )
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+def test_api_templates_retrieve_authenticated_related_direct():
+    """
+    Authenticated users should be allowed to retrieve a template to which they
+    are directly related whatever the role.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory()
+    access1 = factories.UserTemplateAccessFactory(template=template, user=user)
+    access2 = factories.UserTemplateAccessFactory(template=template)
+
+    response = client.get(
+        f"/api/v1.0/templates/{template.id!s}/",
+    )
+    assert response.status_code == 200
+    content = response.json()
+    assert sorted(content.pop("accesses"), key=lambda x: x["user"]) == sorted(
+        [
+            {
+                "id": str(access1.id),
+                "user": str(user.id),
+                "team": "",
+                "role": access1.role,
+                "abilities": access1.get_abilities(user),
+            },
+            {
+                "id": str(access2.id),
+                "user": str(access2.user.id),
+                "team": "",
+                "role": access2.role,
+                "abilities": access2.get_abilities(user),
+            },
+        ],
+        key=lambda x: x["user"],
+    )
+    assert response.json() == {
+        "id": str(template.id),
+        "title": template.title,
+        "abilities": template.get_abilities(user),
+        "is_public": template.is_public,
+        "code": template.code,
+        "css": template.css,
+    }
+
+
+def test_api_templates_retrieve_authenticated_related_team_none(mock_user_teams):
+    """
+    Authenticated users should not be able to retrieve a template related to teams in
+    which the user is not.
+    """
+    mock_user_teams.return_value = []
+
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=False)
+
+    factories.TeamTemplateAccessFactory(
+        template=template, team="readers", role="reader"
+    )
+    factories.TeamTemplateAccessFactory(
+        template=template, team="editors", role="editor"
+    )
+    factories.TeamTemplateAccessFactory(
+        template=template, team="administrators", role="administrator"
+    )
+    factories.TeamTemplateAccessFactory(template=template, team="owners", role="owner")
+    factories.TeamTemplateAccessFactory(template=template)
+    factories.TeamTemplateAccessFactory()
+
+    response = client.get(f"/api/v1.0/templates/{template.id!s}/")
+    assert response.status_code == 403
+    assert response.json() == {
+        "detail": "You do not have permission to perform this action."
+    }
+
+
+@pytest.mark.parametrize(
+    "teams",
+    [
+        ["readers"],
+        ["unknown", "readers"],
+        ["editors"],
+        ["unknown", "editors"],
+    ],
+)
+def test_api_templates_retrieve_authenticated_related_team_readers_or_editors(
+    teams, mock_user_teams
+):
+    """
+    Authenticated users should be allowed to retrieve a template to which they
+    are related via a team whatever the role and see all its accesses.
+    """
+    mock_user_teams.return_value = teams
+
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=False)
+
+    access_reader = factories.TeamTemplateAccessFactory(
+        template=template, team="readers", role="reader"
+    )
+    access_editor = factories.TeamTemplateAccessFactory(
+        template=template, team="editors", role="editor"
+    )
+    access_administrator = factories.TeamTemplateAccessFactory(
+        template=template, team="administrators", role="administrator"
+    )
+    access_owner = factories.TeamTemplateAccessFactory(
+        template=template, team="owners", role="owner"
+    )
+    other_access = factories.TeamTemplateAccessFactory(template=template)
+    factories.TeamTemplateAccessFactory()
+
+    response = client.get(f"/api/v1.0/templates/{template.id!s}/")
+    assert response.status_code == 200
+    content = response.json()
+    expected_abilities = {
+        "destroy": False,
+        "retrieve": True,
+        "set_role_to": [],
+        "update": False,
+        "partial_update": False,
+    }
+    assert sorted(content.pop("accesses"), key=lambda x: x["id"]) == sorted(
+        [
+            {
+                "id": str(access_reader.id),
+                "user": None,
+                "team": "readers",
+                "role": access_reader.role,
+                "abilities": expected_abilities,
+            },
+            {
+                "id": str(access_editor.id),
+                "user": None,
+                "team": "editors",
+                "role": access_editor.role,
+                "abilities": expected_abilities,
+            },
+            {
+                "id": str(access_administrator.id),
+                "user": None,
+                "team": "administrators",
+                "role": access_administrator.role,
+                "abilities": expected_abilities,
+            },
+            {
+                "id": str(access_owner.id),
+                "user": None,
+                "team": "owners",
+                "role": access_owner.role,
+                "abilities": expected_abilities,
+            },
+            {
+                "id": str(other_access.id),
+                "user": None,
+                "team": other_access.team,
+                "role": other_access.role,
+                "abilities": expected_abilities,
+            },
+        ],
+        key=lambda x: x["id"],
+    )
+    assert response.json() == {
+        "id": str(template.id),
+        "title": template.title,
+        "abilities": template.get_abilities(user),
+        "is_public": False,
+        "code": template.code,
+        "css": template.css,
+    }
+
+
+@pytest.mark.parametrize(
+    "teams",
+    [
+        ["administrators"],
+        ["members", "administrators"],
+        ["unknown", "administrators"],
+    ],
+)
+def test_api_templates_retrieve_authenticated_related_team_administrators(
+    teams, mock_user_teams
+):
+    """
+    Authenticated users should be allowed to retrieve a template to which they
+    are related via a team whatever the role and see all its accesses.
+    """
+    mock_user_teams.return_value = teams
+
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=False)
+
+    access_reader = factories.TeamTemplateAccessFactory(
+        template=template, team="readers", role="reader"
+    )
+    access_editor = factories.TeamTemplateAccessFactory(
+        template=template, team="editors", role="editor"
+    )
+    access_administrator = factories.TeamTemplateAccessFactory(
+        template=template, team="administrators", role="administrator"
+    )
+    access_owner = factories.TeamTemplateAccessFactory(
+        template=template, team="owners", role="owner"
+    )
+    other_access = factories.TeamTemplateAccessFactory(template=template)
+    factories.TeamTemplateAccessFactory()
+
+    response = client.get(f"/api/v1.0/templates/{template.id!s}/")
+
+    assert response.status_code == 200
+    content = response.json()
+    assert sorted(content.pop("accesses"), key=lambda x: x["id"]) == sorted(
+        [
+            {
+                "id": str(access_reader.id),
+                "user": None,
+                "team": "readers",
+                "role": "reader",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["administrator", "editor"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_editor.id),
+                "user": None,
+                "team": "editors",
+                "role": "editor",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["administrator", "reader"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_administrator.id),
+                "user": None,
+                "team": "administrators",
+                "role": "administrator",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["editor", "reader"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_owner.id),
+                "user": None,
+                "team": "owners",
+                "role": "owner",
+                "abilities": {
+                    "destroy": False,
+                    "retrieve": True,
+                    "set_role_to": [],
+                    "update": False,
+                    "partial_update": False,
+                },
+            },
+            {
+                "id": str(other_access.id),
+                "user": None,
+                "team": other_access.team,
+                "role": other_access.role,
+                "abilities": other_access.get_abilities(user),
+            },
+        ],
+        key=lambda x: x["id"],
+    )
+    assert response.json() == {
+        "id": str(template.id),
+        "title": template.title,
+        "abilities": template.get_abilities(user),
+        "is_public": False,
+        "code": template.code,
+        "css": template.css,
+    }
+
+
+@pytest.mark.parametrize(
+    "teams",
+    [
+        ["owners"],
+        ["owners", "administrators"],
+        ["members", "administrators", "owners"],
+        ["unknown", "owners"],
+    ],
+)
+def test_api_templates_retrieve_authenticated_related_team_owners(
+    teams, mock_user_teams
+):
+    """
+    Authenticated users should be allowed to retrieve a template to which they
+    are related via a team whatever the role and see all its accesses.
+    """
+    mock_user_teams.return_value = teams
+
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(is_public=False)
+
+    access_reader = factories.TeamTemplateAccessFactory(
+        template=template, team="readers", role="reader"
+    )
+    access_editor = factories.TeamTemplateAccessFactory(
+        template=template, team="editors", role="editor"
+    )
+    access_administrator = factories.TeamTemplateAccessFactory(
+        template=template, team="administrators", role="administrator"
+    )
+    access_owner = factories.TeamTemplateAccessFactory(
+        template=template, team="owners", role="owner"
+    )
+    other_access = factories.TeamTemplateAccessFactory(template=template)
+    factories.TeamTemplateAccessFactory()
+
+    response = client.get(f"/api/v1.0/templates/{template.id!s}/")
+
+    assert response.status_code == 200
+    content = response.json()
+    assert sorted(content.pop("accesses"), key=lambda x: x["id"]) == sorted(
+        [
+            {
+                "id": str(access_reader.id),
+                "user": None,
+                "team": "readers",
+                "role": "reader",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["owner", "administrator", "editor"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_editor.id),
+                "user": None,
+                "team": "editors",
+                "role": "editor",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["owner", "administrator", "reader"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_administrator.id),
+                "user": None,
+                "team": "administrators",
+                "role": "administrator",
+                "abilities": {
+                    "destroy": True,
+                    "retrieve": True,
+                    "set_role_to": ["owner", "editor", "reader"],
+                    "update": True,
+                    "partial_update": True,
+                },
+            },
+            {
+                "id": str(access_owner.id),
+                "user": None,
+                "team": "owners",
+                "role": "owner",
+                "abilities": {
+                    # editable only if there is another owner role than the user's team...
+                    "destroy": other_access.role == "owner",
+                    "retrieve": True,
+                    "set_role_to": ["administrator", "editor", "reader"]
+                    if other_access.role == "owner"
+                    else [],
+                    "update": other_access.role == "owner",
+                    "partial_update": other_access.role == "owner",
+                },
+            },
+            {
+                "id": str(other_access.id),
+                "user": None,
+                "team": other_access.team,
+                "role": other_access.role,
+                "abilities": other_access.get_abilities(user),
+            },
+        ],
+        key=lambda x: x["id"],
+    )
+    assert response.json() == {
+        "id": str(template.id),
+        "title": template.title,
+        "abilities": template.get_abilities(user),
+        "is_public": False,
+        "code": template.code,
+        "css": template.css,
+    }

src/backend/core/tests/templates/test_api_templates_update.py

@@ -0,0 +1,54 @@
+"""
+Tests for Templates API endpoint in impress's core app: update
+"""
+
+import pytest
+from rest_framework.test import APIClient
+
+from core import factories
+from core.api import serializers
+
+pytestmark = pytest.mark.django_db
+
+
+def test_api_templates_update_anonymous():
+    """Anonymous users should not be allowed to update a template."""
+    template = factories.TemplateFactory()
+
+    new_template_values = serializers.TemplateSerializer(
+        instance=factories.TemplateFactory()
+    ).data
+    response = APIClient().put(
+        f"/api/v1.0/templates/{template.id!s}/",
+        new_template_values,
+        format="json",
+    )
+    assert response.status_code == 401
+
+
+def test_api_templates_update_not_implemented():
+    """
+    Authenticated users should not be allowed to update a template.
+    """
+    user = factories.UserFactory()
+
+    client = APIClient()
+    client.force_login(user)
+
+    template = factories.TemplateFactory(users=[(user, "owner")])
+
+    new_template_values = serializers.TemplateSerializer(
+        instance=factories.TemplateFactory()
+    ).data
+
+    response = client.put(
+        f"/api/v1.0/templates/{template.id!s}/", new_template_values, format="json"
+    )
+
+    assert response.status_code == 405
+
+    response = client.patch(
+        f"/api/v1.0/templates/{template.id!s}/", new_template_values, format="json"
+    )
+
+    assert response.status_code == 405

src/backend/core/tests/test_api_config.py

@@ -19,10 +19,7 @@ pytestmark = pytest.mark.django_db
 
 
 @override_settings(
-    AI_BOT={"name": "Test Bot", "color": "#000000"},
     AI_FEATURE_ENABLED=False,
-    AI_MODEL="test-model",
-    AI_STREAM=False,
     COLLABORATION_WS_URL="http://testcollab/",
     COLLABORATION_WS_NOT_CONNECTED_READY_ONLY=True,
     CRISP_WEBSITE_ID="123",
@@ -46,15 +43,9 @@ def test_api_config(is_authenticated):
     response = client.get("/api/v1.0/config/")
     assert response.status_code == HTTP_200_OK
     assert response.json() == {
-        "AI_BOT": {"name": "Test Bot", "color": "#000000"},
         "AI_FEATURE_ENABLED": False,
-        "AI_MODEL": "test-model",
-        "AI_FEATURE_ENABLED": False,
-        "AI_STREAM": False,
         "COLLABORATION_WS_URL": "http://testcollab/",
         "COLLABORATION_WS_NOT_CONNECTED_READY_ONLY": True,
-        "CONVERSION_FILE_EXTENSIONS_ALLOWED": [".docx", ".md"],
-        "CONVERSION_FILE_MAX_SIZE": 20971520,
         "CRISP_WEBSITE_ID": "123",
         "ENVIRONMENT": "test",
         "FRONTEND_CSS_URL": "http://testcss/",

src/backend/core/tests/test_models_documents.py

@@ -155,7 +155,8 @@ def test_models_documents_get_abilities_forbidden(
     expected_abilities = {
         "accesses_manage": False,
         "accesses_view": False,
-        "ai_proxy": False,
+        "ai_transform": False,
+        "ai_translate": False,
         "attachment_upload": False,
         "can_edit": False,
         "children_create": False,
@@ -219,7 +220,8 @@ def test_models_documents_get_abilities_reader(
     expected_abilities = {
         "accesses_manage": False,
         "accesses_view": False,
-        "ai_proxy": False,
+        "ai_transform": False,
+        "ai_translate": False,
         "attachment_upload": False,
         "can_edit": False,
         "children_create": False,
@@ -355,7 +357,8 @@ def test_models_documents_get_abilities_editor(
     expected_abilities = {
         "accesses_manage": False,
         "accesses_view": False,
-        "ai_proxy": is_authenticated,
+        "ai_transform": is_authenticated,
+        "ai_translate": is_authenticated,
         "attachment_upload": True,
         "can_edit": True,
         "children_create": is_authenticated,
@@ -410,7 +413,8 @@ def test_models_documents_get_abilities_owner(django_assert_num_queries):
     expected_abilities = {
         "accesses_manage": True,
         "accesses_view": True,
-        "ai_proxy": True,
+        "ai_transform": True,
+        "ai_translate": True,
         "attachment_upload": True,
         "can_edit": True,
         "children_create": True,
@@ -497,7 +501,8 @@ def test_models_documents_get_abilities_administrator(django_assert_num_queries)
     expected_abilities = {
         "accesses_manage": True,
         "accesses_view": True,
-        "ai_proxy": True,
+        "ai_transform": True,
+        "ai_translate": True,
         "attachment_upload": True,
         "can_edit": True,
         "children_create": True,
@@ -552,7 +557,8 @@ def test_models_documents_get_abilities_editor_user(django_assert_num_queries):
     expected_abilities = {
         "accesses_manage": False,
         "accesses_view": True,
-        "ai_proxy": True,
+        "ai_transform": True,
+        "ai_translate": True,
         "attachment_upload": True,
         "can_edit": True,
         "children_create": True,
@@ -614,7 +620,8 @@ def test_models_documents_get_abilities_reader_user(
         "accesses_view": True,
         # If you get your editor rights from the link role and not your access role
         # You should not access AI if it's restricted to users with specific access
-        "ai_proxy": access_from_link and ai_access_setting != "restricted",
+        "ai_transform": access_from_link and ai_access_setting != "restricted",
+        "ai_translate": access_from_link and ai_access_setting != "restricted",
         "attachment_upload": access_from_link,
         "can_edit": access_from_link,
         "children_create": access_from_link,
@@ -740,7 +747,8 @@ def test_models_documents_get_abilities_preset_role(django_assert_num_queries):
     assert abilities == {
         "accesses_manage": False,
         "accesses_view": True,
-        "ai_proxy": False,
+        "ai_transform": False,
+        "ai_translate": False,
         "attachment_upload": False,
         "can_edit": False,
         "children_create": False,
@@ -870,7 +878,8 @@ def test_models_document_get_abilities_ai_access_authenticated(is_authenticated,
     document = factories.DocumentFactory(link_reach=reach, link_role="editor")
 
     abilities = document.get_abilities(user)
-    assert abilities["ai_proxy"] is True
+    assert abilities["ai_transform"] is True
+    assert abilities["ai_translate"] is True
 
 
 @override_settings(AI_ALLOW_REACH_FROM="authenticated")
@@ -888,7 +897,8 @@ def test_models_document_get_abilities_ai_access_public(is_authenticated, reach)
     document = factories.DocumentFactory(link_reach=reach, link_role="editor")
 
     abilities = document.get_abilities(user)
-    assert abilities["ai_proxy"] == is_authenticated
+    assert abilities["ai_transform"] == is_authenticated
+    assert abilities["ai_translate"] == is_authenticated
 
 
 def test_models_documents_get_versions_slice_pagination(settings):
@@ -1014,39 +1024,6 @@ 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/core/tests/test_models_template_accesses.py

@@ -0,0 +1,419 @@
+"""
+Unit tests for the TemplateAccess model
+"""
+
+from django.contrib.auth.models import AnonymousUser
+from django.core.exceptions import ValidationError
+
+import pytest
+
+from core import factories
+
+pytestmark = pytest.mark.django_db
+
+
+def test_models_template_accesses_str():
+    """
+    The str representation should include user email, template title and role.
+    """
+    user = factories.UserFactory(email="david.bowman@example.com")
+    access = factories.UserTemplateAccessFactory(
+        role="reader",
+        user=user,
+        template__title="admins",
+    )
+    assert str(access) == "david.bowman@example.com is reader in template admins"
+
+
+def test_models_template_accesses_unique_user():
+    """Template accesses should be unique for a given couple of user and template."""
+    access = factories.UserTemplateAccessFactory()
+
+    with pytest.raises(
+        ValidationError,
+        match="This user is already in this template.",
+    ):
+        factories.UserTemplateAccessFactory(user=access.user, template=access.template)
+
+
+def test_models_template_accesses_several_empty_teams():
+    """A template can have several template accesses with an empty team."""
+    access = factories.UserTemplateAccessFactory()
+    factories.UserTemplateAccessFactory(template=access.template)
+
+
+def test_models_template_accesses_unique_team():
+    """Template accesses should be unique for a given couple of team and template."""
+    access = factories.TeamTemplateAccessFactory()
+
+    with pytest.raises(
+        ValidationError,
+        match="This team is already in this template.",
+    ):
+        factories.TeamTemplateAccessFactory(team=access.team, template=access.template)
+
+
+def test_models_template_accesses_several_null_users():
+    """A template can have several template accesses with a null user."""
+    access = factories.TeamTemplateAccessFactory()
+    factories.TeamTemplateAccessFactory(template=access.template)
+
+
+def test_models_template_accesses_user_and_team_set():
+    """User and team can't both be set on a template access."""
+    with pytest.raises(
+        ValidationError,
+        match="Either user or team must be set, not both.",
+    ):
+        factories.UserTemplateAccessFactory(team="my-team")
+
+
+def test_models_template_accesses_user_and_team_empty():
+    """User and team can't both be empty on a template access."""
+    with pytest.raises(
+        ValidationError,
+        match="Either user or team must be set, not both.",
+    ):
+        factories.UserTemplateAccessFactory(user=None)
+
+
+# get_abilities
+
+
+def test_models_template_access_get_abilities_anonymous():
+    """Check abilities returned for an anonymous user."""
+    access = factories.UserTemplateAccessFactory()
+    abilities = access.get_abilities(AnonymousUser())
+    assert abilities == {
+        "destroy": False,
+        "retrieve": False,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_authenticated():
+    """Check abilities returned for an authenticated user."""
+    access = factories.UserTemplateAccessFactory()
+    user = factories.UserFactory()
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": False,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+# - for owner
+
+
+def test_models_template_access_get_abilities_for_owner_of_self_allowed():
+    """
+    Check abilities of self access for the owner of a template when
+    there is more than one owner left.
+    """
+    access = factories.UserTemplateAccessFactory(role="owner")
+    factories.UserTemplateAccessFactory(template=access.template, role="owner")
+    abilities = access.get_abilities(access.user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["administrator", "editor", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_owner_of_self_last():
+    """
+    Check abilities of self access for the owner of a template when there is only one owner left.
+    """
+    access = factories.UserTemplateAccessFactory(role="owner")
+    abilities = access.get_abilities(access.user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_owner_of_owner():
+    """Check abilities of owner access for the owner of a template."""
+    access = factories.UserTemplateAccessFactory(role="owner")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="owner"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["administrator", "editor", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_owner_of_administrator():
+    """Check abilities of administrator access for the owner of a template."""
+    access = factories.UserTemplateAccessFactory(role="administrator")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="owner"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["owner", "editor", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_owner_of_editor():
+    """Check abilities of editor access for the owner of a template."""
+    access = factories.UserTemplateAccessFactory(role="editor")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="owner"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["owner", "administrator", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_owner_of_reader():
+    """Check abilities of reader access for the owner of a template."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="owner"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["owner", "administrator", "editor"],
+    }
+
+
+# - for administrator
+
+
+def test_models_template_access_get_abilities_for_administrator_of_owner():
+    """Check abilities of owner access for the administrator of a template."""
+    access = factories.UserTemplateAccessFactory(role="owner")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="administrator"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_administrator_of_administrator():
+    """Check abilities of administrator access for the administrator of a template."""
+    access = factories.UserTemplateAccessFactory(role="administrator")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="administrator"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["editor", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_administrator_of_editor():
+    """Check abilities of editor access for the administrator of a template."""
+    access = factories.UserTemplateAccessFactory(role="editor")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="administrator"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["administrator", "reader"],
+    }
+
+
+def test_models_template_access_get_abilities_for_administrator_of_reader():
+    """Check abilities of reader access for the administrator of a template."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="administrator"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "partial_update": True,
+        "set_role_to": ["administrator", "editor"],
+    }
+
+
+# - For editor
+
+
+def test_models_template_access_get_abilities_for_editor_of_owner():
+    """Check abilities of owner access for the editor of a template."""
+    access = factories.UserTemplateAccessFactory(role="owner")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="editor"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_editor_of_administrator():
+    """Check abilities of administrator access for the editor of a template."""
+    access = factories.UserTemplateAccessFactory(role="administrator")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="editor"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_editor_of_editor_user(
+    django_assert_num_queries,
+):
+    """Check abilities of editor access for the editor of a template."""
+    access = factories.UserTemplateAccessFactory(role="editor")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="editor"
+    ).user
+
+    with django_assert_num_queries(1):
+        abilities = access.get_abilities(user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+# - For reader
+
+
+def test_models_template_access_get_abilities_for_reader_of_owner():
+    """Check abilities of owner access for the reader of a template."""
+    access = factories.UserTemplateAccessFactory(role="owner")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="reader"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_reader_of_administrator():
+    """Check abilities of administrator access for the reader of a template."""
+    access = factories.UserTemplateAccessFactory(role="administrator")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="reader"
+    ).user
+    abilities = access.get_abilities(user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_for_reader_of_reader_user(
+    django_assert_num_queries,
+):
+    """Check abilities of reader access for the reader of a template."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+    factories.UserTemplateAccessFactory(template=access.template)  # another one
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="reader"
+    ).user
+
+    with django_assert_num_queries(1):
+        abilities = access.get_abilities(user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }
+
+
+def test_models_template_access_get_abilities_preset_role(django_assert_num_queries):
+    """No query is done if the role is preset, e.g., with a query annotation."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+    user = factories.UserTemplateAccessFactory(
+        template=access.template, role="reader"
+    ).user
+    access.user_roles = ["reader"]
+
+    with django_assert_num_queries(0):
+        abilities = access.get_abilities(user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "partial_update": False,
+        "set_role_to": [],
+    }

src/backend/core/tests/test_models_templates.py

@@ -0,0 +1,187 @@
+"""
+Unit tests for the Template model
+"""
+
+from django.contrib.auth.models import AnonymousUser
+from django.core.exceptions import ValidationError
+
+import pytest
+
+from core import factories, models
+
+pytestmark = pytest.mark.django_db
+
+
+def test_models_templates_str():
+    """The str representation should be the title of the template."""
+    template = factories.TemplateFactory(title="admins")
+    assert str(template) == "admins"
+
+
+def test_models_templates_id_unique():
+    """The "id" field should be unique."""
+    template = factories.TemplateFactory()
+    with pytest.raises(ValidationError, match="Template with this Id already exists."):
+        factories.TemplateFactory(id=template.id)
+
+
+def test_models_templates_title_null():
+    """The "title" field should not be null."""
+    with pytest.raises(ValidationError, match="This field cannot be null."):
+        models.Template.objects.create(title=None)
+
+
+def test_models_templates_title_empty():
+    """The "title" field should not be empty."""
+    with pytest.raises(ValidationError, match="This field cannot be blank."):
+        models.Template.objects.create(title="")
+
+
+def test_models_templates_title_max_length():
+    """The "title" field should be 100 characters maximum."""
+    factories.TemplateFactory(title="a" * 255)
+    with pytest.raises(
+        ValidationError,
+        match=r"Ensure this value has at most 255 characters \(it has 256\)\.",
+    ):
+        factories.TemplateFactory(title="a" * 256)
+
+
+# get_abilities
+
+
+def test_models_templates_get_abilities_anonymous_public():
+    """Check abilities returned for an anonymous user if the template is public."""
+    template = factories.TemplateFactory(is_public=True)
+    abilities = template.get_abilities(AnonymousUser())
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_anonymous_not_public():
+    """Check abilities returned for an anonymous user if the template is private."""
+    template = factories.TemplateFactory(is_public=False)
+    abilities = template.get_abilities(AnonymousUser())
+    assert abilities == {
+        "destroy": False,
+        "retrieve": False,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": False,
+    }
+
+
+def test_models_templates_get_abilities_authenticated_public():
+    """Check abilities returned for an authenticated user if the user is public."""
+    template = factories.TemplateFactory(is_public=True)
+    abilities = template.get_abilities(factories.UserFactory())
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_authenticated_not_public():
+    """Check abilities returned for an authenticated user if the template is private."""
+    template = factories.TemplateFactory(is_public=False)
+    abilities = template.get_abilities(factories.UserFactory())
+    assert abilities == {
+        "destroy": False,
+        "retrieve": False,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": False,
+    }
+
+
+def test_models_templates_get_abilities_owner():
+    """Check abilities returned for the owner of a template."""
+    user = factories.UserFactory()
+    access = factories.UserTemplateAccessFactory(role="owner", user=user)
+    abilities = access.template.get_abilities(access.user)
+    assert abilities == {
+        "destroy": True,
+        "retrieve": True,
+        "update": True,
+        "accesses_manage": True,
+        "partial_update": True,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_administrator():
+    """Check abilities returned for the administrator of a template."""
+    access = factories.UserTemplateAccessFactory(role="administrator")
+    abilities = access.template.get_abilities(access.user)
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": True,
+        "accesses_manage": True,
+        "partial_update": True,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_editor_user(django_assert_num_queries):
+    """Check abilities returned for the editor of a template."""
+    access = factories.UserTemplateAccessFactory(role="editor")
+
+    with django_assert_num_queries(1):
+        abilities = access.template.get_abilities(access.user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": True,
+        "accesses_manage": False,
+        "partial_update": True,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_reader_user(django_assert_num_queries):
+    """Check abilities returned for the reader of a template."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+
+    with django_assert_num_queries(1):
+        abilities = access.template.get_abilities(access.user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": True,
+    }
+
+
+def test_models_templates_get_abilities_preset_role(django_assert_num_queries):
+    """No query is done if the role is preset e.g. with query annotation."""
+    access = factories.UserTemplateAccessFactory(role="reader")
+    access.template.user_roles = ["reader"]
+
+    with django_assert_num_queries(0):
+        abilities = access.template.get_abilities(access.user)
+
+    assert abilities == {
+        "destroy": False,
+        "retrieve": True,
+        "update": False,
+        "accesses_manage": False,
+        "partial_update": False,
+        "generate_document": True,
+    }

src/backend/core/tests/test_services_ai_services.py

@@ -2,9 +2,10 @@
 Test ai API endpoints in the impress core app.
 """
 
-from unittest.mock import patch
+from unittest.mock import MagicMock, patch
 
 from django.core.exceptions import ImproperlyConfigured
+from django.test.utils import override_settings
 
 import pytest
 from openai import OpenAIError
@@ -14,15 +15,6 @@ from core.services.ai_services import AIService
 pytestmark = pytest.mark.django_db
 
 
-@pytest.fixture(autouse=True)
-def ai_settings(settings):
-    """Fixture to set AI settings."""
-    settings.AI_MODEL = "llama"
-    settings.AI_BASE_URL = "http://example.com"
-    settings.AI_API_KEY = "test-key"
-    settings.AI_FEATURE_ENABLED = True
-
-
 @pytest.mark.parametrize(
     "setting_name, setting_value",
     [
@@ -31,105 +23,62 @@ def ai_settings(settings):
         ("AI_MODEL", None),
     ],
 )
-def test_services_ai_setting_missing(setting_name, setting_value, settings):
+def test_api_ai_setting_missing(setting_name, setting_value):
     """Setting should be set"""
-    setattr(settings, setting_name, setting_value)
 
-    with pytest.raises(
-        ImproperlyConfigured,
-        match="AI configuration not set",
-    ):
-        AIService()
+    with override_settings(**{setting_name: setting_value}):
+        with pytest.raises(
+            ImproperlyConfigured,
+            match="AI configuration not set",
+        ):
+            AIService()
 
 
+@override_settings(
+    AI_BASE_URL="http://example.com", AI_API_KEY="test-key", AI_MODEL="test-model"
+)
 @patch("openai.resources.chat.completions.Completions.create")
-def test_services_ai_proxy_client_error(mock_create):
+def test_api_ai__client_error(mock_create):
     """Fail when the client raises an error"""
 
     mock_create.side_effect = OpenAIError("Mocked client error")
 
     with pytest.raises(
-        RuntimeError,
-        match="Failed to proxy AI request: Mocked client error",
+        OpenAIError,
+        match="Mocked client error",
     ):
-        AIService().proxy({"messages": [{"role": "user", "content": "hello"}]})
+        AIService().transform("hello", "prompt")
 
 
+@override_settings(
+    AI_BASE_URL="http://example.com", AI_API_KEY="test-key", AI_MODEL="test-model"
+)
 @patch("openai.resources.chat.completions.Completions.create")
-def test_services_ai_proxy_success(mock_create):
+def test_api_ai__client_invalid_response(mock_create):
+    """Fail when the client response is invalid"""
+
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content=None))]
+    )
+
+    with pytest.raises(
+        RuntimeError,
+        match="AI response does not contain an answer",
+    ):
+        AIService().transform("hello", "prompt")
+
+
+@override_settings(
+    AI_BASE_URL="http://example.com", AI_API_KEY="test-key", AI_MODEL="test-model"
+)
+@patch("openai.resources.chat.completions.Completions.create")
+def test_api_ai__success(mock_create):
     """The AI request should work as expect when called with valid arguments."""
 
-    mock_create.return_value = {
-        "id": "chatcmpl-test",
-        "object": "chat.completion",
-        "created": 1234567890,
-        "model": "test-model",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Salut"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-
-    response = AIService().proxy({"messages": [{"role": "user", "content": "hello"}]})
-
-    expected_response = {
-        "id": "chatcmpl-test",
-        "object": "chat.completion",
-        "created": 1234567890,
-        "model": "test-model",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Salut"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-    assert response == expected_response
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "hello"}], stream=False
+    mock_create.return_value = MagicMock(
+        choices=[MagicMock(message=MagicMock(content="Salut"))]
     )
 
+    response = AIService().transform("hello", "prompt")
 
-@patch("openai.resources.chat.completions.Completions.create")
-def test_services_ai_proxy_with_stream(mock_create):
-    """The AI request should work as expect when called with valid arguments."""
-
-    mock_create.return_value = {
-        "id": "chatcmpl-test",
-        "object": "chat.completion",
-        "created": 1234567890,
-        "model": "test-model",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Salut"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-
-    response = AIService().proxy(
-        {"messages": [{"role": "user", "content": "hello"}]}, stream=True
-    )
-
-    expected_response = {
-        "id": "chatcmpl-test",
-        "object": "chat.completion",
-        "created": 1234567890,
-        "model": "test-model",
-        "choices": [
-            {
-                "index": 0,
-                "message": {"role": "assistant", "content": "Salut"},
-                "finish_reason": "stop",
-            }
-        ],
-    }
-    assert response == expected_response
-    mock_create.assert_called_once_with(
-        messages=[{"role": "user", "content": "hello"}], stream=True
-    )
+    assert response == {"answer": "Salut"}

src/backend/core/tests/test_services_converter_orchestration.py

@@ -1,93 +0,0 @@
-"""Test Converter orchestration services."""
-
-from unittest.mock import MagicMock, patch
-
-from core.services import mime_types
-from core.services.converter_services import Converter
-
-
-@patch("core.services.converter_services.DocSpecConverter")
-@patch("core.services.converter_services.YdocConverter")
-def test_converter_docx_to_yjs_orchestration(mock_ydoc_class, mock_docspec_class):
-    """Test that DOCX to YJS conversion uses both DocSpec and Ydoc converters."""
-    # Setup mocks
-    mock_docspec = MagicMock()
-    mock_ydoc = MagicMock()
-    mock_docspec_class.return_value = mock_docspec
-    mock_ydoc_class.return_value = mock_ydoc
-
-    # Mock the conversion chain: DOCX -> BlockNote -> YJS
-    blocknote_data = b'[{"type": "paragraph", "content": "test"}]'
-    yjs_data = "base64encodedyjs"
-
-    mock_docspec.convert.return_value = blocknote_data
-    mock_ydoc.convert.return_value = yjs_data
-
-    # Execute conversion
-    converter = Converter()
-    docx_data = b"fake docx data"
-    result = converter.convert(docx_data, mime_types.DOCX, mime_types.YJS)
-
-    # Verify the orchestration
-    mock_docspec.convert.assert_called_once_with(
-        docx_data, mime_types.DOCX, mime_types.BLOCKNOTE
-    )
-    mock_ydoc.convert.assert_called_once_with(
-        blocknote_data, mime_types.BLOCKNOTE, mime_types.YJS
-    )
-    assert result == yjs_data
-
-
-@patch("core.services.converter_services.YdocConverter")
-def test_converter_markdown_to_yjs_delegation(mock_ydoc_class):
-    """Test that Markdown to YJS conversion is delegated to YdocConverter."""
-    mock_ydoc = MagicMock()
-    mock_ydoc_class.return_value = mock_ydoc
-
-    yjs_data = "base64encodedyjs"
-    mock_ydoc.convert.return_value = yjs_data
-
-    converter = Converter()
-    markdown_data = "# Test Document"
-    result = converter.convert(markdown_data, mime_types.MARKDOWN, mime_types.YJS)
-
-    mock_ydoc.convert.assert_called_once_with(
-        markdown_data, mime_types.MARKDOWN, mime_types.YJS
-    )
-    assert result == yjs_data
-
-
-@patch("core.services.converter_services.YdocConverter")
-def test_converter_yjs_to_html_delegation(mock_ydoc_class):
-    """Test that YJS to HTML conversion is delegated to YdocConverter."""
-    mock_ydoc = MagicMock()
-    mock_ydoc_class.return_value = mock_ydoc
-
-    html_data = "<p>Test Document</p>"
-    mock_ydoc.convert.return_value = html_data
-
-    converter = Converter()
-    yjs_data = b"yjs binary data"
-    result = converter.convert(yjs_data, mime_types.YJS, mime_types.HTML)
-
-    mock_ydoc.convert.assert_called_once_with(yjs_data, mime_types.YJS, mime_types.HTML)
-    assert result == html_data
-
-
-@patch("core.services.converter_services.YdocConverter")
-def test_converter_blocknote_to_yjs_delegation(mock_ydoc_class):
-    """Test that BlockNote to YJS conversion is delegated to YdocConverter."""
-    mock_ydoc = MagicMock()
-    mock_ydoc_class.return_value = mock_ydoc
-
-    yjs_data = "base64encodedyjs"
-    mock_ydoc.convert.return_value = yjs_data
-
-    converter = Converter()
-    blocknote_data = b'[{"type": "paragraph"}]'
-    result = converter.convert(blocknote_data, mime_types.BLOCKNOTE, mime_types.YJS)
-
-    mock_ydoc.convert.assert_called_once_with(
-        blocknote_data, mime_types.BLOCKNOTE, mime_types.YJS
-    )
-    assert result == yjs_data

src/backend/core/tests/test_services_converter_services.py

@@ -6,7 +6,6 @@ from unittest.mock import MagicMock, patch
 import pytest
 import requests
 
-from core.services import mime_types
 from core.services.converter_services import (
     ServiceUnavailableError,
     ValidationError,
@@ -22,9 +21,9 @@ def test_auth_header(settings):
 
 
 def test_convert_empty_text():
-    """Should raise ValidationError when data is empty."""
+    """Should raise ValidationError when text is empty."""
     converter = YdocConverter()
-    with pytest.raises(ValidationError, match="Input data cannot be empty"):
+    with pytest.raises(ValidationError, match="Input text cannot be empty"):
         converter.convert("")
 
 
@@ -37,7 +36,7 @@ def test_convert_service_unavailable(mock_post):
 
     with pytest.raises(
         ServiceUnavailableError,
-        match="Failed to connect to YDoc conversion service",
+        match="Failed to connect to conversion service",
     ):
         converter.convert("test text")
 
@@ -53,7 +52,7 @@ def test_convert_http_error(mock_post):
 
     with pytest.raises(
         ServiceUnavailableError,
-        match="Failed to connect to YDoc conversion service",
+        match="Failed to connect to conversion service",
     ):
         converter.convert("test text")
 
@@ -84,8 +83,8 @@ def test_convert_full_integration(mock_post, settings):
         data="test markdown",
         headers={
             "Authorization": "Bearer test-key",
-            "Content-Type": mime_types.MARKDOWN,
-            "Accept": mime_types.YJS,
+            "Content-Type": "text/markdown",
+            "Accept": "application/vnd.yjs.doc",
         },
         timeout=5,
         verify=False,
@@ -109,7 +108,9 @@ def test_convert_full_integration_with_specific_headers(mock_post, settings):
     mock_response.raise_for_status.return_value = None
     mock_post.return_value = mock_response
 
-    result = converter.convert(b"test_content", mime_types.YJS, mime_types.MARKDOWN)
+    result = converter.convert(
+        b"test_content", "application/vnd.yjs.doc", "text/markdown"
+    )
 
     assert result == expected_response
     mock_post.assert_called_once_with(
@@ -117,8 +118,8 @@ def test_convert_full_integration_with_specific_headers(mock_post, settings):
         data=b"test_content",
         headers={
             "Authorization": "Bearer test-key",
-            "Content-Type": mime_types.YJS,
-            "Accept": mime_types.MARKDOWN,
+            "Content-Type": "application/vnd.yjs.doc",
+            "Accept": "text/markdown",
         },
         timeout=5,
         verify=False,
@@ -134,7 +135,7 @@ def test_convert_timeout(mock_post):
 
     with pytest.raises(
         ServiceUnavailableError,
-        match="Failed to connect to YDoc conversion service",
+        match="Failed to connect to conversion service",
     ):
         converter.convert("test text")
 
@@ -143,5 +144,5 @@ def test_convert_none_input():
     """Should raise ValidationError when input is None."""
     converter = YdocConverter()
 
-    with pytest.raises(ValidationError, match="Input data cannot be empty"):
+    with pytest.raises(ValidationError, match="Input text cannot be empty"):
         converter.convert(None)

src/backend/core/tests/test_services_docspec_converter.py

@@ -1,117 +0,0 @@
-"""Test DocSpec converter services."""
-
-from unittest.mock import MagicMock, patch
-
-import pytest
-import requests
-
-from core.services import mime_types
-from core.services.converter_services import (
-    DocSpecConverter,
-    ServiceUnavailableError,
-    ValidationError,
-)
-
-
-def test_docspec_convert_empty_data():
-    """Should raise ValidationError when data is empty."""
-    converter = DocSpecConverter()
-    with pytest.raises(ValidationError, match="Input data cannot be empty"):
-        converter.convert("", mime_types.DOCX, mime_types.BLOCKNOTE)
-
-
-def test_docspec_convert_none_input():
-    """Should raise ValidationError when input is None."""
-    converter = DocSpecConverter()
-    with pytest.raises(ValidationError, match="Input data cannot be empty"):
-        converter.convert(None, mime_types.DOCX, mime_types.BLOCKNOTE)
-
-
-def test_docspec_convert_unsupported_content_type():
-    """Should raise ValidationError when content type is not DOCX."""
-    converter = DocSpecConverter()
-    with pytest.raises(
-        ValidationError, match="Conversion from text/plain to .* is not supported"
-    ):
-        converter.convert(b"test data", "text/plain", mime_types.BLOCKNOTE)
-
-
-def test_docspec_convert_unsupported_accept():
-    """Should raise ValidationError when accept type is not BLOCKNOTE."""
-    converter = DocSpecConverter()
-    with pytest.raises(
-        ValidationError,
-        match=f"Conversion from {mime_types.DOCX} to {mime_types.YJS} is not supported",
-    ):
-        converter.convert(b"test data", mime_types.DOCX, mime_types.YJS)
-
-
-@patch("requests.post")
-def test_docspec_convert_service_unavailable(mock_post):
-    """Should raise ServiceUnavailableError when service is unavailable."""
-    converter = DocSpecConverter()
-    mock_post.side_effect = requests.RequestException("Connection error")
-
-    with pytest.raises(
-        ServiceUnavailableError,
-        match="Failed to connect to DocSpec conversion service",
-    ):
-        converter.convert(b"test data", mime_types.DOCX, mime_types.BLOCKNOTE)
-
-
-@patch("requests.post")
-def test_docspec_convert_http_error(mock_post):
-    """Should raise ServiceUnavailableError when HTTP error occurs."""
-    converter = DocSpecConverter()
-    mock_response = MagicMock()
-    mock_response.raise_for_status.side_effect = requests.HTTPError("HTTP Error")
-    mock_post.return_value = mock_response
-
-    with pytest.raises(
-        ServiceUnavailableError,
-        match="Failed to connect to DocSpec conversion service",
-    ):
-        converter.convert(b"test data", mime_types.DOCX, mime_types.BLOCKNOTE)
-
-
-@patch("requests.post")
-def test_docspec_convert_timeout(mock_post):
-    """Should raise ServiceUnavailableError when request times out."""
-    converter = DocSpecConverter()
-    mock_post.side_effect = requests.Timeout("Request timed out")
-
-    with pytest.raises(
-        ServiceUnavailableError,
-        match="Failed to connect to DocSpec conversion service",
-    ):
-        converter.convert(b"test data", mime_types.DOCX, mime_types.BLOCKNOTE)
-
-
-@patch("requests.post")
-def test_docspec_convert_success(mock_post, settings):
-    """Test successful DOCX to BlockNote conversion."""
-    settings.DOCSPEC_API_URL = "http://docspec.test/convert"
-    settings.CONVERSION_API_TIMEOUT = 5
-    settings.CONVERSION_API_SECURE = False
-
-    converter = DocSpecConverter()
-
-    expected_content = b'[{"type": "paragraph", "content": "test"}]'
-    mock_response = MagicMock()
-    mock_response.content = expected_content
-    mock_response.raise_for_status.return_value = None
-    mock_post.return_value = mock_response
-
-    docx_data = b"fake docx binary data"
-    result = converter.convert(docx_data, mime_types.DOCX, mime_types.BLOCKNOTE)
-
-    assert result == expected_content
-
-    # Verify the request was made correctly
-    mock_post.assert_called_once_with(
-        "http://docspec.test/convert",
-        headers={"Accept": mime_types.BLOCKNOTE},
-        files={"file": ("document.docx", docx_data, mime_types.DOCX)},
-        timeout=5,
-        verify=False,
-    )

src/backend/core/urls.py

@@ -10,6 +10,7 @@ from core.api import viewsets
 
 # - Main endpoints
 router = DefaultRouter()
+router.register("templates", viewsets.TemplateViewSet, basename="templates")
 router.register("documents", viewsets.DocumentViewSet, basename="documents")
 router.register("users", viewsets.UserViewSet, basename="users")
 

src/backend/demo/data/template/code.txt

@@ -0,0 +1,2 @@
+<img width="200" src="http://localhost:3000/assets/logo-gouv.png" />
+<br/>

src/backend/demo/management/commands/create_demo.py

@@ -216,6 +216,29 @@ def create_demo(stdout):
 
         queue.flush()
 
+    with Timeit(stdout, "Creating Template"):
+        with open(
+            file="demo/data/template/code.txt", mode="r", encoding="utf-8"
+        ) as text_file:
+            code_data = text_file.read()
+
+        with open(
+            file="demo/data/template/css.txt", mode="r", encoding="utf-8"
+        ) as text_file:
+            css_data = text_file.read()
+
+        queue.push(
+            models.Template(
+                id="baca9e2a-59fb-42ef-b5c6-6f6b05637111",
+                title="Demo Template",
+                description="This is the demo template",
+                code=code_data,
+                css=css_data,
+                is_public=True,
+            )
+        )
+        queue.flush()
+
 
 class Command(BaseCommand):
     """A management command to create a demo database."""

src/backend/demo/tests/test_commands_create_demo.py

@@ -25,6 +25,7 @@ def test_commands_create_demo():
     """The create_demo management command should create objects as expected."""
     call_command("create_demo")
 
+    assert models.Template.objects.count() == 1
     assert models.User.objects.count() >= 10
     assert models.Document.objects.count() >= 10
     assert models.DocumentAccess.objects.count() > 10

src/backend/impress/settings.py

@@ -29,10 +29,6 @@ from sentry_sdk.integrations.logging import ignore_logger
 BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 DATA_DIR = os.getenv("DATA_DIR", os.path.join("/", "data"))
 
-KB = 1024
-MB = KB * KB
-GB = MB * KB
-
 
 def get_release():
     """
@@ -172,7 +168,7 @@ class Base(Configuration):
 
     # Document images
     DOCUMENT_IMAGE_MAX_SIZE = values.IntegerValue(
-        10 * MB,  # 10MB
+        10 * (2**20),  # 10MB
         environ_name="DOCUMENT_IMAGE_MAX_SIZE",
         environ_prefix=None,
     )
@@ -410,6 +406,16 @@ class Base(Configuration):
                 environ_name="API_DOCUMENT_ACCESS_THROTTLE_RATE",
                 environ_prefix=None,
             ),
+            "template": values.Value(
+                default="30/minute",
+                environ_name="API_TEMPLATE_THROTTLE_RATE",
+                environ_prefix=None,
+            ),
+            "template_access": values.Value(
+                default="30/minute",
+                environ_name="API_TEMPLATE_ACCESS_THROTTLE_RATE",
+                environ_prefix=None,
+            ),
             "invitation": values.Value(
                 default="60/minute",
                 environ_name="API_INVITATION_THROTTLE_RATE",
@@ -459,7 +465,6 @@ 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")
@@ -670,35 +675,24 @@ class Base(Configuration):
         default=True, environ_name="ALLOW_LOGOUT_GET_METHOD", environ_prefix=None
     )
 
-    # AI settings
+    # AI service
+    AI_FEATURE_ENABLED = values.BooleanValue(
+        default=False, environ_name="AI_FEATURE_ENABLED", environ_prefix=None
+    )
+    AI_API_KEY = SecretFileValue(None, environ_name="AI_API_KEY", environ_prefix=None)
+    AI_BASE_URL = values.Value(None, environ_name="AI_BASE_URL", environ_prefix=None)
+    AI_MODEL = values.Value(None, environ_name="AI_MODEL", environ_prefix=None)
     AI_ALLOW_REACH_FROM = values.Value(
         choices=("public", "authenticated", "restricted"),
         default="authenticated",
         environ_name="AI_ALLOW_REACH_FROM",
         environ_prefix=None,
     )
-    AI_API_KEY = SecretFileValue(None, environ_name="AI_API_KEY", environ_prefix=None)
-    AI_BASE_URL = values.Value(None, environ_name="AI_BASE_URL", environ_prefix=None)
-    AI_BOT = values.DictValue(
-        default={
-            "name": _("Docs AI"),
-            "color": "#8bc6ff",
-        },
-        environ_name="AI_BOT",
-        environ_prefix=None,
-    )
     AI_DOCUMENT_RATE_THROTTLE_RATES = {
         "minute": 5,
         "hour": 100,
         "day": 500,
     }
-    AI_FEATURE_ENABLED = values.BooleanValue(
-        default=False, environ_name="AI_FEATURE_ENABLED", environ_prefix=None
-    )
-    AI_MODEL = values.Value(None, environ_name="AI_MODEL", environ_prefix=None)
-    AI_STREAM = values.BooleanValue(
-        default=False, environ_name="AI_STREAM", environ_prefix=None
-    )
     AI_USER_RATE_THROTTLE_RATES = {
         "minute": 3,
         "hour": 50,
@@ -725,22 +719,6 @@ class Base(Configuration):
         environ_prefix=None,
     )
 
-    # DocSpec API microservice
-    DOCSPEC_API_URL = values.Value(environ_name="DOCSPEC_API_URL", environ_prefix=None)
-
-    # Imported file settings
-    CONVERSION_FILE_MAX_SIZE = values.IntegerValue(
-        20 * MB,  # 10MB
-        environ_name="CONVERSION_FILE_MAX_SIZE",
-        environ_prefix=None,
-    )
-
-    CONVERSION_FILE_EXTENSIONS_ALLOWED = values.ListValue(
-        default=[".docx", ".md"],
-        environ_name="CONVERSION_FILE_EXTENSIONS_ALLOWED",
-        environ_prefix=None,
-    )
-
     # Conversion endpoint
     CONVERSION_API_ENDPOINT = values.Value(
         default="convert",
@@ -1086,9 +1064,6 @@ class Production(Base):
     # Privacy
     SECURE_REFERRER_POLICY = "same-origin"
 
-    # Conversion API: Always verify SSL in production
-    CONVERSION_API_SECURE = True
-
     CACHES = {
         "default": {
             "BACKEND": "django_redis.cache.RedisCache",

src/backend/pyproject.toml

@@ -19,7 +19,7 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
 ]
-description = "Docs is a collaborative text editor designed to address common challenges in knowledge building and sharing."
+description = "An application to print markdown to pdf from a set of managed templates."
 keywords = ["Django", "Contacts", "Templates", "RBAC"]
 license = { file = "LICENSE" }
 readme = "README.md"

src/frontend/apps/e2e/.gitignore

@@ -1,6 +1,6 @@
 # e2e
 test-results/
-report*/
+report/
 blob-report/
 playwright/.auth/
 playwright/.cache/

src/frontend/apps/e2e/__tests__/app-impress/assets/test_import.md

@@ -1,60 +0,0 @@
-![473389927-e4ff1794-69f3-460a-85f8-fec993cd74d6.png](http://localhost:3000/assets/logo-suite-numerique.png)![497094770-53e5f8e2-c93e-4a0b-a82f-cd184fd03f51.svg](http://localhost:3000/assets/icon-docs.svg)
-
-# Lorem Ipsum import Document
-
-## Introduction
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam auctor, nisl eget ultricies tincidunt, nisl nisl aliquam nisl, eget ultricies nisl nisl eget nisl.
-
-### Subsection 1.1
-
-* **Bold text**: Lorem ipsum dolor sit amet.
-
-* *Italic text*: Consectetur adipiscing elit.
-
-* ~~Strikethrough text~~: Nullam auctor, nisl eget ultricies tincidunt.
-
-1. First item in an ordered list.
-
-2. Second item in an ordered list.
-
-   * Indented bullet point.
-
-   * Another indented bullet point.
-
-3. Third item in an ordered list.
-
-### Subsection 1.2
-
-**Code block:**
-
-```js
-const hello_world = () => {
-    console.log("Hello, world!");
-}
-```
-
-**Blockquote:**
-
-> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam auctor, nisl eget ultricies tincidunt.
-
-**Horizontal rule:**
-
-***
-
-**Table:**
-
-| Syntax    | Description |
-| --------- | ----------- |
-| Header    | Title       |
-| Paragraph | Text        |
-
-**Inline code:**
-
-Use the `printf()` function.
-
-**Link:** [Example](http://localhost:3000/)
-
-## Conclusion
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam auctor, nisl eget ultricies tincidunt, nisl nisl aliquam nisl, eget ultricies nisl nisl eget nisl.

src/frontend/apps/e2e/__tests__/app-impress/config.spec.ts

@@ -93,7 +93,9 @@ test.describe('Config', () => {
     expect(
       await page.locator('button[data-test="convertMarkdown"]').count(),
     ).toBe(1);
-    await expect(page.getByRole('button', { name: 'Ask AI' })).toBeHidden();
+    expect(await page.locator('button[data-test="ai-actions"]').count()).toBe(
+      0,
+    );
   });
 
   test('it checks that Crisp is trying to init from config endpoint', async ({

src/frontend/apps/e2e/__tests__/app-impress/doc-editor.spec.ts

@@ -1,3 +1,4 @@
+/* eslint-disable playwright/no-conditional-expect */
 import path from 'path';
 
 import { expect, test } from '@playwright/test';
@@ -72,7 +73,7 @@ test.describe('Doc Editor', () => {
 
     await page.keyboard.press('Escape');
 
-    await page.locator('.bn-block-outer').last().click();
+    await page.locator('.ProseMirror').focus();
 
     await page.keyboard.press('Enter');
 
@@ -388,72 +389,13 @@ test.describe('Doc Editor', () => {
     await expect(image).toHaveAttribute('aria-hidden', 'true');
   });
 
-  test('it checks the AI feature', async ({ page, browserName }) => {
-    await overrideConfig(page, {
-      AI_BOT: {
-        name: 'Albert AI',
-        color: '#8bc6ff',
-      },
-    });
-
-    await page.goto('/');
-
-    await page.route(/.*\/ai-proxy\//, async (route) => {
+  test('it checks the AI buttons', async ({ page, browserName }) => {
+    await page.route(/.*\/ai-translate\//, async (route) => {
       const request = route.request();
       if (request.method().includes('POST')) {
         await route.fulfill({
           json: {
-            id: 'chatcmpl-b1e7a9e456ca41f78fec130d552a6bf5',
-            choices: [
-              {
-                finish_reason: 'stop',
-                index: 0,
-                logprobs: null,
-                message: {
-                  content: '',
-                  refusal: null,
-                  role: 'assistant',
-                  annotations: null,
-                  audio: null,
-                  function_call: null,
-                  tool_calls: [
-                    {
-                      id: 'chatcmpl-tool-2e3567dfecf94a4c85e27a3528337718',
-                      function: {
-                        arguments:
-                          '{"operations": [{"type": "update", "id": "initialBlockId$", "block": "<p>Bonjour le monde</p>"}]}',
-                        name: 'json',
-                      },
-                      type: 'function',
-                    },
-                  ],
-                  reasoning_content: null,
-                },
-                stop_reason: null,
-              },
-            ],
-            created: 1749549477,
-            model: 'neuralmagic/Meta-Llama-3.1-70B-Instruct-FP8',
-            object: 'chat.completion',
-            service_tier: null,
-            system_fingerprint: null,
-            usage: {
-              completion_tokens: 0,
-              prompt_tokens: 204,
-              total_tokens: 204,
-              completion_tokens_details: null,
-              prompt_tokens_details: null,
-              details: [
-                {
-                  id: 'chatcmpl-b1e7a9e456ca41f78fec130d552a6bf5',
-                  model: 'neuralmagic/Meta-Llama-3.1-70B-Instruct-FP8',
-                  prompt_tokens: 204,
-                  completion_tokens: 0,
-                  total_tokens: 204,
-                },
-              ],
-            },
-            prompt_logprobs: null,
+            answer: 'Bonjour le monde',
           },
         });
       } else {
@@ -466,84 +408,118 @@ test.describe('Doc Editor', () => {
     await page.locator('.bn-block-outer').last().fill('Hello World');
 
     const editor = page.locator('.ProseMirror');
-    await editor.getByText('Hello World').selectText();
+    await editor.getByText('Hello').selectText();
 
-    // Check from toolbar
-    await page.getByRole('button', { name: 'Ask AI' }).click();
+    await page.getByRole('button', { name: 'AI' }).click();
 
     await expect(
-      page.getByRole('option', { name: 'Improve Writing' }),
+      page.getByRole('menuitem', { name: 'Use as prompt' }),
     ).toBeVisible();
     await expect(
-      page.getByRole('option', { name: 'Fix Spelling' }),
+      page.getByRole('menuitem', { name: 'Rephrase' }),
+    ).toBeVisible();
+    await expect(
+      page.getByRole('menuitem', { name: 'Summarize' }),
+    ).toBeVisible();
+    await expect(page.getByRole('menuitem', { name: 'Correct' })).toBeVisible();
+    await expect(
+      page.getByRole('menuitem', { name: 'Language' }),
     ).toBeVisible();
-    await expect(page.getByRole('option', { name: 'Translate' })).toBeVisible();
 
-    await page.getByRole('option', { name: 'Translate' }).click();
-    await page.getByPlaceholder('Ask AI anything…').fill('French');
-    await page.getByPlaceholder('Ask AI anything…').press('Enter');
-    await expect(editor.getByText('Albert AI')).toBeVisible();
-    await page
-      .locator('p.bn-mt-suggestion-menu-item-title')
-      .getByText('Accept')
-      .click();
+    await page.getByRole('menuitem', { name: 'Language' }).hover();
+    await expect(
+      page.getByRole('menuitem', { name: 'English', exact: true }),
+    ).toBeVisible();
+    await expect(
+      page.getByRole('menuitem', { name: 'French', exact: true }),
+    ).toBeVisible();
+    await expect(
+      page.getByRole('menuitem', { name: 'German', exact: true }),
+    ).toBeVisible();
 
-    await expect(editor.getByText('Bonjour le monde')).toBeVisible();
+    await page.getByRole('menuitem', { name: 'English', exact: true }).click();
 
-    // Check Suggestion menu
-    await page.locator('.bn-block-outer').last().fill('/');
-    await expect(page.getByText('Write with AI')).toBeVisible();
-
-    // Reload the page to check that the AI change is still there
-    await page.goto(page.url());
     await expect(editor.getByText('Bonjour le monde')).toBeVisible();
   });
 
-  test(`it checks ai_proxy ability`, async ({ page, browserName }) => {
-    await mockedDocument(page, {
-      accesses: [
-        {
-          id: 'b0df4343-c8bd-4c20-9ff6-fbf94fc94egg',
-          role: 'owner',
-          user: {
-            email: 'super@owner.com',
-            full_name: 'Super Owner',
-          },
-        },
-      ],
-      abilities: {
-        destroy: true, // Means owner
-        link_configuration: true,
-        ai_proxy: false,
-        accesses_manage: true,
-        accesses_view: true,
-        update: true,
-        partial_update: true,
-        retrieve: true,
-      },
-      link_reach: 'restricted',
-      link_role: 'editor',
-      created_at: '2021-09-01T09:00:00Z',
-      title: '',
-    });
-
-    const [randomDoc] = await createDoc(
+  [
+    { ai_transform: false, ai_translate: false },
+    { ai_transform: true, ai_translate: false },
+    { ai_transform: false, ai_translate: true },
+  ].forEach(({ ai_transform, ai_translate }) => {
+    test(`it checks AI buttons when can transform is at "${ai_transform}" and can translate is at "${ai_translate}"`, async ({
       page,
-      'doc-editor-ai-proxy',
       browserName,
-      1,
-    );
+    }) => {
+      await mockedDocument(page, {
+        accesses: [
+          {
+            id: 'b0df4343-c8bd-4c20-9ff6-fbf94fc94egg',
+            role: 'owner',
+            user: {
+              email: 'super@owner.com',
+              full_name: 'Super Owner',
+            },
+          },
+        ],
+        abilities: {
+          destroy: true, // Means owner
+          link_configuration: true,
+          ai_transform,
+          ai_translate,
+          accesses_manage: true,
+          accesses_view: true,
+          update: true,
+          partial_update: true,
+          retrieve: true,
+        },
+        link_reach: 'restricted',
+        link_role: 'editor',
+        created_at: '2021-09-01T09:00:00Z',
+        title: '',
+      });
 
-    await verifyDocName(page, randomDoc);
+      const [randomDoc] = await createDoc(
+        page,
+        'doc-editor-ai',
+        browserName,
+        1,
+      );
 
-    await page.locator('.bn-block-outer').last().fill('Hello World');
+      await verifyDocName(page, randomDoc);
 
-    const editor = page.locator('.ProseMirror');
-    await editor.getByText('Hello').selectText();
+      await page.locator('.bn-block-outer').last().fill('Hello World');
 
-    await expect(page.getByRole('button', { name: 'Ask AI' })).toBeHidden();
-    await page.locator('.bn-block-outer').last().fill('/');
-    await expect(page.getByText('Write with AI')).toBeHidden();
+      const editor = page.locator('.ProseMirror');
+      await editor.getByText('Hello').selectText();
+
+      if (!ai_transform && !ai_translate) {
+        await expect(page.getByRole('button', { name: 'AI' })).toBeHidden();
+        return;
+      }
+
+      await page.getByRole('button', { name: 'AI' }).click();
+
+      if (ai_transform) {
+        await expect(
+          page.getByRole('menuitem', { name: 'Use as prompt' }),
+        ).toBeVisible();
+      } else {
+        await expect(
+          page.getByRole('menuitem', { name: 'Use as prompt' }),
+        ).toBeHidden();
+      }
+
+      if (ai_translate) {
+        await expect(
+          page.getByRole('menuitem', { name: 'Language' }),
+        ).toBeVisible();
+      } else {
+        await expect(
+          page.getByRole('menuitem', { name: 'Language' }),
+        ).toBeHidden();
+      }
+    });
   });
 
   test('it downloads unsafe files', async ({ page, browserName }) => {
@@ -914,9 +890,6 @@ test.describe('Doc Editor', () => {
     await expect(interlinkChild.locator('svg').first()).toBeHidden();
     await interlinkChild.click();
 
-    // wait for navigation to complete
-    await page.waitForTimeout(1000);
-
     await verifyDocName(page, docChild2);
 
     await editor.click();

src/frontend/apps/e2e/__tests__/app-impress/doc-export.spec.ts

@@ -35,6 +35,9 @@ test.describe('Doc Export', () => {
     await expect(
       page.getByText(/Download your document in a \.docx, \.odt.*format\./i),
     ).toBeVisible();
+    await expect(
+      page.getByRole('combobox', { name: 'Template' }),
+    ).toBeVisible();
     await expect(page.getByRole('combobox', { name: 'Format' })).toBeVisible();
     await expect(
       page.getByRole('button', {
@@ -233,6 +236,20 @@ test.describe('Doc Export', () => {
       })
       .click();
 
+    await page
+      .getByRole('combobox', {
+        name: 'Template',
+      })
+      .click();
+
+    await page
+      .getByRole('option', {
+        name: 'Demo Template',
+      })
+      .click({
+        delay: 100,
+      });
+
     await new Promise((resolve) => setTimeout(resolve, 1000));
 
     await expect(page.getByTestId('doc-export-download-button')).toBeVisible();
@@ -447,8 +464,6 @@ export const overrideDocContent = async ({
 
   await verifyDocName(page, randomDoc);
 
-  await page.waitForTimeout(1000);
-
   // Add Image SVG
   await page.keyboard.press('Enter');
   const { suggestionMenu } = await openSuggestionMenu({ page });

src/frontend/apps/e2e/__tests__/app-impress/doc-import.spec.ts

@@ -1,181 +0,0 @@
-import { readFileSync } from 'fs';
-import path from 'path';
-
-import { Page, expect, test } from '@playwright/test';
-
-import { getEditor } from './utils-editor';
-
-test.beforeEach(async ({ page }) => {
-  await page.goto('/');
-});
-
-test.describe('Doc Import', () => {
-  test('it imports 2 docs with the import icon', async ({ page }) => {
-    const fileChooserPromise = page.waitForEvent('filechooser');
-    await page.getByLabel('Open the upload dialog').click();
-
-    const fileChooser = await fileChooserPromise;
-    await fileChooser.setFiles([
-      path.join(__dirname, 'assets/test_import.docx'),
-      path.join(__dirname, 'assets/test_import.md'),
-    ]);
-
-    await expect(
-      page.getByText(
-        'The document "test_import.docx" has been successfully imported',
-      ),
-    ).toBeVisible();
-    await expect(
-      page.getByText(
-        'The document "test_import.md" has been successfully imported',
-      ),
-    ).toBeVisible();
-
-    const docsGrid = page.getByTestId('docs-grid');
-    await expect(docsGrid.getByText('test_import.docx').first()).toBeVisible();
-    await expect(docsGrid.getByText('test_import.md').first()).toBeVisible();
-
-    // Check content of imported md
-    await docsGrid.getByText('test_import.md').first().click();
-    const editor = await getEditor({ page });
-
-    const contentCheck = async (isMDCheck = false) => {
-      await expect(
-        editor.getByRole('heading', {
-          name: 'Lorem Ipsum import Document',
-          level: 1,
-        }),
-      ).toBeVisible();
-      await expect(
-        editor.getByRole('heading', {
-          name: 'Introduction',
-          level: 2,
-        }),
-      ).toBeVisible();
-      await expect(
-        editor.getByRole('heading', {
-          name: 'Subsection 1.1',
-          level: 3,
-        }),
-      ).toBeVisible();
-      await expect(
-        editor
-          .locator('div[data-content-type="bulletListItem"] strong')
-          .getByText('Bold text'),
-      ).toBeVisible();
-      await expect(
-        editor
-          .locator('div[data-content-type="codeBlock"]')
-          .getByText('hello_world'),
-      ).toBeVisible();
-      await expect(
-        editor
-          .locator('div[data-content-type="table"] td')
-          .getByText('Paragraph'),
-      ).toBeVisible();
-      await expect(
-        editor.locator('a[href="http://localhost:3000/"]').getByText('Example'),
-      ).toBeVisible();
-
-      /* eslint-disable playwright/no-conditional-expect */
-      if (isMDCheck) {
-        await expect(
-          editor.locator(
-            'img[src="http://localhost:3000/assets/logo-suite-numerique.png"]',
-          ),
-        ).toBeVisible();
-        await expect(
-          editor.locator(
-            'img[src="http://localhost:3000/assets/icon-docs.svg"]',
-          ),
-        ).toBeVisible();
-      } else {
-        await expect(editor.locator('img')).toHaveCount(2);
-      }
-      /* eslint-enable playwright/no-conditional-expect */
-
-      /**
-       * Divider are not supported in docx import in DocSpec 2.4.4
-       */
-      /* eslint-disable playwright/no-conditional-expect */
-      if (isMDCheck) {
-        await expect(
-          editor.locator('div[data-content-type="divider"] hr'),
-        ).toBeVisible();
-      }
-      /* eslint-enable playwright/no-conditional-expect */
-    };
-
-    await contentCheck(true);
-
-    // Check content of imported docx
-    await page.getByLabel('Back to homepage').first().click();
-    await docsGrid.getByText('test_import.docx').first().click();
-
-    await contentCheck();
-  });
-
-  test('it imports 2 docs with the drag and drop area', async ({ page }) => {
-    const docsGrid = page.getByTestId('docs-grid');
-    await expect(docsGrid).toBeVisible();
-
-    await dragAndDropFiles(page, "[data-testid='docs-grid']", [
-      {
-        filePath: path.join(__dirname, 'assets/test_import.docx'),
-        fileName: 'test_import.docx',
-        fileType:
-          'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-      },
-      {
-        filePath: path.join(__dirname, 'assets/test_import.md'),
-        fileName: 'test_import.md',
-        fileType: 'text/markdown',
-      },
-    ]);
-
-    // Wait for success messages
-    await expect(
-      page.getByText(
-        'The document "test_import.docx" has been successfully imported',
-      ),
-    ).toBeVisible();
-    await expect(
-      page.getByText(
-        'The document "test_import.md" has been successfully imported',
-      ),
-    ).toBeVisible();
-
-    await expect(docsGrid.getByText('test_import.docx').first()).toBeVisible();
-    await expect(docsGrid.getByText('test_import.md').first()).toBeVisible();
-  });
-});
-
-const dragAndDropFiles = async (
-  page: Page,
-  selector: string,
-  files: Array<{ filePath: string; fileName: string; fileType?: string }>,
-) => {
-  const filesData = files.map((file) => ({
-    bufferData: `data:application/octet-stream;base64,${readFileSync(file.filePath).toString('base64')}`,
-    fileName: file.fileName,
-    fileType: file.fileType || '',
-  }));
-
-  const dataTransfer = await page.evaluateHandle(async (filesInfo) => {
-    const dt = new DataTransfer();
-
-    for (const fileInfo of filesInfo) {
-      const blobData = await fetch(fileInfo.bufferData).then((res) =>
-        res.blob(),
-      );
-      const file = new File([blobData], fileInfo.fileName, {
-        type: fileInfo.fileType,
-      });
-      dt.items.add(file);
-    }
-
-    return dt;
-  }, filesData);
-
-  await page.dispatchEvent(selector, 'drop', { dataTransfer });
-};

src/frontend/apps/e2e/__tests__/app-impress/doc-tree.spec.ts

@@ -27,32 +27,47 @@ test.describe('Doc Tree', () => {
     const docTree = page.getByTestId('doc-tree');
 
     // Create first sub page
+    const firstResponsePromise = page.waitForResponse(
+      (response) =>
+        response.url().includes('/documents/') &&
+        response.url().includes('/children/') &&
+        response.request().method() === 'POST',
+    );
+
     await clickOnAddRootSubPage(page);
-    await updateDocTitle(page, 'first move');
+    const firstResponse = await firstResponsePromise;
+    expect(firstResponse.ok()).toBeTruthy();
+    await updateDocTitle(page, 'first');
+
+    const secondResponsePromise = page.waitForResponse(
+      (response) =>
+        response.url().includes('/documents/') &&
+        response.url().includes('/children/') &&
+        response.request().method() === 'POST',
+    );
 
     // Create second sub page
     await clickOnAddRootSubPage(page);
-    await updateDocTitle(page, 'second move');
+    const secondResponse = await secondResponsePromise;
+    expect(secondResponse.ok()).toBeTruthy();
+    await updateDocTitle(page, 'second');
 
-    const firstSubPageItem = docTree.getByText('first move').first();
-    const secondSubPageItem = docTree.getByText('second move').first();
+    const secondSubPageJson = await secondResponse.json();
+    const firstSubPageJson = await firstResponse.json();
+
+    const firstSubPageItem = docTree
+      .getByTestId(`doc-sub-page-item-${firstSubPageJson.id}`)
+      .first();
+
+    const secondSubPageItem = docTree
+      .getByTestId(`doc-sub-page-item-${secondSubPageJson.id}`)
+      .first();
 
     // check that the sub pages are visible in the tree
     await expect(firstSubPageItem).toBeVisible();
     await expect(secondSubPageItem).toBeVisible();
 
-    // Check the position of the sub pages
-    const allSubPageItems = await docTree
-      .getByTestId(/^doc-sub-page-item/)
-      .all();
-
-    expect(allSubPageItems.length).toBe(2);
-
-    // Check that elements are in the correct order
-    await expect(allSubPageItems[0].getByText('first move')).toBeVisible();
-    await expect(allSubPageItems[1].getByText('second move')).toBeVisible();
-
-    // Will move the first sub page to the second position
+    // get the bounding boxes of the sub pages
     const firstSubPageBoundingBox = await firstSubPageItem.boundingBox();
     const secondSubPageBoundingBox = await secondSubPageItem.boundingBox();
 
@@ -60,9 +75,10 @@ test.describe('Doc Tree', () => {
     expect(secondSubPageBoundingBox).toBeDefined();
 
     if (!firstSubPageBoundingBox || !secondSubPageBoundingBox) {
-      throw new Error('unable to determine the position of the elements');
+      throw new Error('Impossible de déterminer la position des éléments');
     }
 
+    // move the first sub page to the second position
     await page.mouse.move(
       firstSubPageBoundingBox.x + firstSubPageBoundingBox.width / 2,
       firstSubPageBoundingBox.y + firstSubPageBoundingBox.height / 2,
@@ -89,19 +105,24 @@ test.describe('Doc Tree', () => {
     await expect(firstSubPageItem).toBeVisible();
     await expect(secondSubPageItem).toBeVisible();
 
-    // Check that elements are in the correct order
-    const allSubPageItemsAfterReload = await docTree
+    // Check the position of the sub pages
+    const allSubPageItems = await docTree
       .getByTestId(/^doc-sub-page-item/)
       .all();
 
-    expect(allSubPageItemsAfterReload.length).toBe(2);
+    expect(allSubPageItems.length).toBe(2);
 
-    await expect(
-      allSubPageItemsAfterReload[0].getByText('second move'),
-    ).toBeVisible();
-    await expect(
-      allSubPageItemsAfterReload[1].getByText('first move'),
-    ).toBeVisible();
+    // Check that the first element has the ID of the second sub page after the drag and drop
+    await expect(allSubPageItems[0]).toHaveAttribute(
+      'data-testid',
+      `doc-sub-page-item-${secondSubPageJson.id}`,
+    );
+
+    // Check that the second element has the ID of the first sub page after the drag and drop
+    await expect(allSubPageItems[1]).toHaveAttribute(
+      'data-testid',
+      `doc-sub-page-item-${firstSubPageJson.id}`,
+    );
   });
 
   test('it detaches a document', async ({ page, browserName }) => {

src/frontend/apps/e2e/__tests__/app-impress/language.spec.ts

@@ -121,7 +121,7 @@ test.describe('Language', () => {
       LANGUAGE_CODE: 'en-us',
     });
 
-    await createDoc(page, 'doc-translations-slash', browserName, 1);
+    await createDoc(page, 'doc-toolbar', browserName, 1);
 
     const { editor, suggestionMenu } = await openSuggestionMenu({ page });
     await expect(

src/frontend/apps/e2e/__tests__/app-impress/utils-common.ts

@@ -4,18 +4,10 @@ export type BrowserName = 'chromium' | 'firefox' | 'webkit';
 export const BROWSERS: BrowserName[] = ['chromium', 'webkit', 'firefox'];
 
 export const CONFIG = {
-  AI_BOT: {
-    name: 'Docs AI',
-    color: '#8bc6ff',
-  },
   AI_FEATURE_ENABLED: true,
-  AI_MODEL: 'llama',
-  AI_STREAM: false,
   CRISP_WEBSITE_ID: null,
   COLLABORATION_WS_URL: 'ws://localhost:4444/collaboration/ws/',
   COLLABORATION_WS_NOT_CONNECTED_READY_ONLY: true,
-  CONVERSION_FILE_EXTENSIONS_ALLOWED: ['.docx', '.md'],
-  CONVERSION_FILE_MAX_SIZE: 20971520,
   ENVIRONMENT: 'development',
   FRONTEND_CSS_URL: null,
   FRONTEND_JS_URL: null,
@@ -168,7 +160,7 @@ export const verifyDocName = async (page: Page, docName: string) => {
     await expect(
       page.getByRole('textbox', { name: 'Document title' }),
     ).toContainText(docName, {
-      timeout: 3000,
+      timeout: 1000,
     });
   } catch {
     await expect(page.getByRole('heading', { name: docName })).toBeVisible();

src/frontend/apps/impress/package.json

@@ -19,18 +19,14 @@
   },
   "dependencies": {
     "@ag-media/react-pdf-table": "2.0.3",
-    "@ai-sdk/groq": "^3.0.15",
-    "@ai-sdk/openai": "^3.0.19",
-    "@ai-sdk/openai-compatible": "2.0.18",
-    "@blocknote/code-block": "0.46.1",
-    "@blocknote/core": "0.46.1",
-    "@blocknote/mantine": "0.46.1",
-    "@blocknote/react": "0.46.1",
-    "@blocknote/xl-ai": "0.46.1",
-    "@blocknote/xl-docx-exporter": "0.46.1",
-    "@blocknote/xl-multi-column": "0.46.1",
-    "@blocknote/xl-odt-exporter": "0.46.1",
-    "@blocknote/xl-pdf-exporter": "0.46.1",
+    "@blocknote/code-block": "0.45.0",
+    "@blocknote/core": "0.45.0",
+    "@blocknote/mantine": "0.45.0",
+    "@blocknote/react": "0.45.0",
+    "@blocknote/xl-docx-exporter": "0.45.0",
+    "@blocknote/xl-multi-column": "0.45.0",
+    "@blocknote/xl-odt-exporter": "0.45.0",
+    "@blocknote/xl-pdf-exporter": "0.45.0",
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/modifiers": "9.0.0",
     "@emoji-mart/data": "1.2.1",
@@ -48,7 +44,6 @@
     "@sentry/nextjs": "10.32.1",
     "@tanstack/react-query": "5.90.16",
     "@tiptap/extensions": "*",
-    "ai": "6.0.49",
     "canvg": "4.0.3",
     "clsx": "2.1.1",
     "cmdk": "1.1.1",
@@ -60,14 +55,13 @@
     "i18next": "25.7.3",
     "i18next-browser-languagedetector": "8.2.0",
     "idb": "8.0.3",
-    "lodash": "4.17.23",
+    "lodash": "4.17.21",
     "luxon": "3.7.2",
     "next": "15.5.9",
     "posthog-js": "1.312.0",
     "react": "*",
     "react-aria-components": "1.14.0",
     "react-dom": "*",
-    "react-dropzone": "14.3.8",
     "react-i18next": "16.5.1",
     "react-intersection-observer": "10.0.0",
     "react-resizable-panels": "3.0.6",
@@ -77,7 +71,6 @@
     "uuid": "13.0.0",
     "y-protocols": "1.0.7",
     "yjs": "*",
-    "zod": "3.25.28",
     "zustand": "5.0.9"
   },
   "devDependencies": {

src/frontend/apps/impress/src/api/helpers.tsx

@@ -20,7 +20,7 @@ export type DefinedInitialDataInfiniteOptionsAPI<
   QueryKey,
   TPageParam
 >;
-export type UseInfiniteQueryResultAPI<Q> = InfiniteData<Q>;
+
 export type InfiniteQueryConfig<Q> = Omit<
   DefinedInitialDataInfiniteOptionsAPI<Q>,
   'queryKey' | 'initialData' | 'getNextPageParam' | 'initialPageParam'

src/frontend/apps/impress/src/assets/icons/doc-all.svg

@@ -1,20 +0,0 @@
-<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <path
-    d="M6.12757 9.8486C5.98657 9.6993 5.91709 9.5143 5.91709 9.30858C5.91709 9.10284 5.98679 8.91775 6.13233 8.77221C6.28262 8.62192 6.47291 8.54842 6.68579 8.54842H13.1697C13.3775 8.54842 13.5623 8.62245 13.7061 8.77215C13.8559 8.91601 13.9299 9.10081 13.9299 9.30858C13.9299 9.51737 13.8553 9.70306 13.7085 9.8511C13.5643 10.0024 13.3787 10.0773 13.1697 10.0773H6.68579C6.47291 10.0773 6.28262 10.0038 6.13233 9.85349L6.13076 9.85192L6.12757 9.8486Z"
-    fill="currentColor"
-  />
-  <path
-    d="M6.12757 12.83C5.98657 12.6807 5.91709 12.4957 5.91709 12.29C5.91709 12.0843 5.98679 11.8992 6.13233 11.7536C6.28262 11.6033 6.47291 11.5298 6.68579 11.5298H13.1697C13.3775 11.5298 13.5623 11.6039 13.7061 11.7536C13.8559 11.8974 13.9299 12.0822 13.9299 12.29C13.9299 12.4988 13.8553 12.6845 13.7085 12.8325C13.5643 12.9838 13.3787 13.0587 13.1697 13.0587H6.68579C6.47291 13.0587 6.28262 12.9852 6.13233 12.8349L6.13076 12.8333L6.12757 12.83Z"
-    fill="currentColor"
-  />
-  <path
-    d="M5.91709 15.2885C5.91709 15.4912 5.98839 15.6726 6.12757 15.82L6.134 15.8266L6.13723 15.8296C6.28833 15.9723 6.47704 16.0401 6.68579 16.0401H9.75263C9.96123 16.0401 10.1502 15.9722 10.2975 15.8249C10.444 15.6784 10.5213 15.4956 10.5213 15.2885C10.5213 15.0768 10.4486 14.8874 10.2999 14.7374C10.1539 14.5842 9.96433 14.5113 9.75263 14.5113H6.68579C6.47293 14.5113 6.28257 14.5847 6.13226 14.735L6.12757 14.7399C5.98486 14.891 5.91709 15.0797 5.91709 15.2885Z"
-    fill="currentColor"
-  />
-  <path
-    fill-rule="evenodd"
-    clip-rule="evenodd"
-    d="M7.37975 1.24597C7.88425 0.735004 8.61944 0.5 9.54031 0.5H18.6127C19.533 0.5 20.2661 0.734736 20.7653 1.24652C21.2686 1.75666 21.5 2.49628 21.5 3.42147V16.3808C21.5 17.3112 21.2688 18.0521 20.7638 18.5572C20.2645 19.0624 19.532 19.2937 18.6127 19.2937H17.347V20.5338C17.347 21.4641 17.1158 22.2051 16.6108 22.7102C16.1115 23.2153 15.3789 23.4467 14.4597 23.4467H5.3873C4.46721 23.4467 3.73242 23.2149 3.22781 22.7103C2.72908 22.2051 2.5 21.4635 2.5 20.5338V7.57442C2.5 6.64962 2.72942 5.90915 3.22673 5.39893C3.73123 4.88796 4.46643 4.65295 5.3873 4.65295H6.65302V3.42147C6.65302 2.49666 6.88244 1.7562 7.37975 1.24597ZM8.42319 4.65295H14.4597C15.38 4.65295 16.1131 4.88769 16.6122 5.39947C17.1156 5.90962 17.347 6.64923 17.347 7.57442V17.5236H18.5444C18.9636 17.5236 19.2496 17.4163 19.4324 17.2289L19.4337 17.2275C19.6238 17.0374 19.7298 16.7549 19.7298 16.3552V3.4471C19.7298 3.04734 19.6238 2.76485 19.4337 2.57481L19.431 2.57206C19.248 2.37972 18.9625 2.27017 18.5444 2.27017H9.60866C9.19081 2.27017 8.90126 2.37956 8.71212 2.57341C8.52701 2.76329 8.42319 3.04633 8.42319 3.4471V4.65295ZM5.45564 21.6765C5.03728 21.6765 4.74743 21.5697 4.55844 21.3811C4.37372 21.1913 4.27017 20.9084 4.27017 20.5081V7.60005C4.27017 7.19928 4.37399 6.91625 4.55911 6.72636C4.74825 6.53252 5.03779 6.42313 5.45564 6.42313H14.3913C14.8095 6.42313 15.095 6.53268 15.278 6.72501L15.2807 6.72776C15.4708 6.9178 15.5768 7.20029 15.5768 7.60005V20.5081C15.5768 20.9079 15.4708 21.1904 15.2807 21.3804L15.2793 21.3818C15.0966 21.5693 14.8105 21.6765 14.3913 21.6765H5.45564Z"
-    fill="currentColor"
-  />
-</svg>

src/frontend/apps/impress/src/components/Emoji/EmojiPicker.tsx

@@ -12,6 +12,7 @@ interface EmojiPickerProps {
   onClickOutside: () => void;
   onEmojiSelect: ({ native }: { native: string }) => void;
   withOverlay?: boolean;
+  onEscape?: () => void;
 }
 
 export const EmojiPicker = ({
@@ -19,12 +20,17 @@ export const EmojiPicker = ({
   onClickOutside,
   onEmojiSelect,
   withOverlay = false,
+  onEscape,
 }: EmojiPickerProps) => {
   const { i18n } = useTranslation();
 
   const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
     if (event.key === 'Escape') {
-      onClickOutside();
+      if (onEscape) {
+        onEscape();
+      } else {
+        onClickOutside();
+      }
     }
   };
 

src/frontend/apps/impress/src/components/Icon.tsx

@@ -1,34 +1,21 @@
 import clsx from 'clsx';
-import React from 'react';
 import { css } from 'styled-components';
 
 import { Text, TextType } from '@/components';
 
-type IconBase = TextType & {
+type IconProps = TextType & {
   disabled?: boolean;
-};
-
-type IconMaterialProps = IconBase & {
   iconName: string;
   variant?: 'filled' | 'outlined' | 'symbols-outlined';
-  icon?: never;
 };
-
-type IconSVGProps = IconBase & {
-  icon: React.ReactNode;
-  iconName?: never;
-  variant?: never;
-};
-
 export const Icon = ({
   className,
-  disabled,
   iconName,
-  icon,
+  disabled,
   variant = 'outlined',
   $theme = 'neutral',
   ...textProps
-}: IconMaterialProps | IconSVGProps) => {
+}: IconProps) => {
   const hasLabel = 'aria-label' in textProps || 'aria-labelledby' in textProps;
   const ariaHidden =
     'aria-hidden' in textProps ? textProps['aria-hidden'] : !hasLabel;
@@ -37,15 +24,15 @@ export const Icon = ({
     <Text
       aria-hidden={ariaHidden}
       className={clsx('--docs--icon-bg', className, {
-        'material-icons-filled': variant === 'filled' && iconName,
-        'material-icons': variant === 'outlined' && iconName,
-        'material-symbols-outlined': variant === 'symbols-outlined' && iconName,
+        'material-icons-filled': variant === 'filled',
+        'material-icons': variant === 'outlined',
+        'material-symbols-outlined': variant === 'symbols-outlined',
       })}
       $theme={disabled ? 'disabled' : $theme}
       aria-disabled={disabled}
       {...textProps}
     >
-      {iconName ?? icon}
+      {iconName}
     </Text>
   );
 };

src/frontend/apps/impress/src/core/config/api/useConfig.tsx

@@ -15,14 +15,9 @@ interface ThemeCustomization {
 }
 
 export interface ConfigResponse {
-  AI_BOT: { name: string; color: string };
   AI_FEATURE_ENABLED?: boolean;
-  AI_MODEL?: string;
-  AI_STREAM: boolean;
   COLLABORATION_WS_URL?: string;
   COLLABORATION_WS_NOT_CONNECTED_READY_ONLY?: boolean;
-  CONVERSION_FILE_EXTENSIONS_ALLOWED: string[];
-  CONVERSION_FILE_MAX_SIZE: number;
   CRISP_WEBSITE_ID?: string;
   ENVIRONMENT: string;
   FRONTEND_CSS_URL?: string;

src/frontend/apps/impress/src/features/docs/doc-editor/api/index.ts

@@ -1,2 +1,4 @@
 export * from './checkDocMediaStatus';
 export * from './useCreateDocUpload';
+export * from './useDocAITransform';
+export * from './useDocAITranslate';

src/frontend/apps/impress/src/features/docs/doc-editor/api/useDocAITransform.tsx

@@ -0,0 +1,48 @@
+import { useMutation } from '@tanstack/react-query';
+
+import { APIError, errorCauses, fetchAPI } from '@/api';
+
+export type AITransformActions =
+  | 'correct'
+  | 'prompt'
+  | 'rephrase'
+  | 'summarize'
+  | 'beautify'
+  | 'emojify';
+
+export type DocAITransform = {
+  docId: string;
+  text: string;
+  action: AITransformActions;
+};
+
+export type DocAITransformResponse = {
+  answer: string;
+};
+
+export const docAITransform = async ({
+  docId,
+  ...params
+}: DocAITransform): Promise<DocAITransformResponse> => {
+  const response = await fetchAPI(`documents/${docId}/ai-transform/`, {
+    method: 'POST',
+    body: JSON.stringify({
+      ...params,
+    }),
+  });
+
+  if (!response.ok) {
+    throw new APIError(
+      'Failed to request ai transform',
+      await errorCauses(response),
+    );
+  }
+
+  return response.json() as Promise<DocAITransformResponse>;
+};
+
+export function useDocAITransform() {
+  return useMutation<DocAITransformResponse, APIError, DocAITransform>({
+    mutationFn: docAITransform,
+  });
+}

src/frontend/apps/impress/src/features/docs/doc-editor/api/useDocAITranslate.tsx

@@ -0,0 +1,40 @@
+import { useMutation } from '@tanstack/react-query';
+
+import { APIError, errorCauses, fetchAPI } from '@/api';
+
+export type DocAITranslate = {
+  docId: string;
+  text: string;
+  language: string;
+};
+
+export type DocAITranslateResponse = {
+  answer: string;
+};
+
+export const docAITranslate = async ({
+  docId,
+  ...params
+}: DocAITranslate): Promise<DocAITranslateResponse> => {
+  const response = await fetchAPI(`documents/${docId}/ai-translate/`, {
+    method: 'POST',
+    body: JSON.stringify({
+      ...params,
+    }),
+  });
+
+  if (!response.ok) {
+    throw new APIError(
+      'Failed to request ai translate',
+      await errorCauses(response),
+    );
+  }
+
+  return response.json() as Promise<DocAITranslateResponse>;
+};
+
+export function useDocAITranslate() {
+  return useMutation<DocAITranslateResponse, APIError, DocAITranslate>({
+    mutationFn: docAITranslate,
+  });
+}

src/frontend/apps/impress/src/features/docs/doc-editor/assets/IconAI.svg

@@ -1,6 +0,0 @@
-<svg viewBox="0 0 10 10" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <path
-    d="M5.89904 7.9473C6.0847 7.9473 6.19816 7.84673 6.23941 7.6456C6.31677 7.17114 6.39671 6.76887 6.47922 6.43881C6.56174 6.10359 6.66746 5.82768 6.79639 5.61108C6.92532 5.38932 7.09551 5.21139 7.30696 5.0773C7.5184 4.93806 7.78916 4.82718 8.11922 4.74466C8.44928 4.66215 8.85928 4.58737 9.34922 4.52033C9.56066 4.49454 9.66639 4.3785 9.66639 4.17221C9.66639 3.98139 9.56066 3.87051 9.34922 3.83957C8.8696 3.77768 8.46475 3.70548 8.13469 3.62297C7.80979 3.53529 7.53903 3.42441 7.32243 3.29033C7.11098 3.15624 6.93822 2.98089 6.80413 2.76429C6.6752 2.54253 6.5669 2.26662 6.47922 1.93656C6.39671 1.60649 6.31677 1.20165 6.23941 0.722032C6.19816 0.515743 6.0847 0.412598 5.89904 0.412598C5.70306 0.412598 5.58702 0.515743 5.55092 0.722032C5.47872 1.1965 5.40136 1.60134 5.31885 1.93656C5.23633 2.26662 5.12803 2.53995 4.99394 2.75655C4.86501 2.97316 4.69483 3.15108 4.48338 3.29033C4.27193 3.42441 4.00118 3.53272 3.67112 3.61523C3.34106 3.69775 2.93364 3.77253 2.44886 3.83957C2.23741 3.87051 2.13169 3.98139 2.13169 4.17221C2.13169 4.36819 2.23741 4.48422 2.44886 4.52033C3.04709 4.60284 3.52929 4.70083 3.89546 4.81429C4.26162 4.92774 4.54784 5.0902 4.75413 5.30164C4.96042 5.51309 5.1203 5.80705 5.23376 6.18353C5.35237 6.55485 5.45809 7.04221 5.55092 7.6456C5.59218 7.84673 5.70822 7.9473 5.89904 7.9473ZM2.53395 9.27786C2.6732 9.27786 2.75829 9.20824 2.78923 9.06899C2.83565 8.77503 2.87691 8.54296 2.91301 8.37277C2.95426 8.20774 3.01357 8.08138 3.09093 7.99371C3.17345 7.90604 3.30238 7.839 3.47772 7.79258C3.65307 7.74617 3.90061 7.69459 4.22036 7.63786C4.35961 7.61208 4.42923 7.52956 4.42923 7.39032C4.42923 7.25623 4.35961 7.17629 4.22036 7.15051C3.90061 7.09894 3.65307 7.05252 3.47772 7.01126C3.30753 6.96485 3.1786 6.90038 3.09093 6.81787C3.00841 6.73019 2.94911 6.60126 2.91301 6.43107C2.87691 6.26089 2.83565 6.02623 2.78923 5.72711C2.75313 5.57756 2.66804 5.50278 2.53395 5.50278C2.40502 5.50278 2.3225 5.57756 2.2864 5.72711C2.23483 6.02108 2.19099 6.25057 2.15489 6.4156C2.11879 6.58063 2.05949 6.70699 1.97697 6.79466C1.89961 6.87717 1.77326 6.94164 1.59791 6.98805C1.42773 7.03447 1.18276 7.08862 0.863011 7.15051C0.713451 7.17629 0.638672 7.25623 0.638672 7.39032C0.638672 7.52956 0.721187 7.61208 0.886218 7.63786C1.19565 7.68944 1.43546 7.73843 1.60565 7.78485C1.77584 7.8261 1.89961 7.89057 1.97697 7.97824C2.05949 8.06592 2.11879 8.19227 2.15489 8.3573C2.19099 8.52749 2.23483 8.75956 2.2864 9.05352C2.32766 9.20308 2.41018 9.27786 2.53395 9.27786Z"
-    fill="currentColor"
-  />
-</svg>

src/frontend/apps/impress/src/features/docs/doc-editor/assets/wand_stars.svg

@@ -1,6 +0,0 @@
-<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <path
-    d="M4.4 21L3 19.6L10.525 12.05L6 10.925L10.95 7.85L10.525 2L15 5.775L20.4 3.575L18.225 9L22 13.45L16.15 13.05L13.05 18L11.925 13.475L4.4 21ZM5 8L3 6L5 4L7 6L5 8ZM13.875 12.925L15.075 10.95L17.4 11.125L15.9 9.35L16.775 7.2L14.625 8.075L12.85 6.6L13.025 8.9L11.05 10.125L13.3 10.675L13.875 12.925ZM18 21L16 19L18 17L20 19L18 21Z"
-    fill="#303030"
-  />
-</svg>

src/frontend/apps/impress/src/features/docs/doc-editor/components/AI/AIUI.tsx

@@ -1,190 +0,0 @@
-import { FormattingToolbarExtension } from '@blocknote/core/extensions';
-import {
-  useBlockNoteEditor,
-  useComponentsContext,
-  useExtension,
-} from '@blocknote/react';
-import {
-  AIExtension,
-  AIMenu as AIMenuDefault,
-  getDefaultAIMenuItems,
-} from '@blocknote/xl-ai';
-import '@blocknote/xl-ai/style.css';
-import { useTranslation } from 'react-i18next';
-import { createGlobalStyle, css } from 'styled-components';
-
-import { Box, Icon, Text } from '@/components';
-import { useCunninghamTheme } from '@/cunningham';
-
-import IconAI from '../../assets/IconAI.svg';
-import IconWandStar from '../../assets/wand_stars.svg';
-import {
-  DocsBlockNoteEditor,
-  DocsBlockSchema,
-  DocsInlineContentSchema,
-  DocsStyleSchema,
-} from '../../types';
-
-const AIMenuStyle = createGlobalStyle`
-  #ai-suggestion-menu .bn-suggestion-menu-item-small .bn-mt-suggestion-menu-item-section[data-position=left] svg {
-    height: 18px;
-    width: 18px;
-  }
-`;
-
-export function AIMenu() {
-  return (
-    <>
-      <AIMenuStyle />
-      <AIMenuDefault
-        items={(editor: DocsBlockNoteEditor, aiResponseStatus) => {
-          if (aiResponseStatus === 'user-input') {
-            let aiMenuItems = getDefaultAIMenuItems(editor, aiResponseStatus);
-
-            if (editor.getSelection()) {
-              aiMenuItems = aiMenuItems.filter(
-                (item) => ['simplify'].indexOf(item.key) === -1,
-              );
-
-              aiMenuItems = aiMenuItems.map((item) => {
-                if (item.key === 'improve_writing') {
-                  return {
-                    ...item,
-                    icon: <IconWandStar />,
-                  };
-                } else if (item.key === 'translate') {
-                  return {
-                    ...item,
-                    icon: (
-                      <Icon
-                        iconName="translate"
-                        $color="inherit"
-                        $size="18px"
-                      />
-                    ),
-                  };
-                }
-
-                return item;
-              });
-            } else {
-              aiMenuItems = aiMenuItems.filter(
-                (item) =>
-                  ['action_items', 'write_anything'].indexOf(item.key) === -1,
-              );
-            }
-
-            return aiMenuItems;
-          } else if (aiResponseStatus === 'user-reviewing') {
-            return getDefaultAIMenuItems(editor, aiResponseStatus).map(
-              (item) => {
-                if (item.key === 'accept') {
-                  return {
-                    ...item,
-                    icon: (
-                      <Icon
-                        iconName="check_circle"
-                        $color="inherit"
-                        $size="18px"
-                      />
-                    ),
-                  };
-                }
-                return item;
-              },
-            );
-          }
-
-          return getDefaultAIMenuItems(editor, aiResponseStatus);
-        }}
-      />
-    </>
-  );
-}
-
-export const AIToolbarButton = () => {
-  const { t } = useTranslation();
-  const Components = useComponentsContext();
-  const { spacingsTokens, colorsTokens } = useCunninghamTheme();
-  const editor = useBlockNoteEditor<
-    DocsBlockSchema,
-    DocsInlineContentSchema,
-    DocsStyleSchema
-  >();
-  const ai = useExtension(AIExtension);
-  const formattingToolbar = useExtension(FormattingToolbarExtension);
-
-  if (!editor.isEditable || !Components) {
-    return null;
-  }
-
-  const onClick = () => {
-    const selection = editor.getSelection();
-    if (!selection) {
-      throw new Error('No selection');
-    }
-
-    const position = selection.blocks[selection.blocks.length - 1].id;
-
-    ai.openAIMenuAtBlock(position);
-    formattingToolbar.store.setState(false);
-  };
-
-  return (
-    <Box
-      $css={css`
-        & > button.mantine-Button-root {
-          padding-inline: ${spacingsTokens['2xs']};
-          transition: all 0.1s ease-in;
-          &:hover,
-          &:hover {
-            background-color: ${colorsTokens['gray-050']};
-          }
-          &:hover .--docs--icon-bg {
-            background-color: #5858e1;
-            border: 1px solid #8484f5;
-            color: #ffffff;
-          }
-        }
-      `}
-      $direction="row"
-      className="--docs--ai-toolbar-button"
-    >
-      <Components.Generic.Toolbar.Button
-        className="bn-button"
-        onClick={onClick}
-      >
-        <Box
-          $direction="row"
-          $align="center"
-          $gap={spacingsTokens['xs']}
-          $padding={{ right: '2xs' }}
-        >
-          <Text
-            className="--docs--icon-bg"
-            $theme="greyscale"
-            $variation="600"
-            $css={css`
-              border: 1px solid var(--c--theme--colors--greyscale-100);
-              transition: all 0.1s ease-in;
-            `}
-            $radius="100%"
-            $padding="0.15rem"
-          >
-            <IconAI width="16px" />
-          </Text>
-          {t('Ask AI')}
-        </Box>
-      </Components.Generic.Toolbar.Button>
-      <Box
-        $background={colorsTokens['gray-100']}
-        $width="1px"
-        $height="70%"
-        $margin={{ left: '2px' }}
-        $css={css`
-          align-self: center;
-        `}
-      />
-    </Box>
-  );
-};

src/frontend/apps/impress/src/features/docs/doc-editor/components/AI/index.ts

@@ -1,25 +0,0 @@
-/**
- * To import AI modules you must import from the index file.
- * This is to ensure that the AI modules are only loaded when
- * the application is not published as MIT.
- */
-import * as XLAI from '@blocknote/xl-ai';
-import * as localesAI from '@blocknote/xl-ai/locales';
-
-import * as AIUI from './AIUI';
-import * as useAI from './useAI';
-
-let modulesAI = undefined;
-if (process.env.NEXT_PUBLIC_PUBLISH_AS_MIT === 'false') {
-  modulesAI = {
-    ...XLAI,
-    ...AIUI,
-    localesAI: localesAI,
-    ...useAI,
-  };
-}
-
-type ModulesAI = typeof XLAI &
-  typeof AIUI & { localesAI: typeof localesAI } & typeof useAI;
-
-export default modulesAI as ModulesAI;

src/frontend/apps/impress/src/features/docs/doc-editor/components/AI/useAI.tsx

@@ -1,43 +0,0 @@
-import { createOpenAI } from '@ai-sdk/openai';
-import { AIExtension, ClientSideTransport } from '@blocknote/xl-ai';
-import { useMemo } from 'react';
-
-import { baseApiUrl, fetchAPI } from '@/api';
-import { useConfig } from '@/core';
-import { Doc } from '@/docs/doc-management';
-//import { usePromptAI } from './usePromptAI';
-
-export const useAI = (docId: Doc['id'], aiAllowed: boolean) => {
-  const conf = useConfig().data;
-  //const promptBuilder = usePromptAI();
-
-  return useMemo(() => {
-    if (!aiAllowed || !conf?.AI_MODEL) {
-      return;
-    }
-
-    const aIprovider = createOpenAI({
-      apiKey: '',
-      baseURL: `${baseApiUrl('1.0')}documents/${docId}/ai-proxy/`,
-      fetch: (input, init) => {
-        // Create a new headers object without the Authorization header
-        const headers = new Headers(init?.headers);
-        headers.delete('Authorization');
-
-        return fetchAPI(`documents/${docId}/ai-proxy/`, {
-          ...init,
-          headers,
-        });
-      },
-    });
-
-    const model = aIprovider.chat(conf.AI_MODEL);
-
-    const extension = AIExtension({
-      agentCursor: conf.AI_BOT,
-      transport: new ClientSideTransport({ model }),
-    });
-
-    return extension;
-  }, [aiAllowed, conf, docId]);
-};

src/frontend/apps/impress/src/features/docs/doc-editor/components/BlockNoteEditor.tsx

@@ -20,7 +20,6 @@ import type { Awareness } from 'y-protocols/awareness';
 import * as Y from 'yjs';
 
 import { Box, TextErrors } from '@/components';
-import { useConfig } from '@/core';
 import { useCunninghamTheme } from '@/cunningham';
 import { Doc, useProviderStore } from '@/docs/doc-management';
 import { avatarUrlFromName, useAuth } from '@/features/auth';
@@ -37,7 +36,6 @@ import { cssEditor } from '../styles';
 import { DocsBlockNoteEditor } from '../types';
 import { randomColor } from '../utils';
 
-import BlockNoteAI from './AI';
 import { BlockNoteSuggestionMenu } from './BlockNoteSuggestionMenu';
 import { BlockNoteToolbar } from './BlockNoteToolBar/BlockNoteToolbar';
 import { cssComments, useComments } from './comments/';
@@ -47,10 +45,6 @@ import {
   PdfBlock,
   UploadLoaderBlock,
 } from './custom-blocks';
-const AIMenu = BlockNoteAI?.AIMenu;
-const AIMenuController = BlockNoteAI?.AIMenuController;
-const useAI = BlockNoteAI?.useAI;
-const localesAI = BlockNoteAI?.localesAI;
 import {
   InterlinkingLinkInlineContent,
   InterlinkingSearchInlineContent,
@@ -89,6 +83,7 @@ interface BlockNoteEditorProps {
 export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
   const { user } = useAuth();
   const { setEditor } = useEditorStore();
+  const { t } = useTranslation();
   const { themeTokens } = useCunninghamTheme();
   const { isSynced: isConnectedToCollabServer } = useProviderStore();
   const refEditorContainer = useRef<HTMLDivElement>(null);
@@ -97,16 +92,13 @@ export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
   const showComments = canSeeComment;
 
   useSaveDoc(doc.id, provider.document, isConnectedToCollabServer);
-  const { i18n, t } = useTranslation();
+  const { i18n } = useTranslation();
   let lang = i18n.resolvedLanguage;
   if (!lang || !(lang in locales)) {
     lang = 'en';
   }
 
   const { uploadFile, errorAttachment } = useUploadFile(doc.id);
-  const conf = useConfig().data;
-  const aiAllowed = !!(conf?.AI_FEATURE_ENABLED && doc.abilities?.ai_proxy);
-  const aiExtension = useAI?.(doc.id, aiAllowed);
 
   const collabName = user?.full_name || user?.email;
   const cursorName = collabName || t('Anonymous');
@@ -176,7 +168,6 @@ export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
         ...(multiColumnLocales && {
           multi_column:
             multiColumnLocales[lang as keyof typeof multiColumnLocales],
-          ai: localesAI?.[lang as keyof typeof localesAI],
         }),
       },
       pasteHandler: ({ event, defaultPasteHandler }) => {
@@ -199,15 +190,7 @@ export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
 
         return defaultPasteHandler();
       },
-      extensions: [
-        CommentsExtension({ threadStore, resolveUsers }),
-        ...(aiExtension ? [aiExtension] : []),
-      ],
-      visualMedia: {
-        image: {
-          maxWidth: 760,
-        },
-      },
+      extensions: [CommentsExtension({ threadStore, resolveUsers })],
       tables: {
         splitCells: true,
         cellBackgroundColor: true,
@@ -217,15 +200,7 @@ export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
       uploadFile,
       schema: blockNoteSchema,
     },
-    [
-      aiExtension,
-      cursorName,
-      lang,
-      provider,
-      uploadFile,
-      threadStore,
-      resolveUsers,
-    ],
+    [cursorName, lang, provider, uploadFile, threadStore, resolveUsers],
   );
 
   useHeadings(editor);
@@ -268,11 +243,8 @@ export const BlockNoteEditor = ({ doc, provider }: BlockNoteEditorProps) => {
         comments={showComments}
         aria-label={t('Document editor')}
       >
-        {aiAllowed && AIMenuController && AIMenu && (
-          <AIMenuController aiMenu={AIMenu} />
-        )}
-        <BlockNoteSuggestionMenu aiAllowed={aiAllowed} />
-        <BlockNoteToolbar aiAllowed={aiAllowed} />
+        <BlockNoteSuggestionMenu />
+        <BlockNoteToolbar />
       </BlockNoteView>
     </Box>
   );
@@ -339,7 +311,7 @@ export const BlockNoteReader = ({
         slashMenu={false}
         comments={false}
       >
-        <BlockNoteToolbar aiAllowed={false} />
+        <BlockNoteToolbar />
       </BlockNoteView>
     </Box>
   );

src/frontend/apps/impress/src/features/docs/doc-editor/components/BlockNoteSuggestionMenu.tsx

@@ -17,7 +17,6 @@ import {
   DocsStyleSchema,
 } from '../types';
 
-import BlockNoteAI from './AI';
 import {
   getCalloutReactSlashMenuItems,
   getPdfReactSlashMenuItems,
@@ -28,13 +27,7 @@ import XLMultiColumn from './xl-multi-column';
 const getMultiColumnSlashMenuItems =
   XLMultiColumn?.getMultiColumnSlashMenuItems;
 
-const getAISlashMenuItems = BlockNoteAI?.getAISlashMenuItems;
-
-export const BlockNoteSuggestionMenu = ({
-  aiAllowed,
-}: {
-  aiAllowed: boolean;
-}) => {
+export const BlockNoteSuggestionMenu = () => {
   const editor = useBlockNoteEditor<
     DocsBlockSchema,
     DocsInlineContentSchema,
@@ -57,7 +50,6 @@ export const BlockNoteSuggestionMenu = ({
       getMultiColumnSlashMenuItems?.(editor) || [],
       getPdfReactSlashMenuItems(editor, t, fileBlocksName),
       getCalloutReactSlashMenuItems(editor, t, basicBlocksName),
-      aiAllowed && getAISlashMenuItems ? getAISlashMenuItems(editor) : [],
     );
 
     const index = combinedMenu.findIndex(
@@ -74,14 +66,7 @@ export const BlockNoteSuggestionMenu = ({
 
     return async (query: string) =>
       Promise.resolve(filterSuggestionItems(newSlashMenuItems, query));
-  }, [
-    editor,
-    t,
-    fileBlocksName,
-    basicBlocksName,
-    aiAllowed,
-    getInterlinkingMenuItems,
-  ]);
+  }, [basicBlocksName, editor, getInterlinkingMenuItems, t, fileBlocksName]);
 
   return (
     <SuggestionMenuController

src/frontend/apps/impress/src/features/docs/doc-editor/components/BlockNoteToolBar/AIButton.tsx

@@ -0,0 +1,371 @@
+import { Block } from '@blocknote/core';
+import {
+  ComponentProps,
+  useBlockNoteEditor,
+  useComponentsContext,
+  useSelectedBlocks,
+} from '@blocknote/react';
+import {
+  Loader,
+  VariantType,
+  useToastProvider,
+} from '@gouvfr-lasuite/cunningham-react';
+import { PropsWithChildren, ReactNode, useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { isAPIError } from '@/api';
+import { Box, Icon } from '@/components';
+import { useDocOptions, useDocStore } from '@/docs/doc-management/';
+
+import {
+  AITransformActions,
+  useDocAITransform,
+  useDocAITranslate,
+} from '../../api';
+
+type LanguageTranslate = {
+  value: string;
+  display_name: string;
+};
+
+const sortByPopularLanguages = (
+  languages: LanguageTranslate[],
+  popularLanguages: string[],
+) => {
+  languages.sort((a, b) => {
+    const indexA = popularLanguages.indexOf(a.value);
+    const indexB = popularLanguages.indexOf(b.value);
+
+    // If both languages are in the popular list, sort based on their order in popularLanguages
+    if (indexA !== -1 && indexB !== -1) {
+      return indexA - indexB;
+    }
+
+    // If only a is in the popular list, it should come first
+    if (indexA !== -1) {
+      return -1;
+    }
+
+    // If only b is in the popular list, it should come first
+    if (indexB !== -1) {
+      return 1;
+    }
+
+    // If neither a nor b is in the popular list, maintain their relative order
+    return 0;
+  });
+};
+
+export function AIGroupButton() {
+  const editor = useBlockNoteEditor();
+  const Components = useComponentsContext();
+  const selectedBlocks = useSelectedBlocks(editor);
+  const { t } = useTranslation();
+  const { currentDoc } = useDocStore();
+  const { data: docOptions } = useDocOptions();
+
+  const languages = useMemo(() => {
+    const languages = docOptions?.actions.POST.language.choices;
+
+    if (!languages) {
+      return;
+    }
+
+    sortByPopularLanguages(languages, [
+      'fr',
+      'en',
+      'de',
+      'es',
+      'it',
+      'pt',
+      'nl',
+      'pl',
+    ]);
+
+    return languages;
+  }, [docOptions?.actions.POST.language.choices]);
+
+  const show = useMemo(() => {
+    return !!selectedBlocks.find((block) => block.content !== undefined);
+  }, [selectedBlocks]);
+
+  if (!show || !editor.isEditable || !Components || !currentDoc || !languages) {
+    return null;
+  }
+
+  const canAITransform = currentDoc.abilities.ai_transform;
+  const canAITranslate = currentDoc.abilities.ai_translate;
+
+  if (!canAITransform && !canAITranslate) {
+    return null;
+  }
+
+  return (
+    <Components.Generic.Menu.Root>
+      <Components.Generic.Menu.Trigger>
+        <Components.FormattingToolbar.Button
+          className="bn-button bn-menu-item --docs--ai-actions-menu-trigger"
+          data-test="ai-actions"
+          label="AI"
+          mainTooltip={t('AI Actions')}
+          icon={<Icon iconName="auto_awesome" $size="md" />}
+        />
+      </Components.Generic.Menu.Trigger>
+      <Components.Generic.Menu.Dropdown
+        className="bn-menu-dropdown bn-drag-handle-menu --docs--ai-actions-menu"
+        sub={true}
+      >
+        {canAITransform && (
+          <>
+            <AIMenuItemTransform
+              action="prompt"
+              docId={currentDoc.id}
+              icon={<Icon iconName="text_fields" $size="s" />}
+            >
+              {t('Use as prompt')}
+            </AIMenuItemTransform>
+            <AIMenuItemTransform
+              action="rephrase"
+              docId={currentDoc.id}
+              icon={<Icon iconName="refresh" $size="s" />}
+            >
+              {t('Rephrase')}
+            </AIMenuItemTransform>
+            <AIMenuItemTransform
+              action="summarize"
+              docId={currentDoc.id}
+              icon={<Icon iconName="summarize" $size="s" />}
+            >
+              {t('Summarize')}
+            </AIMenuItemTransform>
+            <AIMenuItemTransform
+              action="correct"
+              docId={currentDoc.id}
+              icon={<Icon iconName="check" $size="s" />}
+            >
+              {t('Correct')}
+            </AIMenuItemTransform>
+            <AIMenuItemTransform
+              action="beautify"
+              docId={currentDoc.id}
+              icon={<Icon iconName="draw" $size="s" />}
+            >
+              {t('Beautify')}
+            </AIMenuItemTransform>
+            <AIMenuItemTransform
+              action="emojify"
+              docId={currentDoc.id}
+              icon={<Icon iconName="emoji_emotions" $size="s" />}
+            >
+              {t('Emojify')}
+            </AIMenuItemTransform>
+          </>
+        )}
+        {canAITranslate && (
+          <Components.Generic.Menu.Root position="right" sub={true}>
+            <Components.Generic.Menu.Trigger sub={false}>
+              <Components.Generic.Menu.Item
+                className="bn-menu-item --docs--ai-translate-menu-trigger"
+                subTrigger={true}
+              >
+                <Box $direction="row" $gap="0.6rem">
+                  <Icon iconName="translate" $size="s" />
+                  {t('Language')}
+                </Box>
+              </Components.Generic.Menu.Item>
+            </Components.Generic.Menu.Trigger>
+            <Components.Generic.Menu.Dropdown
+              sub={true}
+              className="bn-menu-dropdown --docs--ai-translate-menu"
+            >
+              {languages.map((language) => (
+                <AIMenuItemTranslate
+                  key={language.value}
+                  language={language.value}
+                  docId={currentDoc.id}
+                >
+                  {language.display_name}
+                </AIMenuItemTranslate>
+              ))}
+            </Components.Generic.Menu.Dropdown>
+          </Components.Generic.Menu.Root>
+        )}
+      </Components.Generic.Menu.Dropdown>
+    </Components.Generic.Menu.Root>
+  );
+}
+
+/**
+ * Item is derived from Mantime, some props seem lacking or incorrect.
+ */
+type ItemDefault = ComponentProps['Generic']['Menu']['Item'];
+type ItemProps = Omit<ItemDefault, 'onClick'> & {
+  rightSection?: ReactNode;
+  closeMenuOnClick?: boolean;
+  onClick: (e: React.MouseEvent) => void;
+};
+
+interface AIMenuItemTransformProps {
+  action: AITransformActions;
+  docId: string;
+  icon?: ReactNode;
+}
+
+const AIMenuItemTransform = ({
+  docId,
+  action,
+  children,
+  icon,
+}: PropsWithChildren<AIMenuItemTransformProps>) => {
+  const { mutateAsync: requestAI, isPending } = useDocAITransform();
+  const editor = useBlockNoteEditor();
+
+  const requestAIAction = async (selectedBlocks: Block[]) => {
+    const text = await editor.blocksToMarkdownLossy(selectedBlocks);
+
+    const responseAI = await requestAI({
+      text,
+      action,
+      docId,
+    });
+
+    if (!responseAI?.answer) {
+      throw new Error('No response from AI');
+    }
+
+    const markdown = await editor.tryParseMarkdownToBlocks(responseAI.answer);
+    editor.replaceBlocks(selectedBlocks, markdown);
+  };
+
+  return (
+    <AIMenuItem icon={icon} requestAI={requestAIAction} isPending={isPending}>
+      {children}
+    </AIMenuItem>
+  );
+};
+
+interface AIMenuItemTranslateProps {
+  language: string;
+  docId: string;
+  icon?: ReactNode;
+}
+
+const AIMenuItemTranslate = ({
+  children,
+  docId,
+  icon,
+  language,
+}: PropsWithChildren<AIMenuItemTranslateProps>) => {
+  const { mutateAsync: requestAI, isPending } = useDocAITranslate();
+  const editor = useBlockNoteEditor();
+
+  const requestAITranslate = async (selectedBlocks: Block[]) => {
+    let fullHtml = '';
+    for (const block of selectedBlocks) {
+      if (Array.isArray(block.content) && block.content.length === 0) {
+        fullHtml += '<p><br/></p>';
+        continue;
+      }
+
+      fullHtml += await editor.blocksToHTMLLossy([block]);
+    }
+
+    const responseAI = await requestAI({
+      text: fullHtml,
+      language,
+      docId,
+    });
+
+    if (!responseAI || !responseAI.answer) {
+      throw new Error('No response from AI');
+    }
+
+    try {
+      const blocks = await editor.tryParseHTMLToBlocks(responseAI.answer);
+      editor.replaceBlocks(selectedBlocks, blocks);
+    } catch {
+      editor.replaceBlocks(selectedBlocks, selectedBlocks);
+    }
+  };
+
+  return (
+    <AIMenuItem
+      icon={icon}
+      requestAI={requestAITranslate}
+      isPending={isPending}
+    >
+      {children}
+    </AIMenuItem>
+  );
+};
+
+interface AIMenuItemProps {
+  requestAI: (blocks: Block[]) => Promise<void>;
+  isPending: boolean;
+  icon?: ReactNode;
+}
+
+const AIMenuItem = ({
+  requestAI,
+  isPending,
+  children,
+  icon,
+}: PropsWithChildren<AIMenuItemProps>) => {
+  const Components = useComponentsContext();
+  const { toast } = useToastProvider();
+  const { t } = useTranslation();
+
+  const editor = useBlockNoteEditor();
+  const handleAIError = useHandleAIError();
+
+  const handleAIAction = async () => {
+    const selectedBlocks = editor.getSelection()?.blocks ?? [
+      editor.getTextCursorPosition().block,
+    ];
+
+    if (!selectedBlocks?.length) {
+      toast(t('No text selected'), VariantType.WARNING);
+      return;
+    }
+
+    try {
+      await requestAI(selectedBlocks);
+    } catch (error) {
+      handleAIError(error);
+    }
+  };
+
+  if (!Components) {
+    return null;
+  }
+
+  const Item = Components.Generic.Menu.Item as React.FC<ItemProps>;
+
+  return (
+    <Item
+      closeMenuOnClick={false}
+      icon={icon}
+      onClick={(e: React.MouseEvent) => {
+        e.stopPropagation();
+        void handleAIAction();
+      }}
+      rightSection={isPending ? <Loader size="small" /> : undefined}
+    >
+      {children}
+    </Item>
+  );
+};
+
+const useHandleAIError = () => {
+  const { toast } = useToastProvider();
+  const { t } = useTranslation();
+
+  return (error: unknown) => {
+    if (isAPIError(error) && error.status === 429) {
+      toast(t('Too many requests. Please wait 60 seconds.'), VariantType.ERROR);
+      return;
+    }
+
+    toast(t('AI seems busy! Please try again.'), VariantType.ERROR);
+  };
+};

src/frontend/apps/impress/src/features/docs/doc-editor/components/BlockNoteToolBar/BlockNoteToolbar.tsx

@@ -8,21 +8,22 @@ import {
 import React, { useCallback, useMemo, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 
-import BlockNoteAI from '../AI';
+import { useConfig } from '@/core/config/api';
+
 import { CommentToolbarButton } from '../comments/CommentToolbarButton';
 import { getCalloutFormattingToolbarItems } from '../custom-blocks';
 
+import { AIGroupButton } from './AIButton';
 import { FileDownloadButton } from './FileDownloadButton';
 import { MarkdownButton } from './MarkdownButton';
 import { ModalConfirmDownloadUnsafe } from './ModalConfirmDownloadUnsafe';
 
-const AIToolbarButton = BlockNoteAI?.AIToolbarButton;
-
-export const BlockNoteToolbar = ({ aiAllowed }: { aiAllowed: boolean }) => {
+export const BlockNoteToolbar = () => {
   const dict = useDictionary();
   const [confirmOpen, setIsConfirmOpen] = useState(false);
   const [onConfirm, setOnConfirm] = useState<() => void | Promise<void>>();
   const { t } = useTranslation();
+  const { data: conf } = useConfig();
 
   const toolbarItems = useMemo(() => {
     let toolbarItems = getFormattingToolbarItems([
@@ -68,17 +69,18 @@ export const BlockNoteToolbar = ({ aiAllowed }: { aiAllowed: boolean }) => {
   const formattingToolbar = useCallback(() => {
     return (
       <FormattingToolbar>
-        {aiAllowed && AIToolbarButton && <AIToolbarButton />}
-
         <CommentToolbarButton />
 
         {toolbarItems}
 
+        {/* Extra button to do some AI powered actions */}
+        {conf?.AI_FEATURE_ENABLED && <AIGroupButton key="AIButton" />}
+
         {/* Extra button to convert from markdown to json */}
         <MarkdownButton key="customButton" />
       </FormattingToolbar>
     );
-  }, [toolbarItems, aiAllowed]);
+  }, [toolbarItems, conf?.AI_FEATURE_ENABLED]);
 
   return (
     <>

src/frontend/apps/impress/src/features/docs/doc-editor/components/DocEditor.tsx

@@ -5,6 +5,7 @@ import { Box, Loading } from '@/components';
 import { DocHeader } from '@/docs/doc-header/';
 import {
   Doc,
+  useDocFocusManagement,
   useIsCollaborativeEditable,
   useProviderStore,
 } from '@/docs/doc-management';
@@ -82,7 +83,9 @@ export const DocEditor = ({ doc }: DocEditorProps) => {
   const readOnly =
     !doc.abilities.partial_update || !isEditable || isLoading || isDeletedDoc;
   const { setIsSkeletonVisible } = useSkeletonStore();
-  const isProviderReady = isReady && provider;
+  const isProviderReady = Boolean(isReady && provider);
+
+  useDocFocusManagement(doc.id, isProviderReady);
 
   useEffect(() => {
     if (isProviderReady) {

src/frontend/apps/impress/src/features/docs/doc-editor/hook/useSaveDoc.tsx

@@ -35,26 +35,7 @@ export const useSaveDoc = (
       _updatedDoc: Y.Doc,
       transaction: Y.Transaction,
     ) => {
-      /**
-       * When the AI edit the doc transaction.local is false,
-       * so we check if the origin constructor to know where
-       * the transaction comes from.
-       * "PluginKey" constructor comes from the current user, but transaction.local is more reliable
-       * "HocuspocusProvider" constructor comes from other users from the collaboration server,
-       * it seems quite reliable too.
-       * The AI constructor name seems to not be reliable enough, but by deduction if it's not local
-       * and not from other users, it has to be from the AI.
-       *
-       * TODO: see if we can get the local changes from the AI
-       */
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-      const transactionOrigin = transaction?.origin?.constructor?.name;
-      const PROVIDER_ORIGIN_CONSTRUCTOR = 'HocuspocusProvider';
-
-      const isAIChange =
-        !transaction.local && transactionOrigin !== PROVIDER_ORIGIN_CONSTRUCTOR;
-
-      setIsLocalChange(transaction.local || isAIChange);
+      setIsLocalChange(transaction.local);
     };
 
     yDoc.on('update', onUpdate);

src/frontend/apps/impress/src/features/docs/doc-editor/styles.tsx

@@ -1,11 +1,6 @@
 import { css } from 'styled-components';
 
 export const cssEditor = css`
-  .mantine-Menu-itemLabel,
-  .mantine-Button-label {
-    font-family: var(--c--components--button--font-family);
-  }
-
   &,
   & > .bn-container,
   & .ProseMirror {
@@ -153,16 +148,6 @@ export const cssEditor = css`
     font-style: italic;
   }
 
-  /**
-    * AI
-    */
-  ins,
-  [data-type='modification'] {
-    background: var(--c--globals--colors--primary-100);
-    border-bottom: 2px solid var(--c--globals--colors--primary-300);
-    color: var(--c--globals--colors--primary-700);
-  }
-
   /**
   * Divider
   */

src/frontend/apps/impress/src/features/docs/doc-export/api/useExport.tsx

@@ -0,0 +1,44 @@
+import { useMutation } from '@tanstack/react-query';
+
+import { APIError, errorCauses, fetchAPI } from '@/api';
+
+interface CreateExportParams {
+  templateId: string;
+  body: string;
+  body_type: 'html' | 'markdown';
+  format: 'pdf' | 'docx';
+}
+
+export const createExport = async ({
+  templateId,
+  body,
+  body_type,
+  format,
+}: CreateExportParams): Promise<Blob> => {
+  const response = await fetchAPI(
+    `templates/${templateId}/generate-document/`,
+    {
+      method: 'POST',
+      body: JSON.stringify({
+        body,
+        body_type,
+        format,
+      }),
+    },
+  );
+
+  if (!response.ok) {
+    throw new APIError(
+      'Failed to export the document',
+      await errorCauses(response),
+    );
+  }
+
+  return await response.blob();
+};
+
+export function useExport() {
+  return useMutation<Blob, APIError, CreateExportParams>({
+    mutationFn: createExport,
+  });
+}

src/frontend/apps/impress/src/features/docs/doc-export/api/useTemplates.tsx

@@ -0,0 +1,74 @@
+import {
+  DefinedInitialDataInfiniteOptions,
+  InfiniteData,
+  QueryKey,
+  useInfiniteQuery,
+} from '@tanstack/react-query';
+
+import { APIError, APIList, errorCauses, fetchAPI } from '@/api';
+
+import { Template } from '../types';
+
+export enum TemplatesOrdering {
+  BY_CREATED_ON = 'created_at',
+  BY_CREATED_ON_DESC = '-created_at',
+}
+
+export type TemplatesParams = {
+  ordering: TemplatesOrdering;
+};
+type TemplatesAPIParams = TemplatesParams & {
+  page: number;
+};
+
+type TemplatesResponse = APIList<Template>;
+
+export const getTemplates = async ({
+  ordering,
+  page,
+}: TemplatesAPIParams): Promise<TemplatesResponse> => {
+  const orderingQuery = ordering ? `&ordering=${ordering}` : '';
+  const response = await fetchAPI(`templates/?page=${page}${orderingQuery}`);
+
+  if (!response.ok) {
+    throw new APIError(
+      'Failed to get the templates',
+      await errorCauses(response),
+    );
+  }
+
+  return response.json() as Promise<TemplatesResponse>;
+};
+
+export const KEY_LIST_TEMPLATE = 'templates';
+
+export function useTemplates(
+  param: TemplatesParams,
+  queryConfig?: DefinedInitialDataInfiniteOptions<
+    TemplatesResponse,
+    APIError,
+    InfiniteData<TemplatesResponse>,
+    QueryKey,
+    number
+  >,
+) {
+  return useInfiniteQuery<
+    TemplatesResponse,
+    APIError,
+    InfiniteData<TemplatesResponse>,
+    QueryKey,
+    number
+  >({
+    initialPageParam: 1,
+    queryKey: [KEY_LIST_TEMPLATE, param],
+    queryFn: ({ pageParam }) =>
+      getTemplates({
+        ...param,
+        page: pageParam,
+      }),
+    getNextPageParam(lastPage, allPages) {
+      return lastPage.next ? allPages.length + 1 : undefined;
+    },
+    ...queryConfig,
+  });
+}

src/frontend/apps/impress/src/features/docs/doc-export/blocks-mapping/tablePDF.tsx

@@ -135,7 +135,7 @@ export const utilTable = (
   columnWidths: (number | undefined)[],
 ) => {
   const totalColumnWidthKnown = columnWidths.reduce(
-    (sum: number, w) => sum + (w && !isNaN(w) ? w : 0),
+    (sum: number, w) => sum + (w ?? 0),
     0,
   );
   const nbColumnWidthUnknown = columnWidths.filter((w) => !w).length;

src/frontend/apps/impress/src/features/docs/doc-export/components/ModalExport.tsx

@@ -14,7 +14,7 @@ import { DocumentProps, pdf } from '@react-pdf/renderer';
 import jsonemoji from 'emoji-datasource-apple' assert { type: 'json' };
 import i18next from 'i18next';
 import JSZip from 'jszip';
-import { cloneElement, isValidElement, useState } from 'react';
+import { cloneElement, isValidElement, useMemo, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { css } from 'styled-components';
 
@@ -25,6 +25,7 @@ import { Doc, useTrans } from '@/docs/doc-management';
 import { fallbackLng } from '@/i18n/config';
 
 import { exportCorsResolveFileUrl } from '../api/exportResolveFileUrl';
+import { TemplatesOrdering, useTemplates } from '../api/useTemplates';
 import { docxDocsSchemaMappings } from '../mappingDocx';
 import { odtDocsSchemaMappings } from '../mappingODT';
 import { pdfDocsSchemaMappings } from '../mappingPDF';
@@ -49,8 +50,12 @@ interface ModalExportProps {
 
 export const ModalExport = ({ onClose, doc }: ModalExportProps) => {
   const { t } = useTranslation();
+  const { data: templates } = useTemplates({
+    ordering: TemplatesOrdering.BY_CREATED_ON_DESC,
+  });
   const { toast } = useToastProvider();
   const { editor } = useEditorStore();
+  const [templateSelected, setTemplateSelected] = useState<string>('');
   const [isExporting, setIsExporting] = useState(false);
   const [format, setFormat] = useState<DocDownloadFormat>(
     DocDownloadFormat.PDF,
@@ -58,6 +63,24 @@ export const ModalExport = ({ onClose, doc }: ModalExportProps) => {
   const { untitledDocument } = useTrans();
   const mediaUrl = useMediaUrl();
 
+  const templateOptions = useMemo(() => {
+    const templateOptions = (templates?.pages || [])
+      .map((page) =>
+        page.results.map((template) => ({
+          label: template.title,
+          value: template.code,
+        })),
+      )
+      .flat();
+
+    templateOptions.unshift({
+      label: t('Empty template'),
+      value: '',
+    });
+
+    return templateOptions;
+  }, [t, templates?.pages]);
+
   async function onSubmit() {
     if (!editor) {
       toast(t('The export failed'), VariantType.ERROR);
@@ -74,7 +97,13 @@ export const ModalExport = ({ onClose, doc }: ModalExportProps) => {
 
     const documentTitle = doc.title || untitledDocument;
 
-    const exportDocument = editor.document;
+    const html = templateSelected;
+    let exportDocument = editor.document;
+    if (html) {
+      const blockTemplate = await editor.tryParseHTMLToBlocks(html);
+      exportDocument = [...blockTemplate, ...editor.document];
+    }
+
     let blobExport: Blob;
     if (format === DocDownloadFormat.PDF) {
       const exporter = new PDFExporter(editor.schema, pdfDocsSchemaMappings, {
@@ -261,6 +290,17 @@ export const ModalExport = ({ onClose, doc }: ModalExportProps) => {
             setFormat(options.target.value as DocDownloadFormat)
           }
         />
+        <Select
+          clearable={false}
+          fullWidth
+          label={t('Template')}
+          options={templateOptions}
+          value={templateSelected}
+          disabled={format === DocDownloadFormat.HTML}
+          onChange={(options) =>
+            setTemplateSelected(options.target.value as string)
+          }
+        />
 
         {isExporting && (
           <Box

src/frontend/apps/impress/src/features/docs/doc-export/mappingDocx.tsx

@@ -22,29 +22,6 @@ export const docxDocsSchemaMappings: DocsExporterDocx['mappings'] = {
     quote: blockMappingQuoteDocx,
     image: blockMappingImageDocx,
     uploadLoader: blockMappingUploadLoaderDocx,
-    table: (block, exporter, nestedLevel, numberedListIndex, children) => {
-      /**
-       * Nan values are not supported, so we need to replace them with undefined
-       * to avoid issues during the export.
-       */
-      const { columnWidths } = block.content;
-      const hasNaN = columnWidths.some(
-        (width) => typeof width === 'number' && Number.isNaN(width),
-      );
-      if (hasNaN) {
-        block.content.columnWidths = columnWidths.map((width) =>
-          typeof width === 'number' && Number.isNaN(width) ? undefined : width,
-        );
-      }
-
-      return docxDefaultSchemaMappings.blockMapping.table(
-        block,
-        exporter,
-        nestedLevel,
-        numberedListIndex,
-        children,
-      );
-    },
   },
   inlineContentMapping: {
     ...docxDefaultSchemaMappings.inlineContentMapping,

src/frontend/apps/impress/src/features/docs/doc-export/types.ts

@@ -13,6 +13,24 @@ import {
   DocsInlineContentSchema,
   DocsStyleSchema,
 } from '../doc-editor';
+import { Access } from '../doc-management';
+
+export interface Template {
+  id: string;
+  abilities: {
+    destroy: boolean;
+    generate_document: boolean;
+    accesses_manage: boolean;
+    retrieve: boolean;
+    update: boolean;
+    partial_update: boolean;
+  };
+  accesses: Access[];
+  title: string;
+  is_public: boolean;
+  css: string;
+  code: string;
+}
 
 export type DocsExporterPDF = Exporter<
   NoInfer<DocsBlockSchema>,

src/frontend/apps/impress/src/features/docs/doc-header/components/DocToolBox.tsx

@@ -19,7 +19,6 @@ import {
   Doc,
   KEY_DOC,
   KEY_LIST_DOC,
-  KEY_LIST_FAVORITE_DOC,
   ModalRemoveDoc,
   getEmojiAndTitle,
   useCopyDocLink,
@@ -68,10 +67,10 @@ export const DocToolBox = ({ doc }: DocToolBoxProps) => {
     },
   });
   const removeFavoriteDoc = useDeleteFavoriteDoc({
-    listInvalidQueries: [KEY_LIST_DOC, KEY_DOC, KEY_LIST_FAVORITE_DOC],
+    listInvalidQueries: [KEY_LIST_DOC, KEY_DOC],
   });
   const makeFavoriteDoc = useCreateFavoriteDoc({
-    listInvalidQueries: [KEY_LIST_DOC, KEY_DOC, KEY_LIST_FAVORITE_DOC],
+    listInvalidQueries: [KEY_LIST_DOC, KEY_DOC],
   });
 
   useEffect(() => {

src/frontend/apps/impress/src/features/docs/doc-management/api/index.ts

@@ -5,7 +5,6 @@ export * from './useDeleteFavoriteDoc';
 export * from './useDoc';
 export * from './useDocOptions';
 export * from './useDocs';
-export * from './useDocsFavorite';
 export * from './useDuplicateDoc';
 export * from './useRestoreDoc';
 export * from './useSubDocs';

src/frontend/apps/impress/src/features/docs/doc-management/api/useDocsFavorite.tsx

@@ -1,72 +0,0 @@
-import { UseQueryOptions, useQuery } from '@tanstack/react-query';
-
-import {
-  APIError,
-  APIList,
-  InfiniteQueryConfig,
-  errorCauses,
-  fetchAPI,
-  useAPIInfiniteQuery,
-} from '@/api';
-
-import { Doc } from '../types';
-
-export type DocsFavoriteParams = {
-  page: number;
-};
-
-export type DocsFavoriteResponse = APIList<Doc>;
-export const getDocsFavorite = async (
-  params: DocsFavoriteParams,
-): Promise<DocsFavoriteResponse> => {
-  const searchParams = new URLSearchParams();
-
-  if (params.page) {
-    searchParams.set('page', params.page.toString());
-  }
-
-  const response = await fetchAPI(
-    `documents/favorite_list/?${searchParams.toString()}`,
-  );
-
-  if (!response.ok) {
-    throw new APIError(
-      'Failed to get the favorite docs',
-      await errorCauses(response),
-    );
-  }
-
-  return response.json() as Promise<DocsFavoriteResponse>;
-};
-
-export const KEY_LIST_FAVORITE_DOC = 'docs_favorite_list';
-
-type UseDocsOptions = UseQueryOptions<
-  DocsFavoriteResponse,
-  APIError,
-  DocsFavoriteResponse
->;
-type UseInfiniteDocsOptions = InfiniteQueryConfig<DocsFavoriteResponse>;
-
-export function useDocsFavorite(
-  params: DocsFavoriteParams,
-  queryConfig?: UseDocsOptions,
-) {
-  return useQuery<DocsFavoriteResponse, APIError, DocsFavoriteResponse>({
-    queryKey: [KEY_LIST_FAVORITE_DOC, params],
-    queryFn: () => getDocsFavorite(params),
-    ...queryConfig,
-  });
-}
-
-export const useInfiniteDocsFavorite = (
-  params: DocsFavoriteParams,
-  queryConfig?: UseInfiniteDocsOptions,
-) => {
-  return useAPIInfiniteQuery(
-    KEY_LIST_FAVORITE_DOC,
-    getDocsFavorite,
-    params,
-    queryConfig,
-  );
-};

src/frontend/apps/impress/src/features/docs/doc-management/components/DocIcon.tsx

@@ -15,6 +15,13 @@ import {
 } from '@/components';
 
 import { useDocTitleUpdate } from '../hooks/useDocTitleUpdate';
+import { cssSelectors } from '../utils';
+
+const getClosestTreeItem = (element: HTMLElement | null) =>
+  element?.closest<HTMLElement>(cssSelectors.DOC_TREE_ROW) ??
+  element?.closest<HTMLElement>(cssSelectors.DOC_TREE_NODE) ??
+  element?.closest<HTMLElement>('[role="treeitem"]') ??
+  null;
 
 type DocIconProps = TextType & {
   buttonProps?: BoxButtonType;
@@ -110,6 +117,30 @@ export const DocIcon = ({
     setOpenEmojiPicker(false);
   };
 
+  const handleEscape = () => {
+    setOpenEmojiPicker(false);
+    window.requestAnimationFrame(() => {
+      const localTreeItem = getClosestTreeItem(iconRef.current);
+      const docTree = document.querySelector<HTMLElement>(
+        cssSelectors.DOC_TREE,
+      );
+      const docTreeItem =
+        localTreeItem ||
+        docTree?.querySelector<HTMLElement>(
+          cssSelectors.DOC_TREE_FOCUSED_NODE,
+        ) ||
+        docTree?.querySelector<HTMLElement>(
+          cssSelectors.DOC_TREE_SELECTED_ROW,
+        ) ||
+        docTree?.querySelector<HTMLElement>(
+          cssSelectors.DOC_TREE_SELECTED_NODE,
+        ) ||
+        document.querySelector<HTMLElement>(cssSelectors.DOC_TREE_ROOT);
+
+      docTreeItem?.focus();
+    });
+  };
+
   return (
     <>
       <BoxButton
@@ -151,6 +182,7 @@ export const DocIcon = ({
               onEmojiSelect={handleEmojiSelect}
               onClickOutside={handleClickOutside}
               withOverlay={true}
+              onEscape={handleEscape}
             />
           </Box>,
           document.body,

src/frontend/apps/impress/src/features/docs/doc-management/hooks/index.ts

@@ -1,6 +1,7 @@
 export * from './useCollaboration';
 export * from './useCopyDocLink';
 export * from './useCreateChildDocTree';
+export * from './useDocFocusManagement';
 export * from './useDocTitleUpdate';
 export * from './useDocUtils';
 export * from './useIsCollaborativeEditable';

src/frontend/apps/impress/src/features/docs/doc-management/hooks/useDocFocusManagement.tsx

@@ -0,0 +1,91 @@
+import { useEffect } from 'react';
+
+import { cssSelectors } from '@/docs/doc-management/utils';
+
+const isWithin = (el: Element | null, selector: string) =>
+  !!el?.closest(selector);
+
+export const useDocFocusManagement = (docId?: string, isReady = true) => {
+  // 1) Auto-focus title when opening a doc
+  useEffect(() => {
+    if (!docId || !isReady || typeof window === 'undefined') {
+      return;
+    }
+
+    const frameId = window.requestAnimationFrame(() => {
+      const titleElement = document.querySelector<HTMLElement>(
+        cssSelectors.DOC_TITLE,
+      );
+      if (!titleElement) {
+        return;
+      }
+
+      // Avoid stealing focus if user is already in the doc tree or editor.
+      const activeEl = document.activeElement;
+      const active = activeEl instanceof Element ? activeEl : null;
+      const isInDocUI =
+        isWithin(active, cssSelectors.DOC_EDITOR_FOCUS) ||
+        isWithin(active, cssSelectors.DOC_TREE);
+
+      const isBodyFocused = activeEl === document.body;
+
+      if (isBodyFocused && !isInDocUI && activeEl !== titleElement) {
+        titleElement.focus();
+      }
+    });
+
+    return () => window.cancelAnimationFrame(frameId);
+  }, [docId, isReady]);
+
+  // 2) Escape from editor/title -> focus back the selected tree item (or root)
+  useEffect(() => {
+    if (!docId || !isReady || typeof window === 'undefined') {
+      return;
+    }
+
+    const handleFocusShortcut = (event: KeyboardEvent) => {
+      if (event.key !== 'F6' || event.defaultPrevented) {
+        return;
+      }
+
+      const target = event.target instanceof Element ? event.target : null;
+      const activeEl = document.activeElement;
+      const active = activeEl instanceof Element ? activeEl : null;
+
+      const isDocFocus =
+        isWithin(target, cssSelectors.DOC_EDITOR_FOCUS) ||
+        isWithin(active, cssSelectors.DOC_EDITOR_FOCUS) ||
+        isWithin(target, cssSelectors.DOC_TITLE) ||
+        isWithin(active, cssSelectors.DOC_TITLE);
+
+      if (!isDocFocus) {
+        return;
+      }
+
+      const docTree = document.querySelector<HTMLElement>(
+        cssSelectors.DOC_TREE,
+      );
+
+      const docTreeItem =
+        docTree?.querySelector<HTMLElement>(
+          cssSelectors.DOC_TREE_SELECTED_ROW,
+        ) ||
+        docTree?.querySelector<HTMLElement>(
+          cssSelectors.DOC_TREE_SELECTED_NODE,
+        ) ||
+        document.querySelector<HTMLElement>(cssSelectors.DOC_TREE_ROOT);
+
+      if (!docTreeItem) {
+        return;
+      }
+
+      docTreeItem.focus();
+      event.preventDefault();
+      event.stopPropagation();
+    };
+
+    document.addEventListener('keydown', handleFocusShortcut, true);
+    return () =>
+      document.removeEventListener('keydown', handleFocusShortcut, true);
+  }, [docId, isReady]);
+};

src/frontend/apps/impress/src/features/docs/doc-management/types.tsx

@@ -74,7 +74,8 @@ export interface Doc {
   abilities: {
     accesses_manage: boolean;
     accesses_view: boolean;
-    ai_proxy: boolean;
+    ai_transform: boolean;
+    ai_translate: boolean;
     attachment_upload: boolean;
     children_create: boolean;
     children_list: boolean;

src/frontend/apps/impress/src/features/docs/doc-management/utils.ts

@@ -38,3 +38,15 @@ export const getEmojiAndTitle = (title: string) => {
 
   return { emoji: null, titleWithoutEmoji: title };
 };
+
+export const cssSelectors = {
+  DOC_TITLE: '.--docs--doc-title-input[contenteditable="true"]',
+  DOC_TREE_ROOT: '[data-testid="doc-tree-root-item"]',
+  DOC_TREE: '[data-testid="doc-tree"]',
+  DOC_EDITOR_FOCUS: '.--docs--main-editor, .--docs--doc-title-input',
+  DOC_TREE_ROW: '.c__tree-view--row',
+  DOC_TREE_NODE: '.c__tree-view--node',
+  DOC_TREE_FOCUSED_NODE: '.c__tree-view--node.isFocused',
+  DOC_TREE_SELECTED_ROW: '.c__tree-view--row[aria-selected="true"]',
+  DOC_TREE_SELECTED_NODE: '.c__tree-view--node[aria-selected="true"]',
+} as const;