Compare commits

...

13 Commits

Author SHA1 Message Date
tristan 388d39a379 refactor(transport) : onglet Qualimat en MalioDataTable paginé, recherche branchée sur le nom (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m1s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m44s
2026-06-16 18:02:16 +02:00
tristan d6d2144cc1 feat(transport) : croix de suppression sur le champ Décharge (clearable) (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m9s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m33s
2026-06-16 17:50:49 +02:00
tristan 6a519874ed fix(transport) : pré-validation front des champs conditionnels obligatoires (décharge AUTRE, affrètement) (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Has been cancelled
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:49:08 +02:00
tristan 3804362546 fix(transport) : certification obligatoire en pré-validation front, sauf cas LIOT (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m7s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:45:11 +02:00
tristan 9864dbc00f fix(transport) : colonne 3 réservée à la décharge, « Affréter » toujours en colonne 4 (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m9s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:41:38 +02:00
tristan be03f4e51a fix(transport) : ordre des champs Nom/Certif/Décharge/Affréter/Indexation/Benne/Volume (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Has been cancelled
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:38:41 +02:00
tristan 8cc2cea444 fix(transport) : décharge après volume (nouvelle ligne) + contenant Benne/FM en select (ERP-166)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m1s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:35:27 +02:00
tristan f70e701854 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
2026-06-16 17:22:25 +02:00
tristan f1b18cfbbe fix(transport) : centre verticalement la case « Affréter » sur la ligne de champ (ERP-165)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m2s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m24s
2026-06-16 17:09:48 +02:00
tristan 5734aaef54 feat(transport) : écran ajout transporteur — layout + formulaire principal (ERP-165)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m11s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
2026-06-16 17:05:21 +02:00
tristan 597c63bb2e chore(frontend) : bump @malio/layer-ui ^1.7.12 + commentaire useSuppliersRepository
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m14s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m31s
2026-06-16 16:59:25 +02:00
tristan 8046de76c6 feat(transport) : filtres checkbox, toggle « Voir les archivés », transporteurs dans Administration (ERP-164)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 3m9s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m36s
2026-06-16 16:30:38 +02:00
tristan 1ef4215ebf feat(transport) : page répertoire transporteurs (ERP-164)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 2m54s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m33s
2026-06-16 16:21:15 +02:00
16 changed files with 2244 additions and 35 deletions
+13 -18
View File
@@ -78,23 +78,6 @@ return [
],
],
],
// Section "Transport" (M4, ERP-153) : pole logistique, porte le repertoire
// transporteurs. L'item est gate par `transport.carriers.view` ; la section
// disparait automatiquement (SidebarProvider) si le module `transport` est
// desactive ou si l'user n'a pas la permission (Compta / Usine).
[
'label' => 'sidebar.transport.section',
'icon' => 'mdi:truck-outline',
'items' => [
[
'label' => 'sidebar.transport.carriers',
'to' => '/carriers',
'icon' => 'mdi:truck-outline',
'module' => 'transport',
'permission' => 'transport.carriers.view',
],
],
],
// Section "Administration" : regroupe toutes les pages de configuration
// applicative (RBAC, users, sites, audit log).
//
@@ -117,8 +100,20 @@ return [
// individuelles"), ajouter : 'permission' => 'core.admin.access'.
[
'label' => 'sidebar.administration.section',
'icon' => 'mdi:cog-outline',
'icon' => 'mdi:file-settings-cog-outline',
'items' => [
// Transport — Repertoire transporteurs (M4, ERP-164). Rattache a
// l'Administration (premier item) plutot qu'a une section dediee :
// referentiel global de configuration applicative, sans cloisonnement
// par site. Reste gate par sa propre permission `transport.carriers.view`
// (Admin / Bureau / Commerciale) et son module owner `transport`.
[
'label' => 'sidebar.transport.carriers',
'to' => '/carriers',
'icon' => 'mdi:truck-outline',
'module' => 'transport',
'permission' => 'transport.carriers.view',
],
[
'label' => 'sidebar.core.roles',
'to' => '/admin/roles',
+87
View File
@@ -495,6 +495,93 @@
}
}
},
"transport": {
"carriers": {
"title": "Répertoire transporteurs",
"add": "Ajouter",
"export": "Exporter",
"empty": "Aucun transporteur pour l'instant.",
"column": {
"name": "Nom",
"certification": "Certification",
"validityDate": "Date de validité",
"lastActivity": "Dernière activité"
},
"certification": {
"QUALIMAT": "QUALIMAT",
"GMP_PLUS": "GMP+",
"OVOCOM": "OVOCOM",
"COMPTE_PROPRE": "Compte-propre",
"AUTRE": "Autre"
},
"filters": {
"title": "Filtres",
"search": "Recherche",
"certification": "Certification",
"status": "Statut",
"archivedOnly": "Voir les archivés",
"apply": "Voir les résultats",
"reset": "Réinitialiser"
},
"toast": {
"error": "Une erreur est survenue. Réessayez.",
"exportError": "L'export du répertoire transporteurs a échoué. Réessayez.",
"createSuccess": "Transporteur créé avec succès",
"integrateSuccess": "Transporteur QUALIMAT intégré"
},
"containerType": {
"BENNE": "Benne",
"FOND_MOUVANT": "Fond mouvant"
},
"tab": {
"qualimat": "Qualimat",
"addresses": "Adresses",
"contacts": "Contacts",
"prices": "Prix"
},
"form": {
"title": "Ajouter un transporteur",
"back": "Retour au répertoire",
"submit": "Valider",
"comingSoon": "À venir",
"duplicateName": "Un transporteur actif portant ce nom existe déjà.",
"main": {
"name": "Nom",
"certificationType": "Certification transport",
"isChartered": "Affréter",
"indexationRate": "Indexation %",
"containerType": "Benne / Fond mouvant",
"volumeM3": "Volume m³",
"discharge": "Décharge",
"liotPlates": "Immatriculations LIOT",
"liotPlatesHint": "Séparées par « ; »"
},
"qualimat": {
"empty": "Aucun transporteur QUALIMAT trouvé.",
"continue": "Continuer",
"columns": {
"name": "Nom",
"address": "Adresse",
"validityDate": "Date de validité"
},
"confirm": {
"title": "Intégration QUALIMAT",
"message": "Êtes-vous sûr de vouloir intégrer ce transporteur ?",
"cancel": "Annuler",
"confirm": "Intégrer"
}
},
"errors": {
"nameRequired": "Le nom du transporteur est obligatoire.",
"certificationRequired": "Le type de certification est obligatoire.",
"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é."
}
}
}
},
"auth": {
"login": "Connexion",
"logout": "Deconnexion",
@@ -41,9 +41,10 @@ export interface Supplier {
* sur la ressource `/suppliers` (RG-13 : pagination serveur obligatoire ; jamais
* de chargement integral en memoire). Miroir de `useClientsRepository` (M1).
*
* Les filtres (recherche, categories, sites, inclusion des archives) sont pilotes
* par la page via `setFilters` du composable partage — la remise en page 1 est
* garantie.
* Les filtres (recherche, categories, sites, archives) sont pilotes par la page
* via `setFilters` du composable partage — la remise en page 1 est garantie.
* Cocher « Voir les archivés » envoie `archivedOnly=true` → seules les archives
* sont listees (aligne sur Client).
*
* Volontairement PAR INSTANCE (pas de singleton module-level) : l'etat tableau
* est propre a l'ecran Repertoire et meurt avec lui, comme tout consommateur de
@@ -0,0 +1,414 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
/**
* Tests du workflow « Ajouter un transporteur » (M4 Transport, ERP-165).
*
* `useCarrierForm` porte le formulaire principal (Nom + Certification + Affréter)
* et l'orchestration des onglets de création. On vérifie ici le CONTRAT propre à
* la création :
* - pré-check front : nom requis → POST bloqué, erreur inline, aucun appel réseau ;
* - POST /carriers (groupe carrier:write:main) : payload + Accept ld+json +
* toast:false ; au succès, verrouillage + bascule sur l'onglet Qualimat +
* réaffichage du nom normalisé ;
* - 409 doublon (RG-4.12) → erreur inline dédiée sur `name` ;
* - 422 → mapping inline par champ (propertyPath) ;
* - onglets : 4 onglets (Qualimat/Adresses/Contacts/Prix), completeTab
* déverrouille/avance et signale le dernier onglet ;
* - patchCarrier : PATCH partiel, no-op avant création.
*/
const mockPost = vi.hoisted(() => vi.fn())
const mockPatch = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({
get: vi.fn(),
post: mockPost,
put: vi.fn(),
patch: mockPatch,
delete: vi.fn(),
}))
vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
vi.stubGlobal('useToast', () => ({
success: vi.fn(),
error: vi.fn(),
warning: vi.fn(),
info: vi.fn(),
}))
const { useCarrierForm, CARRIER_TAB_KEYS } = await import('../useCarrierForm')
describe('useCarrierForm', () => {
beforeEach(() => {
mockPost.mockReset()
mockPatch.mockReset()
})
it('front : nom vide → erreur inline sur name, pas de POST', async () => {
const form = useCarrierForm()
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.errors.nameRequired')
expect(form.mainLocked.value).toBe(false)
})
it('front : nom en espaces uniquement → erreur inline, pas de POST', async () => {
const form = useCarrierForm()
form.main.name = ' '
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.errors.nameRequired')
})
it('front : certification vide (hors LIOT) → erreur inline sur certificationType, pas de POST', async () => {
const form = useCarrierForm()
form.main.name = 'Acme'
// certificationType laissé null → bloqué côté front (RG-4.01).
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.certificationType).toBe('transport.carriers.form.errors.certificationRequired')
})
it('front : cas LIOT → certification non requise (aucune erreur de certification)', async () => {
mockPost.mockResolvedValueOnce({ id: 5, name: 'LIOT', certificationType: null })
const form = useCarrierForm()
form.main.name = 'LIOT'
form.main.liotPlates = 'AA-123-BB'
const created = await form.submitMain()
expect(created).toBe(true)
expect(form.mainErrors.errors.certificationType).toBeUndefined()
})
it('front RG-4.02 : certification AUTRE sans décharge → erreur inline, pas de POST', async () => {
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'AUTRE'
// dischargeDocumentIri null (upload non fourni).
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.dischargeDocument).toBe('transport.carriers.form.errors.dischargeRequired')
})
it('front RG-4.03 : affrété sans indexation / contenant / volume → 3 erreurs inline, pas de POST', async () => {
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'GMP_PLUS'
form.main.isChartered = true
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.indexationRate).toBe('transport.carriers.form.errors.indexationRequired')
expect(form.mainErrors.errors.containerType).toBe('transport.carriers.form.errors.containerTypeRequired')
expect(form.mainErrors.errors.volumeM3).toBe('transport.carriers.form.errors.volumeRequired')
})
it('front RG-4.03 : affrété avec tous les champs remplis → POST envoyé', async () => {
mockPost.mockResolvedValueOnce({ id: 8, name: 'ACME', certificationType: 'GMP_PLUS' })
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'GMP_PLUS'
form.main.isChartered = true
form.main.indexationRate = '5'
form.main.containerType = 'BENNE'
form.main.volumeM3 = '30'
const created = await form.submitMain()
expect(created).toBe(true)
expect(mockPost).toHaveBeenCalledTimes(1)
expect(mockPost.mock.calls[0]?.[1]).toMatchObject({
isChartered: true,
indexationRate: '5',
containerType: 'BENNE',
volumeM3: '30',
})
})
it('POST /carriers avec Accept ld+json, verrouille et bascule sur Qualimat', async () => {
mockPost.mockResolvedValueOnce({ id: 42, name: 'TRANSPORTS ACME', certificationType: 'GMP_PLUS' })
const form = useCarrierForm()
form.main.name = 'Transports Acme'
form.main.certificationType = 'GMP_PLUS'
const created = await form.submitMain()
expect(created).toBe(true)
expect(mockPost).toHaveBeenCalledTimes(1)
const [url, body, opts] = mockPost.mock.calls[0] ?? []
expect(url).toBe('/carriers')
expect(body).toEqual({
name: 'Transports Acme',
certificationType: 'GMP_PLUS',
isChartered: false,
})
expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
expect(form.carrierId.value).toBe(42)
// RG-4.13 : réaffiche le nom normalisé (UPPERCASE) renvoyé par le serveur.
expect(form.main.name).toBe('TRANSPORTS ACME')
expect(form.mainLocked.value).toBe(true)
expect(form.activeTab.value).toBe('qualimat')
expect(form.unlockedIndex.value).toBe(0)
})
it('buildMainPayload : omet certificationType vide, garde isChartered', () => {
const form = useCarrierForm()
form.main.name = 'X'
const body = form.buildMainPayload()
expect(body).toEqual({ name: 'X', isChartered: false })
expect('certificationType' in body).toBe(false)
})
it('409 doublon (RG-4.12) : erreur inline dédiée sur name, pas de verrouillage', async () => {
mockPost.mockRejectedValueOnce({ response: { status: 409 } })
const form = useCarrierForm()
form.main.name = 'Doublon'
form.main.certificationType = 'GMP_PLUS'
const created = await form.submitMain()
expect(created).toBe(false)
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.duplicateName')
expect(form.mainLocked.value).toBe(false)
})
it('422 : mappe les violations serveur inline par champ', async () => {
// Contrainte re-validée uniquement back (ex. longueur du nom) : le pré-check
// front passe (nom rempli, certif choisie, non affrété), la 422 mappe inline
// sur le champ via son propertyPath.
mockPost.mockRejectedValueOnce({
response: {
status: 422,
_data: { violations: [{ propertyPath: 'name', message: 'Le nom du transporteur ne peut dépasser 255 caractères.' }] },
},
})
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'GMP_PLUS'
const created = await form.submitMain()
expect(created).toBe(false)
expect(form.mainErrors.errors.name).toBe('Le nom du transporteur ne peut dépasser 255 caractères.')
expect(form.mainLocked.value).toBe(false)
})
it('onglets : 4 clés Qualimat/Adresses/Contacts/Prix', () => {
expect(CARRIER_TAB_KEYS).toEqual(['qualimat', 'addresses', 'contacts', 'prices'])
const form = useCarrierForm()
expect(form.tabKeys.value).toEqual(['qualimat', 'addresses', 'contacts', 'prices'])
// Tous verrouillés tant que le formulaire principal n'est pas validé.
expect(form.unlockedIndex.value).toBe(-1)
})
it('completeTab : déverrouille/avance, et signale le dernier onglet du flux', () => {
const form = useCarrierForm()
// Qualimat → Adresses (pas le dernier).
expect(form.completeTab('qualimat')).toBe(false)
expect(form.isValidated('qualimat')).toBe(true)
expect(form.activeTab.value).toBe('addresses')
expect(form.unlockedIndex.value).toBe(1)
expect(form.completeTab('addresses')).toBe(false)
expect(form.activeTab.value).toBe('contacts')
expect(form.completeTab('contacts')).toBe(false)
expect(form.activeTab.value).toBe('prices')
// Prix = dernier onglet → true (création terminée).
expect(form.completeTab('prices')).toBe(true)
expect(form.isValidated('prices')).toBe(true)
})
it('editMode : completeTab ne verrouille pas et ne bascule pas d\'onglet', () => {
const form = useCarrierForm()
form.editMode.value = true
form.activeTab.value = 'qualimat'
expect(form.completeTab('qualimat')).toBe(false)
expect(form.isValidated('qualimat')).toBe(false)
expect(form.activeTab.value).toBe('qualimat')
})
it('patchCarrier : PATCH /carriers/{id} en mode strict, no-op avant création', async () => {
const form = useCarrierForm()
await form.patchCarrier({ liotPlates: 'AA-123-BB' })
expect(mockPatch).not.toHaveBeenCalled()
mockPost.mockResolvedValueOnce({ id: 9, name: 'ACME', certificationType: 'OVOCOM' })
form.main.name = 'Acme'
form.main.certificationType = 'OVOCOM'
await form.submitMain()
await form.patchCarrier({ liotPlates: 'AA-123-BB' })
expect(mockPatch).toHaveBeenCalledWith('/carriers/9', { liotPlates: 'AA-123-BB' }, { toast: false })
})
})
describe('useCarrierForm — champs conditionnels (ERP-166)', () => {
beforeEach(() => {
mockPost.mockReset()
mockPatch.mockReset()
})
it('cas LIOT (insensible à la casse) : masque la certification, payload réduit', () => {
const form = useCarrierForm()
form.main.name = 'liot'
expect(form.isLiot.value).toBe(true)
expect(form.showCertification.value).toBe(false)
form.main.liotPlates = 'AA-123-BB ; CC-456-DD'
expect(form.buildMainPayload()).toEqual({
name: 'liot',
isChartered: false,
liotPlates: 'AA-123-BB ; CC-456-DD',
})
})
it('LIOT masque les champs conditionnels (affrètement / décharge)', () => {
const form = useCarrierForm()
form.main.name = 'LIOT'
form.main.isChartered = true
form.main.certificationType = 'AUTRE'
expect(form.showCharteredFields.value).toBe(false)
expect(form.showDischarge.value).toBe(false)
})
it('RG-4.03 affrété : indexation / contenant / volume visibles et dans le payload', () => {
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'GMP_PLUS'
form.main.isChartered = true
expect(form.showCharteredFields.value).toBe(true)
form.main.indexationRate = '5'
form.main.containerType = 'BENNE'
form.main.volumeM3 = '30'
expect(form.buildMainPayload()).toEqual({
name: 'Acme',
certificationType: 'GMP_PLUS',
isChartered: true,
indexationRate: '5',
containerType: 'BENNE',
volumeM3: '30',
})
})
it('RG-4.03 affrété mais champs vides : omis du payload (422 NotBlank back)', () => {
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'GMP_PLUS'
form.main.isChartered = true
expect(form.buildMainPayload()).toEqual({
name: 'Acme',
certificationType: 'GMP_PLUS',
isChartered: true,
})
})
it('RG-4.02 AUTRE : décharge visible + dischargeDocument dans le payload si IRI résolu', () => {
const form = useCarrierForm()
form.main.name = 'Acme'
form.main.certificationType = 'AUTRE'
expect(form.showDischarge.value).toBe(true)
form.main.dischargeDocumentIri = '/api/uploaded_documents/7'
expect(form.buildMainPayload()).toMatchObject({ dischargeDocument: '/api/uploaded_documents/7' })
})
})
describe('useCarrierForm — copie QUALIMAT (ERP-166)', () => {
const QUALIMAT_ROW = {
'@id': '/api/qualimat_carriers/42',
id: '42',
name: 'TRANSPORTS QUALIMAT',
siret: '12345678900012',
address: '1 rue du Port',
postalCode: '86000',
city: 'Poitiers',
validityDate: '2027-01-15',
status: 'VALIDE',
}
beforeEach(() => {
mockPost.mockReset()
mockPatch.mockReset()
})
it('copie name + certificationType=QUALIMAT (readonly) + IRI + adresse, sans PATCH avant création', async () => {
const form = useCarrierForm()
const ok = await form.applyQualimatSelection(QUALIMAT_ROW)
expect(ok).toBe(true)
expect(mockPatch).not.toHaveBeenCalled()
expect(form.main.name).toBe('TRANSPORTS QUALIMAT')
expect(form.main.certificationType).toBe('QUALIMAT')
expect(form.main.qualimatCarrierIri).toBe('/api/qualimat_carriers/42')
expect(form.isQualimat.value).toBe(true)
expect(form.certificationReadonly.value).toBe(true)
expect(form.qualimatAddress.value).toEqual({
country: 'France',
postalCode: '86000',
city: 'Poitiers',
street: '1 rue du Port',
})
})
it('après création : PATCH /carriers/{id} avec qualimatCarrier + name + certification', async () => {
mockPost.mockResolvedValueOnce({ id: 9, name: 'X', certificationType: 'GMP_PLUS' })
mockPatch.mockResolvedValueOnce({})
const form = useCarrierForm()
form.main.name = 'X'
form.main.certificationType = 'GMP_PLUS'
await form.submitMain()
const ok = await form.applyQualimatSelection(QUALIMAT_ROW)
expect(ok).toBe(true)
expect(mockPatch).toHaveBeenCalledWith(
'/carriers/9',
{
qualimatCarrier: '/api/qualimat_carriers/42',
name: 'TRANSPORTS QUALIMAT',
certificationType: 'QUALIMAT',
},
{ toast: false },
)
})
it('buildMainPayload inclut qualimatCarrier + certificationType QUALIMAT après intégration', async () => {
const form = useCarrierForm()
form.main.name = 'Acme'
await form.applyQualimatSelection(QUALIMAT_ROW)
expect(form.buildMainPayload()).toMatchObject({
qualimatCarrier: '/api/qualimat_carriers/42',
certificationType: 'QUALIMAT',
})
})
})
@@ -0,0 +1,97 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { useCarriersRepository, type Carrier } from '../useCarriersRepository'
const mockApiGet = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
/**
* Tests du repertoire transporteurs (ERP-164).
*
* `useCarriersRepository` est une fine enveloppe de `usePaginatedList<Carrier>`
* sur `/carriers`. Les invariants generiques de pagination sont deja couverts par
* `usePaginatedList.test.ts` ; on verifie ici le CONTRAT propre au repertoire :
* - la ressource ciblee est bien `/carriers` ;
* - l'enveloppe Hydra (member / totalItems) est consommee ;
* - le header `Accept: application/ld+json` est envoye (sinon API Platform 4
* renvoie un tableau plat sans pagination) ;
* - EXCLUSION DES ARCHIVES PAR DEFAUT : aucun `archivedOnly` n'est envoye
* tant que l'utilisateur ne coche pas le filtre (le back masque alors les
* archives) ; le filtre « Voir les archivés » est bien transmis une fois
* applique (aligne sur Client / Fournisseur / Prestataire).
*/
describe('useCarriersRepository', () => {
beforeEach(() => {
mockApiGet.mockReset()
})
/** Une page de transporteurs Hydra, avec qualimatCarrier embarque (RG-4.04). */
const PAGE: Carrier[] = [
{
id: 1,
name: 'TRANSPORTS ACME',
certificationType: 'QUALIMAT',
qualimatCarrier: {
id: '42',
name: 'TRANSPORTS ACME',
validityDate: '2027-01-15',
status: 'VALIDE',
},
updatedAt: '2026-06-15T08:12:01+02:00',
isArchived: false,
},
]
it('cible /carriers, consomme l\'enveloppe Hydra et envoie l\'Accept ld+json', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
expect(mockApiGet).toHaveBeenCalledTimes(1)
const [url, query, opts] = mockApiGet.mock.calls[0]
expect(url).toBe('/carriers')
expect(query).toMatchObject({ page: 1, itemsPerPage: 10 })
expect(opts).toMatchObject({
toast: false,
headers: { Accept: 'application/ld+json' },
})
expect(repo.items.value).toEqual(PAGE)
expect(repo.totalItems.value).toBe(1)
})
it('exclut les archives par defaut : aucun archivedOnly au premier fetch', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
const query = mockApiGet.mock.calls[0][1] as Record<string, unknown>
expect(query.archivedOnly).toBeUndefined()
})
it('transmet archivedOnly une fois le filtre applique (retour page 1)', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
await repo.setFilters({ archivedOnly: true })
expect(repo.currentPage.value).toBe(1)
const query = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
expect(query.archivedOnly).toBe(true)
})
it('transmet les certifications multiples + la recherche', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
await repo.setFilters({ search: 'acme', 'certificationType[]': ['QUALIMAT', 'AUTRE'] })
const query = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
expect(query.search).toBe('acme')
expect(query['certificationType[]']).toEqual(['QUALIMAT', 'AUTRE'])
})
})
@@ -0,0 +1,62 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { useQualimatSearch, type QualimatCarrierRow } from '../useQualimatSearch'
const mockApiGet = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
/**
* Tests de la saisie assistée QUALIMAT (M4 Transport, ERP-166 — RG-4.01).
*
* `useQualimatSearch` est une fine enveloppe de `usePaginatedList<QualimatCarrierRow>`
* sur `/qualimat_carriers`. La pagination générique est couverte par
* `usePaginatedList.test.ts` ; on vérifie ici le CONTRAT propre à la recherche :
* - ressource ciblée `/qualimat_carriers` + enveloppe Hydra + `Accept: application/ld+json` ;
* - le filtre `search` (branché sur le nom du transporteur) est transmis et
* retombe en page 1.
*/
describe('useQualimatSearch', () => {
beforeEach(() => {
mockApiGet.mockReset()
})
const PAGE: QualimatCarrierRow[] = [
{
'@id': '/api/qualimat_carriers/1',
id: '1',
name: 'TRANSPORTS ACME',
siret: '12345678900012',
address: '1 rue du Port',
postalCode: '86000',
city: 'Poitiers',
validityDate: '2027-01-15',
status: 'VALIDE',
},
]
it('cible /qualimat_carriers, consomme l\'enveloppe Hydra et envoie l\'Accept ld+json', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useQualimatSearch()
await repo.fetch()
const [url, query, opts] = mockApiGet.mock.calls[0]
expect(url).toBe('/qualimat_carriers')
expect(query).toMatchObject({ page: 1, itemsPerPage: 10 })
expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
expect(repo.items.value).toEqual(PAGE)
expect(repo.totalItems.value).toBe(1)
})
it('transmet le filtre `search` (nom du transporteur) et retombe en page 1', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useQualimatSearch()
await repo.fetch()
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
await repo.setFilters({ search: 'acme' })
expect(repo.currentPage.value).toBe(1)
const query = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
expect(query.search).toBe('acme')
})
})
@@ -0,0 +1,342 @@
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) —
* miroir conceptuel de `useSupplierForm` (M2) / `useProviderForm` (M3).
*
* Périmètre ERP-165 : le formulaire PRINCIPAL (pré-onglets) et l'orchestration de
* la barre d'onglets. La création est INCRÉMENTALE (spec-front § Écran Ajouter) :
* - on POST d'abord le formulaire principal (`POST /api/carriers`) ;
* - au succès le bloc principal passe en lecture seule, le 1er onglet (Qualimat)
* se déverrouille et devient actif ;
* - chaque onglet validé déverrouille le suivant (PATCH partiels par groupe de
* sérialisation) et passe en lecture seule.
*
* Les champs conditionnels du formulaire principal (indexation / benne / volume
* si affrété, décharge si AUTRE, cas LIOT) et la saisie assistée QUALIMAT arrivent
* à ERP-166 ; le contenu des onglets Adresses / Contacts / Prix aux tickets
* suivants. Ce composable pose le POST principal, le PATCH partiel et le gating
* des onglets.
*
* État 100 % local à l'instance (refs / reactive) — aucune persistance URL.
*/
/**
* Clés des onglets du flux de création, dans l'ordre de la barre (spec-front
* § Écran Ajouter). Toujours les 4 (pas de gating par permission au M4, ≠ l'onglet
* Comptabilité du M3).
*/
export const CARRIER_TAB_KEYS = ['qualimat', 'addresses', 'contacts', 'prices'] as const
export function useCarrierForm() {
const api = useApi()
const { t } = useI18n()
const toast = useToast()
// Erreurs de validation par champ (ERP-101) du formulaire principal.
const mainErrors = useFormErrors()
// ── État du transporteur créé ─────────────────────────────────────────────
const carrierId = ref<number | null>(null)
const mainLocked = ref(false)
const mainSubmitting = ref(false)
// ── 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éé).
const unlockedIndex = ref(-1)
const activeTab = ref<string>(CARRIER_TAB_KEYS[0])
// Onglets validés (passent en lecture seule).
const validated = reactive<Record<string, boolean>>({})
// Mode MODIFICATION (ticket ultérieur) : navigation libre, pas de verrouillage
// ni de bascule automatique d'onglet à la validation (cf. completeTab).
const editMode = ref(false)
function isValidated(key: string): boolean {
return validated[key] === true
}
function tabIndex(key: string): number {
return tabKeys.value.indexOf(key)
}
/**
* Validation FRONT du formulaire principal : seul le nom est requis côté front
* (ERP-101) : feedback immédiat sur tous les champs obligatoires (y compris
* conditionnels), alignés sur les RG du back (qui reste autoritaire) :
* - RG-4.01 : nom requis ; certification requise hors cas LIOT (où tout est masqué) ;
* - RG-4.02 : décharge requise si certification AUTRE ;
* - RG-4.03 : indexation + contenant + volume requis si « Affréter ».
*/
function validateMainFront(): boolean {
let valid = true
if (!main.name?.trim()) {
mainErrors.setError('name', t('transport.carriers.form.errors.nameRequired'))
valid = false
}
// Cas LIOT : seul le nom compte, les autres champs sont masqués (RG-4.01).
if (isLiot.value) {
return valid
}
// RG-4.01 : certification obligatoire hors LIOT.
if (!main.certificationType) {
mainErrors.setError('certificationType', t('transport.carriers.form.errors.certificationRequired'))
valid = false
}
// RG-4.02 : décharge obligatoire si certification AUTRE.
if (main.certificationType === 'AUTRE' && !main.dischargeDocumentIri) {
mainErrors.setError('dischargeDocument', t('transport.carriers.form.errors.dischargeRequired'))
valid = false
}
// RG-4.03 : indexation / contenant / volume obligatoires si affrété.
if (main.isChartered) {
if (!main.indexationRate.trim()) {
mainErrors.setError('indexationRate', t('transport.carriers.form.errors.indexationRequired'))
valid = false
}
if (!main.containerType) {
mainErrors.setError('containerType', t('transport.carriers.form.errors.containerTypeRequired'))
valid = false
}
if (!main.volumeM3.trim()) {
mainErrors.setError('volumeM3', t('transport.carriers.form.errors.volumeRequired'))
valid = false
}
}
return valid
}
/**
* Payload du POST principal (groupe `carrier:write:main`). `name` et
* `certificationType` sont omis s'ils sont vides afin que la 422 porte la
* violation métier (NotBlank sur le nom, « certification obligatoire » sur la
* certification) sur le champ plutôt qu'une erreur de type.
*/
function buildMainPayload(): Record<string, unknown> {
// 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
}
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
}
/**
* POST /carriers (groupe `carrier:write:main`). Pré-check front (nom), puis
* création. Au succès : verrouille le bloc principal, déverrouille le 1er onglet
* et bascule sur « Qualimat ». Retourne true si créé, false sinon.
*/
async function submitMain(): Promise<boolean> {
if (mainSubmitting.value) return false
mainErrors.clearErrors()
if (!validateMainFront()) return false
mainSubmitting.value = true
try {
const created = await api.post<CarrierMainResponse>('/carriers', buildMainPayload(), {
headers: { Accept: 'application/ld+json' },
toast: false,
})
carrierId.value = created.id
// Réaffiche les valeurs normalisées renvoyées par le serveur (nom en
// UPPERCASE — RG-4.13 ; certification éventuellement forcée).
main.name = created.name ?? main.name
main.certificationType = created.certificationType ?? main.certificationType
mainLocked.value = true
unlockedIndex.value = 0
activeTab.value = tabKeys.value[0] ?? CARRIER_TAB_KEYS[0]
toast.success({ title: t('transport.carriers.toast.createSuccess') })
return true
}
catch (error) {
// 409 = doublon de nom (RG-4.12) → erreur inline dédiée + toast ;
// 422 → mapping inline par champ ; autre → toast de fallback (ERP-101).
const status = (error as { response?: { status?: number } })?.response?.status
if (status === 409) {
const message = t('transport.carriers.form.duplicateName')
mainErrors.setError('name', message)
toast.error({ title: t('transport.carriers.toast.error'), message })
}
else {
mainErrors.handleApiError(error, { fallbackMessage: t('transport.carriers.toast.error') })
}
return false
}
finally {
mainSubmitting.value = false
}
}
/**
* PATCH partiel du transporteur (mode strict : un seul groupe de sérialisation
* par appel — spec-back § 2.9). Servira les onglets à champs scalaires des
* tickets suivants. No-op tant que le transporteur n'existe pas.
*/
async function patchCarrier(payload: Record<string, unknown>): Promise<void> {
if (carrierId.value === null) return
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
* terminée), false sinon.
*/
function completeTab(key: string): boolean {
// En modification : navigation libre, l'onglet reste éditable après validation.
if (editMode.value) {
return false
}
validated[key] = true
const index = tabIndex(key)
const next = tabKeys.value[index + 1]
if (next === undefined) {
return true
}
unlockedIndex.value = Math.max(unlockedIndex.value, index + 1)
activeTab.value = next
return false
}
return {
// état
main,
qualimatAddress,
carrierId,
mainLocked,
mainSubmitting,
mainErrors,
// affichage conditionnel
isLiot,
isQualimat,
showCertification,
certificationReadonly,
showCharteredFields,
showDischarge,
// onglets
tabKeys,
activeTab,
unlockedIndex,
validated,
editMode,
isValidated,
// actions
validateMainFront,
buildMainPayload,
submitMain,
patchCarrier,
applyQualimatSelection,
completeTab,
}
}
@@ -0,0 +1,70 @@
import { usePaginatedList } from '~/shared/composables/usePaginatedList'
/**
* Vue MINIMALE du referentiel QUALIMAT embarque (groupe `qualimat:read`) dans la
* LISTE des transporteurs. Seuls les champs consommes par le Repertoire sont
* types : `validityDate` alimente la colonne « Date de validité » (fond rouge si
* perimee — RG-4.04). L'id QUALIMAT est une chaine (colonne BIGINT cote back).
*/
export interface CarrierQualimat {
id: string
name: string | null
/** Date ISO de validite de l'agrement QUALIMAT (date_immutable) — RG-4.04. */
validityDate: string | null
status: string | null
}
/**
* Vue MINIMALE d'un transporteur pour le Repertoire (datatable). Volontairement
* partielle : seuls les champs des colonnes + l'id (navigation) sont types ici.
* Le detail complet (onglets Adresses / Contacts / Prix) est hors perimetre de
* cet ecran (ERP-164, ticket #9).
*
* `certificationType` : QUALIMAT | GMP_PLUS | OVOCOM | COMPTE_PROPRE | AUTRE, ou
* `null` dans le cas LIOT (compte-propre interne sans certification — RG-4.01).
* Le libelle affiche est resolu cote front (cle i18n `transport.carriers.certification.*`).
*/
export interface Carrier {
id: number
name: string | null
certificationType: string | null
/** Lien editable vers le referentiel QUALIMAT (null si transporteur non QUALIMAT). */
qualimatCarrier: CarrierQualimat | null
/** Date ISO de derniere modification (default:read) — colonne « Dernière activité ». */
updatedAt: string | null
isArchived: boolean
}
/**
* Filtres du Repertoire transporteurs, branches sur les query params de
* `GET /api/carriers` (spec-back § 4.1). Pilotes par la page via `setFilters` :
* - `search` : recherche fuzzy sur le nom ;
* - `certificationType[]` : multi-valeurs (OR cote back) ;
* - `archivedOnly` : n'affiche QUE les archives (toggle « Voir les archivés »,
* aligne sur les autres repertoires M1/M2/M3).
*/
export interface CarrierFilters {
search?: string
'certificationType[]'?: string[]
archivedOnly?: boolean
}
/**
* Repertoire transporteurs (M4, ERP-164) — simple enveloppe de
* `usePaginatedList<Carrier>` sur la ressource `/carriers` (regle ABSOLUE n°13 :
* pagination serveur obligatoire ; jamais de chargement integral en memoire).
* Miroir de `useSuppliersRepository` (M2) / `useProvidersRepository` (M3).
*
* Les filtres (recherche, certifications, archives) sont pilotes par la page via
* `setFilters` du composable partage — la remise en page 1 est garantie. Par
* defaut AUCUN `archivedOnly` n'est envoye : le back masque alors les archives
* (§ 2.4). Cocher « Voir les archivés » envoie `archivedOnly=true` (seules les
* archives sont listees, aligne sur Client / Fournisseur / Prestataire).
*
* Volontairement PAR INSTANCE (pas de singleton module-level) : l'etat tableau
* est propre a l'ecran Repertoire et meurt avec lui, comme tout consommateur de
* `usePaginatedList`. Aucun reset au logout a gerer.
*/
export function useCarriersRepository() {
return usePaginatedList<Carrier, CarrierFilters>({ url: '/carriers' })
}
@@ -0,0 +1,40 @@
import { usePaginatedList } from '~/shared/composables/usePaginatedList'
/**
* Ligne du référentiel QUALIMAT renvoyée par la saisie assistée (groupe
* `qualimat:read`). `@id` est l'IRI conservée comme FK `carrier.qualimatCarrier`
* (RG-4.01 / § 2.5) ; `validityDate` pilote le fond rouge de la colonne « Date de
* validité » (RG-4.04).
*/
export interface QualimatCarrierRow {
'@id': string
id: string
name: string | null
siret: string | null
address: string | null
postalCode: string | null
city: string | null
validityDate: string | null
status: string | null
}
/** Filtre de la recherche QUALIMAT (branché sur le nom du transporteur). */
export interface QualimatSearchFilters {
search?: string
}
/**
* Saisie assistée QUALIMAT (M4 Transport, ERP-166 — RG-4.01 / spec-back § 4.7).
*
* `GET /api/qualimat_carriers?search=` : référentiel en LECTURE SEULE, lignes
* actives uniquement (filtré côté serveur), recherche fuzzy nom + siret. Simple
* enveloppe de `usePaginatedList` (règle frontend : toute GetCollection passe par
* ce composable — pagination Hydra, état 100 % local) consommée par le
* `MalioDataTable` de l'onglet Qualimat. Le filtre `search` est piloté par le nom
* saisi dans le formulaire principal (pas de champ de recherche dédié).
*
* Volontairement PAR INSTANCE (état local à l'écran d'ajout).
*/
export function useQualimatSearch() {
return usePaginatedList<QualimatCarrierRow, QualimatSearchFilters>({ url: '/qualimat_carriers' })
}
@@ -0,0 +1,211 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { mount, flushPromises } from '@vue/test-utils'
import { defineComponent, h, ref } from 'vue'
// ── Auto-imports Nuxt stubbes globalement ───────────────────────────────────
// La page ne les importe pas (auto-import) : on les expose en globals pour le
// runtime de test (happy-dom). Meme philosophie que les specs M1/M2/M3.
const mockPush = vi.hoisted(() => vi.fn())
const mockApiGet = vi.hoisted(() => vi.fn())
const mockCan = vi.hoisted(() => vi.fn())
const mockSetFilters = vi.hoisted(() => vi.fn())
const mockFetch = vi.hoisted(() => vi.fn())
const mockToastError = vi.hoisted(() => vi.fn())
vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
vi.stubGlobal('useHead', () => undefined)
vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
vi.stubGlobal('useRouter', () => ({ push: mockPush }))
vi.stubGlobal('useToast', () => ({ error: mockToastError, success: vi.fn() }))
vi.stubGlobal('usePermissions', () => ({ can: mockCan }))
// Le repository est lui aussi un auto-import : on controle items + setFilters.
vi.stubGlobal('useCarriersRepository', () => ({
items: ref([
{
id: 7,
name: 'TRANSPORTS ACME',
certificationType: 'QUALIMAT',
qualimatCarrier: { id: '42', name: 'TRANSPORTS ACME', validityDate: '2027-01-15', status: 'VALIDE' },
updatedAt: '2026-01-15T10:00:00+00:00',
isArchived: false,
},
]),
totalItems: ref(1),
currentPage: ref(1),
itemsPerPage: ref(10),
itemsPerPageOptions: ref([10, 25, 50]),
fetch: mockFetch,
goToPage: vi.fn(),
setItemsPerPage: vi.fn(),
setFilters: mockSetFilters,
}))
// happy-dom n'implemente pas createObjectURL : on ajoute les methodes statiques
// sur la classe URL existante (sans la remplacer — sinon `new URL()` casse).
globalThis.URL.createObjectURL = vi.fn(() => 'blob:fake')
globalThis.URL.revokeObjectURL = vi.fn()
// Import APRES les stubs (la page resout les auto-imports au top-level du module).
const CarriersIndex = (await import('../carriers/index.vue')).default
// ── Stubs de composants ──────────────────────────────────────────────────────
const ButtonStub = defineComponent({
props: { label: { type: String, default: '' }, disabled: { type: Boolean, default: false } },
emits: ['click'],
setup(props, { emit }) {
return () => h('button', { 'data-label': props.label, onClick: () => emit('click') }, props.label)
},
})
const DataTableStub = defineComponent({
props: { items: { type: Array, default: () => [] } },
emits: ['row-click', 'update:page', 'update:per-page'],
setup(props, { emit }) {
return () => h('div', { 'data-testid': 'datatable' },
(props.items as Array<{ id: number }>).map(it =>
h('tr', { 'data-row-id': it.id, onClick: () => emit('row-click', it) }),
),
)
},
})
const DrawerStub = defineComponent({
props: { modelValue: { type: Boolean, default: false } },
setup(_, { slots }) {
return () => h('div', {}, [slots.header?.(), slots.default?.(), slots.footer?.()])
},
})
const SlotStub = defineComponent({ setup(_, { slots }) { return () => h('div', {}, slots.default?.()) } })
const PageHeaderStub = defineComponent({
setup(_, { slots }) { return () => h('div', {}, [slots.default?.(), slots.actions?.()]) },
})
const CheckboxStub = defineComponent({
props: { id: { type: String, default: '' }, modelValue: { type: Boolean, default: false } },
emits: ['update:model-value'],
setup(props, { emit }) {
return () => h('input', {
'type': 'checkbox',
'data-id': props.id,
'onChange': (e: Event) => emit('update:model-value', (e.target as HTMLInputElement).checked),
})
},
})
const InputTextStub = defineComponent({ setup() { return () => h('input') } })
function mountPage() {
return mount(CarriersIndex, {
global: {
stubs: {
PageHeader: PageHeaderStub,
MalioButton: ButtonStub,
MalioDataTable: DataTableStub,
MalioDrawer: DrawerStub,
MalioAccordion: SlotStub,
MalioAccordionItem: SlotStub,
MalioInputText: InputTextStub,
MalioCheckbox: CheckboxStub,
},
},
})
}
describe('Répertoire transporteurs (page /carriers)', () => {
beforeEach(() => {
mockPush.mockReset()
mockApiGet.mockReset().mockResolvedValue({ member: [] })
mockCan.mockReset().mockReturnValue(true)
mockSetFilters.mockReset()
mockFetch.mockReset()
mockToastError.mockReset()
})
it('charge la liste au montage', async () => {
mountPage()
await flushPromises()
expect(mockFetch).toHaveBeenCalled()
})
it('affiche « + Ajouter » uniquement avec la permission manage', async () => {
mockCan.mockImplementation((perm: string) => perm === 'transport.carriers.manage')
const wrapper = mountPage()
await flushPromises()
expect(wrapper.find('[data-label="transport.carriers.add"]').exists()).toBe(true)
})
it('masque « + Ajouter » sans la permission manage (view seul)', async () => {
mockCan.mockImplementation((perm: string) => perm === 'transport.carriers.view')
const wrapper = mountPage()
await flushPromises()
expect(wrapper.find('[data-label="transport.carriers.add"]').exists()).toBe(false)
})
it('navigue vers la consultation au clic sur une ligne', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('tr[data-row-id="7"]').trigger('click')
expect(mockPush).toHaveBeenCalledWith('/carriers/7')
})
it('appelle l\'export XLSX sur /carriers/export.xlsx en blob', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('[data-label="transport.carriers.export"]').trigger('click')
await flushPromises()
expect(mockApiGet).toHaveBeenCalledWith(
'/carriers/export.xlsx',
expect.any(Object),
expect.objectContaining({ responseType: 'blob', toast: false }),
)
})
it('repercute le filtre « Voir les archivés » dans setFilters sans toucher l\'URL', async () => {
const wrapper = mountPage()
await flushPromises()
// Coche « Voir les archivés » puis applique les filtres.
await wrapper.find('input[data-id="filter-archived-only"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith(
{ archivedOnly: true },
{ replace: true },
)
// Etat 100 % local (regle n°6) : aucune navigation/query string declenchee.
expect(mockPush).not.toHaveBeenCalled()
})
it('repercute les certifications cochees dans setFilters (filtre multi)', async () => {
const wrapper = mountPage()
await flushPromises()
// Coche deux certifications via les cases a cocher (pattern repertoire clients).
await wrapper.find('input[data-id="filter-certification-QUALIMAT"]').setValue(true)
await wrapper.find('input[data-id="filter-certification-AUTRE"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith(
{ 'certificationType[]': ['QUALIMAT', 'AUTRE'] },
{ replace: true },
)
})
it('badge filtres actifs + Réinitialiser vide l\'etat applique', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('input[data-id="filter-archived-only"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
// Le libelle du bouton Filtrer porte le compteur (1 filtre actif).
expect(wrapper.find('[data-label="transport.carriers.filters.title (1)"]').exists()).toBe(true)
// Réinitialiser → query propre (setFilters avec objet vide).
await wrapper.find('[data-label="transport.carriers.filters.reset"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith({}, { replace: true })
})
})
@@ -0,0 +1,389 @@
<template>
<div>
<PageHeader>
{{ t('transport.carriers.title') }}
<template #actions>
<!-- gap-8 = 32px d'espacement entre Filtrer et Ajouter. -->
<div class="flex items-center gap-8">
<!-- Bouton Filtrer a GAUCHE d'Ajouter. Le compteur reflete les filtres actifs. -->
<MalioButton
v-if="canView"
variant="tertiary"
:label="filterButtonLabel"
icon-name="mdi:tune"
icon-position="left"
icon-size="24"
@click="openFilters"
/>
<MalioButton
v-if="canManage"
variant="secondary"
:label="t('transport.carriers.add')"
icon-name="mdi:add-bold"
icon-position="left"
@click="goToCreate"
/>
</div>
</template>
</PageHeader>
<!-- Datatable branchee sur usePaginatedList via useCarriersRepository :
pagination serveur, tri name ASC par defaut (cote back). -->
<MalioDataTable
:columns="columns"
:items="rows"
:total-items="totalItems"
:page="currentPage"
:per-page="itemsPerPage"
:per-page-options="itemsPerPageOptions"
row-clickable
:empty-message="t('transport.carriers.empty')"
@row-click="onRowClick"
@update:page="goToPage"
@update:per-page="setItemsPerPage"
>
<!-- Certification : libelle i18n (le back renvoie le code enum). -->
<template #cell-certificationType="{ item }">
{{ formatCertification(item) }}
</template>
<!-- Date de validite QUALIMAT : fond rouge si perimee (< aujourd'hui — RG-4.04). -->
<template #cell-validityDate="{ item }">
<span
v-if="getValidityDate(item)"
:class="isValidityExpired(item) ? 'inline-block rounded px-2 py-0.5 bg-m-danger text-white' : ''"
>
{{ formatDateFr(getValidityDate(item)) }}
</span>
</template>
<!-- Derniere activite : date de derniere modification (updatedAt). -->
<template #cell-lastActivity="{ item }">
{{ formatDateFr(item.updatedAt as string | null) }}
</template>
</MalioDataTable>
<div class="flex justify-center mt-4">
<MalioButton
v-if="canView"
variant="primary"
:label="t('transport.carriers.export')"
:disabled="exporting"
@click="exportXlsx"
/>
</div>
<!-- Drawer de filtres : etat BROUILLON, applique uniquement au clic sur
« Voir les résultats ». Meme pattern que les repertoires M1/M2/M3.
Etat 100 % local, jamais dans l'URL (regle ABSOLUE n°6). -->
<MalioDrawer
v-model="filterDrawerOpen"
drawer-class="max-w-[450px]"
body-class="p-0"
footer-class="justify-between border-t border-black p-6"
>
<template #header>
<h2 class="text-[24px] font-bold uppercase">{{ t('transport.carriers.filters.title') }}</h2>
</template>
<MalioAccordion>
<!-- Recherche : nom du transporteur (param `search`). -->
<MalioAccordionItem :title="t('transport.carriers.filters.search')" value="search">
<MalioInputText
v-model="draftSearch"
icon-name="mdi:magnify"
/>
</MalioAccordionItem>
<!-- Certification : cases a cocher (multi). Valeur = code enum.
Meme pattern que le filtre Categories du repertoire clients. -->
<MalioAccordionItem :title="t('transport.carriers.filters.certification')" value="certification">
<div class="flex flex-col">
<MalioCheckbox
v-for="opt in certificationOptions"
:id="`filter-certification-${opt.value}`"
:key="opt.value"
:label="opt.label"
:model-value="draftCertificationTypes.includes(opt.value)"
@update:model-value="(val: boolean) => toggleCertification(opt.value, val)"
/>
</div>
</MalioAccordionItem>
<!-- Statut : voir uniquement les archives (sinon actifs uniquement). -->
<MalioAccordionItem :title="t('transport.carriers.filters.status')" value="status">
<MalioCheckbox
id="filter-archived-only"
:label="t('transport.carriers.filters.archivedOnly')"
:model-value="draftArchivedOnly"
@update:model-value="(val: boolean) => draftArchivedOnly = val"
/>
</MalioAccordionItem>
</MalioAccordion>
<template #footer>
<MalioButton
variant="tertiary"
:label="t('transport.carriers.filters.reset')"
button-class="w-m-btn-action"
@click="resetFilters"
/>
<MalioButton
variant="primary"
:label="t('transport.carriers.filters.apply')"
button-class="w-[170px]"
@click="applyFilters"
/>
</template>
</MalioDrawer>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue'
interface FilterOption {
value: string
label: string
}
const { t } = useI18n()
const api = useApi()
const router = useRouter()
const toast = useToast()
const { can } = usePermissions()
useHead({ title: t('transport.carriers.title') })
// Bouton « Ajouter » reserve a `manage` (Admin + Bureau). « Exporter » et
// « Filtrer » suivent `view` (Admin / Bureau / Commerciale). Compta et Usine
// n'ont aucun acces (item sidebar masque cote back).
const canManage = computed(() => can('transport.carriers.manage'))
const canView = computed(() => can('transport.carriers.view'))
const {
items: carriers,
totalItems,
currentPage,
itemsPerPage,
itemsPerPageOptions,
fetch: loadCarriers,
goToPage,
setItemsPerPage,
setFilters,
} = useCarriersRepository()
// Mappe les transporteurs en objets « plats » pour MalioDataTable (items typees
// Record<string, unknown>[]) : un objet litteral porte une signature d'index
// implicite, contrairement a l'interface Carrier. Meme pattern que M1/M2/M3.
const rows = computed(() => carriers.value.map(carrier => ({
id: carrier.id,
name: carrier.name,
certificationType: carrier.certificationType,
validityDate: carrier.qualimatCarrier?.validityDate ?? null,
updatedAt: carrier.updatedAt,
})))
const columns = [
{ key: 'name', label: t('transport.carriers.column.name') },
{ key: 'certificationType', label: t('transport.carriers.column.certification') },
{ key: 'validityDate', label: t('transport.carriers.column.validityDate') },
{ key: 'lastActivity', label: t('transport.carriers.column.lastActivity') },
]
// Codes de certification (miroir de l'enum back) + cas LIOT (null). Le libelle
// est resolu par i18n ; un code inconnu retombe sur le code brut.
const CERTIFICATION_CODES = ['QUALIMAT', 'GMP_PLUS', 'OVOCOM', 'COMPTE_PROPRE', 'AUTRE'] as const
const certificationOptions = computed<FilterOption[]>(() =>
CERTIFICATION_CODES.map(code => ({
value: code,
label: t(`transport.carriers.certification.${code}`),
})),
)
/** Libelle i18n de la certification (vide en cas LIOT — certificationType null). */
function formatCertification(item: Record<string, unknown>): string {
const code = item.certificationType as string | null | undefined
if (!code) {
return ''
}
return t(`transport.carriers.certification.${code}`)
}
/** Date de validite QUALIMAT de la ligne (null si transporteur non QUALIMAT). */
function getValidityDate(item: Record<string, unknown>): string | null {
return (item.validityDate as string | null | undefined) ?? null
}
/**
* RG-4.04 : un agrement QUALIMAT est perime si sa date de validite est anterieure
* a la date du jour (comparaison jour a jour, sans l'heure).
*/
function isValidityExpired(item: Record<string, unknown>): boolean {
const value = getValidityDate(item)
if (!value) {
return false
}
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return false
}
const today = new Date()
today.setHours(0, 0, 0, 0)
date.setHours(0, 0, 0, 0)
return date.getTime() < today.getTime()
}
/** Format court francais JJ-MM-AAAA (spec M4). Chaine vide si date absente / invalide. */
function formatDateFr(value: string | null | undefined): string {
if (!value) {
return ''
}
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return ''
}
const day = String(date.getDate()).padStart(2, '0')
const month = String(date.getMonth() + 1).padStart(2, '0')
return `${day}-${month}-${date.getFullYear()}`
}
/** Clic sur une ligne → ecran Consultation (route a plat /carriers/{id}). */
function onRowClick(item: Record<string, unknown>): void {
router.push(`/carriers/${item.id}`)
}
function goToCreate(): void {
router.push('/carriers/new')
}
// ── Filtres (drawer) ────────────────────────────────────────────────────────
// Deux niveaux d'etat (pattern repertoires M1/M2/M3) :
// - APPLIED : pilote la liste/l'export + le compteur du bouton. Modifie
// uniquement au clic « Voir les résultats » / « Réinitialiser ».
// - DRAFT : edite librement dans le drawer ; recopie vers applied a la validation.
const filterDrawerOpen = ref(false)
const draftSearch = ref('')
const draftCertificationTypes = ref<string[]>([])
const draftArchivedOnly = ref(false)
const appliedSearch = ref('')
const appliedCertificationTypes = ref<string[]>([])
const appliedArchivedOnly = ref(false)
const activeFilterCount = computed(() => {
let count = 0
if (appliedSearch.value.trim() !== '') count++
if (appliedCertificationTypes.value.length > 0) count++
if (appliedArchivedOnly.value) count++
return count
})
const filterButtonLabel = computed(() => {
const base = t('transport.carriers.filters.title')
return activeFilterCount.value > 0 ? `${base} (${activeFilterCount.value})` : base
})
// Recopie l'etat applique vers le brouillon puis ouvre le drawer : la reouverture
// reflete les filtres actifs.
function openFilters(): void {
draftSearch.value = appliedSearch.value
draftCertificationTypes.value = [...appliedCertificationTypes.value]
draftArchivedOnly.value = appliedArchivedOnly.value
filterDrawerOpen.value = true
}
/** Coche / decoche une certification dans le brouillon (filtre multi). */
function toggleCertification(code: string, selected: boolean): void {
draftCertificationTypes.value = selected
? [...draftCertificationTypes.value, code]
: draftCertificationTypes.value.filter(c => c !== code)
}
/**
* Construit le payload de filtres serveur a partir de l'etat applique. Cle
* `certificationType[]` pour que PHP la parse en tableau (OR cote back). Les
* filtres vides sont omis pour une query propre.
*/
function buildFilterPayload(): Record<string, string | string[] | boolean> {
const payload: Record<string, string | string[] | boolean> = {}
if (appliedSearch.value.trim() !== '') payload.search = appliedSearch.value.trim()
if (appliedCertificationTypes.value.length > 0) payload['certificationType[]'] = [...appliedCertificationTypes.value]
if (appliedArchivedOnly.value) payload.archivedOnly = true
return payload
}
// « Voir les résultats » : recopie brouillon → applied, pousse les filtres
// (retombe en page 1 via usePaginatedList) et ferme le drawer.
function applyFilters(): void {
appliedSearch.value = draftSearch.value.trim()
appliedCertificationTypes.value = [...draftCertificationTypes.value]
appliedArchivedOnly.value = draftArchivedOnly.value
setFilters(buildFilterPayload(), { replace: true })
filterDrawerOpen.value = false
}
// « Réinitialiser » : vide brouillon ET applied, recharge la liste complete.
// Le drawer reste ouvert pour montrer le formulaire vide.
function resetFilters(): void {
draftSearch.value = ''
draftCertificationTypes.value = []
draftArchivedOnly.value = false
appliedSearch.value = ''
appliedCertificationTypes.value = []
appliedArchivedOnly.value = false
setFilters({}, { replace: true })
}
// ── Export XLSX ─────────────────────────────────────────────────────────────
// Memes filtres que la vue : l'export reflete exactement ce que l'utilisateur voit.
const exporting = ref(false)
async function exportXlsx(): Promise<void> {
if (exporting.value) {
return
}
exporting.value = true
try {
// useApi type ses options en JSON ; l'export renvoie un binaire, donc on
// force responseType:'blob' (transmis tel quel a ofetch au runtime). Cast
// contenu faute d'overload blob sur le client partage (meme pattern M2/M3).
const blob = await api.get<Blob>('/carriers/export.xlsx', buildFilterPayload(), {
responseType: 'blob',
toast: false,
} as unknown as Parameters<typeof api.get>[2])
triggerDownload(blob, 'repertoire-transporteurs.xlsx')
}
catch {
toast.error({
title: t('transport.carriers.toast.error'),
message: t('transport.carriers.toast.exportError'),
})
}
finally {
exporting.value = false
}
}
/** Declenche le telechargement d'un blob via un lien temporaire. */
function triggerDownload(blob: Blob, filename: string): void {
const url = URL.createObjectURL(blob)
const link = document.createElement('a')
link.href = url
link.download = filename
document.body.appendChild(link)
link.click()
link.remove()
URL.revokeObjectURL(url)
}
onMounted(() => {
loadCarriers()
})
</script>
@@ -0,0 +1,423 @@
<template>
<div>
<!-- En-tete : retour vers le repertoire + titre. -->
<div class="flex items-center gap-3 pt-11">
<MalioButtonIcon
icon="mdi:arrow-left-bold"
icon-size="24"
variant="ghost"
v-bind="{ ariaLabel: t('transport.carriers.form.back') }"
@click="goBack"
/>
<h1 class="text-[30px] font-semibold text-m-primary">{{ t('transport.carriers.form.title') }}</h1>
</div>
<!-- Formulaire principal (pre-onglets)
Champs conditionnels (ERP-166) : cas LIOT (nom == LIOT) seul
« immatriculations » ; certification AUTRE champ Decharge ; Affreter
coche indexation / contenant / volume. La certification est en lecture
seule pour un transporteur QUALIMAT (saisie assistee, onglet Qualimat). -->
<div class="mt-[48px] grid grid-cols-3 xl:grid-cols-4 gap-x-[44px] gap-y-4">
<MalioInputText
v-model="main.name"
:label="t('transport.carriers.form.main.name')"
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.name"
/>
<!-- Cas LIOT : seul le champ immatriculations est pertinent. -->
<MalioInputText
v-if="isLiot"
v-model="main.liotPlates"
:label="t('transport.carriers.form.main.liotPlates')"
:hint="t('transport.carriers.form.main.liotPlatesHint')"
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.liotPlates"
/>
<!-- Cas standard : certification + affretement + champs conditionnels. -->
<template v-if="!isLiot">
<MalioSelect
:model-value="main.certificationType"
:options="certificationOptions"
:label="t('transport.carriers.form.main.certificationType')"
empty-option-label=""
:required="true"
:readonly="certificationReadonly"
:error="mainErrors.errors.certificationType"
@update:model-value="(v: string | number | null) => main.certificationType = v === null ? null : String(v)"
/>
<!-- 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. -->
<MalioInputUpload
v-if="showDischarge"
:label="t('transport.carriers.form.main.discharge')"
accept="application/pdf,image/*"
:required="true"
:readonly="mainLocked"
:clearable="true"
:error="mainErrors.errors.dischargeDocument"
@clear="main.dischargeDocumentIri = null"
/>
<div v-else class="hidden xl:block"></div>
<!-- « Affréter » : toujours en colonne 4 de la ligne 1 (colonne 3
réservée à la décharge ci-dessus). Wrapper h-12 + centrage vertical
pour aligner la case sur la ligne de champ des inputs/selects. -->
<div class="flex h-12 items-center">
<MalioCheckbox
id="carrier-is-chartered"
:label="t('transport.carriers.form.main.isChartered')"
:model-value="main.isChartered"
:readonly="mainLocked"
:reserve-message-space="false"
@update:model-value="(val: boolean) => main.isChartered = val"
/>
</div>
<!-- RG-4.03 : champs d'affretement (ligne 2) visibles + obligatoires si
« Affreter ». La ligne 1 étant pleine (4 colonnes), ils démarrent
naturellement en colonne 1 de la ligne 2. -->
<template v-if="showCharteredFields">
<MalioInputNumber
v-model="main.indexationRate"
:label="t('transport.carriers.form.main.indexationRate')"
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.indexationRate"
/>
<!-- Contenant : Benne / Fond mouvant (RG-4.03). -->
<MalioSelect
:model-value="main.containerType"
:options="containerOptions"
:label="t('transport.carriers.form.main.containerType')"
empty-option-label=""
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.containerType"
@update:model-value="(v: string | number | null) => main.containerType = v === null ? null : String(v)"
/>
<MalioInputNumber
v-model="main.volumeM3"
:label="t('transport.carriers.form.main.volumeM3')"
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.volumeM3"
/>
</template>
</template>
</div>
<div v-if="!mainLocked" class="mt-12 flex justify-center">
<MalioButton
variant="primary"
:label="t('transport.carriers.form.submit')"
:disabled="mainSubmitting"
@click="onSubmitMain"
/>
</div>
<!-- ── Onglets a validation incrementale ─────────────────────────────
Barre Qualimat · Adresses · Contacts · Prix. Onglet Qualimat = saisie
assistee (table de selection) ; Adresses / Contacts / Prix arrivent aux
tickets suivants (placeholders « A venir »). -->
<MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
<!-- Onglet Qualimat : datatable paginé filtré par le NOM du transporteur
(pas de champ de recherche dédié — RG-4.01 / 4.04). -->
<template #qualimat>
<div class="mt-12 flex flex-col gap-6">
<MalioDataTable
:columns="qualimatColumns"
:items="qualimatRows"
:total-items="qualimatTotal"
:page="qualimatPage"
:per-page="qualimatPerPage"
:per-page-options="qualimatPerPageOptions"
row-clickable
:empty-message="t('transport.carriers.form.qualimat.empty')"
@row-click="onQualimatRowClick"
@update:page="qualimatGoToPage"
@update:per-page="qualimatSetPerPage"
>
<!-- Radio reflétant la ligne QUALIMAT intégrée (lecture). -->
<template #cell-select="{ item }">
<MalioRadioButton
:model-value="main.qualimatCarrierIri"
name="qualimat-row"
:value="item.iri"
group-class="mt-0"
/>
</template>
<!-- Date de validité : fond rouge si périmée (RG-4.04). -->
<template #cell-validityDate="{ item }">
<span
v-if="item.validityDate"
:class="isExpired(item.validityDate as string) ? 'inline-block rounded px-2 py-0.5 bg-m-danger text-white' : ''"
>
{{ formatDateFr(item.validityDate as string) }}
</span>
</template>
</MalioDataTable>
<div v-if="!isValidated('qualimat')" class="flex justify-center">
<MalioButton
variant="primary"
:label="t('transport.carriers.form.qualimat.continue')"
:disabled="carrierId === null"
@click="onContinueQualimat"
/>
</div>
</div>
</template>
<!-- Adresses / Contacts / Prix : contenu aux tickets suivants. -->
<template
v-for="key in placeholderTabs"
:key="key"
#[key]
>
<div class="mt-12 flex justify-center text-m-muted">
{{ t('transport.carriers.form.comingSoon') }}
</div>
</template>
</MalioTabList>
<!-- Modal de confirmation d'integration QUALIMAT (RG-4.01). -->
<MalioModal v-model="confirmOpen" modal-class="max-w-md">
<template #header>
<h2 class="text-[24px] font-bold">{{ t('transport.carriers.form.qualimat.confirm.title') }}</h2>
</template>
<p>{{ t('transport.carriers.form.qualimat.confirm.message') }}</p>
<template #footer>
<MalioButton
variant="secondary"
button-class="flex-1"
:label="t('transport.carriers.form.qualimat.confirm.cancel')"
@click="confirmOpen = false"
/>
<MalioButton
variant="primary"
button-class="flex-1"
:label="t('transport.carriers.form.qualimat.confirm.confirm')"
@click="confirmIntegrate"
/>
</template>
</MalioModal>
</div>
</template>
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
import { useCarrierForm } from '~/modules/transport/composables/useCarrierForm'
import { useQualimatSearch, type QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
interface SelectOption {
value: string
label: string
}
const { t } = useI18n()
const router = useRouter()
const toast = useToast()
const { can } = usePermissions()
useHead({ title: t('transport.carriers.form.title') })
// Gating de la route : la creation est reservee a `manage` (Admin / Bureau).
// Commerciale (consultation seule), Compta et Usine sont rediriges vers le repertoire.
if (!can('transport.carriers.manage')) {
await navigateTo('/carriers')
}
const {
main,
carrierId,
mainLocked,
mainSubmitting,
mainErrors,
isLiot,
certificationReadonly,
showCharteredFields,
showDischarge,
tabKeys,
activeTab,
unlockedIndex,
isValidated,
submitMain,
applyQualimatSelection,
completeTab,
} = useCarrierForm()
const {
items: qualimatItems,
totalItems: qualimatTotal,
currentPage: qualimatPage,
itemsPerPage: qualimatPerPage,
itemsPerPageOptions: qualimatPerPageOptions,
goToPage: qualimatGoToPage,
setItemsPerPage: qualimatSetPerPage,
setFilters: qualimatSetFilters,
} = useQualimatSearch()
// Certifications selectionnables manuellement (spec § Formulaire principal) :
// GMP+ / OVOCOM / Compte-propre / Autre. QUALIMAT n'y figure PAS — il est posé par
// la saisie assistee (onglet Qualimat). On l'ajoute cependant aux options QUAND il
// est deja selectionne (transporteur QUALIMAT integre), uniquement pour AFFICHER
// son libelle dans le select en lecture seule.
const SELECTABLE_CERTIFICATIONS = ['GMP_PLUS', 'OVOCOM', 'COMPTE_PROPRE', 'AUTRE'] as const
const certificationOptions = computed<SelectOption[]>(() => {
const codes: string[] = [...SELECTABLE_CERTIFICATIONS]
if (main.certificationType === 'QUALIMAT') {
codes.unshift('QUALIMAT')
}
return codes.map(code => ({
value: code,
label: t(`transport.carriers.certification.${code}`),
}))
})
// Colonnes du datatable de selection QUALIMAT (radio / Nom / Adresse / Validite).
const qualimatColumns = [
{ key: 'select', label: '' },
{ key: 'name', label: t('transport.carriers.form.qualimat.columns.name') },
{ key: 'address', label: t('transport.carriers.form.qualimat.columns.address') },
{ key: 'validityDate', label: t('transport.carriers.form.qualimat.columns.validityDate') },
]
// Lignes « plates » pour MalioDataTable (l'IRI sert au radio + à retrouver la ligne
// source au clic). Le détail QUALIMAT complet reste dans `qualimatItems`.
const qualimatRows = computed(() => qualimatItems.value.map(row => ({
id: row.id,
iri: row['@id'],
name: row.name,
address: formatQualimatAddress(row),
validityDate: row.validityDate,
})))
// Contenant (RG-4.03) : Benne / Fond mouvant — select simple.
const CONTAINER_TYPES = ['BENNE', 'FOND_MOUVANT'] as const
const containerOptions = computed<SelectOption[]>(() =>
CONTAINER_TYPES.map(code => ({
value: code,
label: t(`transport.carriers.containerType.${code}`),
})),
)
// Icone (Iconify) affichee dans chaque onglet, par cle.
const TAB_ICONS: Record<string, string> = {
qualimat: 'mdi:truck-check-outline',
addresses: 'mdi:map-marker-outline',
contacts: 'mdi:account-box-plus-outline',
prices: 'mdi:currency-eur',
}
// Onglets desactives tant que le formulaire principal n'est pas valide
// (unlockedIndex = -1 au depart) ; deverrouillage progressif ensuite.
const tabs = computed(() => tabKeys.value.map((key, index) => ({
key,
label: t(`transport.carriers.tab.${key}`),
icon: TAB_ICONS[key],
disabled: index > unlockedIndex.value,
})))
// Onglets dont le contenu arrive aux tickets suivants (tout sauf Qualimat).
const placeholderTabs = computed(() => tabKeys.value.filter(key => key !== 'qualimat'))
// ── Saisie assistee QUALIMAT (onglet Qualimat) ───────────────────────────────
const qualimatLoaded = ref(false)
const confirmOpen = ref(false)
const pendingRow = ref<QualimatCarrierRow | null>(null)
// Chargement quand l'onglet Qualimat devient actif : la recherche est branchée sur
// le NOM saisi dans le formulaire principal (RG-4.01) — pas de champ dédié.
watch(activeTab, (tab) => {
if (tab === 'qualimat' && !qualimatLoaded.value) {
qualimatLoaded.value = true
void qualimatSetFilters({ search: main.name })
}
})
/** Adresse QUALIMAT condensee pour la colonne « Adresse » (voie · CP · ville). */
function formatQualimatAddress(row: QualimatCarrierRow): string {
return [row.address, row.postalCode, row.city].filter(Boolean).join(' · ')
}
/** RG-4.04 : un agrement est perime si sa date de validite est < aujourd'hui. */
function isExpired(value: string): boolean {
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return false
}
const today = new Date()
today.setHours(0, 0, 0, 0)
date.setHours(0, 0, 0, 0)
return date.getTime() < today.getTime()
}
/** Format court francais JJ-MM-AAAA (chaine vide si date absente / invalide). */
function formatDateFr(value: string | null | undefined): string {
if (!value) {
return ''
}
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return ''
}
const day = String(date.getDate()).padStart(2, '0')
const month = String(date.getMonth() + 1).padStart(2, '0')
return `${day}-${month}-${date.getFullYear()}`
}
/** Clic sur une ligne du datatable → retrouve la ligne QUALIMAT source + modal. */
function onQualimatRowClick(item: Record<string, unknown>): void {
const row = qualimatItems.value.find(r => r.id === item.id)
if (row) {
askIntegrate(row)
}
}
/** Ouvre la modal de confirmation d'integration pour une ligne QUALIMAT. */
function askIntegrate(row: QualimatCarrierRow): void {
pendingRow.value = row
confirmOpen.value = true
}
/** Confirme l'integration : copie + PATCH (cf. useCarrierForm.applyQualimatSelection). */
async function confirmIntegrate(): Promise<void> {
const row = pendingRow.value
confirmOpen.value = false
if (row === null) {
return
}
const ok = await applyQualimatSelection(row)
if (ok) {
toast.success({ title: t('transport.carriers.toast.integrateSuccess') })
}
}
/** « Continuer » : valide l'onglet Qualimat et avance a l'onglet Adresses. */
function onContinueQualimat(): void {
completeTab('qualimat')
}
/** Retour vers le repertoire transporteurs (fleche d'en-tete). */
function goBack(): void {
router.push('/carriers')
}
/** Valide le formulaire principal (POST /carriers ; bascule geree par le composable). */
async function onSubmitMain(): Promise<void> {
await submitMain()
}
</script>
@@ -0,0 +1,77 @@
/**
* Types du workflow « Ajouter un transporteur » (M4 Transport, ERP-165 / ERP-166).
*
* Périmètre :
* - ERP-165 : formulaire PRINCIPAL minimal (Nom + Certification + Affréter).
* - ERP-166 : champs CONDITIONNELS du formulaire principal (indexation / benne /
* volume si affrété — RG-4.03 ; décharge si AUTRE — RG-4.02 ; immatriculations
* LIOT — RG-4.01) + saisie assistée QUALIMAT (copie name / certification /
* adresse + FK qualimatCarrier — RG-4.01 / § 2.5).
*
* L'upload réel de la décharge (file → IRI via useUpload) arrive à ERP-171 ; ici
* on porte seulement l'IRI résolu (`dischargeDocumentIri`).
*/
/**
* Brouillon du formulaire principal. Les décimales (indexation / volume) sont
* portées en `string` car `MalioInputNumber` émet une chaîne ; le serveur parse.
* `certificationType` est un code enum back (GMP_PLUS | OVOCOM | COMPTE_PROPRE |
* AUTRE | QUALIMAT — ce dernier posé par la saisie assistée) ou `null`.
* `containerType` vaut `BENNE` | `FOND_MOUVANT` (radio) ou `null`.
*/
export interface CarrierMainDraft {
name: string
certificationType: string | null
isChartered: boolean
indexationRate: string
containerType: string | null
volumeM3: string
liotPlates: string
/** IRI du document de décharge (résolu par useUpload — ERP-171). */
dischargeDocumentIri: string | null
/** IRI de la ligne QUALIMAT liée (saisie assistée — null si non QUALIMAT). */
qualimatCarrierIri: string | null
}
/** Brouillon principal vide (état initial du formulaire de création). */
export function emptyCarrierMain(): CarrierMainDraft {
return {
name: '',
certificationType: null,
isChartered: false,
indexationRate: '',
containerType: null,
volumeM3: '',
liotPlates: '',
dischargeDocumentIri: null,
qualimatCarrierIri: null,
}
}
/**
* Adresse copiée depuis le référentiel QUALIMAT à la sélection (RG-4.01 / § 2.5).
* Stockée dans l'état du formulaire pour alimenter l'onglet Adresses (ticket
* ultérieur) ; pré-remplie « France » côté pays par défaut.
*/
export interface CarrierAddressCopy {
country: string
postalCode: string
city: string
street: string
}
/** Adresse copiée vide. */
export function emptyCarrierAddressCopy(): CarrierAddressCopy {
return { country: 'France', postalCode: '', city: '', street: '' }
}
/**
* Réponse du POST / PATCH principal (groupe `carrier:read`). Le serveur renvoie
* le nom normalisé (UPPERCASE, RG-4.13) que l'UI réaffiche tel quel.
*/
export interface CarrierMainResponse {
id: number
name: string | null
certificationType: string | null
'@id'?: string
}
+10 -10
View File
@@ -7,7 +7,7 @@
"name": "starseed-frontend",
"hasInstallScript": true,
"dependencies": {
"@malio/layer-ui": "^1.7.10",
"@malio/layer-ui": "^1.7.12",
"@nuxt/icon": "^2.2.1",
"@nuxtjs/i18n": "^10.2.3",
"@nuxtjs/tailwindcss": "^6.14.0",
@@ -583,9 +583,9 @@
"license": "MIT"
},
"node_modules/@emnapi/core": {
"version": "1.11.0",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.0.tgz",
"integrity": "sha512-l9Oo58x0HOP5znGzVhYW9U3e5wVuA4LAZU2AGezTmkhO1CgQRFDhDg4nneHsu/t3WniXg9QrG2nIXL/ZS8ln8Q==",
"version": "1.11.1",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.1.tgz",
"integrity": "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==",
"license": "MIT",
"optional": true,
"dependencies": {
@@ -594,9 +594,9 @@
}
},
"node_modules/@emnapi/runtime": {
"version": "1.11.0",
"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.0.tgz",
"integrity": "sha512-55coeOFKHv1ywEcUXJtWU5f+Jr/W5tZDvZig8DLKSwUN1JpROQ4rk/SNOQiFWmaR/VKF4zuFyW1B8JduOSv6Pg==",
"version": "1.11.1",
"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz",
"integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==",
"license": "MIT",
"optional": true,
"dependencies": {
@@ -1866,9 +1866,9 @@
"license": "MIT"
},
"node_modules/@malio/layer-ui": {
"version": "1.7.10",
"resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.10/layer-ui-1.7.10.tgz",
"integrity": "sha512-ZWYaKvl+VpGAqeTE+4xdyKOmuRd4zwjlUYVppeIBZwGeNAK16kZnrztR+4eQmnzUqPZVybBhEBdKP9weqWHSUg==",
"version": "1.7.12",
"resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.12/layer-ui-1.7.12.tgz",
"integrity": "sha512-ezQLqi19K2ogI3XwSMsUyluU9x5C4W0tu1muxFbL3foKjibRYRg/FdvySivEhEsalAAt1E88V6Sv/06xPqyYTw==",
"dependencies": {
"@nuxt/icon": "^2.2.1",
"@nuxtjs/tailwindcss": "^6.14.0",
+1 -1
View File
@@ -17,7 +17,7 @@
"test:e2e:ui": "playwright test --ui"
},
"dependencies": {
"@malio/layer-ui": "^1.7.10",
"@malio/layer-ui": "^1.7.12",
"@nuxt/icon": "^2.2.1",
"@nuxtjs/i18n": "^10.2.3",
"@nuxtjs/tailwindcss": "^6.14.0",
+4 -3
View File
@@ -95,10 +95,11 @@ export const personas: Record<PersonaKey, Persona> = {
'technique.providers.accounting.view',
'technique.providers.accounting.manage',
'technique.providers.archive',
// Transport — Repertoire transporteurs (M4, ERP-153). Meme logique :
// Transport — Repertoire transporteurs (M4, ERP-164). Meme logique :
// mappe sur le persona "tout", pas de nouveau persona (regle ABSOLUE
// n°7). transport.carriers.view n'ajoute pas de lien dans la section
// Administration, donc expectedAdminLinks reste inchange.
// n°7). L'item transporteurs vit desormais dans la section Administration
// (1er item, ERP-164) mais sur la route `/carriers` (hors `/admin/<slug>`),
// donc il n'entre pas dans ALL_ADMIN_LINKS : expectedAdminLinks reste inchange.
'transport.carriers.view',
'transport.carriers.manage',
'transport.carriers.archive',