feat(transport) : saisie assistée QUALIMAT + champs conditionnels (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m8s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m36s

This commit is contained in:
2026-06-16 17:22:25 +02:00
parent f1b18cfbbe
commit f70e701854
7 changed files with 738 additions and 48 deletions
@@ -1,10 +1,16 @@
import { reactive, ref } from 'vue'
import { computed, reactive, ref } from 'vue'
import { useFormErrors } from '~/shared/composables/useFormErrors'
import {
emptyCarrierAddressCopy,
emptyCarrierMain,
type CarrierAddressCopy,
type CarrierMainDraft,
type CarrierMainResponse,
} from '~/modules/transport/types/carrierForm'
import type { QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
/** Nom du cas spécial « compte-propre » LIOT (comparaison insensible à la casse, RG-4.01). */
const LIOT_NAME = 'LIOT'
/**
* Workflow de l'écran « Ajouter un transporteur » (M4 Transport, ERP-165) —
@@ -50,6 +56,24 @@ export function useCarrierForm() {
// ── Formulaire principal ──────────────────────────────────────────────────
const main = reactive<CarrierMainDraft>(emptyCarrierMain())
// Adresse copiée depuis QUALIMAT à la sélection (alimente l'onglet Adresses,
// ticket ultérieur). Vide tant qu'aucun transporteur QUALIMAT n'est intégré.
const qualimatAddress = ref<CarrierAddressCopy>(emptyCarrierAddressCopy())
// ── Affichage conditionnel du formulaire principal (RG-4.01 / 4.02 / 4.03) ──
// Cas LIOT : nom == « LIOT » → seul `liotPlates` est pertinent, le reste masqué.
const isLiot = computed(() => main.name.trim().toUpperCase() === LIOT_NAME)
// Transporteur QUALIMAT : la FK est posée → certification figée à « QUALIMAT ».
const isQualimat = computed(() => main.qualimatCarrierIri !== null)
// Certification masquée en cas LIOT ; lecture seule si QUALIMAT (ou bloc verrouillé).
const showCertification = computed(() => !isLiot.value)
const certificationReadonly = computed(() => isQualimat.value || mainLocked.value)
// RG-4.03 : champs d'affrètement (indexation / contenant / volume) visibles et
// obligatoires si « Affréter » coché — masqués en cas LIOT.
const showCharteredFields = computed(() => main.isChartered && !isLiot.value)
// RG-4.02 : décharge visible et obligatoire si certification == AUTRE (hors LIOT).
const showDischarge = computed(() => main.certificationType === 'AUTRE' && !isLiot.value)
// ── Onglets : ordre + gating progressif ───────────────────────────────────
const tabKeys = ref<string[]>([...CARRIER_TAB_KEYS])
// Index du dernier onglet déverrouillé (-1 tant que le transporteur n'est pas créé).
@@ -92,15 +116,45 @@ export function useCarrierForm() {
* certification) sur le champ plutôt qu'une erreur de type.
*/
function buildMainPayload(): Record<string, unknown> {
const payload: Record<string, unknown> = {
isChartered: main.isChartered,
// Cas LIOT (RG-4.01) : seul `liotPlates` est pertinent ; les autres champs
// sont masqués côté front et non envoyés (le back stocke ce qu'il reçoit).
if (isLiot.value) {
const payload: Record<string, unknown> = { name: main.name, isChartered: false }
if (main.liotPlates.trim()) {
payload.liotPlates = main.liotPlates
}
return payload
}
if (main.name?.trim()) {
const payload: Record<string, unknown> = { isChartered: main.isChartered }
if (main.name.trim()) {
payload.name = main.name
}
if (main.certificationType) {
payload.certificationType = main.certificationType
}
// FK QUALIMAT (saisie assistée, § 2.5) envoyée si une ligne a été intégrée.
if (main.qualimatCarrierIri) {
payload.qualimatCarrier = main.qualimatCarrierIri
}
// RG-4.02 : décharge envoyée seulement en certification AUTRE ; omise quand
// absente pour que la 422 « obligatoire » porte sur le champ.
if (main.certificationType === 'AUTRE' && main.dischargeDocumentIri) {
payload.dischargeDocument = main.dischargeDocumentIri
}
// RG-4.03 : indexation / contenant / volume envoyés seulement si affrété ;
// omis quand vides pour déclencher la 422 NotBlank inline sur le champ.
if (main.isChartered) {
if (main.indexationRate.trim()) {
payload.indexationRate = main.indexationRate
}
if (main.containerType) {
payload.containerType = main.containerType
}
if (main.volumeM3.trim()) {
payload.volumeM3 = main.volumeM3
}
}
return payload
}
@@ -162,6 +216,43 @@ export function useCarrierForm() {
await api.patch(`/carriers/${carrierId.value}`, payload, { toast: false })
}
/**
* Intègre une ligne QUALIMAT sélectionnée dans l'onglet Qualimat (RG-4.01 /
* § 2.5) : copie le nom, force la certification à « QUALIMAT » (lecture seule),
* pose la FK `qualimatCarrier` (IRI) et copie l'adresse (pour l'onglet Adresses).
* Si le transporteur existe déjà (post-POST, cas nominal de l'onglet), persiste
* la copie via un PATCH partiel `carrier:write:main`. La copie locale a lieu
* dans tous les cas. Retourne true si l'intégration a abouti.
*/
async function applyQualimatSelection(row: QualimatCarrierRow): Promise<boolean> {
main.name = row.name ?? ''
main.certificationType = 'QUALIMAT'
main.qualimatCarrierIri = row['@id']
qualimatAddress.value = {
country: 'France',
postalCode: row.postalCode ?? '',
city: row.city ?? '',
street: row.address ?? '',
}
if (carrierId.value === null) {
return true
}
try {
await patchCarrier({
qualimatCarrier: row['@id'],
name: row.name,
certificationType: 'QUALIMAT',
})
return true
}
catch (error) {
mainErrors.handleApiError(error, { fallbackMessage: t('transport.carriers.toast.error') })
return false
}
}
/**
* Marque un onglet validé (passe en lecture seule), déverrouille et avance à
* l'onglet suivant. Retourne true si c'était le dernier onglet du flux (création
@@ -186,10 +277,18 @@ export function useCarrierForm() {
return {
// état
main,
qualimatAddress,
carrierId,
mainLocked,
mainSubmitting,
mainErrors,
// affichage conditionnel
isLiot,
isQualimat,
showCertification,
certificationReadonly,
showCharteredFields,
showDischarge,
// onglets
tabKeys,
activeTab,
@@ -202,6 +301,7 @@ export function useCarrierForm() {
buildMainPayload,
submitMain,
patchCarrier,
applyQualimatSelection,
completeTab,
}
}