fix : retours métier ERP-193 (4 répertoires) (#139)

Lot de retours métier **ERP-193** (« Fix tous les retours starseed »), transverse aux 4 répertoires (clients, fournisseurs, prestataires, transporteurs). ## Contenu - **Pagination** : défaut à 25 items/page sur les 4 répertoires. - **Libellé** : colonne « Dernière activité » → « Dernière modification ». - **Consultation** : masquage des onglets vides (coquilles « à venir » + onglets de données sans donnée). - **Chiffre d'affaires** : plafonné à 999 999 999 999,99 (clamp front + `Assert\LessThanOrEqual` back). - **Date de création** : interdiction des dates futures (`:max` MalioDate + `Assert\LessThanOrEqual('today')` back). - **Caractères spéciaux** : blocage des caractères parasites (`²³§~#|…`) dans les champs texte via une allow-list par profil (nom de personne / texte libre / adresse / code alphanumérique) — filtrage front à la frappe + `Assert\Regex` back autoritaire. Email/IBAN/BIC/TVA conservent leurs validateurs de format. - **UI** : champs en consultation et onglets validés grisés (`readonly` → `disabled`). - **UI** : boutons « Archiver » en rouge (variant `danger`). ## Tests - Back : nouveaux tests RG (plafond CA, dates futures, caractères spéciaux) + garde-fou contraintes — suite complète verte (813 tests). - Front : nouveaux tests unitaires (sanitizers, helpers date/montant) — 615 tests verts, eslint clean. --------- Co-authored-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr> Reviewed-on: #139 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
2026-06-22 09:40:40 +00:00
parent 6c938756cc
commit 5e15c1f69f
93 changed files with 2791 additions and 803 deletions
@@ -1,6 +1,8 @@
 import { describe, it, expect } from 'vitest'
 import {
    canEditCarrier,
+    carrierConsultationVisibleTabs,
+    hasAddressData,
    iriOf,
    labelOfRelation,
    mapAddressToDraft,
@@ -25,6 +27,10 @@ describe('carrierMappers', () => {
        expect(iriOf(undefined)).toBeNull()
    })

+    it('labelOfRelation : companyName (client/fournisseur) prioritaire sur name/adresse', () => {
+        expect(labelOfRelation({ '@id': '/api/suppliers/8', companyName: 'AAAAAAA', name: 'X' })).toBe('AAAAAAA')
+    })
+
    it('labelOfRelation : name (site) à défaut adresse condensée', () => {
        expect(labelOfRelation({ '@id': '/api/sites/1', name: 'Châtellerault' })).toBe('Châtellerault')
        expect(labelOfRelation({ '@id': '/api/client_addresses/8', street: '1 rue X', postalCode: '86000', city: 'Poitiers' })).toBe('1 rue X · 86000 · Poitiers')
@@ -118,3 +124,47 @@ describe('carrierMappers', () => {
        expect(showRestoreAction(noArchive, true)).toBe(false)
    })
 })
+
+describe('hasAddressData', () => {
+    it('faux pour une adresse absente ou entièrement vide', () => {
+        expect(hasAddressData(null)).toBe(false)
+        expect(hasAddressData(undefined)).toBe(false)
+        expect(hasAddressData({ '@id': '/api/carrier_addresses/1', id: 1 })).toBe(false)
+    })
+
+    it('vrai dès qu\'un champ adresse est rempli', () => {
+        expect(hasAddressData({ '@id': '/api/carrier_addresses/1', id: 1, city: 'Poitiers' })).toBe(true)
+        expect(hasAddressData({ '@id': '/api/carrier_addresses/1', id: 1, country: 'France' })).toBe(true)
+    })
+})
+
+describe('carrierConsultationVisibleTabs', () => {
+    it('retourne [] tant que le transporteur n\'est pas chargé', () => {
+        expect(carrierConsultationVisibleTabs(null)).toEqual([])
+        expect(carrierConsultationVisibleTabs(undefined)).toEqual([])
+    })
+
+    it('masque les onglets vides (transporteur minimal)', () => {
+        expect(carrierConsultationVisibleTabs({ '@id': '/api/carriers/1', id: 1, name: 'LIOT' })).toEqual([])
+    })
+
+    it('affiche addresses/contacts/prices dans l\'ordre quand renseignés', () => {
+        const carrier: CarrierDetail = {
+            '@id': '/api/carriers/1', id: 1,
+            address: { '@id': '/api/carrier_addresses/1', id: 1, city: 'Poitiers' },
+            contacts: [{ '@id': '/api/carrier_contacts/1', id: 1 }],
+            prices: [{ '@id': '/api/carrier_prices/1', id: 1 }],
+        }
+        expect(carrierConsultationVisibleTabs(carrier)).toEqual(['addresses', 'contacts', 'prices'])
+    })
+
+    it('ne garde que les onglets non vides (contacts seulement)', () => {
+        const carrier: CarrierDetail = {
+            '@id': '/api/carriers/1', id: 1,
+            address: { '@id': '/api/carrier_addresses/1', id: 1 },
+            contacts: [{ '@id': '/api/carrier_contacts/1', id: 1 }],
+            prices: [],
+        }
+        expect(carrierConsultationVisibleTabs(carrier)).toEqual(['contacts'])
+    })
+})
@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'vitest'
-import { clampPercent, sanitizeDecimal } from '../numberInput'
+import { Mask } from 'maska'
+import { clampPercent, LIOT_PLATES_MASK, sanitizeDecimal } from '../numberInput'

 describe('numberInput — saisie volume / indexation (ERP-170)', () => {
    it('sanitizeDecimal : ne garde que chiffres + un seul point', () => {
@@ -19,4 +20,14 @@ describe('numberInput — saisie volume / indexation (ERP-170)', () => {
        expect(clampPercent('12,5')).toBe('12,5') // ≤ 100 → inchangé
        expect(clampPercent('')).toBe('')
    })
+
+    it('LIOT_PLATES_MASK : garde lettres/chiffres/tiret/point-virgule, bloque espaces et reste', () => {
+        // Reproduit ce que fait maska au runtime (MaskInput) : preProcess puis masked.
+        const masked = (v: string) => new Mask(LIOT_PLATES_MASK).masked(LIOT_PLATES_MASK.preProcess!(v))
+        expect(masked('AB-123-CD;EF-456-GH')).toBe('AB-123-CD;EF-456-GH')
+        expect(masked('ab-123-cd ; ef-456-gh')).toBe('ab-123-cd;ef-456-gh') // espaces retirés
+        expect(masked('AB 123 CD')).toBe('AB123CD') // espaces retirés
+        expect(masked('AB.123/CD#42&²²')).toBe('AB123CD42') // . / # & ² retirés
+        expect(masked('')).toBe('')
+    })
 })
@@ -1,10 +1,10 @@
 /**
- * Helpers purs de l'onglet Contact transporteur (M4 Transport, ERP-168) — ALIGNÉ
- * sur `providerContact.ts` (M3) / les autres modules : mêmes règles de validité et
- * de gating « + Nouveau contact » (un contact est « nommé » dès qu'il porte un
- * prénom OU un nom). Seule spécificité M4 conservée : les téléphones partent au back
- * dans le tableau virtuel `phones` (max 2), mappés par le CarrierContactProcessor.
- * Testables sans Vue ni API.
+ * Helpers purs de l'onglet Contact transporteur (M4 Transport, ERP-168). ERP-193
+ * (retour métier) : l'onglet Contact n'est plus obligatoire — la règle « prénom OU
+ * nom » est retirée. Le gating « + Nouveau contact » repose désormais sur « le
+ * dernier bloc n'est pas vide » (et non plus « nommé »). Spécificité M4 conservée :
+ * les téléphones partent au back dans le tableau virtuel `phones` (max 2), mappés
+ * par le CarrierContactProcessor. Testables sans Vue ni API.
 */

 import type { CarrierContactFormDraft } from '~/modules/transport/types/carrierForm'
@@ -30,15 +30,6 @@ export function isCarrierContactBlank(contact: CarrierContactFormDraft): boolean
    ].some(isFilled)
 }

-/**
- * Un contact est « nommé » (valide) dès qu'il porte un prénom OU un nom — aligné
- * sur M1/M2/M3. Pilote le gating « + Nouveau contact » : la fonction / le téléphone
- * / l'email seuls ne suffisent pas pour ajouter un nouveau bloc.
- */
-export function isCarrierContactNamed(contact: CarrierContactFormDraft): boolean {
-    return isFilled(contact.firstName) || isFilled(contact.lastName)
-}
-
 /**
 * Payload de la sous-ressource contacts (groupe `carrier:write:contacts`). Les
 * chaînes vides partent à null (le serveur normalise/trim). Les téléphones sont
@@ -97,13 +97,18 @@ export function iriOf(relation: Relation): string | null {
 }

 /**
- * Libellé d'affichage d'une relation embarquée : `name` (site) à défaut une adresse
- * condensée (voie · CP · ville). Chaîne vide si la relation est un IRI nu / absente.
+ * Libellé d'affichage d'une relation embarquée : `companyName` (client/fournisseur)
+ * à défaut `name` (site), à défaut une adresse condensée (voie · CP · ville). Chaîne
+ * vide si la relation est un IRI nu / absente.
 */
 export function labelOfRelation(relation: Relation): string {
    if (!relation || typeof relation === 'string') {
        return ''
    }
+    const companyName = relation.companyName as string | undefined
+    if (companyName) {
+        return companyName
+    }
    const name = relation.name as string | undefined
    if (name) {
        return name
@@ -175,6 +180,62 @@ export function mapPriceToDraft(price: CarrierPriceRead): CarrierPriceFormDraft
    }
 }

+/**
+ * Vrai si une valeur scalaire porte une donnée affichable (non null/undefined,
+ * et non chaîne vide après trim). Sert aux prédicats « onglet vide » ci-dessous.
+ */
+function hasValue(value: unknown): boolean {
+    if (value === null || value === undefined) {
+        return false
+    }
+    if (typeof value === 'string') {
+        return value.trim() !== ''
+    }
+    return true
+}
+
+/**
+ * Vrai si l'adresse unique (OneToOne, ERP-172) porte au moins un champ rempli.
+ * Un objet adresse vide (toutes clés nulles) est considéré comme « pas d'adresse ».
+ */
+export function hasAddressData(address: CarrierAddressRead | null | undefined): boolean {
+    if (!address) {
+        return false
+    }
+    return [
+        address.postalCode,
+        address.city,
+        address.street,
+        address.streetComplement,
+        address.country,
+    ].some(hasValue)
+}
+
+/**
+ * Onglets visibles en consultation (ERP-193, retour métier) : on masque tout
+ * onglet de données vide. Le transporteur n'a pas de coquille « à venir ».
+ * Ordre : Adresses · Contacts · Prix. Retourne `[]` tant que le transporteur
+ * n'est pas chargé.
+ */
+export function carrierConsultationVisibleTabs(
+    carrier: CarrierDetail | null | undefined,
+): string[] {
+    if (!carrier) {
+        return []
+    }
+    const visible: string[] = []
+    if (hasAddressData(carrier.address)) {
+        visible.push('addresses')
+    }
+    if ((carrier.contacts ?? []).length > 0) {
+        visible.push('contacts')
+    }
+    if ((carrier.prices ?? []).length > 0) {
+        visible.push('prices')
+    }
+    return visible
+}
+
 /** Bouton « Modifier » : visible avec la permission `manage` (Admin / Bureau). */
 export function canEditCarrier(can: (code: string) => boolean): boolean {
    return can('transport.carriers.manage')
@@ -1,7 +1,9 @@
 /**
- * Helpers de saisie numérique du formulaire principal transporteur (ERP-170).
- * Champs texte restreints (volume m³ décimal, indexation plafonnée). Purs / testables.
+ * Helpers de saisie du formulaire principal transporteur (ERP-170).
+ * Champs texte restreints (volume m³ décimal, indexation plafonnée, immatriculations
+ * LIOT via mask maska). Purs / testables.
 */
+import type { MaskInputOptions } from 'maska'

 /**
 * Restreint une saisie à un nombre décimal : chiffres + UN seul point (RG volume m³,
@@ -26,3 +28,20 @@ export function clampPercent(value: string): string {
    const n = Number(String(value ?? '').replace(',', '.').replace(/\s/g, ''))
    return (!Number.isNaN(n) && n > 100) ? '100' : value
 }
+
+/**
+ * Mask maska des immatriculations LIOT : n'autorise que lettres, chiffres, tiret et
+ * point-virgule (séparateur de plaques), longueur libre. Filtrage NATIF (maska gère
+ * le focus et le curseur, contrairement à un nettoyage manuel). Espaces et tout autre
+ * caractère sont bloqués à la frappe / au collage. La normalisation finale (majuscules
+ * + « ; » espacé) reste au back (RG-4.13).
+ *
+ * `preProcess` retire d'abord tout caractère interdit (espaces, &, ², …) OÙ QU'IL
+ * SOIT (le masque positionnel seul s'arrêterait au 1er caractère invalide) ; le
+ * token `P` en `multiple: true` laisse ensuite passer le reste (longueur libre).
+ */
+export const LIOT_PLATES_MASK: MaskInputOptions = {
+    mask: 'P',
+    tokens: { P: { pattern: /[A-Za-z0-9;-]/, multiple: true } },
+    preProcess: (value: string) => value.replace(/[^A-Za-z0-9;-]/g, ''),
+}