feat(commercial) : plafonne le chiffre d'affaires client/fournisseur à 999 999 999 999,99 (ERP-193)

frontend/modules/commercial/utils/forms/__tests__/amountInput.spec.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest'
+import { clampRevenueAmount, REVENUE_AMOUNT_MAX } from '../amountInput'
+
+describe('clampRevenueAmount', () => {
+    it('laisse les valeurs vides / nulles telles quelles', () => {
+        expect(clampRevenueAmount(null)).toBeNull()
+        expect(clampRevenueAmount(undefined)).toBeUndefined()
+        expect(clampRevenueAmount('')).toBe('')
+    })
+
+    it('laisse une valeur sous le plafond inchangee', () => {
+        expect(clampRevenueAmount('1000.50')).toBe('1000.50')
+        expect(clampRevenueAmount('999999999999.99')).toBe('999999999999.99')
+    })
+
+    it('plafonne une valeur au-dessus du maximum', () => {
+        expect(clampRevenueAmount('1000000000000')).toBe('999999999999.99')
+        expect(clampRevenueAmount('999999999999999.99')).toBe('999999999999.99')
+    })
+
+    it('tolere une saisie a virgule / avec espaces (securite)', () => {
+        expect(clampRevenueAmount('1 000 000 000 000,00')).toBe('999999999999.99')
+        expect(clampRevenueAmount('12,5')).toBe('12,5')
+    })
+
+    it('ne touche pas une saisie non numerique', () => {
+        expect(clampRevenueAmount('abc')).toBe('abc')
+    })
+
+    it('expose le plafond metier', () => {
+        expect(REVENUE_AMOUNT_MAX).toBe(999_999_999_999.99)
+    })
+})

frontend/modules/commercial/utils/forms/amountInput.ts

@@ -0,0 +1,29 @@
+/**
+ * Helpers de saisie des montants des formulaires Client / Fournisseur (commercial).
+ * Purs / testables. Pendant FRONT de la contrainte back `LessThanOrEqual` posee sur
+ * `revenueAmount` (Client/Supplier) — retour metier ERP-193 : le chiffre d'affaires
+ * est plafonne a 999 999 999 999,99.
+ */
+
+/** Plafond metier du chiffre d'affaires (CA) : 999 999 999 999,99. */
+export const REVENUE_AMOUNT_MAX = 999_999_999_999.99
+
+/** Valeur « modele » (decimale a point, sans separateur) renvoyee quand on plafonne. */
+const REVENUE_AMOUNT_MAX_MODEL = '999999999999.99'
+
+/**
+ * Plafonne le CA au maximum metier. Recoit le modele emis par `MalioInputAmount`
+ * (chaine propre a decimale `.`, sans espaces) ; tolere malgre tout une virgule /
+ * des espaces par securite. Renvoie la valeur telle quelle si elle est vide, non
+ * numerique ou sous le plafond ; sinon la valeur plafonnee.
+ */
+export function clampRevenueAmount(value: string | null | undefined): string | null | undefined {
+    if (value === null || value === undefined || value === '') {
+        return value
+    }
+    const n = Number(String(value).replace(/\s/g, '').replace(',', '.'))
+    if (Number.isNaN(n)) {
+        return value
+    }
+    return n > REVENUE_AMOUNT_MAX ? REVENUE_AMOUNT_MAX_MODEL : value
+}