feat(transport) : upload décharge (useUpload) + câblage MalioInputUpload + i18n erreur (ERP-171)

This commit is contained in:
2026-06-17 15:14:31 +02:00
parent b6b5bb06e8
commit 1d5110d000
6 changed files with 179 additions and 7 deletions
+2 -1
View File
@@ -621,7 +621,8 @@
"dischargeRequired": "La décharge est obligatoire pour une certification « Autre ».",
"indexationRequired": "Le taux d'indexation est obligatoire pour un transporteur affrété.",
"containerTypeRequired": "Le type de contenant est obligatoire pour un transporteur affrété.",
"volumeRequired": "Le volume est obligatoire pour un transporteur affrété."
"volumeRequired": "Le volume est obligatoire pour un transporteur affrété.",
"uploadFailed": "Le téléversement de la décharge a échoué."
},
"address": {
"country": "Pays",
@@ -1,5 +1,6 @@
import { computed, reactive, ref, type Ref } from 'vue'
import { useFormErrors } from '~/shared/composables/useFormErrors'
import { useUpload } from '~/shared/composables/useUpload'
import { extractApiErrorMessage, mapViolationsToRecord } from '~/shared/utils/api'
import { removeCollectionRow } from '~/shared/utils/collectionRow'
import {
@@ -66,6 +67,9 @@ export function useCarrierForm() {
// Erreurs de validation par champ (ERP-101) du formulaire principal.
const mainErrors = useFormErrors()
// Upload de la décharge (RG-4.02) — infra partagée /api/uploaded_documents.
const { uploading: dischargeUploading, upload: uploadFile } = useUpload()
// ── État du transporteur créé ─────────────────────────────────────────────
const carrierId = ref<number | null>(null)
const mainLocked = ref(false)
@@ -165,6 +169,24 @@ export function useCarrierForm() {
return valid
}
/**
* Upload de la décharge (RG-4.02) déclenché par `@file-selected` du champ
* Décharge : envoie le fichier, pose l'IRI résultant sur le brouillon. Au 422
* (MIME hors whitelist / taille), le message back s'affiche sous le champ
* (pas de toast) ; l'IRI est remis à null pour bloquer la validation.
*/
async function uploadDischarge(file: File): Promise<void> {
mainErrors.clearError('dischargeDocument')
try {
main.dischargeDocumentIri = await uploadFile(file)
} catch (error) {
main.dischargeDocumentIri = null
const message = extractApiErrorMessage((error as { data?: unknown })?.data)
|| t('transport.carriers.form.errors.uploadFailed')
mainErrors.setError('dischargeDocument', message)
}
}
/**
* Payload du POST principal (groupe `carrier:write:main`). `name` et
* `certificationType` sont omis s'ils sont vides afin que la 422 porte la
@@ -732,6 +754,7 @@ export function useCarrierForm() {
mainSubmitting,
tabSubmitting,
mainErrors,
dischargeUploading,
// affichage conditionnel
isLiot,
isQualimat,
@@ -768,6 +791,7 @@ export function useCarrierForm() {
removePrice,
submitPrices,
// actions
uploadDischarge,
validateMainFront,
buildMainPayload,
submitMain,
@@ -45,12 +45,16 @@
/>
<MalioInputUpload
v-if="showDischarge"
:model-value="dischargeFileName"
:label="t('transport.carriers.form.main.discharge')"
accept="application/pdf,image/*"
:required="true"
:readonly="dischargeUploading"
:clearable="true"
:error="mainErrors.errors.dischargeDocument"
@clear="main.dischargeDocumentIri = null"
@update:model-value="(v: string) => dischargeFileName = v"
@file-selected="uploadDischarge"
@clear="onClearDischarge"
/>
<div v-else class="hidden xl:block"></div>
<div class="flex h-12 items-center">
@@ -231,6 +235,8 @@ const {
mainSubmitting,
tabSubmitting,
mainErrors,
dischargeUploading,
uploadDischarge,
isLiot,
certificationReadonly,
showCharteredFields,
@@ -307,6 +313,12 @@ onMounted(async () => {
await load()
if (carrier.value) {
prefillFrom(carrier.value)
// Pré-affiche le nom du fichier de décharge déjà rattaché (s'il existe).
const doc = carrier.value.dischargeDocument
if (doc && typeof doc !== 'string') {
const meta = doc as Record<string, unknown>
dischargeFileName.value = String(meta.originalFilename ?? meta.name ?? '')
}
}
loadCountries().catch(() => {})
void loadOptions('/clients', clientOptions, m => String(m.companyName ?? m['@id']))
@@ -319,6 +331,16 @@ function apiErrorMessage(err: unknown): string {
return extractApiErrorMessage(data) || t('transport.carriers.toast.error')
}
// Nom de fichier affiché dans le champ Décharge (alimenté à la sélection ou au
// chargement d'un transporteur ayant déjà une décharge).
const dischargeFileName = ref('')
/** Vidage du champ Décharge : retire l'IRI et le nom affiché. */
function onClearDischarge(): void {
main.dischargeDocumentIri = null
dischargeFileName.value = ''
}
// Indexation plafonnée à 100 % : la clé force le ré-affichage du MalioInputAmount
// (contrôlé) quand le plafonnement laisse le modelValue inchangé.
const indexationKey = ref(0)
@@ -53,18 +53,20 @@
<!-- Colonne 3 RÉSERVÉE à la Décharge (RG-4.02 : visible et obligatoire
si certification AUTRE). Si elle n'apparaît pas, on garde la colonne
vide (xl) pour qu'« Affréter » reste en colonne 4 de la ligne 1.
L'upload reel (File → IRI via useUpload) arrive a ERP-171. -->
<!-- TODO ERP-171 : brancher useUpload pour resoudre le File en IRI
(main.dischargeDocumentIri). Le champ est deja visible/obligatoire. -->
L'upload réel (File → IRI via useUpload, ERP-171) résout le
fichier en IRI posé sur main.dischargeDocumentIri. -->
<MalioInputUpload
v-if="showDischarge"
:model-value="dischargeFileName"
:label="t('transport.carriers.form.main.discharge')"
accept="application/pdf,image/*"
:required="true"
:readonly="mainLocked"
:readonly="mainLocked || dischargeUploading"
:clearable="true"
:error="mainErrors.errors.dischargeDocument"
@clear="main.dischargeDocumentIri = null"
@update:model-value="(v: string) => dischargeFileName = v"
@file-selected="uploadDischarge"
@clear="onClearDischarge"
/>
<div v-else class="hidden xl:block"></div>
@@ -398,6 +400,8 @@ const {
mainSubmitting,
tabSubmitting,
mainErrors,
dischargeUploading,
uploadDischarge,
isLiot,
isQualimat,
certificationReadonly,
@@ -429,6 +433,15 @@ const {
applyQualimatSelection,
} = useCarrierForm()
// Nom de fichier affiché dans le champ Décharge (alimenté à la sélection).
const dischargeFileName = ref('')
/** Vidage du champ Décharge : retire l'IRI et le nom affiché. */
function onClearDischarge(): void {
main.dischargeDocumentIri = null
dischargeFileName.value = ''
}
const {
items: qualimatItems,
totalItems: qualimatTotal,
@@ -0,0 +1,59 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
/**
* Tests du composable d'upload générique (ERP-171) :
* - succès : POST multipart /uploaded_documents (champ « file »), toast désactivé,
* renvoie l'IRI (@id) du document créé, `uploading` retombe à false ;
* - erreur MIME hors whitelist → 422 : l'erreur est RELAYÉE à l'appelant (pour un
* affichage inline sous le champ), `uploading` ré-armé via le finally.
*/
const mockPost = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({
get: vi.fn(),
post: mockPost,
put: vi.fn(),
patch: vi.fn(),
delete: vi.fn(),
}))
const { useUpload } = await import('../useUpload')
describe('useUpload', () => {
beforeEach(() => {
mockPost.mockReset()
})
it('succès : POST multipart champ « file » + toast:false → renvoie l\'IRI', async () => {
mockPost.mockResolvedValue({ '@id': '/api/uploaded_documents/9', originalFilename: 'decharge.pdf' })
const { upload, uploading } = useUpload()
const file = new File(['contenu'], 'decharge.pdf', { type: 'application/pdf' })
const iri = await upload(file)
expect(iri).toBe('/api/uploaded_documents/9')
const [url, body, options] = mockPost.mock.calls[0]
expect(url).toBe('/uploaded_documents')
expect(body).toBeInstanceOf(FormData)
const stored = (body as FormData).get('file')
expect(stored).toBeInstanceOf(File)
expect((stored as File).name).toBe('decharge.pdf')
expect(options).toMatchObject({ toast: false })
expect(uploading.value).toBe(false)
})
it('erreur MIME → 422 : l\'erreur est remontée à l\'appelant', async () => {
const error = Object.assign(new Error('422'), {
data: { 'hydra:description': 'Type de fichier non autorisé.' },
})
mockPost.mockRejectedValue(error)
const { upload, uploading } = useUpload()
const file = new File(['x'], 'malware.exe', { type: 'application/x-msdownload' })
await expect(upload(file)).rejects.toBe(error)
expect(uploading.value).toBe(false)
})
})
+53
View File
@@ -0,0 +1,53 @@
import { ref } from 'vue'
import type { AnyObject } from '~/shared/composables/useApi'
/**
* Réponse JSON-LD de POST /api/uploaded_documents (groupe `uploaded_document:read`).
* Seul l'IRI (`@id`) est exploité pour le poser sur la relation cible.
*/
export interface UploadedDocumentResponse {
'@id': string
originalFilename?: string
mimeType?: string
}
/**
* Upload d'un document générique vers l'infra partagée (ERP-154) :
* POST /api/uploaded_documents en multipart/form-data, champ « file », via
* `useApi()` (cookie JWT, parsing Hydra/erreurs). Renvoie l'IRI du document créé,
* à poser sur la relation cible (ex: `carrier.dischargeDocument` — RG-4.02).
*
* Les erreurs (MIME hors whitelist / fichier trop volumineux → 422) sont relayées
* (rethrow) à l'appelant pour un affichage inline sous le champ. `toast: false` par
* défaut : pas de toast fourre-tout, le formulaire mappe le message au bon champ.
*/
export function useUpload() {
// Indicateur d'upload en cours (désactivation UI / spinner éventuel).
const uploading = ref(false)
/**
* Envoie `file` et renvoie l'IRI du `UploadedDocument` créé.
* @throws relaie l'erreur réseau / 422 (MIME, taille) à l'appelant.
*/
async function upload(file: File, options: { toast?: boolean } = {}): Promise<string> {
const formData = new FormData()
formData.append('file', file)
uploading.value = true
try {
// useApi() détecte le FormData et n'impose pas de Content-Type JSON :
// le navigateur pose lui-même la frontière multipart.
const doc = await useApi().post<UploadedDocumentResponse>(
'/uploaded_documents',
formData as unknown as AnyObject,
{ toast: options.toast ?? false },
)
return doc['@id']
} finally {
uploading.value = false
}
}
return { uploading, upload }
}