feat(frontend) : add TaskDocument DTO, service and i18n translations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

frontend/i18n/locales/fr.json

@@ -60,6 +60,17 @@
         "archived": "Groupe archivé avec succès.",
         "unarchived": "Groupe désarchivé avec succès."
     },
+    "taskDocuments": {
+        "title": "Documents",
+        "dropzone": "Glisser des fichiers ici ou cliquer pour sélectionner",
+        "uploaded": "Document ajouté avec succès.",
+        "deleted": "Document supprimé avec succès.",
+        "uploadError": "Erreur lors de l'upload du document.",
+        "confirmDeleteTitle": "Supprimer le document",
+        "confirmDeleteMessage": "Êtes-vous sûr de vouloir supprimer ce document ?",
+        "download": "Télécharger",
+        "maxSizeError": "Le fichier dépasse la taille maximale de 50 Mo."
+    },
     "tasks": {
         "created": "Ticket créé avec succès.",
         "updated": "Ticket mis à jour avec succès.",

frontend/services/dto/task-document.ts

@@ -0,0 +1,13 @@
+import type { UserData } from './user-data'
+
+export type TaskDocument = {
+    '@id'?: string
+    id: number
+    task: string
+    originalName: string
+    fileName: string
+    mimeType: string
+    size: number
+    createdAt: string
+    uploadedBy: UserData | null
+}

frontend/services/dto/task.ts

@@ -5,6 +5,7 @@ import type { TaskTag } from './task-tag'
 import type { TaskGroup } from './task-group'
 import type { UserData } from './user-data'
 import type { Project } from './project'
+import type { TaskDocument } from './task-document'
 
 export type Task = {
     id: number
@@ -19,6 +20,7 @@ export type Task = {
     group: TaskGroup | null
     project: Project | null
     tags: TaskTag[]
+    documents: TaskDocument[]
     archived: boolean
 }
 

frontend/services/task-documents.ts

@@ -0,0 +1,42 @@
+import type { TaskDocument } from './dto/task-document'
+import type { HydraCollection } from '~/utils/api'
+import { extractHydraMembers } from '~/utils/api'
+import { $fetch } from 'ofetch'
+
+export function useTaskDocumentService() {
+    const api = useApi()
+    const config = useRuntimeConfig()
+    const baseURL = config.public.apiBase || '/api'
+
+    async function getByTask(taskId: number): Promise<TaskDocument[]> {
+        const data = await api.get<HydraCollection<TaskDocument>>('/task_documents', {
+            task: `/api/tasks/${taskId}`,
+        })
+        return extractHydraMembers(data)
+    }
+
+    async function upload(taskId: number, file: File): Promise<TaskDocument> {
+        const formData = new FormData()
+        formData.append('file', file)
+        formData.append('task', `/api/tasks/${taskId}`)
+
+        return await $fetch<TaskDocument>(`${baseURL}/task_documents`, {
+            method: 'POST',
+            body: formData,
+            credentials: 'include',
+            // Do NOT set Content-Type — browser sets multipart boundary automatically
+        })
+    }
+
+    async function remove(id: number): Promise<void> {
+        await api.delete(`/task_documents/${id}`, {}, {
+            toastSuccessKey: 'taskDocuments.deleted',
+        })
+    }
+
+    function getDownloadUrl(id: number): string {
+        return `${baseURL}/task_documents/${id}/download`
+    }
+
+    return { getByTask, upload, remove, getDownloadUrl }
+}