chore: bump version to v0.1.140

Entité WeighingTicket
- Entité métier complète (#[Auditable], TimestampableBlamableTrait, relations
  ORM Client/Supplier/Site) + contrat de sérialisation à 3 maillons
  (weighing_ticket:read / :item:read + contextes par opération).
- Getters calculés displayDate et plateFreeFormat (#[SerializedName]),
  sécurité view/manage, pas de Delete/archive.
- Validation #[Assert\*] messages FR + #[Assert\Callback] RG-5.03 (->atPath()),
  libellé i18n audit.entity.logistique_weighingticket.
- Repository : interface Domain + DoctrineWeighingTicketRepository
  (recherche + tri number DESC, deletedAt IS NULL).

Dette site.code
- Site.code mappé VARCHAR(8) (groupes read/write), dérivation auto au
  PrePersist (2 premiers chiffres du CP), UniqueConstraint uq_site_code.
- Migration Version20260617160000 : ALTER COLUMN code SET NOT NULL + COMMENT.
- Fixtures (codes 86/17/82) et SiteApiTest ajustés.

Câblage
- doctrine.yaml : mapping ORM du module Logistique (absent du scaffold ERP-181).
- ColumnCommentsCatalog : site.code + table weighing_ticket.

Specs M5 versionnées (spec-back / spec-front / prompts).

.claude/rules/frontend.md

@@ -79,6 +79,7 @@ Regles :
 - **Toujours `{ toast: false }`** sur l'appel API qui veut un mapping inline (sinon le toast natif d'`useApi` masque le fin).
 - **Cas metier specifique** (ex: 409 doublon) : `setError('champ', message)` + toast explicite **avant** de deleguer le reste a `handleApiError`. Cf. `useCategoryForm` (doublon RG-1.07).
 - **Collections** (listes de sous-entites sauvees par un appel par ligne) : une erreur PAR LIGNE via un tableau `ref<Record<string, string>[]>` aligne sur l'index, peuple par `mapViolationsToRecord(error.response._data)` (util pur de `shared/utils/api.ts`). Le composant de ligne expose une prop `:errors` (`Record<string, string>`) bindee sur le `:error` de chaque champ. Cf. `ClientContactBlock` / `ClientAddressBlock` et les submits de `clients/new.vue` / `clients/[id]/edit.vue`.
+- **Message back technique → surcharge i18n par code** : la plupart des contraintes back portent un message FR explicite (affiche tel quel). Mais une 422 peut porter un message TECHNIQUE non montrable (ex. erreur de type API Platform sur une date non parsable : « Cette valeur doit être de type DateTimeImmutable|null. », voire en anglais selon la negociation). On le surcharge **cote front** via le `code` de violation (UUID Symfony fige, robuste — pas un match sur le texte) : table `VIOLATION_MESSAGE_I18N` + `resolveViolationMessage` dans `shared/utils/api.ts`, appliquee par `useFormErrors`. Ajouter un cas = une entree `code -> cle i18n`. Cas reference : date invalide (MalioDate forwarde la saisie brute via `@update:rawValue`, le back renvoie 422 sur `foundedAt` grace a `collectDenormalizationErrors`, le front affiche `errors.validation.invalidDate`).
 
 **Interdit** : se contenter d'un toast global sur une 422 quand le back identifie les champs fautifs (`propertyPath`). Reimplementer un mapping `if/else` par champ a la main au lieu d'`useFormErrors` / `mapViolationsToRecord`.
 

.gitea/workflows/pull-request.yml

@@ -56,7 +56,10 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: '8.4'
-          extensions: pdo, pdo_pgsql, intl, opcache, zip, mbstring, sodium
+          # gd requis par phpoffice/phpspreadsheet (export XLSX). Doit etre explicite :
+          # sinon `composer install` echoue sur la verification de plateforme des que
+          # le runner ne fournit pas l'extension par defaut (ext-gd manquante).
+          extensions: pdo, pdo_pgsql, intl, opcache, zip, mbstring, sodium, gd
           coverage: none
           tools: composer:v2
 

composer.json

@@ -12,7 +12,6 @@
         "doctrine/doctrine-bundle": "^3.2",
         "doctrine/doctrine-migrations-bundle": "^4.0",
         "doctrine/orm": "^3.6",
-        "dompdf/dompdf": "^3.1",
         "lexik/jwt-authentication-bundle": "^3.2",
         "nelmio/cors-bundle": "^2.6",
         "nyholm/psr7": "^1.8",

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "b9a204bab17aa0371f8419362f3bee0c",
+    "content-hash": "b029c1484227c926d39dfd3ae5cb0699",
     "packages": [
         {
             "name": "api-platform/doctrine-common",
@@ -2520,161 +2520,6 @@
             },
             "time": "2026-02-08T16:21:46+00:00"
         },
-        {
-            "name": "dompdf/dompdf",
-            "version": "v3.1.5",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/dompdf/dompdf.git",
-                "reference": "f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/dompdf/dompdf/zipball/f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496",
-                "reference": "f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496",
-                "shasum": ""
-            },
-            "require": {
-                "dompdf/php-font-lib": "^1.0.0",
-                "dompdf/php-svg-lib": "^1.0.0",
-                "ext-dom": "*",
-                "ext-mbstring": "*",
-                "masterminds/html5": "^2.0",
-                "php": "^7.1 || ^8.0"
-            },
-            "require-dev": {
-                "ext-gd": "*",
-                "ext-json": "*",
-                "ext-zip": "*",
-                "mockery/mockery": "^1.3",
-                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11",
-                "squizlabs/php_codesniffer": "^3.5",
-                "symfony/process": "^4.4 || ^5.4 || ^6.2 || ^7.0"
-            },
-            "suggest": {
-                "ext-gd": "Needed to process images",
-                "ext-gmagick": "Improves image processing performance",
-                "ext-imagick": "Improves image processing performance",
-                "ext-zlib": "Needed for pdf stream compression"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Dompdf\\": "src/"
-                },
-                "classmap": [
-                    "lib/"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "LGPL-2.1"
-            ],
-            "authors": [
-                {
-                    "name": "The Dompdf Community",
-                    "homepage": "https://github.com/dompdf/dompdf/blob/master/AUTHORS.md"
-                }
-            ],
-            "description": "DOMPDF is a CSS 2.1 compliant HTML to PDF converter",
-            "homepage": "https://github.com/dompdf/dompdf",
-            "support": {
-                "issues": "https://github.com/dompdf/dompdf/issues",
-                "source": "https://github.com/dompdf/dompdf/tree/v3.1.5"
-            },
-            "time": "2026-03-03T13:54:37+00:00"
-        },
-        {
-            "name": "dompdf/php-font-lib",
-            "version": "1.0.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/dompdf/php-font-lib.git",
-                "reference": "a6e9a688a2a80016ac080b97be73d3e10c444c9a"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/dompdf/php-font-lib/zipball/a6e9a688a2a80016ac080b97be73d3e10c444c9a",
-                "reference": "a6e9a688a2a80016ac080b97be73d3e10c444c9a",
-                "shasum": ""
-            },
-            "require": {
-                "ext-mbstring": "*",
-                "php": "^7.1 || ^8.0"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11 || ^12"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "FontLib\\": "src/FontLib"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "LGPL-2.1-or-later"
-            ],
-            "authors": [
-                {
-                    "name": "The FontLib Community",
-                    "homepage": "https://github.com/dompdf/php-font-lib/blob/master/AUTHORS.md"
-                }
-            ],
-            "description": "A library to read, parse, export and make subsets of different types of font files.",
-            "homepage": "https://github.com/dompdf/php-font-lib",
-            "support": {
-                "issues": "https://github.com/dompdf/php-font-lib/issues",
-                "source": "https://github.com/dompdf/php-font-lib/tree/1.0.2"
-            },
-            "time": "2026-01-20T14:10:26+00:00"
-        },
-        {
-            "name": "dompdf/php-svg-lib",
-            "version": "1.0.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/dompdf/php-svg-lib.git",
-                "reference": "8259ffb930817e72b1ff1caef5d226501f3dfeb1"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/dompdf/php-svg-lib/zipball/8259ffb930817e72b1ff1caef5d226501f3dfeb1",
-                "reference": "8259ffb930817e72b1ff1caef5d226501f3dfeb1",
-                "shasum": ""
-            },
-            "require": {
-                "ext-mbstring": "*",
-                "php": "^7.1 || ^8.0",
-                "sabberworm/php-css-parser": "^8.4 || ^9.0"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Svg\\": "src/Svg"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "LGPL-3.0-or-later"
-            ],
-            "authors": [
-                {
-                    "name": "The SvgLib Community",
-                    "homepage": "https://github.com/dompdf/php-svg-lib/blob/master/AUTHORS.md"
-                }
-            ],
-            "description": "A library to read, parse and export to PDF SVG files.",
-            "homepage": "https://github.com/dompdf/php-svg-lib",
-            "support": {
-                "issues": "https://github.com/dompdf/php-svg-lib/issues",
-                "source": "https://github.com/dompdf/php-svg-lib/tree/1.0.2"
-            },
-            "time": "2026-01-02T16:01:13+00:00"
-        },
         {
             "name": "lcobucci/jwt",
             "version": "5.6.0",
@@ -3049,73 +2894,6 @@
             },
             "time": "2022-12-02T22:17:43+00:00"
         },
-        {
-            "name": "masterminds/html5",
-            "version": "2.10.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/Masterminds/html5-php.git",
-                "reference": "fcf91eb64359852f00d921887b219479b4f21251"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/Masterminds/html5-php/zipball/fcf91eb64359852f00d921887b219479b4f21251",
-                "reference": "fcf91eb64359852f00d921887b219479b4f21251",
-                "shasum": ""
-            },
-            "require": {
-                "ext-dom": "*",
-                "php": ">=5.3.0"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "^4.8.35 || ^5.7.21 || ^6 || ^7 || ^8 || ^9"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "2.7-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Masterminds\\": "src"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Matt Butcher",
-                    "email": "technosophos@gmail.com"
-                },
-                {
-                    "name": "Matt Farina",
-                    "email": "matt@mattfarina.com"
-                },
-                {
-                    "name": "Asmir Mustafic",
-                    "email": "goetas@gmail.com"
-                }
-            ],
-            "description": "An HTML5 parser and serializer.",
-            "homepage": "http://masterminds.github.io/html5-php",
-            "keywords": [
-                "HTML5",
-                "dom",
-                "html",
-                "parser",
-                "querypath",
-                "serializer",
-                "xml"
-            ],
-            "support": {
-                "issues": "https://github.com/Masterminds/html5-php/issues",
-                "source": "https://github.com/Masterminds/html5-php/tree/2.10.0"
-            },
-            "time": "2025-07-25T09:04:22+00:00"
-        },
         {
             "name": "monolog/monolog",
             "version": "3.10.0",
@@ -4159,86 +3937,6 @@
             },
             "time": "2021-10-29T13:26:27+00:00"
         },
-        {
-            "name": "sabberworm/php-css-parser",
-            "version": "v9.3.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/MyIntervals/PHP-CSS-Parser.git",
-                "reference": "88dbd0f7f91abbfe4402d0a3071e9ff4d81ed949"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/MyIntervals/PHP-CSS-Parser/zipball/88dbd0f7f91abbfe4402d0a3071e9ff4d81ed949",
-                "reference": "88dbd0f7f91abbfe4402d0a3071e9ff4d81ed949",
-                "shasum": ""
-            },
-            "require": {
-                "ext-iconv": "*",
-                "php": "^7.2.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0",
-                "thecodingmachine/safe": "^1.3 || ^2.5 || ^3.4"
-            },
-            "require-dev": {
-                "php-parallel-lint/php-parallel-lint": "1.4.0",
-                "phpstan/extension-installer": "1.4.3",
-                "phpstan/phpstan": "1.12.32 || 2.1.32",
-                "phpstan/phpstan-phpunit": "1.4.2 || 2.0.8",
-                "phpstan/phpstan-strict-rules": "1.6.2 || 2.0.7",
-                "phpunit/phpunit": "8.5.52",
-                "rawr/phpunit-data-provider": "3.3.1",
-                "rector/rector": "1.2.10 || 2.2.8",
-                "rector/type-perfect": "1.0.0 || 2.1.0",
-                "squizlabs/php_codesniffer": "4.0.1",
-                "thecodingmachine/phpstan-safe-rule": "1.2.0 || 1.4.1"
-            },
-            "suggest": {
-                "ext-mbstring": "for parsing UTF-8 CSS"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "9.4.x-dev"
-                }
-            },
-            "autoload": {
-                "files": [
-                    "src/Rule/Rule.php",
-                    "src/RuleSet/RuleContainer.php"
-                ],
-                "psr-4": {
-                    "Sabberworm\\CSS\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Raphael Schweikert"
-                },
-                {
-                    "name": "Oliver Klee",
-                    "email": "github@oliverklee.de"
-                },
-                {
-                    "name": "Jake Hotson",
-                    "email": "jake.github@qzdesign.co.uk"
-                }
-            ],
-            "description": "Parser for CSS Files written in PHP",
-            "homepage": "https://www.sabberworm.com/blog/2010/6/10/php-css-parser",
-            "keywords": [
-                "css",
-                "parser",
-                "stylesheet"
-            ],
-            "support": {
-                "issues": "https://github.com/MyIntervals/PHP-CSS-Parser/issues",
-                "source": "https://github.com/MyIntervals/PHP-CSS-Parser/tree/v9.3.0"
-            },
-            "time": "2026-03-03T17:31:43+00:00"
-        },
         {
             "name": "symfony/asset",
             "version": "v8.0.8",
@@ -9081,149 +8779,6 @@
             ],
             "time": "2026-03-30T15:14:47+00:00"
         },
-        {
-            "name": "thecodingmachine/safe",
-            "version": "v3.4.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/thecodingmachine/safe.git",
-                "reference": "705683a25bacf0d4860c7dea4d7947bfd09eea19"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/thecodingmachine/safe/zipball/705683a25bacf0d4860c7dea4d7947bfd09eea19",
-                "reference": "705683a25bacf0d4860c7dea4d7947bfd09eea19",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^8.1"
-            },
-            "require-dev": {
-                "php-parallel-lint/php-parallel-lint": "^1.4",
-                "phpstan/phpstan": "^2",
-                "phpunit/phpunit": "^10",
-                "squizlabs/php_codesniffer": "^3.2"
-            },
-            "type": "library",
-            "autoload": {
-                "files": [
-                    "lib/special_cases.php",
-                    "generated/apache.php",
-                    "generated/apcu.php",
-                    "generated/array.php",
-                    "generated/bzip2.php",
-                    "generated/calendar.php",
-                    "generated/classobj.php",
-                    "generated/com.php",
-                    "generated/cubrid.php",
-                    "generated/curl.php",
-                    "generated/datetime.php",
-                    "generated/dir.php",
-                    "generated/eio.php",
-                    "generated/errorfunc.php",
-                    "generated/exec.php",
-                    "generated/fileinfo.php",
-                    "generated/filesystem.php",
-                    "generated/filter.php",
-                    "generated/fpm.php",
-                    "generated/ftp.php",
-                    "generated/funchand.php",
-                    "generated/gettext.php",
-                    "generated/gmp.php",
-                    "generated/gnupg.php",
-                    "generated/hash.php",
-                    "generated/ibase.php",
-                    "generated/ibmDb2.php",
-                    "generated/iconv.php",
-                    "generated/image.php",
-                    "generated/imap.php",
-                    "generated/info.php",
-                    "generated/inotify.php",
-                    "generated/json.php",
-                    "generated/ldap.php",
-                    "generated/libxml.php",
-                    "generated/lzf.php",
-                    "generated/mailparse.php",
-                    "generated/mbstring.php",
-                    "generated/misc.php",
-                    "generated/mysql.php",
-                    "generated/mysqli.php",
-                    "generated/network.php",
-                    "generated/oci8.php",
-                    "generated/opcache.php",
-                    "generated/openssl.php",
-                    "generated/outcontrol.php",
-                    "generated/pcntl.php",
-                    "generated/pcre.php",
-                    "generated/pgsql.php",
-                    "generated/posix.php",
-                    "generated/ps.php",
-                    "generated/pspell.php",
-                    "generated/readline.php",
-                    "generated/rnp.php",
-                    "generated/rpminfo.php",
-                    "generated/rrd.php",
-                    "generated/sem.php",
-                    "generated/session.php",
-                    "generated/shmop.php",
-                    "generated/sockets.php",
-                    "generated/sodium.php",
-                    "generated/solr.php",
-                    "generated/spl.php",
-                    "generated/sqlsrv.php",
-                    "generated/ssdeep.php",
-                    "generated/ssh2.php",
-                    "generated/stream.php",
-                    "generated/strings.php",
-                    "generated/swoole.php",
-                    "generated/uodbc.php",
-                    "generated/uopz.php",
-                    "generated/url.php",
-                    "generated/var.php",
-                    "generated/xdiff.php",
-                    "generated/xml.php",
-                    "generated/xmlrpc.php",
-                    "generated/yaml.php",
-                    "generated/yaz.php",
-                    "generated/zip.php",
-                    "generated/zlib.php"
-                ],
-                "classmap": [
-                    "lib/DateTime.php",
-                    "lib/DateTimeImmutable.php",
-                    "lib/Exceptions/",
-                    "generated/Exceptions/"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "description": "PHP core functions that throw exceptions instead of returning FALSE on error",
-            "support": {
-                "issues": "https://github.com/thecodingmachine/safe/issues",
-                "source": "https://github.com/thecodingmachine/safe/tree/v3.4.0"
-            },
-            "funding": [
-                {
-                    "url": "https://github.com/OskarStark",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/shish",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/silasjoisten",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/staabm",
-                    "type": "github"
-                }
-            ],
-            "time": "2026-02-04T18:08:13+00:00"
-        },
         {
             "name": "twig/twig",
             "version": "v3.24.0",

config/modules.php

@@ -4,13 +4,17 @@ declare(strict_types=1);
 use App\Module\Catalog\CatalogModule;
 use App\Module\Commercial\CommercialModule;
 use App\Module\Core\CoreModule;
-use App\Module\FieldSales\FieldSalesModule;
+use App\Module\Logistique\LogistiqueModule;
 use App\Module\Sites\SitesModule;
+use App\Module\Technique\TechniqueModule;
+use App\Module\Transport\TransportModule;
 
 return [
     CoreModule::class,
     CommercialModule::class,
     SitesModule::class,
     CatalogModule::class,
-    FieldSalesModule::class,
+    TechniqueModule::class,
+    TransportModule::class,
+    LogistiqueModule::class,
 ];

config/packages/api_platform.yaml

@@ -12,11 +12,9 @@ api_platform:
             # Resources virtuelles (sans entite Doctrine) declarees via #[ApiResource]
             # en dehors de Domain/Entity : AuditLogResource, etc.
             - '%kernel.project_dir%/src/Module/Core/Infrastructure/ApiPlatform/Resource'
-            # Module FieldSales (M6) : entites ApiResource Tour / TourStop.
-            - '%kernel.project_dir%/src/Module/FieldSales/Domain/Entity'
-            # Module FieldSales (M6) : resources virtuelles sans entite Doctrine
-            # (VisitableTierResource — pins de la carte, lecture DBAL).
-            - '%kernel.project_dir%/src/Module/FieldSales/Infrastructure/ApiPlatform/Resource'
+            # Entites techniques partagees portant un #[ApiResource]
+            # (UploadedDocument — infra upload generique ERP-154).
+            - '%kernel.project_dir%/src/Shared/Domain/Entity'
     formats:
         jsonld: ['application/ld+json']
         json: ['application/json']

config/packages/doctrine.yaml

@@ -8,16 +8,34 @@ doctrine:
             default:
                 url: '%env(resolve:DATABASE_URL)%'
                 profiling_collect_backtrace: '%kernel.debug%'
-                # Exclut `audit_log` de toute operation de comparaison de schema
-                # (doctrine:schema:update, schema:validate, diff de migrations...).
-                # Cette table n'a volontairement aucune entite mappee : elle est
-                # append-only via DBAL brut (AuditLogWriter) pour eviter la
-                # recursion du listener Doctrine. Sans ce filtre, schema:update
-                # la considere comme "orpheline" et genere un `DROP TABLE
-                # audit_log` qui casse la base de test apres chaque
-                # `make test-db-setup`. La creation / suppression de la table
-                # reste pilotee par les migrations (cf. Version20260420202749).
-                schema_filter: '~^(?!audit_log$).+~'
+                # Exclut certaines tables de toute operation de comparaison de
+                # schema (doctrine:schema:update, schema:validate, diff de
+                # migrations...). Ces tables n'ont volontairement aucune entite
+                # mappee :
+                #  - `audit_log` : append-only via DBAL brut (AuditLogWriter) pour
+                #    eviter la recursion du listener Doctrine.
+                #  - `qualimat_sync_log` : journal de synchro transporteurs
+                #    QUALIMAT, ecrit en DBAL brut par `app:qualimat:sync`, hors ORM.
+                #    NB : `qualimat_carrier` n'est PLUS filtree depuis M4 (ERP-155) :
+                #    elle est desormais mappee en LECTURE SEULE par l'entite
+                #    App\Module\Transport\Domain\Entity\QualimatCarrier (cible de la
+                #    FK editable carrier.qualimat_carrier_id). Son mapping reproduit
+                #    a l'identique le DDL de la migration ERP-39 (unique siret, index
+                #    is_active, TIMESTAMP(6)) -> schema:update reste un no-op.
+                #  - `idtf_product` / `idtf_sync_log` : referentiel codes IDTF
+                #    synchronise en DBAL brut par `app:idtf:sync`, hors ORM.
+                #  - `weighing_ticket_counter` / `weighbridge_dsd_counter` : compteurs
+                #    par site (numero de ticket de pesee RG-5.02 / DSD du pont RG-5.04,
+                #    M5 Logistique), incrementes en DBAL brut sous verrou `FOR UPDATE`
+                #    par l'allocateur — jamais mappes en ORM (cf. spec M5 § 2.5 / § 2.7).
+                # Sans ce filtre, schema:update les considere comme "orphelines" et
+                # genere un `DROP TABLE` qui casse la base de test apres chaque
+                # `make test-db-setup` (la migration les a creees, schema:update les
+                # supprime juste apres). Creation / suppression restent pilotees par
+                # les migrations (audit_log : Version20260420202749 ; qualimat :
+                # Version20260612150000 ; idtf : Version20260612160000 ; compteurs M5 :
+                # Version20260617150000).
+                schema_filter: '~^(?!(?:audit_log|qualimat_sync_log|idtf_product|idtf_sync_log|weighing_ticket_counter|weighbridge_dsd_counter)$).+~'
             audit:
                 url: '%env(resolve:DATABASE_URL)%'
     orm:
@@ -41,14 +59,26 @@ doctrine:
             # Permet au module Commercial de referencer une Category via le contrat
             # Shared sans importer la classe concrete du module Catalog (regle n°1).
             App\Shared\Domain\Contract\CategoryInterface: App\Module\Catalog\Domain\Entity\Category
-            # NOTE (M6 / VisitableInterface) : VisitableInterface n'apparait PAS ici.
-            # resolve_target_entities mappe un contrat -> UNE seule classe concrete,
-            # or ce contrat a plusieurs implementations (Client M1, Supplier M2, et
-            # Prestataire a venir). FieldSales ne reference donc pas un Tiers via une
-            # association Doctrine mais via le couple polymorphe (tier_type, tier_id)
-            # de tour_stop, resolu par un service a partir de getVisitableType()
-            # (ERP-124). Aucune ligne resolve_target_entities n'est requise/possible.
+            # Cibles des ManyToOne de CarrierPrice (M4 Transport, onglet Prix) :
+            # permet au module Transport de referencer Client / Supplier et leurs
+            # adresses (M1/M2 Commercial) via des contrats Shared sans importer les
+            # classes concretes (regle n°1). L'embed JSON passe par les read-groups
+            # des entites concretes (client:read / supplier:read / ...).
+            App\Shared\Domain\Contract\ClientInterface: App\Module\Commercial\Domain\Entity\Client
+            App\Shared\Domain\Contract\ClientAddressInterface: App\Module\Commercial\Domain\Entity\ClientAddress
+            App\Shared\Domain\Contract\SupplierInterface: App\Module\Commercial\Domain\Entity\Supplier
+            App\Shared\Domain\Contract\SupplierAddressInterface: App\Module\Commercial\Domain\Entity\SupplierAddress
         mappings:
+            # Mapping des entites techniques partagees (src/Shared/Domain/Entity).
+            # Premier occupant : UploadedDocument (infra upload generique ERP-154).
+            # Necessaire car les entites Shared ne sont pas couvertes par
+            # l'auto_mapping (qui ne cible que les bundles).
+            Shared:
+                type: attribute
+                is_bundle: false
+                dir: '%kernel.project_dir%/src/Shared/Domain/Entity'
+                prefix: 'App\Shared\Domain\Entity'
+                alias: Shared
             Core:
                 type: attribute
                 is_bundle: false
@@ -87,16 +117,38 @@ doctrine:
                 dir: '%kernel.project_dir%/src/Module/Commercial/Domain/Entity'
                 prefix: 'App\Module\Commercial\Domain\Entity'
                 alias: Commercial
-            # Mapping inconditionnel du module FieldSales (M6 — meme logique que
-            # Commercial) : les tables tour / tour_stop creees par la migration
-            # M6.3 (Version20260611140000) doivent etre connues de l'ORM.
-            # L'activation fonctionnelle passe par config/modules.php.
-            FieldSales:
+            # Mapping inconditionnel du module Technique (meme logique que Commercial) :
+            # les tables prestataires (provider + sous-collections + jointures M2M)
+            # creees par la migration M3 (Version20260612100000) doivent etre connues
+            # de l'ORM. L'activation fonctionnelle passe par config/modules.php.
+            Technique:
                 type: attribute
                 is_bundle: false
-                dir: '%kernel.project_dir%/src/Module/FieldSales/Domain/Entity'
-                prefix: 'App\Module\FieldSales\Domain\Entity'
-                alias: FieldSales
+                dir: '%kernel.project_dir%/src/Module/Technique/Domain/Entity'
+                prefix: 'App\Module\Technique\Domain\Entity'
+                alias: Technique
+            # Mapping inconditionnel du module Transport (meme logique que Technique) :
+            # les tables transporteurs (carrier + sous-collections) creees par la
+            # migration M4 (Version20260615150000) et le mapping lecture-seule de
+            # qualimat_carrier (referentiel ERP-39) doivent etre connus de l'ORM.
+            # L'activation fonctionnelle passe par config/modules.php.
+            Transport:
+                type: attribute
+                is_bundle: false
+                dir: '%kernel.project_dir%/src/Module/Transport/Domain/Entity'
+                prefix: 'App\Module\Transport\Domain\Entity'
+                alias: Transport
+            # Mapping inconditionnel du module Logistique (meme logique que Transport) :
+            # la table weighing_ticket (tickets de pesee M5) creee par la migration
+            # Version20260617150000 doit etre connue de l'ORM, sinon schema:update la
+            # drope sur la base de test. L'activation fonctionnelle passe par
+            # config/modules.php.
+            Logistique:
+                type: attribute
+                is_bundle: false
+                dir: '%kernel.project_dir%/src/Module/Logistique/Domain/Entity'
+                prefix: 'App\Module\Logistique\Domain\Entity'
+                alias: Logistique
         controller_resolver:
             auto_mapping: false
 

config/packages/doctrine_migrations.yaml

@@ -2,4 +2,5 @@ doctrine_migrations:
     migrations_paths:
         'DoctrineMigrations': '%kernel.project_dir%/migrations'
         'App\Module\Core\Infrastructure\Doctrine\Migrations': '%kernel.project_dir%/src/Module/Core/Infrastructure/Doctrine/Migrations'
+        'App\Module\Transport\Infrastructure\Doctrine\Migrations': '%kernel.project_dir%/src/Module/Transport/Infrastructure/Doctrine/Migrations'
     enable_profiler: false

config/packages/http_client.yaml

@@ -0,0 +1,13 @@
+# Active le composant HTTP Client (symfony/http-client) et enregistre
+# l'autowiring de HttpClientInterface. Utilise par les commandes de
+# synchronisation de referentiels externes (QUALIMAT, IDTF...).
+#
+# User-Agent navigateur neutre : les sources (qualimat.org sous WordPress/WAF,
+# icrt-idtf.com) filtrent souvent les UA de bibliotheque/vides ; un UA de type
+# navigateur evite les blocages anti-bot sans reveler l'application.
+framework:
+    http_client:
+        default_options:
+            timeout: 30
+            headers:
+                User-Agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36'

config/services.yaml

@@ -1,8 +1,6 @@
 # yaml-language-server: $schema=../vendor/symfony/dependency-injection/Loader/schema/services.schema.json
 
 parameters:
-    # Vitesse moyenne (km/h) du moteur de trajet V1 Haversine (M6 § 3.4).
-    field_sales.route_average_speed_kmh: 50.0
 
 imports:
     - { resource: version.yaml }
@@ -35,25 +33,3 @@ services:
 
     App\Module\Sites\Application\Service\CurrentSiteProviderInterface:
         alias: App\Module\Sites\Application\Service\CurrentSiteProvider
-
-    # Geocodage des adresses Tiers (M6.1) : BAN api-adresse.data.gouv.fr.
-    App\Shared\Domain\Contract\GeocoderInterface:
-        alias: App\Shared\Infrastructure\Geocoding\BanGeocoder
-
-    # Moteur de trajet V1 (M6 § 3.4) : Haversine + plus proche voisin. La V2
-    # rebranchera OrsRouteEngine ici sans toucher au calculateur ni au front.
-    App\Module\FieldSales\Domain\Route\RouteEngineInterface:
-        alias: App\Module\FieldSales\Infrastructure\Route\HaversineRouteEngine
-
-    # Rendu PDF (feuille de route M6.4, etc.) : Dompdf.
-    App\Shared\Domain\Contract\PdfRendererInterface:
-        alias: App\Shared\Infrastructure\Pdf\DompdfRenderer
-
-# En test : geocodeur en memoire, deterministe et sans reseau (les tests
-# fonctionnels d'adresse ne doivent jamais appeler la BAN reelle).
-when@test:
-    services:
-        App\Tests\Fixtures\Geocoding\InMemoryGeocoder: ~
-
-        App\Shared\Domain\Contract\GeocoderInterface:
-            alias: App\Tests\Fixtures\Geocoding\InMemoryGeocoder

config/sidebar.php

@@ -61,20 +61,39 @@ return [
             ],
         ],
     ],
-    // Section "Tournées" (module field_sales, M6) : planification de tournees
-    // commerciales terrain. Transverse Clients/Fournisseurs. Masquee si le module
-    // field_sales est desactivee (cle `module`) ou si l'user n'a pas la
-    // permission field_sales.tours.view.
+    // Section "Technique" (M3, ERP-138) : pole distinct du Commercial, porte le
+    // repertoire prestataires. L'item est gate par `technique.providers.view` ;
+    // la section disparait automatiquement (SidebarProvider) si le module
+    // `technique` est desactive ou si l'user n'a pas la permission.
     [
-        'label' => 'sidebar.field_sales.section',
-        'icon'  => 'mdi:map-marker-path',
+        'label' => 'sidebar.technique.section',
+        'icon'  => 'mdi:account-convert-outline',
         'items' => [
             [
-                'label'      => 'sidebar.field_sales.tours',
-                'to'         => '/tours',
-                'icon'       => 'mdi:map-marker-path',
-                'module'     => 'field_sales',
-                'permission' => 'field_sales.tours.view',
+                'label'      => 'sidebar.technique.providers',
+                'to'         => '/providers',
+                'icon'       => 'mdi:account-wrench-outline',
+                'module'     => 'technique',
+                'permission' => 'technique.providers.view',
+            ],
+        ],
+    ],
+    // Section "Logistique" (M5, ERP-181) : nouveau pole "operations physiques sur
+    // site", distinct du repertoire Transport (M4, desormais rattache a la section
+    // Administration cote develop). Porte le ticket de pesee au pont bascule.
+    // L'item est gate par `logistique.weighing_tickets.view` ; la section disparait
+    // automatiquement (SidebarProvider) si le module `logistique` est desactive ou
+    // si l'user n'a pas la permission (Compta / Commerciale).
+    [
+        'label' => 'sidebar.logistique.section',
+        'icon'  => 'mdi:scale',
+        'items' => [
+            [
+                'label'      => 'sidebar.logistique.weighing_tickets',
+                'to'         => '/weighing-tickets',
+                'icon'       => 'mdi:scale',
+                'module'     => 'logistique',
+                'permission' => 'logistique.weighing_tickets.view',
             ],
         ],
     ],
@@ -100,8 +119,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',

config/version.yaml

@@ -1,2 +1,2 @@
 parameters:
-    app.version: '0.1.109'
+    app.version: '0.1.140'

docs/specs/M3-prestataires/spec-front.md

@@ -0,0 +1,339 @@
+---
+# === IDENTITÉ ===
+module: M3
+nom: "Répertoire prestataires"
+ecran: repertoire-prestataires
+owner_spec: Matthieu
+backup_spec: Tristan
+version: V0.2
+date_redaction: 2026-06-11
+# Historique :
+#   V0.2 (2026-06-11) — Restitution Markdown du docx « M3-reportoire-prestataires.docx » (04/06/2026).
+#     Alignement refonte-contact (comme M1/M2) : le contact principal inline du formulaire principal
+#     du PDF V0.1 (Nom contact / Prénom contact / Téléphone + / Email) est RETIRÉ — saisie via
+#     l'onglet Contacts uniquement (décision Matthieu, 11/06 : « oublie le contact inline, comme client »).
+#     RG-3.01 / RG-3.02 (contact inline + max 2 tél sur le formulaire principal) supprimées en conséquence.
+#   V0.1 (PDF) — version fonctionnelle plus ancienne, NON retenue (contact inline sur le formulaire principal).
+
+# === LIENS ===
+maquette_figma: "https://www.figma.com/design/jRYgT0T9c03VsEbjGhCwwS/Composants---Design-System?node-id=1132-42090&p=f&m=dev"
+regles_metier: [RG-3.03, RG-3.04, RG-3.05, RG-3.06, RG-3.07, RG-3.08, RG-3.09, RG-3.10, RG-3.11, RG-3.12, RG-3.13, RG-3.14, RG-3.15, RG-3.16, RG-3.17]
+roles: [Admin, Bureau, Compta, Commerciale, Usine]
+lien_spec_back: ./spec-back.md
+
+# === VALIDATION CLIENT ===
+client_validation_1:
+  statut: validee
+  date: 2026-05-22
+  version: V0
+  valide_par: "Matthieu (CP MALIO)"
+client_validation_2:
+  statut: validee
+  date: 2026-06-01
+  version: V0.1
+  valide_par: "Matthieu (CP MALIO)"
+client_validation_3:
+  statut: a_valider
+  date: 2026-06-04
+  version: V0.2
+  resume: "Module 3 — Répertoire prestataires. Pôle Technique (nouvelle section sidebar). Datatable + 3 écrans (Ajouter / Consulter / Modifier). Création par onglets : Contact / Adresse / Comptabilité (Rapports, Échanges = placeholders 'À venir'). PAS d'onglet Information. Sélecteur de site aussi sur le formulaire principal."
+  trace_archivee: "uploads/M3-reportoire-prestataires.docx (V0.2) + M3-reportoire-prestataires-V01.pdf (V0.1, obsolète)"
+
+# === LIEN LESSTIME ===
+lesstime_taskgroup_id: 29   # M3 — Répertoire prestataires (projet STARSEED #6)
+lesstime_project_id: 6
+statut_global: en_dev
+---
+
+# Module 3 — Répertoire prestataires (V0.2 front)
+
+> **Origine** : spec fonctionnelle `M3-reportoire-prestataires.docx` (V0.2 du 04/06/2026 ; historique V0 22/05 → V0.1 01/06). Restitution Markdown pour intégration au workflow MALIO. Le contenu fonctionnel original n'est pas modifié, **sauf** l'alignement refonte-contact (cf. ci-dessous). Toute décision technique (back) vit dans [`spec-back.md`](./spec-back.md). Le M3 réutilise massivement le pattern et les composants posés au [M1 clients](../M1-clients/spec-front.md) et au [M2 fournisseurs](../M2-suppliers/spec-front.md).
+
+> **⚠️ Alignement refonte-contact (décision Matthieu, 11/06/2026)** : le PDF V0.1 portait un **contact principal inline** sur le formulaire principal (Nom du contact / Prénom du contact / Téléphone + bouton + / Email) avec RG-3.01 (Nom OU Prénom) et RG-3.02 (max 2 téléphones). Ce contact inline est **retiré**, exactement comme l'a fait M1/M2 (refonte-contact). Les coordonnées du contact se saisissent **uniquement dans l'onglet Contacts**. **RG-3.01 et RG-3.02 sont donc supprimées du formulaire principal** ; la garantie « au moins un contact nommé » est portée par RG-3.04 + RG-3.12, et le « maximum 2 téléphones » s'applique aux blocs Contact.
+
+> **⚠️ Décision d'architecture (à confirmer) — pôle « Technique »** : le docx place le répertoire prestataires dans un **Module « Technique »**. Confirmé par Matthieu (11/06) : c'est bien un **nouveau pôle Technique**, distinct du Commercial. Côté front cela se traduit par une **nouvelle section sidebar « Technique »** (route `/providers`). Côté back, voir [`spec-back.md § 2.1`](./spec-back.md) (nouveau module `Technique`, entités jumelles du fournisseur, référentiels comptables consommés en relation ORM partagée).
+
+## But
+
+Lister tous les prestataires de l'organisation et accéder rapidement à leurs fiches : consultation, création, modification, archivage. C'est la **porte d'entrée du pôle Technique**.
+
+## Accès
+
+- **Depuis** : menu principal → section **Technique** → entrée « Répertoire prestataires » (route `/providers`).
+- **Rôles autorisés** (tableau « Rôles & permissions » du docx) :
+
+| Rôle | Consultation | Création / Modification | Archivage |
+|---|---|---|---|
+| **Admin** | ✅ Tout | ✅ Tout | ✅ |
+| **Bureau** | ✅ Tout | ✅ Tout sauf onglet Comptabilité | ❌ |
+| **Compta** | ✅ Tout | ✅ Onglet Comptabilité uniquement | ❌ |
+| **Commerciale** | ✅ Tout sauf Comptabilité | ✅ Tout sauf Comptabilité | ❌ |
+| **Usine** | ✅ Son site uniquement | — | ❌ |
+
+> **Notes** :
+> - RBAC transposée sur `technique.providers.*` (cf. [`spec-back.md § 2.9 / § 5`](./spec-back.md)). Compta édite uniquement l'onglet Comptabilité d'un prestataire existant ; Compta ne peut pas **créer** un prestataire. **L'archivage est réservé à Admin**.
+> - **Cloisonnement par site (décision 11/06 — DANS LE PÉRIMÈTRE M3)** : « Tout » vs « son site uniquement » n'est **pas porté par le rôle** mais par l'**utilisateur**. Chaque user a un site courant ; **par défaut il ne voit que les prestataires rattachés à son site**. Les profils qui doivent voir tous les sites (Admin, et par défaut Bureau / Compta / Commerciale) ont la permission `sites.bypass_scope` (Admin l'a automatiquement). **Usine** n'a pas le bypass → cloisonnée à son site. Filtrage **automatique côté back** (cf. [`spec-back.md § 2.13`](./spec-back.md)) — aucun filtre à coder côté front.
+
+## Navigation
+
+Page d'entrée du pôle **Technique** (route `/providers`). Titre : « **Répertoire prestataires** ».
+
+- Affichage principal : un **datatable** listant tous les prestataires **actifs** (les archivés sont masqués par défaut — toggle/filtre dédié).
+- **Clic sur une ligne** → écran **Consultation prestataire** (page dédiée).
+- **Bouton « + Ajouter »** (haut droite) → écran **Ajouter un prestataire**.
+- **Bouton « Filtrer »** (haut droite) → panneau de filtres (cf. ci-dessous).
+- **Bouton « Exporter »** (haut droite) → télécharge un **XLSX** des prestataires **affichés** (cf. filtres actifs). Format dans [`spec-back.md § 4.6`](./spec-back.md).
+
+### Panneau de filtres (bouton « Filtrer »)
+
+Réutilise le pattern M1/M2. Filtres branchés sur les query params de `GET /api/providers` (cf. [`spec-back.md § 4.1`](./spec-back.md)) :
+
+| Filtre | Composant | Query param back |
+|---|---|---|
+| **Recherche** (nom entreprise / contact / email) | `<MalioInputText>` | `?search=` |
+| **Catégorie** | `<MalioSelectCheckbox>` (multi, type PRESTATAIRE) | `?categoryCode=` |
+| **Site** | `<MalioSelectCheckbox>` (86 / 17 / 82) | `?siteId=` |
+| **Inclure les archivés** | `<MalioCheckbox>` | `?includeArchived=true` |
+
+- À l'application des filtres → `setFilters(...)` de `usePaginatedList` (retombe en **page 1**), qui relance `GET /api/providers`.
+- **État 100 % local** (jamais dans l'URL — règle ABSOLUE n°6).
+
+## Datatable du Répertoire
+
+Composant : `<MalioDataTable>` branché sur `usePaginatedList<Provider>({ url: '/providers' })` (règle frontend obligatoire — pagination Hydra, état 100 % local). Colonnes (alignées M2) :
+
+| Colonne | Source | Tri |
+|---|---|---|
+| **Nom** | `provider.companyName` | ASC par défaut |
+| **Catégories** | `provider.categories[].name` (embarquées en liste — cohérence M1/M2 ; libellé = `name`, pas `label`) | Non |
+| **Site** | `provider.sites[].name` (sites du prestataire — cf. note ci-dessous) | Non |
+| **Dernière activité** | `provider.updatedAt` (format `JJ-MM-AAAA`) — exposé dans `provider:read` | Oui |
+
+> **Source de la colonne « Site »** : le M3 porte un sélecteur de site **sur le formulaire principal** (RG-3.03) — donc `provider.sites[]` est une relation **directe** du prestataire (≠ M2 où les sites venaient de l'agrégat des adresses). La colonne liste affiche ces sites directs. Voir [`spec-back.md § 2.12`](./spec-back.md).
+> **Clic sur une ligne** → écran Consultation. **Pagination** : standard Starseed 10 / 25 / 50 (défaut 10). Tri serveur `companyName ASC` par défaut.
+
+## Écran « Ajouter un prestataire »
+
+Création par **onglets successifs avec validation incrémentale** : pour passer à l'onglet suivant, il faut avoir validé l'onglet en cours. **Une fois un onglet validé, on passe automatiquement au suivant** ; les champs validés passent en lecture seule + bouton « Valider » désactivé (disabled). Cf. [`spec-back.md § 2.10`](./spec-back.md) (PATCH partiels par groupe de sérialisation).
+
+**Accès** : bouton « + Ajouter » du Répertoire. **Rôles** : Admin, Bureau.
+
+**Barre d'onglets en création (3 onglets)** : `Contact` · `Adresse` · `Comptabilité`. Les onglets `Rapports` et `Échanges` **n'apparaissent PAS dans le flux de création** — ils ne sont présents qu'en Consultation / Modification (placeholders « À venir »).
+
+> **Différence majeure avec M2 : PAS d'onglet « Information ».** Le M3 n'a aucun champ Description / Concurrent / Date création / Salariés / CA / Dirigeant / Résultat / Volume. Le formulaire principal est minimal (3 champs).
+
+> **Règle « placeholder par défaut » (convention MALIO)** : tout onglet ou écran que la spec ne détaille pas explicitement (ici **Rapports** et **Échanges**) est livré en **placeholder « À venir »** (frame vide, navigable, pas de validation ni d'API), à l'identique des autres modules (M1/M2). Aucun champ inventé hors spec.
+
+### Formulaire principal (pré-onglets)
+
+1er bloc à remplir. Sans validation, les onglets ne sont pas accessibles. Une fois validé → POST `/api/providers`, puis bascule sur l'onglet Contact ; les champs passent en readonly.
+
+| Champ | Type composant | Obligatoire | Règle |
+|---|---|---|---|
+| **Nom du prestataire (Entreprise)** | `<MalioInputText>` | Oui | RG-3.11 (UPPERCASE serveur) ; RG-3.10 (unicité) |
+| **Catégorie** | `<MalioSelectCheckbox>` (multi) | Oui | `Category` de **type PRESTATAIRE** via `GET /api/categories?typeCode=PRESTATAIRE` (RG-3.09). Libellé affiché = `category.name`. |
+| **Sélecteur de site** | `<MalioSelectCheckbox>` (86 / 17 / 82) | Oui | RG-3.03 — ≥ 1 site. Les 3 cases = les 3 `Site` fixes ; libellés « 86/17/82 » = **préfixe du `postalCode`** (86100 / 17400 / 82400), pas un `Site.code` (qui n'existe pas). La sélection stocke des **IDs de Site** (M2M `provider_site`). |
+
+**Action** : « Valider » (`<MalioButton>`) → POST `/api/providers` ([`spec-back.md § 4.3`](./spec-back.md)). Succès → onglet « Contact ».
+
+### Onglet « Contact »
+
+Saisir un ou plusieurs contacts. Au moins un bloc Contact valide est requis (RG-3.12). **(Refonte-contact : pas de pré-remplissage depuis le formulaire principal ; les coordonnées du contact se saisissent directement ici.)**
+
+**Bloc Contact** :
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Nom** | `<MalioInputText>` | Conditionnel | RG-3.04 + RG-3.11 (Capitalize) |
+| **Prénom** | `<MalioInputText>` | Conditionnel | RG-3.04 + RG-3.11 (Capitalize) |
+| **Fonction** | `<MalioInputText>` | Non | — |
+| **Téléphone** (x1, +1 possible, **max 2**) | `<MalioInputText>` | Non | RG-3.11 (format) ; max 2 téléphones par contact |
+| **Email** | `<MalioInputText>` type email | Non | RG-3.11 (lowercase) |
+
+**RG-3.04 / RG-3.12** : un bloc Contact est valide dès qu'au moins 1 champ est rempli ; au moins 1 bloc Contact valide pour finaliser l'onglet — l'onglet Contact ne peut pas être validé vide.
+
+**Actions** :
+- « + Nouveau contact » : ajoute un bloc. **Désactivé tant que le bloc précédent n'a pas au moins 1 champ rempli** (RG-3.04).
+- « Supprimer » (icône) : modal de confirmation, puis suppression du bloc.
+- « Valider » → PATCH `/api/providers/{id}/contacts`.
+
+### Onglet « Adresse »
+
+Saisir une ou plusieurs adresses, rattachées à un ou plusieurs sites (86 / 17 / 82) et à des contacts.
+
+**Bloc Adresse** :
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Sélecteur de site** | `<MalioSelectCheckbox>` (86 / 17 / 82) | Oui | RG-3.05 — ≥ 1 site. Stocke des IDs de Site (M2M `provider_address_site`). |
+| **Adresse** | `<MalioInputText>` (saisie assistée) | Oui | RG-3.06 — autocomplete BAN |
+| **Adresse complémentaire** | `<MalioInputText>` | Non | — |
+| **Code postal** | `<MalioInputText>` (saisie assistée) | Oui | RG-3.06 — déclenche autocomplete ville (BAN) |
+| **Ville** | `<MalioSelect>` (saisie assistée) | Oui | RG-3.06 — alimentée par api-adresse.data.gouv.fr suivant le CP ; si plusieurs villes, choix dans le select |
+| **Pays** | `<MalioSelect>` (préremplie « France ») | Oui | — |
+| **Catégories** | `<MalioSelectCheckbox>` (multi) | Oui | Catégories de type PRESTATAIRE (RG-3.09) |
+| **Contact** | `<MalioSelectCheckbox>` (multi) | Non | Liste = blocs Contact saisis dans l'onglet Contact |
+
+> **Différence avec M2** : l'adresse prestataire n'a **PAS** de Type d'adresse (Prospect/Départ/Rendu), **PAS** de Bennes, **PAS** de Prestation de triage. C'est une adresse « simple » (site + adresse postale + catégories + contacts).
+
+**Actions** :
+- « + Nouvelle Adresse » : ajoute un bloc identique au premier.
+- « Supprimer » (icône) : modal de confirmation puis suppression.
+- « Valider » → PATCH `/api/providers/{id}/addresses`.
+
+### Onglet « Comptabilité »
+
+⚠ **Accessible aux rôles avec `technique.providers.accounting.view`** (Admin + Compta). Bureau et Commerciale ne voient pas l'onglet. **Compta peut éditer** cet onglet (`accounting.manage`). Compta ne peut pas créer un prestataire (pas de `manage` global).
+
+**Champs comptables** :
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **SIREN** | `<MalioInputText>` (masque 9 chiffres) | Oui | 9 chiffres. **Pas d'unicité** (cf. [`spec-back.md § 2.6`](./spec-back.md)) |
+| **Numéro de compte** | `<MalioInputText>` | Oui | — |
+| **Mode de TVA** | `<MalioSelect>` | Oui | Liste depuis `/api/tva_modes` (référentiel partagé M1) |
+| **N° de TVA** | `<MalioInputText>` | Oui | — |
+| **Délai de règlement** | `<MalioSelect>` | Oui | Liste depuis `/api/payment_delays` |
+| **Type de règlement** | `<MalioSelect>` | Oui | Liste depuis `/api/payment_types` |
+| **Banque** | `<MalioSelect>` | Conditionnel | RG-3.07 — visible et obligatoire **si** Type de règlement = `VIREMENT`. Liste depuis `/api/banks` (SG / CIC / CA). |
+
+**Bloc RIB** (0..n, présence obligatoire conditionnée par RG-3.08) :
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Libellé** | `<MalioInputText>` | Oui (si LCR) | RG-3.08 |
+| **BIC** | `<MalioInputText>` | Oui (si LCR) | RG-3.08 |
+| **IBAN** | `<MalioInputText>` | Oui (si LCR) | RG-3.08 |
+
+**Actions** :
+- « + RIB » : ajoute un bloc.
+- « Supprimer » (icône) : modal de confirmation.
+- « Valider » → PATCH `/api/providers/{id}` (groupe `provider:write:accounting`) + sous-ressource RIBs.
+
+## Écran « Consultation prestataire »
+
+Tous les champs en **lecture seule**. La page s'ouvre par défaut sur l'onglet **Contacts**. Layout identique à l'écran Ajouter mais sans bouton « Valider », sans `+` pour ajouter des blocs.
+
+- **Flèche retour** (gauche) → revient au Répertoire.
+- **Bouton « Modifier »** (droite, visible si `technique.providers.manage`) → écran Modification.
+- **Bouton « Archiver »** (droite, visible **uniquement Admin** via `technique.providers.archive`) → modal de confirmation, puis PATCH `/api/providers/{id}` `{ "isArchived": true }`.
+
+> Un prestataire archivé peut être restauré (`isArchived: false`) — bouton « Restaurer » remplace « Archiver » dans la consultation d'un archivé.
+
+### Onglets affichés en consultation
+
+`Contacts` · `Adresse` · `Rapports` · `Échanges` · `Comptabilité`. Navigation **libre** entre onglets (pas de séquence forcée). `Rapports` et `Échanges` = placeholders « À venir ». `Comptabilité` selon permission.
+
+- **Onglet Contacts** : un bloc par contact, 5 champs en lecture seule (Nom / Prénom / Fonction / Téléphone / Email).
+- **Onglet Adresse** : un bloc par adresse, en lecture seule (Sélecteur de site / Adresse / Adresse complémentaire / Code postal / Ville / Pays / Catégorie / Contact).
+- **Onglet Comptabilité** : bloc principal (champs comptables) + un bloc par RIB. Le champ **Banque** n'apparaît que si Type de règlement = Virement (RG-3.07).
+
+## Écran « Modification prestataire »
+
+Comportement identique à l'écran Ajouter (mêmes formulaires, mêmes RG-3.03 → RG-3.08) sauf :
+- **Pas de formulaire principal** réaffiché (champs principaux édités via l'onglet correspondant / pré-remplis).
+- Les champs sont **pré-remplis** avec les valeurs actuelles du prestataire.
+- **Validation par onglet** : on peut modifier UN onglet sans toucher aux autres (PATCH partiel).
+- Les onglets pour lesquels l'utilisateur n'a **pas** la permission `manage` (ou `accounting.manage`) restent en **lecture seule** (pas de bouton Valider, pas d'icône suppression).
+- **Accès** : Admin, Bureau (Compta pour l'onglet Comptabilité uniquement).
+
+## Composants UI à utiliser (`@malio/layer-ui`)
+
+- **Datatable** : `<MalioDataTable>` (+ `usePaginatedList`)
+- **Input texte** : `<MalioInputText>`
+- **Select simple** : `<MalioSelect>` (Pays, Ville, référentiels comptables)
+- **Select multi (cases à cocher)** : `<MalioSelectCheckbox>` (Catégorie, Sites, Contacts rattachés)
+- **Bouton** : `<MalioButton>`, `<MalioButtonIcon>`
+- **Toasts** : standards via `useApi()`
+- **Validation par champ** : `useFormErrors` (mapping 422 inline — règle frontend obligatoire)
+
+**Exceptions autorisées** (commenter `// TODO migrer quand Malio couvre`) :
+- Modal de confirmation : `<MalioModal>` ou wrapper partagé dans `frontend/shared/` (réutiliser celui du M1/M2).
+
+## Composables & appels API
+
+- `usePaginatedList<Provider>({ url: '/providers' })` — liste paginée (obligatoire). La liste consomme `categories[]` (libellé = `name`) et `sites[]` (libellé = `name`, pas de `code`) **embarqués** + `updatedAt` (cf. [`spec-back.md § 2.12 / § 4.0`](./spec-back.md)).
+- `useProvider(id)` — charge le détail via `GET /api/providers/{id}`, qui **embarque** `contacts`, `addresses` (avec `sites` / `categories` / `contacts` imbriqués) et, si permission, `ribs` + scalaires compta. Écrans Consultation et Modification peuplés depuis cette seule réponse (RETEX M1 §2 : embed borné, pas de N+1). **DoD avant intégration** : vérifier que le JSON réel contient ces blocs (cf. [`spec-back.md § 4.0.bis`](./spec-back.md)).
+- `useProviderForm()` — workflow par onglet (POST principal + PATCH partiels par groupe), miroir de `useSupplierForm()`.
+- `useAddressAutocomplete()` — **réutilisé du M1/M2** (BAN), pas de réécriture.
+- `usePermissions()` — masque l'onglet Comptabilité et le bouton Archiver.
+- Tous les appels passent par `useApi()` (jamais `$fetch` direct — règle ABSOLUE n°4).
+- Filter `formatPhoneFR()` — **réutilisé** pour l'affichage `XX XX XX XX XX`.
+
+## Règles de formatage et normalisation
+
+Le serveur normalise systématiquement (RG-3.11 — cf. [`spec-back.md`](./spec-back.md)) :
+
+| Champ | Normalisation serveur | Affichage front |
+|---|---|---|
+| Nom prestataire (`companyName`) | UPPERCASE intégral | UPPERCASE |
+| Nom + Prénom contact | Capitalize | identique |
+| Téléphones (blocs `ProviderContact`) | Chiffres uniquement en BDD | Formaté `XX XX XX XX XX` (filter Vue) |
+| Email | lowercase intégral | identique |
+
+> Le front **ne normalise pas** : il envoie la valeur saisie, le serveur normalise et renvoie la valeur normalisée que l'UI affiche.
+
+## API adresse postale
+
+Code postal + Ville + Adresse branchés sur **api-adresse.data.gouv.fr** (BAN) via le composable `useAddressAutocomplete()` **déjà créé au M1/M2** (réutilisé tel quel) :
+- À la saisie du CP (5 chiffres) : `GET https://api-adresse.data.gouv.fr/search/?q={cp}&type=municipality` → alimente le select Ville (RG-3.06 : si plusieurs villes, choix dans le select).
+- À la saisie d'adresse : `?q={addr}&postcode={cp}&type=housenumber` → suggestions.
+- Cas dégradé (timeout / offline) : Ville en `<MalioInputText>` libre + toast d'avertissement.
+
+## Différences notables avec le M2 (fournisseurs)
+
+| Zone | M2 fournisseurs | M3 prestataires |
+|---|---|---|
+| Onglet Information | 8 champs (Description … Volume) | **Absent** (aucun champ Information) |
+| Sélecteur de site sur formulaire principal | Non (sites uniquement via adresses) | **Oui** (RG-3.03 — relation directe `provider.sites`) |
+| Type d'adresse | Radio Prospect / Départ / Rendu (RG-2.09) | **Absent** |
+| Bennes / Prestation de triage (adresse) | Présents | **Absents** |
+| Onglet Transport | Placeholder | **Absent** |
+| Onglet Statistiques | Placeholder | **Absent** |
+| Onglets « À venir » | Transport / Stats / Rapports / Échanges | **Rapports / Échanges** uniquement |
+| Catégories | type `FOURNISSEUR` | **nouveau type `PRESTATAIRE`** |
+| Pôle / module | Commercial | **Technique** (nouvelle section sidebar + module back) |
+| Cloisonnement par site | aucun | **Visibilité par site, pilotée par l'utilisateur** (bypass via `sites.bypass_scope`) — § 2.13 |
+
+## Points résolus côté back
+
+| # | Zone d'ombre | Résolution (cf. `spec-back.md`) |
+|---|---|---|
+| 1 | Catégorie multi-select | M2M `provider_category`, `Category` de type **PRESTATAIRE** (RG-3.09) |
+| 2 | Site sur le formulaire principal | M2M `provider_site` (≥ 1 — RG-3.03), distinct de `provider_address_site` (RG-3.05) |
+| 3 | Onglet Comptabilité : qui édite ? | Admin + Compta (`accounting.manage`) ; Bureau/Commerciale ne le voient pas |
+| 4 | Workflow par onglet | Sauvegarde incrémentale (POST principal + PATCH partiels) — pas d'état « draft » |
+| 5 | Onglets « À venir » | Placeholder minimal « À venir » (Rapports / Échanges) |
+| 6 | Archive vs delete | Flag `is_archived` séparé de `deleted_at` ; archivage Admin seul ; soft delete = HP |
+| 7 | Unicité métier | Nom de prestataire uniquement (à valider — § 2.6). SIREN/email non uniques |
+| 8 | Référentiels comptables | Réutilisés M1/M2 (zéro duplication) ; relation ORM partagée |
+| 9 | API code postal | BAN via `useAddressAutocomplete()` du M1/M2 (RG-3.06) |
+| 10 | Format export | XLSX uniquement (CSV = HP) |
+| 11 | Cloisonnement par site (Usine « son site ») | Filtre back automatique par `currentSite` + bypass `sites.bypass_scope` (§ 2.13 / RG-3.17) |
+
+---
+
+## 📦 Tickets Lesstime
+
+**TaskGroup Lesstime** : **#29 — M3 — Répertoire prestataires** (projet `ERP / Starseed`, projectId=6) — créé le 11/06/2026, 16 tickets `ERP-131` → `ERP-146`, statut « Prêt à dev », assignés à **Tristan**.
+
+| # | Ticket | Réf | Tag |
+|---|---|---|---|
+| 1.1 | Créer module Technique + taxonomie PRESTATAIRE | ERP-131 | Backend |
+| 1.2 | Migrer le schéma BDD M3 (provider + sous-collections) | ERP-132 | Backend |
+| 1.3 | Créer entités + repositories Provider* | ERP-133 | Backend |
+| 1.4 | ProviderProvider + ProviderProcessor + cloisonnement site | ERP-134 | Backend |
+| 1.5 | Sous-ressources Contacts / Adresses / RIBs | ERP-135 | Backend |
+| 1.6 | Valider les RG métier server-side (RG-3.03→3.09) | ERP-136 | Backend |
+| 1.7 | Export XLSX des prestataires | ERP-137 | Backend |
+| 1.8 | RBAC technique.providers.* (3 sources) | ERP-138 | Backend |
+| 1.9 | PHPUnit RG-3.x + capture contrat JSON | ERP-139 | Backend |
+| 1.10 | Page Répertoire (/providers) | ERP-140 | Frontend |
+| 1.11 | Page Ajouter (/providers/new) + formulaire principal | ERP-141 | Frontend |
+| 1.12 | Onglet Contact | ERP-142 | Frontend |
+| 1.13 | Onglet Adresse (autocomplete BAN) | ERP-143 | Frontend |
+| 1.14 | Onglet Comptabilité + RIB | ERP-144 | Frontend |
+| 1.15 | Pages Consultation + Modification | ERP-145 | Frontend |
+| 1.16 | i18n + sidebar Technique + libellés audit | ERP-146 | Frontend |
+
+> Détail back complet → voir [`spec-back.md § Tickets Lesstime`](./spec-back.md#-tickets-lesstime-à-découper).

docs/specs/M4-transporteurs/prompts/00-PLAN-MAITRE.md

@@ -0,0 +1,100 @@
+# M4 — Plan maître worktrees (back, Matthieu)
+
+> **Rôle de ce fichier** : vue d'ensemble que la *conversation maître* tient à jour.
+> Chaque worktree = une conversation Claude isolée + une branche + une PR vers `develop`.
+> Les prompts à coller sont dans `WT*.md`.
+
+## Principe
+
+- 1 worktree = 1 branche partant de `origin/develop` (à jour des deps).
+- 1 ticket = 1 PR atomique vers **`develop`** (jamais `main`).
+- Commit autorisé sur la branche du worktree (ces prompts SONT la demande explicite) ;
+  `git commit --no-verify` OK si `make test` est déjà vert (le hook relance toute la suite).
+- **Chaque worktree ouvre SA PR** vers `develop` en fin de tâche (cf. bloc PR ci-dessous).
+
+## Bloc PR standard (repris dans chaque prompt)
+
+```bash
+git push -u origin <branche>
+tea pr create --base develop --head <branche> \
+  --title "<type>(<scope>) : <titre>" \
+  --description "Résumé + lien ticket Lesstime ERP-XXX"
+```
+Puis **labelliser la PR via l'API Gitea** (tea ne pose pas les labels en CLI — `gitea.malio.fr`).
+Cible **`develop`**, jamais `main`. **Aucune mention de Claude/IA** dans titre ou description.
+
+## Vagues & ordre de merge
+
+```
+VAGUE 0  (en parallèle, dès maintenant)
+  WT1  1.2 upload Shared      base: origin/develop            ──┐
+  WT2  1.1 RBAC + sidebar     base: origin/develop (≥ERP-150) ──┤ indépendants
+                                                                 │
+VAGUE 1  (critique, séquentiel)                                  │
+  WT3  1.3 migration + 1.5 entités/resource/provider + i18n audit
+       base: origin/develop APRÈS merge WT1  (FK uploaded_document)
+       ⭐ livre le CONTRAT JSON liste+détail → débloque le front (Tristan)
+
+VAGUE 2  (fan-out, tous en parallèle dès WT3 mergé)
+  WT4  1.6 processor          base: develop ≥ WT3
+  WT5  1.4 qualimat endpoint  base: develop ≥ WT2 (perm) + ERP-39   (indépendant de WT3)
+  WT6  1.7 adresses           base: develop ≥ WT3
+  WT7  1.8 contacts           base: develop ≥ WT3
+  WT8  1.9 prix               base: develop ≥ WT3
+  WT9  1.10 export XLSX        base: develop ≥ WT3
+
+VAGUE 3  (final)
+  WT10 1.11 tests + fixtures + contrat  base: develop ≥ TOUT
+```
+
+**Parallélisme réel** : 2 worktrees en V0, puis 1 goulot (WT3), puis **jusqu'à 6 en V2**, puis 1 (WT10).
+
+## Règle anti-conflit worktree (IMPORTANT)
+
+Pour que WT4→WT9 tournent en parallèle sans conflit de merge :
+
+| Fichier partagé | Qui le touche | Les autres |
+|---|---|---|
+| `CarrierFixtures` | **WT10 uniquement** | interdit (WT3 met un fixture minimal, WT6-9 n'y touchent pas) |
+| Entité `Carrier` (ApiResource) | **WT3** crée, **WT4** ajoute le Processor | WT6-9 créent des **resources/processors dédiés** par sous-entité, ne modifient pas `Carrier` |
+| `ColumnCommentsCatalog` | WT1 (`uploaded_document`), WT3 (`carrier*`) | personne d'autre |
+| `fr.json` (clés audit) | **WT3** (clés `audit.entity.transport_*`) | personne d'autre côté back |
+| `migrations/` | WT1 puis WT3 (ordre timestamp) | aucune autre migration |
+
+## Mode retenu : STACK séquentiel, SANS worktree (repo principal)
+
+Matthieu empile les MR, un ticket à la fois, **directement dans `/home/matthieu/dev_malio/Starseed`** (pas de worktree).
+- **Ignorer les blocs `git worktree add` des `WT*.md`** → remplacés par une branche normale :
+  ```bash
+  git fetch origin
+  git checkout -b feat/erp-XXX-... origin/<branche-précédente>
+  ```
+- **WT1 hors pile** (déjà mergé). Pile M4 — chaque branche basée sur la précédente :
+  `WT2 → WT3 → WT4 → WT5 → WT6 → WT7 → WT8 → WT9 → WT10`
+- PR de chaque maillon : `--base <branche-précédente>` (bas de pile WT2 = `develop`). Au merge, les MR du dessus se recible auto.
+- Docker tourne sur le repo principal → `make test`/`php-cs-fixer` OK sans rebind (le piège worktree-vs-mount ne s'applique plus).
+- Worktrees créés pour WT1/WT2 à nettoyer : `git worktree remove ../sb-erp154-upload ../sb-erp153-rbac`.
+- Garder les MR basses propres ; merger dans l'ordre.
+
+## Suivi (tenu par la conv maître)
+
+| WT | Ticket | ERP | État | PR | Notes |
+|----|--------|-----|------|----|----|
+| WT1 | 1.2 upload | 154 | ✅ MERGÉ | #108 | migration `Version20260615130000` |
+| WT2 | 1.1 RBAC | 153 | ✅ PR ouverte | #111 | bas de pile (cible develop) |
+| WT3 | 1.3+1.5 | 155+157 | ▶️ À LANCER | — | stack sur `feat/erp-153-rbac` ; gate contrat front |
+| WT4 | 1.6 proc | 158 | ⛔ bloqué par WT3 | — | |
+| WT5 | 1.4 qualimat | 156 | ⛔ bloqué par WT2+ERP-39 | — | |
+| WT6 | 1.7 adresses | 159 | ⛔ bloqué par WT3 | — | |
+| WT7 | 1.8 contacts | 160 | ⛔ bloqué par WT3 | — | |
+| WT8 | 1.9 prix | 161 | ⛔ bloqué par WT3 | — | |
+| WT9 | 1.10 export | 162 | ⛔ bloqué par WT3 | — | |
+| WT10 | 1.11 tests | 163 | ⛔ bloqué par tout | — | |
+
+## Cadre commun à tous les prompts (rappels projet)
+
+- Carrier vit dans `src/Module/Transport/` (créé par ERP-150). **Miroir = `src/Module/Commercial/`** (Supplier).
+- Tests sous `tests/Module/Transport/Api/` (miroir `tests/Module/Commercial/Api/`).
+- `declare(strict_types=1);` partout ; commentaires **FR**, code EN.
+- `make test` + `make php-cs-fixer-allow-risky` avant de dire « fini ».
+- Ne jamais mentionner Claude/IA dans commit/PR.

docs/specs/M4-transporteurs/prompts/WT1-upload.md

@@ -0,0 +1,44 @@
+# WT1 — Infra upload générique `Shared` (ticket 1.2 / ERP-154)
+
+> Créer le worktree puis lancer Claude dedans :
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp154-upload -b feat/erp-154-upload origin/develop
+> cd ../sb-erp154-upload && claude
+> ```
+> **Base** : `origin/develop` (aucune dépendance — peut démarrer tout de suite, même avant le merge du socle Transport).
+
+---
+
+## Prompt à coller
+
+Tu travailles sur le projet Starseed (modular monolith DDD, Symfony 8 / API Platform 4). Lis `CLAUDE.md` et `.claude/rules/backend.md` avant de coder. Charge le skill `backend-entity-conventions`.
+
+**Mission** : poser une infra d'upload de fichiers **générique et réutilisable** dans `src/Shared/` (la « Décharge » du M4 en sera le 1er consommateur, mais ce ticket ne touche PAS au module Transport).
+
+**Spec** : `docs/specs/M4-transporteurs/spec-back.md § 2.7`.
+
+**À livrer** :
+1. Table `uploaded_document` (migration namespace racine `DoctrineMigrations` dans `migrations/`, postérieure à la dernière présente — vérifie `ls migrations/`). Colonnes : `id`, `original_filename`, `stored_path`, `mime_type`, `size_bytes`, `checksum`, `created_at`, `created_by`.
+2. Service `Shared\Infrastructure\Upload\FileUploader` :
+   - validation MIME **server-side via `$file->getMimeType()`** (JAMAIS `getClientMimeType()`),
+   - whitelist MIME explicite (PDF + images),
+   - bornage taille, checksum sha256, écriture disque `var/uploads/{yyyy}/{mm}/`.
+3. Endpoint `POST /api/uploaded_documents` (multipart) → renvoie l'IRI. MIME hors whitelist → **422**.
+
+**Gardes-fous (cassent `make test` sinon)** :
+- **`COMMENT ON COLUMN` sur TOUTES les colonnes** de `uploaded_document` (FR, ≤200 car., règle n°12) ET ajoute le bloc `'uploaded_document' => [...]` dans `src/Shared/Infrastructure/Database/ColumnCommentsCatalog.php` — sinon `make test-db-setup` drope les COMMENT et `ColumnsHaveSqlCommentTest` casse.
+- Pagination : si tu exposes une `GetCollection`, elle reste paginée (`CollectionsArePaginatedTest`).
+
+**Scope STRICT** : uniquement `src/Shared/` + migration + catalog. Ne crée AUCUN fichier sous `src/Module/Transport/`. Pas d'antivirus/S3/purge (hors périmètre, § 9).
+
+**Tests à écrire** (PHPUnit) : MIME hors whitelist → 422 ; MIME valide → IRI + ligne persistée + checksum calculé.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky` propre. Commit (`--no-verify` OK si `make test` déjà vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-154-upload
+tea pr create --base develop --head feat/erp-154-upload \
+  --title "feat(shared) : infra upload générique (ERP-154)" \
+  --description "Table uploaded_document + FileUploader + endpoint POST. Ticket ERP-154."
+```
+Puis labellise la PR via l'API Gitea (tea ne pose pas les labels en CLI). Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT10-tests.md

@@ -0,0 +1,37 @@
+# WT10 — Tests PHPUnit + fixtures + contrat JSON (ticket 1.11 / ERP-163)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp163-tests -b feat/erp-163-carrier-tests origin/develop
+> cd ../sb-erp163-tests && claude
+> ```
+> **Base** : `origin/develop` **après merge de TOUS les worktrees back** (WT1→WT9). C'est le filet final.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`, `.claude/rules/testing.md`. Charge le skill `backend-entity-conventions`. **Miroir** : `tests/Module/Commercial/Api/Supplier*Test.php`.
+
+**Mission** : couverture complète des RG + capture du contrat de sérialisation + fixtures consolidées. C'est le DoD back avant intégration front.
+
+**Spec** : `spec-back.md § 4.0.bis / 8.1 / 8.4`.
+
+**À livrer** :
+- Matrice **RG-4.01→4.14** couverte (§ 8.1) + RBAC par rôle (Compta/Usine → 403, Commerciale → 403 sur write, Admin → archive).
+- `CarrierSerializationContractTest` : capture JSON réel **liste + détail** ; `prices[].client`/`.supplier`/sites **embarqués** (pas IRI) ; `qualimatCarrier` embarqué ; `isArchived` présent. Colle les JSON dans `spec-back.md § 4.0.bis`.
+- Anti-N+1 liste ; pagination Hydra ; audit (`entity_type='Carrier'`) ; `AuditableEntitiesHaveI18nLabelTest` vert.
+- **`CarrierFixtures` idempotent (§ 8.4)** — c'est ICI que les fixtures complètes vivent : transporteur QUALIMAT (validité passée → RG-4.04), AUTRE+décharge, affrété, LIOT, complet (contacts/adresses/prix CLIENT+FOURNISSEUR), 1 archivé.
+
+**Piège CI (mémoire projet)** : la CI tourne `APP_DEBUG=0`. Les tests de **comptage de requêtes (anti-N+1)** passent en local mais cassent en CI (DoctrineDataHolder absent) → vérifie/active `profiling: true` dans la config Doctrine de l'environnement `test`. Sans ça le test anti-N+1 sera rouge en CI.
+
+**Scope** : tests + `CarrierFixtures` + remplissage § 4.0.bis. Tu peux ajuster un test cassé hérité d'un autre WT mais signale-le à la conv maître (ne masque pas un vrai bug).
+
+**Fini quand** : `make test` **intégralement vert** + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-163-carrier-tests
+tea pr create --base develop --head feat/erp-163-carrier-tests \
+  --title "test(transport) : couverture RG-4.01→4.14 + contrat + fixtures (ERP-163)" \
+  --description "Matrice RG + CarrierSerializationContractTest + CarrierFixtures + § 4.0.bis. Ticket ERP-163."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT2-rbac.md

@@ -0,0 +1,45 @@
+# WT2 — Permissions `transport.carriers.*` + sidebar (ticket 1.1 / ERP-153)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp153-rbac -b feat/erp-153-rbac origin/develop
+> cd ../sb-erp153-rbac && claude
+> ```
+> **Base** : `origin/develop` **après merge d'ERP-150** (le module `Transport` doit exister). Vérifie : `ls src/Module/Transport/`.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (modular monolith DDD). Lis `CLAUDE.md`, `.claude/rules/architecture.md` et `.claude/rules/testing.md` avant de coder.
+
+**Mission** : poser le socle RBAC du module Transport et son entrée de menu. `TransportModule::permissions()` renvoie `[]` aujourd'hui.
+
+**Spec** : `spec-back.md § 5` + `spec-front.md § Accès`.
+
+**À livrer** :
+1. `TransportModule::permissions()` déclare `transport.carriers.view`, `transport.carriers.manage`, `transport.carriers.archive`. `app:sync-permissions` les enregistre.
+2. **Matrice § 5.2** : Admin (view+manage+archive), Bureau (view+manage), Commerciale (view), Compta + Usine (**aucune**).
+3. **RÈGLE ABSOLUE n°8 — les 3 sources RBAC dans le MÊME commit** :
+   - `config/sidebar.php` : section « Transport » + item `/carriers` + `permission: transport.carriers.view`,
+   - `frontend/tests/e2e/_fixtures/personas.ts` : ajuster `permissions` + `expectedAdminLinks` des personas existants,
+   - `src/Module/Core/Infrastructure/Console/SeedE2ECommand.php` : miroir back des mêmes personas.
+4. Item sidebar masqué pour Compta/Usine ; visible Admin/Bureau/Commerciale.
+
+**Pièges** :
+- Ne touche QUE le RBAC/sidebar — pas d'entité, pas de migration.
+- Toute modif d'une seule des 3 sources sans les 2 autres = drift / test cassé.
+- Section « Transport » vs « Logistique » : prends « Transport » (cosmétique, alignable plus tard).
+
+**Tests à écrire/vérifier** : `app:sync-permissions` OK ; cohérence personas (pas de drift). Lance `make test`.
+
+**Scope STRICT** : RBAC + sidebar + 3 miroirs. Rien d'autre.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si test vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-153-rbac
+tea pr create --base develop --head feat/erp-153-rbac \
+  --title "feat(transport) : permissions carriers + sidebar (ERP-153)" \
+  --description "RBAC transport.carriers.* + 3 sources RBAC alignées. Ticket ERP-153."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT3-migration-entites.md

@@ -0,0 +1,54 @@
+# WT3 ⭐ — Migration + entités Carrier* + ApiResource + Provider (tickets 1.3 + 1.5 / ERP-155 + ERP-157)
+
+> **Worktree pivot : il livre le CONTRAT JSON qui débloque tout le front.**
+> **Mode STACK, sans worktree** (repo principal) — base = branche de WT2 :
+> ```bash
+> cd /home/matthieu/dev_malio/Starseed && git fetch origin
+> git checkout -b feat/erp-155-carrier-schema-entities origin/feat/erp-153-rbac
+> ```
+> **Base** : `feat/erp-153-rbac` (contient ERP-150 + WT1 + RBAC WT2). Quand #111 sera mergé dans develop, la PR de WT3 se recible automatiquement sur develop.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (modular monolith DDD, Symfony 8 / API Platform 4). Lis `CLAUDE.md`, `.claude/rules/backend.md`, `.claude/rules/architecture.md`. **Charge le skill `backend-entity-conventions`** (patterns entités/migrations complets).
+
+**Mission** : créer le schéma BDD du répertoire transporteurs + les entités + le contrat de lecture (liste + détail). Tu poses le contrat JSON sur lequel le front s'appuiera — c'est le livrable critique.
+
+**Spec** : `spec-back.md § 3.2 / 3.3 / 3.4 / 4.0 / 4.1 / 4.2`. **Miroir = le module Supplier** : `src/Module/Commercial/Domain/Entity/Supplier*.php`, `…/Infrastructure/ApiPlatform/State/Provider/SupplierProvider.php`, `…/Serializer/SupplierReadGroupContextBuilder.php`. Carrier vit dans `src/Module/Transport/`.
+
+### Étape A — Migration (`migrations/`, namespace racine `DoctrineMigrations`)
+- **PAS de migration modulaire** : même si la spec dit « modulaire », toute migration va dans `migrations/` namespace racine (tri FQCN cassant sinon). Postérieure à la dernière présente — vérifie `ls migrations/` (à ce jour `Version20260615120000`).
+- Tables `carrier`, `carrier_address`, `carrier_contact`, `carrier_price` + FK : `qualimat_carrier`, `uploaded_document`, `client`, `client_address`, `supplier`, `supplier_address`, `site`, `user`.
+- `certification_type` **nullable** (null en cas LIOT) + CHECK enum ; CHECK sur `container_type`, `direction`, `pricing_unit`, `price_state`, branches Prix client/fournisseur.
+- Index partiel `uq_carrier_name_active` : `LOWER(name)` WHERE non archivé ET non supprimé.
+- **`COMMENT ON COLUMN` sur TOUTES les colonnes** (FR, ≤200 car.) + helper standard pour les 4 colonnes Timestampable/Blamable. Bonus `COMMENT ON TABLE`.
+
+### Étape B — Entités + repos
+- `Carrier`, `CarrierAddress`, `CarrierContact`, `CarrierPrice` : `#[Auditable]`, `implements TimestampableInterface, BlamableInterface` + `use TimestampableBlamableTrait`. Repos `*RepositoryInterface` (Domain) + `Doctrine*Repository` (Infrastructure).
+- `ApiResource` Carrier (attribut sur l'entité, comme Supplier) : `GetCollection` + `Get` + `Post` + `Patch` avec `security` (§ 3.3). **PAS de Delete**.
+- Groupes : `carrier:read`, `carrier:item:read`, `qualimat:read`. **Embed au détail** (pas IRI) : `client:read`/`client_address:read`/`supplier:read`/`supplier_address:read`/`site:read` + `qualimatCarrier`. ⚠ les adresses de l'onglet Prix sont des `ClientAddress`/`SupplierAddress` distinctes.
+- `CarrierProvider` paginé (`ApiPlatform\Doctrine\Orm\Paginator`), liste **sans cloisonnement site** (§ 2.3), **anti-N+1** (fetch joins, § 2.11), exclut les archivés par défaut + `?includeArchived=true`.
+- Piège booléen : `#[SerializedName('isArchived')]` sur le getter.
+
+### Gardes-fous qui CASSENT `make test` (à traiter dans CE worktree)
+- `ColumnsHaveSqlCommentTest` → COMMENT partout **+ ajouter les blocs `carrier`, `carrier_address`, `carrier_contact`, `carrier_price` dans `src/Shared/Infrastructure/Database/ColumnCommentsCatalog.php`** (sinon `test-db-setup` drope les COMMENT).
+- `makefile test-db-setup` : l'index partiel `uq_carrier_name_active` n'est PAS exprimé par `schema:update` → **ajoute-le à la ligne `dbal:run-sql` du target `test-db-setup`** du `makefile`, sinon `make test` casse.
+- `AuditableEntitiesHaveI18nLabelTest` → ajoute dans `frontend/i18n/locales/fr.json` les clés `audit.entity.transport_carrier`, `transport_carrieraddress`, `transport_carriercontact`, `transport_carrierprice` (clé = strtolower(module)+'_'+strtolower(Entity)).
+- `EntitiesAreTimestampableBlamableTest`, `EntityConstraintsHaveFrenchMessageTest` (messages FR + `Length.max` = longueur colonne), `CollectionsArePaginatedTest`.
+
+**Scope STRICT** : schéma + entités + ApiResource lecture + Provider + i18n audit. **PAS** le Processor d'écriture (→ WT4), **PAS** les sous-ressources POST/PATCH adresses/contacts/prix (→ WT6/7/8), **PAS** l'export (→ WT9). Mets un `CarrierFixtures` **minimal** (1-2 lignes) juste pour faire tourner tes tests de lecture ; les fixtures complètes sont faites par WT10 — n'y investis pas.
+
+**Tests à écrire** : liste exclut archivés / `?includeArchived=true` ; enveloppe Hydra (`member`/`totalItems`) ; `isArchived` présent dans le JSON ; embeds détail présents (pas IRI).
+
+**LIVRABLE GATE** : une fois vert, **capture le JSON réel liste + détail** (`curl` ou test) et colle-le dans `spec-back.md § 4.0.bis`. C'est le signal pour démarrer le front. Préviens la conv maître.
+
+**Fini quand** : `make db-reset` OK + `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si test vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-155-carrier-schema-entities
+tea pr create --base feat/erp-153-rbac --head feat/erp-155-carrier-schema-entities \
+  --title "feat(transport) : schéma + entités Carrier + contrat lecture (ERP-155/157)" \
+  --description "Migration + entités Carrier* + ApiResource lecture + Provider + i18n audit + contrat JSON. Tickets ERP-155, ERP-157."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT4-processor.md

@@ -0,0 +1,41 @@
+# WT4 — CarrierProcessor (ticket 1.6 / ERP-158)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp158-processor -b feat/erp-158-carrier-processor origin/develop
+> cd ../sb-erp158-processor && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT3** (entités Carrier) **et WT1** (upload, pour la décharge).
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. Charge le skill `backend-entity-conventions`.
+
+**Mission** : logique d'écriture du formulaire principal Carrier (POST/PATCH) — normalisation, champs conditionnels, archivage. **Miroir** : `src/Module/Commercial/Infrastructure/ApiPlatform/State/Processor/SupplierProcessor.php` + `Application/Service/SupplierFieldNormalizer.php`.
+
+**Spec** : `spec-back.md § 4.3 / 4.4 / 7`.
+
+**Règles métier à implémenter (un test PHPUnit par RG)** :
+- **RG-4.01** : POST avec `qualimatCarrier` → `certificationType=QUALIMAT` + FK persistée ; cas LIOT (`name='LIOT'`) ⇒ `certificationType` non requis, `liotPlates` accepté.
+- **RG-4.02** : `certificationType='AUTRE'` sans `dischargeDocument` → **422** (`#[Assert\Callback]`).
+- **RG-4.03** : `isChartered=true` sans `indexationRate` / `containerType` / `volumeM3` → **422**.
+- **RG-4.13** : normalisation via `CarrierFieldNormalizer` (miroir Supplier) — `name` UPPER, contacts Capitalize, phones digits-only, email lower, `liotPlates` (`;`-split/trim/UPPER).
+- **RG-4.12** : doublon `name` (parmi actifs) → **409** + `setError` ciblé.
+- **RG-4.14** : PATCH `isArchived` exige `transport.carriers.archive` (Admin) ; mode strict → 403 sinon.
+
+**Pièges** :
+- Messages de validation **FR explicites** sur chaque contrainte (`EntityConstraintsHaveFrenchMessageTest`).
+- Le back renvoie **toutes** les violations d'un coup avec `propertyPath` aligné sur les champs front.
+
+**Scope STRICT** : `CarrierProcessor` + `CarrierFieldNormalizer` + contraintes sur l'entité `Carrier` (formulaire principal). **NE TOUCHE PAS** : les sous-ressources adresses/contacts/prix (WT6/7/8), `CarrierFixtures` (WT10), l'export (WT9). Ajoute tes contraintes sur `Carrier` sans réécrire l'ApiResource posée par WT3.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-158-carrier-processor
+tea pr create --base develop --head feat/erp-158-carrier-processor \
+  --title "feat(transport) : CarrierProcessor (RG-4.01→4.03/4.12→4.14) (ERP-158)" \
+  --description "Normalisation + champs conditionnels + archive. Ticket ERP-158."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT5-qualimat.md

@@ -0,0 +1,37 @@
+# WT5 — Endpoint QualimatCarrier lecture seule (ticket 1.4 / ERP-156)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp156-qualimat -b feat/erp-156-qualimat-search origin/develop
+> cd ../sb-erp156-qualimat && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT2** (permission `transport.carriers.view`) **et ERP-39** (table `qualimat_carrier` peuplée). **Indépendant de WT3** — peut tourner en parallèle.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. Charge le skill `backend-entity-conventions`.
+
+**Mission** : exposer le référentiel QUALIMAT (table existante `qualimat_carrier`, alimentée par console) en **lecture seule** + endpoint de recherche pour la saisie assistée du nom (RG-4.01). **Ne touche pas** la commande de sync.
+
+**Spec** : `spec-back.md § 4.7` + RG-4.01.
+
+**À livrer** :
+1. Entité `QualimatCarrier` (lecture seule) mappée sur la table existante `qualimat_carrier`. **Aucune écriture exposée** (pas de Post/Patch/Delete). Probablement pas `#[Auditable]` ni Timestampable (référentiel externe synchronisé) — vérifie le mapping existant.
+2. `GET /api/qualimat_carriers?search=` : fuzzy sur `name` (+ `siret`), **seulement `is_active = true`**, tri `name`, **paginé** (règle n°13 — `CollectionsArePaginatedTest`).
+3. **Security** `is_granted('transport.carriers.view')`.
+4. Champs exposés : `id, siret, name, address, postalCode, city, phone, department, status, validityDate, isActive`.
+
+**Tests à écrire** : recherche ne renvoie que les actifs ; pagination Hydra ; 403 sans permission ; tri `name`.
+
+**Scope STRICT** : uniquement l'exposition lecture de `qualimat_carrier`. Ne crée rien autour de `Carrier` (autres worktrees). Si la table n'a pas de COMMENT (référentiel pré-existant), vérifie si elle est dans `EXCLUDED_TABLES` de `ColumnsHaveSqlCommentTest` — ne casse pas ce test.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-156-qualimat-search
+tea pr create --base develop --head feat/erp-156-qualimat-search \
+  --title "feat(transport) : endpoint recherche QualimatCarrier (ERP-156)" \
+  --description "Entité lecture seule + GET /api/qualimat_carriers?search=. Ticket ERP-156."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT6-adresses.md

@@ -0,0 +1,37 @@
+# WT6 — Sous-ressource Adresses (ticket 1.7 / ERP-159)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp159-adresses -b feat/erp-159-carrier-addresses origin/develop
+> cd ../sb-erp159-adresses && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT3** (entités `CarrierAddress`). Parallèle à WT5/WT7/WT8/WT9.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. Charge le skill `backend-entity-conventions`. **Miroir** : `SupplierAddressProcessor.php` (`src/Module/Commercial/Infrastructure/ApiPlatform/State/Processor/`).
+
+**Mission** : opérations d'écriture sur les adresses transporteur.
+
+**Spec** : `spec-back.md § 4.5` + RG-4.05→4.07.
+
+**À livrer** :
+- `POST /api/carriers/{id}/addresses`, `PATCH`/`DELETE /api/carrier_addresses/{id}` (security `manage`) — **resource/processor dédiés à `CarrierAddress`**, ne modifie pas l'ApiResource `Carrier`.
+- **RG-4.06** : `postalCode` matche `^[0-9]{4,5}$` (autocomplete ville = front). Message FR.
+- **RG-4.05** : si affrété → adresse obligatoire (Pays/CP/Ville/Adresse) — validation conditionnelle.
+- RG-4.07 (bouton Valider masqué si QUALIMAT) = front ; côté back, accepter le PATCH normalement.
+
+**Tests à écrire** : CP invalide → 422 ; adresse affrété incomplète → 422 ; PATCH/DELETE OK avec `manage`, 403 sans.
+
+**Scope STRICT** : uniquement `CarrierAddress` (resource + processor + tests). **NE TOUCHE PAS** `CarrierFixtures` (WT10), l'entité `Carrier`, les autres sous-ressources. Messages de validation FR (`EntityConstraintsHaveFrenchMessageTest`).
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-159-carrier-addresses
+tea pr create --base develop --head feat/erp-159-carrier-addresses \
+  --title "feat(transport) : sous-ressource adresses transporteur (ERP-159)" \
+  --description "POST/PATCH/DELETE carrier_address + RG-4.05→4.07. Ticket ERP-159."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT7-contacts.md

@@ -0,0 +1,35 @@
+# WT7 — Sous-ressource Contacts (ticket 1.8 / ERP-160)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp160-contacts -b feat/erp-160-carrier-contacts origin/develop
+> cd ../sb-erp160-contacts && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT3**. Parallèle à WT5/WT6/WT8/WT9.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. Charge le skill `backend-entity-conventions`. **Miroir** : `SupplierContactProcessor.php` (`src/Module/Commercial/…/State/Processor/`).
+
+**Mission** : opérations d'écriture sur les contacts transporteur.
+
+**Spec** : `spec-back.md § 4.5` + RG-4.08.
+
+**À livrer** :
+- `POST /api/carriers/{id}/contacts`, `PATCH`/`DELETE /api/carrier_contacts/{id}` (security `manage`) — resource/processor dédiés à `CarrierContact`.
+- **RG-4.08** : bloc valide si **≥ 1 champ rempli** (CHECK `chk_carrier_contact_filled` côté migration WT3 + validation Processor) ; **max 2 téléphones**.
+
+**Tests à écrire** : contact vide → 422 ; 1 champ → 200/201 ; 3ᵉ téléphone → 422.
+
+**Scope STRICT** : uniquement `CarrierContact`. **NE TOUCHE PAS** `CarrierFixtures` (WT10), `Carrier`, les autres sous-ressources. Messages FR. Si le CHECK `chk_carrier_contact_filled` manque (WT3 ne l'a pas posé), valide côté Processor et signale-le à la conv maître.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-160-carrier-contacts
+tea pr create --base develop --head feat/erp-160-carrier-contacts \
+  --title "feat(transport) : sous-ressource contacts transporteur (ERP-160)" \
+  --description "POST/PATCH/DELETE carrier_contact + RG-4.08 (≥1 champ, max 2 tel). Ticket ERP-160."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT8-prix.md

@@ -0,0 +1,39 @@
+# WT8 — Sous-ressource Prix + RG branches (ticket 1.9 / ERP-161)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp161-prix -b feat/erp-161-carrier-prices origin/develop
+> cd ../sb-erp161-prix && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT3**. Parallèle à WT5/WT6/WT7/WT9.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. Charge le skill `backend-entity-conventions`.
+
+**Mission** : opérations d'écriture sur les prix transporteur, avec branches Client / Fournisseur.
+
+**Spec** : `spec-back.md § 4.5 / 7` + RG-4.09→4.11.
+
+**À livrer** :
+- `POST /api/carriers/{id}/prices`, `PATCH`/`DELETE /api/carrier_prices/{id}` (security `manage`) — resource/processor dédiés à `CarrierPrice`.
+- **RG-4.10 (CLIENT)** : `client`, `clientDeliveryAddress`, `departureSite` requis ; `clientDeliveryAddress` **doit appartenir au `client`** → sinon 422.
+- **RG-4.11 (FOURNISSEUR)** : `supplier`, `supplierSupplyAddress`, `deliverySite` requis ; `supplierSupplyAddress` appartient au `supplier` → sinon 422.
+- Communs obligatoires : `containerType`, `pricingUnit`, `price`, `priceState`. CHECK branches respectés.
+
+**Rappels FK** : « Adresse départ/livraison 86/17/82 » = `Site` (FK). Livraison client = `ClientAddress`, appro = `SupplierAddress` (relations ORM partagées — pas de M2M).
+
+**Tests à écrire** : branche CLIENT/FOURNISSEUR incomplète → 422 ; adresse étrangère au client/supplier → 422 ; prix valide → 201.
+
+**Scope STRICT** : uniquement `CarrierPrice`. **NE TOUCHE PAS** `CarrierFixtures` (WT10), `Carrier`, les autres sous-ressources. Messages FR.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-161-carrier-prices
+tea pr create --base develop --head feat/erp-161-carrier-prices \
+  --title "feat(transport) : sous-ressource prix transporteur (ERP-161)" \
+  --description "POST/PATCH/DELETE carrier_price + RG-4.09→4.11 (branches client/fournisseur). Ticket ERP-161."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/prompts/WT9-export.md

@@ -0,0 +1,36 @@
+# WT9 — Export XLSX (ticket 1.10 / ERP-162)
+
+> ```bash
+> git fetch origin
+> git worktree add ../sb-erp162-export -b feat/erp-162-carrier-export origin/develop
+> cd ../sb-erp162-export && claude
+> ```
+> **Base** : `origin/develop` **après merge de WT3** (lecture Carrier). Parallèle à WT5/WT6/WT7/WT8.
+
+---
+
+## Prompt à coller
+
+Projet Starseed (Symfony 8 / API Platform 4, DDD). Lis `CLAUDE.md`, `.claude/rules/backend.md`. **Miroir** : `src/Module/Commercial/Infrastructure/Controller/SupplierExportController.php` (PhpSpreadsheet déjà présent).
+
+**Mission** : export Excel du répertoire et du tableau Prix regroupé.
+
+**Spec** : `spec-back.md § 4.6`.
+
+**À livrer** :
+- `GET /api/carriers/export.xlsx` : transporteurs affichés (**mêmes filtres** que la liste) ; colonnes § 4.6.
+- `GET /api/carriers/{id}/prices/export.xlsx` : tableau Prix regroupé Benne / Fond Mouvant (colonnes docx p.10).
+- **Controllers custom** avec `#[Route(priority: 1)]` (sinon conflit API Platform `{id}`) ; en-tête `Content-Disposition`.
+
+**Tests à écrire** : 200 + en-tête fichier (Content-Disposition + type XLSX) ; respect des filtres.
+
+**Scope STRICT** : controllers d'export + service de génération. **NE TOUCHE PAS** entités, processors, `CarrierFixtures` (WT10). Réutilise le Provider/filtres de WT3 pour la cohérence des données exportées.
+
+**Fini quand** : `make test` vert + `make php-cs-fixer-allow-risky`. Commit (`--no-verify` si vert), puis **ouvre la PR** :
+```bash
+git push -u origin feat/erp-162-carrier-export
+tea pr create --base develop --head feat/erp-162-carrier-export \
+  --title "feat(transport) : export XLSX répertoire + prix (ERP-162)" \
+  --description "GET /api/carriers/export.xlsx + /carriers/{id}/prices/export.xlsx. Ticket ERP-162."
+```
+Puis labellise via l'API Gitea. Cible **develop**. Aucune mention IA.

docs/specs/M4-transporteurs/spec-front.md

@@ -0,0 +1,354 @@
+---
+# === IDENTITÉ ===
+module: M4
+nom: "Répertoire transporteurs"
+ecran: repertoire-transporteurs
+owner_spec: Matthieu
+backup_spec: Tristan
+version: V0.1
+date_redaction: 2026-06-15
+# Historique :
+#   V0.1 (2026-06-15) — Restitution Markdown du docx « M4-repertoire-transporteurs-V0 »
+#     (validé 27/05/2026) + maquette Figma (node 1132-45376). Précisions techniques (back)
+#     dans spec-back.md. Réutilise le pattern et les composants M1/M2/M3.
+
+# === LIENS ===
+maquette_figma: "https://www.figma.com/design/jRYgT0T9c03VsEbjGhCwwS/Composants---Design-System?node-id=1132-45376&p=f&m=dev"
+regles_metier: [RG-4.01, RG-4.02, RG-4.03, RG-4.04, RG-4.05, RG-4.06, RG-4.07, RG-4.08, RG-4.09, RG-4.10, RG-4.11]
+roles: [Admin, Bureau, Compta, Commerciale, Usine]
+lien_spec_back: ./spec-back.md
+
+# === VALIDATION CLIENT ===
+client_validation_1:
+  statut: validee
+  date: 2026-05-27
+  version: V0
+  valide_par: "Matthieu (CP MALIO)"
+
+# === LIEN LESSTIME ===
+lesstime_project_id: 6
+lesstime_taskgroup_id: 31   # M4 — Répertoire transporteurs (tickets ERP-153 → ERP-171)
+statut_global: pret_a_dev
+---
+
+# Module 4 — Répertoire transporteurs (V0.1 front)
+
+> **Origine** : spec fonctionnelle `M4-repertoire-transporteurs-V0` (validée le 27/05/2026) + maquette Figma. Restitution Markdown pour intégration au workflow MALIO. Toute décision technique (back) vit dans [`spec-back.md`](./spec-back.md). Le M4 réutilise le pattern et les composants posés aux [M1 clients](../M1-clients/spec-front.md), [M2 fournisseurs](../M2-suppliers/spec-front.md) et [M3 prestataires](../M3-prestataires/spec-front.md).
+
+> **Socle déjà en place** : le module back `Transport` existe (ERP-150) et porte deux référentiels **synchronisés par commandes console** : transporteurs **QUALIMAT** (`qualimat_carrier`, ERP-39) et codes **IDTF** (`idtf_product`, ERP-149). Le M4 ajoute le **répertoire éditable** (`Carrier`) **par-dessus** ces référentiels — la saisie assistée du nom interroge le référentiel QUALIMAT (RG-4.01). L'IDTF n'est **pas** utilisé par ces écrans.
+
+> **Décisions Matthieu (15/06/2026)** : (1) lien QUALIMAT = FK + **copie éditable** des champs (nom / certification / adresse) ; (2) **pas de cloisonnement par site** (référentiel global) ; (3) le champ « Décharge » s'appuie sur une **infra d'upload réutilisable** (`Shared`), car d'autres uploads suivront. Détails : [`spec-back.md § 2.5 / § 2.3 / § 2.7`](./spec-back.md).
+
+## But
+
+Lister tous les transporteurs de l'organisation et accéder rapidement à leurs fiches : consultation, création, modification, archivage. Le nom est **relié à QUALIMAT** (saisie assistée) ; les transporteurs hors QUALIMAT (GMP+, OVOCOM, compte-propre, LIOT, autre) sont saisis manuellement.
+
+## Accès
+
+- **Depuis** : menu principal → section **Transport** (route `/carriers`). *(Section « Transport » dédiée ou rattachement à une section « Logistique » — à confirmer, cf. [`spec-back.md § 5.3`](./spec-back.md).)*
+- **Rôles autorisés** (tableau « Rôles & permissions » du docx) :
+
+| Rôle | Consultation | Ajout / Modification | Archive |
+|---|---|---|---|
+| **Admin** | ✅ Tout | ✅ Tout | ✅ |
+| **Bureau** | ✅ Tout | ✅ Tout | ❌ |
+| **Compta** | ❌ | ❌ | ❌ |
+| **Commerciale** | ✅ Tout | ❌ | ❌ |
+| **Usine** | ❌ | ❌ | ❌ |
+
+> **Notes** :
+> - RBAC transposée sur `transport.carriers.*` (cf. [`spec-back.md § 5`](./spec-back.md)). **Commerciale** = consultation seule (pas de « + Ajouter » ni « Modifier »). **Compta** et **Usine** n'ont **aucun** accès au module (item sidebar masqué).
+> - **Pas de cloisonnement par site** (≠ M3) : tout rôle autorisé voit tous les transporteurs.
+
+## Navigation
+
+Page d'entrée du module **Transport** (route `/carriers`). Titre : « **Répertoire transporteurs** ».
+
+- Affichage principal : un **datatable** listant tous les transporteurs **actifs** (les archivés sont masqués par défaut — filtre dédié).
+- **Clic sur une ligne** → écran **Consultation transporteur** (page dédiée).
+- **Bouton « + Ajouter »** (haut droite, si `manage`) → écran **Ajouter un transporteur**.
+- **Bouton « Filtrer »** (haut droite) → panneau de filtres.
+- **Bouton « Exporter »** (haut droite) → télécharge un **XLSX** des transporteurs **affichés** (cf. filtres actifs). Format dans [`spec-back.md § 4.6`](./spec-back.md).
+
+### Panneau de filtres (bouton « Filtrer »)
+
+Réutilise le pattern M1/M2/M3. Filtres branchés sur les query params de `GET /api/carriers` (cf. [`spec-back.md § 4.1`](./spec-back.md)) :
+
+| Filtre | Composant | Query param back |
+|---|---|---|
+| **Recherche** (nom) | `<MalioInputText>` | `?search=` |
+| **Certification** | `<MalioSelectCheckbox>` (QUALIMAT / GMP+ / OVOCOM / Compte-propre / Autre) | `?certificationType=` |
+| **Inclure les archivés** | `<MalioCheckbox>` | `?includeArchived=true` |
+
+- À l'application des filtres → `setFilters(...)` de `usePaginatedList` (retombe en **page 1**).
+- **État 100 % local** (jamais dans l'URL — règle ABSOLUE n°6).
+
+## Datatable du Répertoire
+
+Composant : `<MalioDataTable>` branché sur `usePaginatedList<Carrier>({ url: '/carriers' })` (règle frontend obligatoire — pagination Hydra, état 100 % local). Colonnes :
+
+| Colonne | Source | Tri |
+|---|---|---|
+| **Nom** | `carrier.name` | ASC par défaut |
+| **Certification** | `carrier.certificationType` (libellé i18n) | Non |
+| **Date de validité** | `carrier.qualimatCarrier.validityDate` (format `JJ-MM-AAAA`) — **fond rouge si < aujourd'hui** (RG-4.04) | Non |
+| **Dernière activité** | `carrier.updatedAt` (format `JJ-MM-AAAA`) | Oui |
+
+> **Clic sur une ligne** → écran Consultation. **Pagination** : standard Starseed 10 / 25 / 50 (défaut 10). Tri serveur `name ASC` par défaut.
+
+## Écran « Ajouter un transporteur »
+
+Création par **onglets successifs avec validation incrémentale** : pour passer à l'onglet suivant, il faut avoir validé l'onglet en cours. **Une fois un onglet validé, on passe automatiquement au suivant** ; les champs validés passent en lecture seule. **L'onglet Adresses n'est accessible qu'une fois le formulaire principal validé.** Cf. [`spec-back.md § 2.9`](./spec-back.md) (PATCH partiels par groupe de sérialisation).
+
+**Accès** : bouton « + Ajouter » du Répertoire. **Rôles** : Admin, Bureau.
+
+**Barre d'onglets** : `Qualimat` · `Adresses` · `Contacts` · `Prix`.
+
+### Formulaire principal (pré-onglets)
+
+1er bloc à remplir. Sans validation, les onglets ne sont pas accessibles. Une fois validé → POST `/api/carriers`, puis bascule sur l'onglet Qualimat/Adresses ; les champs passent en readonly.
+
+| Champ | Type composant | Obligatoire | Règle |
+|---|---|---|---|
+| **Nom** (saisie assistée reliée à QUALIMAT) | `<MalioInputText>` (autocomplete) | Oui | RG-4.01 ; RG-4.13 (UPPERCASE serveur) ; RG-4.12 (unicité) |
+| **Liste certification transport** | `<MalioSelect>` (GMP+ / OVOCOM / Compte-propre / Autre) | Oui | RG-4.02 ; auto = `QUALIMAT` (lecture seule) si transporteur QUALIMAT sélectionné |
+| **Affréter** | `<MalioCheckbox>` | Non | RG-4.03 |
+| **Indexation %** | `<MalioInputNumber>` | Conditionnel | RG-4.03 — visible + obligatoire si « Affréter » coché |
+| **Benne / Fond mouvant** | `<MalioRadioButton>` | Conditionnel | RG-4.03 — visible + obligatoire si « Affréter » coché |
+| **Volume m³** | `<MalioInputNumber>` | Conditionnel | RG-4.03 — visible + obligatoire si « Affréter » coché |
+| **Décharge** | `<MalioInputUpload>` *(cf. note)* | Conditionnel (**obligatoire si AUTRE**) | RG-4.02 — visible **et obligatoire** si certification = `AUTRE`. Upload via infra Shared ([`spec-back.md § 2.7`](./spec-back.md)) |
+| **Liste immatriculation LIOT** | `<MalioInputText>` (ou TextArea) | Cas LIOT | RG-4.01 — visible **uniquement** si nom = `LIOT` ; les autres champs disparaissent. Immatriculations séparées par `;` |
+
+> **Comportement RG-4.01 (saisie assistée)** : à la saisie du nom, recherche dans le référentiel QUALIMAT via `GET /api/qualimat_carriers?search=`. Sélection d'un résultat → **modal de confirmation** « Êtes-vous sûr de vouloir intégrer ce transporteur ? ». Si confirmé : le **Nom** et la **certification** (= `QUALIMAT`, lecture seule) se remplissent automatiquement, **ainsi que l'onglet Adresse** (copie pays/CP/ville/voie depuis le référentiel). La FK QUALIMAT est conservée (traçabilité + date de validité RG-4.04).
+> - **Cas transporteur non trouvé** (pas QUALIMAT) : l'utilisateur choisit une autre certification (RG-4.02) → affichage des champs associés.
+> - **Cas LIOT** : si le nom saisi est exactement `LIOT`, seul le champ « Liste immatriculation LIOT » s'affiche, les autres champs sont masqués.
+
+> **Note `<MalioInputUpload>`** : si le composant ne couvre pas le drag & drop / type fichier requis, exception autorisée documentée (`// TODO migrer quand Malio couvre`) — cf. exceptions @.claude/rules/frontend.md.
+
+**Action** : « Valider » (`<MalioButton>`) → POST `/api/carriers` ([`spec-back.md § 4.3`](./spec-back.md)). Succès → onglet « Qualimat » / « Adresses ».
+
+### Onglet « Qualimat »
+
+Sélectionner un transporteur de la liste QUALIMAT afin de mettre à jour les informations du transporteur (saisie assistée — voir RG-4.01).
+
+**Colonnes du tableau de sélection** :
+
+| Colonne | Règle |
+|---|---|
+| **Sélection** (bouton / clic ligne) | RG-4.03 *(docx)* — clic → modal « Êtes-vous sûr de vouloir intégrer ce transporteur ? » → remplit Nom + certification + onglet adresse |
+| **Nom** | — |
+| **Adresse** | — |
+| **Date de validité** | RG-4.04 — **fond rouge si < date du jour** |
+
+> Cet onglet alimente le formulaire principal et l'onglet Adresse par copie (RG-4.01 / RG-4.05). Source : `GET /api/qualimat_carriers?search=` (lecture seule, lignes actives uniquement).
+
+### Onglet « Adresses »
+
+Saisir l'adresse du transporteur (un bloc par adresse).
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Pays** | `<MalioSelect>` (préremplie « France ») | Conditionnel | RG-4.05 |
+| **Code postal** | `<MalioInputText>` (saisie assistée) | Conditionnel | RG-4.06, RG-4.05 — déclenche autocomplete ville (BAN) |
+| **Ville** | `<MalioSelect>` (saisie assistée) | Conditionnel | RG-4.06, RG-4.05 — alimentée par api-adresse.data.gouv.fr |
+| **Adresse** | `<MalioInputText>` (saisie assistée) | Conditionnel | RG-4.05 |
+| **Adresse complémentaire** | `<MalioInputText>` | Non | — |
+
+> **RG-4.05** : les champs sont **déjà remplis** si le transporteur est QUALIMAT (copie). Si « Affréter » est coché, l'adresse devient **obligatoire** (Pays, Code postal, Ville, Adresse).
+> **RG-4.06** : la ville est préremplie automatiquement à partir du code postal via l'API BAN (`useAddressAutocomplete()`, réutilisé M1/M2/M3). Si plusieurs villes → choix dans le select. L'adresse est une saisie assistée basée sur le CP et la ville.
+> **RG-4.07** : le bouton « Valider » **n'apparaît pas** pour un transporteur QUALIMAT (adresse remplie automatiquement).
+
+**Actions** : « Valider » → PATCH `/api/carriers/{id}/addresses` (sauf QUALIMAT, RG-4.07).
+
+### Onglet « Contacts »
+
+Saisir un ou plusieurs contacts associés au transporteur.
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Nom** | `<MalioInputText>` | Non | RG-4.08 + RG-4.13 (Capitalize) |
+| **Prénom** | `<MalioInputText>` | Non | RG-4.08 + RG-4.13 (Capitalize) |
+| **Fonction** | `<MalioInputText>` | Non | RG-4.08 |
+| **Téléphone** (x1, +1 possible, **max 2**) | `<MalioInputText>` | Non | RG-4.08 + RG-4.13 (format) |
+| **Email** | `<MalioInputText>` type email | Non | RG-4.08 + RG-4.13 (lowercase) |
+
+**RG-4.08** : un bloc Contact est valide dès qu'au moins 1 champ est rempli. Impossible d'ajouter un nouveau bloc tant que le précédent n'est pas valide.
+
+**Actions** :
+- « + Nouveau contact » : ajoute un bloc. **Désactivé tant que le bloc précédent n'a aucun champ rempli** (RG-4.08).
+- « Supprimer » (icône) : modal de confirmation, puis suppression du bloc.
+- « Valider » → PATCH `/api/carriers/{id}/contacts`.
+
+### Onglet « Prix »
+
+Saisir un suivi de prix du transporteur (un bloc par prix). Tous les champs sont masqués par défaut sauf le radio « Client / Fournisseur » (RG-4.09).
+
+**Bloc Prix** :
+
+| Champ | Type | Obligatoire | Règle |
+|---|---|---|---|
+| **Client / Fournisseur** | `<MalioRadioButton>` | Oui | RG-4.09 |
+| **Client** | `<MalioSelect>` (liste des clients) | Conditionnel | RG-4.10 — si Client |
+| **Adresse de livraison** | `<MalioSelect>` (adresses du client sélectionné) | Conditionnel | RG-4.10 — si Client |
+| **Adresse de départ** | `<MalioSelect>` (86 / 17 / 82) | Conditionnel | RG-4.10 — si Client ; = un des 3 sites |
+| **Fournisseur** | `<MalioSelect>` (liste des fournisseurs) | Conditionnel | RG-4.11 — si Fournisseur |
+| **Adresse d'approvisionnement** | `<MalioSelect>` (adresses du fournisseur) | Conditionnel | RG-4.11 — si Fournisseur |
+| **Adresse de livraison** | `<MalioSelect>` (86 / 17 / 82) | Conditionnel | RG-4.11 — si Fournisseur ; = un des 3 sites |
+| **Benne / Fond mouvant (FM)** | `<MalioRadioButton>` | Oui | — |
+| **Forfait / Tonne** | `<MalioRadioButton>` | Oui | — |
+| **Prix** | `<MalioInputAmount>` (monnaie) | Oui | — |
+| **État du prix** | `<MalioSelect>` (En cours / Validé / Non validé) | Oui | — |
+
+> **RG-4.10** : si **Client** sélectionné → champs liés au client affichés et obligatoires ; champs fournisseur masqués et non obligatoires.
+> **RG-4.11** : si **Fournisseur** sélectionné → champs liés au fournisseur affichés et obligatoires ; champs client masqués et non obligatoires.
+> **Adresse de départ / livraison « 86 / 17 / 82 »** = les 3 `Site` fixes (cf. switcher de site Châtellerault / Saint-Jean / Pommevic en haut de l'app). La sélection stocke un **ID de Site** ([`spec-back.md § 3.2`](./spec-back.md)).
+
+**Actions** :
+- « + Nouveau prix » : ajoute un bloc. Bloqué tant que le précédent n'est pas valide.
+- « Supprimer » (icône) : modal de confirmation puis suppression.
+- « Valider » → PATCH `/api/carriers/{id}/prices`.
+
+## Écran « Consultation d'un transporteur »
+
+Consulter en **lecture seule** la fiche complète. Affiche en haut du bloc les infos principales du transporteur (comme l'écran d'ajout) ainsi que les onglets Adresses, Contacts, Prix. **Tous les champs sont en lecture seule.**
+
+**Accès** : clic sur une ligne du Répertoire. La page s'ouvre par défaut sur l'onglet **Adresses**. Icône « flèche » à gauche pour revenir au répertoire. Deux boutons à droite :
+- **« Modifier »** (visible si `transport.carriers.manage` → Admin, Bureau).
+- **« Archiver »** (visible **uniquement Admin** via `transport.carriers.archive`) → modal de confirmation, puis PATCH `/api/carriers/{id}` `{ "isArchived": true }`.
+
+> Un transporteur archivé peut être restauré (`isArchived: false`) — bouton « Restaurer » remplace « Archiver » dans la consultation d'un archivé.
+
+### Onglet Adresses (consultation)
+
+Un bloc par adresse du transporteur. Chaque bloc, 5 champs en lecture seule : Pays / Code postal / Ville / Adresse / Adresse complémentaire.
+
+### Onglet Contacts (consultation)
+
+Un bloc par contact. 5 champs en lecture seule : Nom / Prénom / Fonction / Téléphone (x1 ou x2) / Email.
+
+### Onglet Prix (consultation)
+
+Un tableau regroupant les prix par type (**Fond Mouvant / Benne**) :
+
+| Colonne | Description |
+|---|---|
+| **Colonne de regroupement** | « Fond Mouvant » / « Benne » |
+| **Transporteurs** | Nom du transporteur |
+| **Adresse APRO ou Adresse Sites** | Si prix « Client » → Adresse APRO sinon Adresse Sites |
+| **Adresse livraisons** | — |
+| **Forfait €** | Prix |
+| **Tonne €** | Prix |
+| **Indexation** | Pourcentage d'indexation (vide si non rempli) |
+| **État du prix** | Validé / Non Validé / En cours |
+
+**Action** : « Exporter » → exporte le tableau au **format Excel** (`GET /api/carriers/{id}/prices/export.xlsx`).
+
+## Écran « Modification d'un transporteur »
+
+Modifier les informations d'un transporteur existant. **Identique à l'écran « Ajouter un transporteur »** — mêmes formulaires, mêmes règles métier (RG-4.01 à RG-4.11) — sauf :
+- Les champs sont **pré-remplis** avec les valeurs actuelles.
+- **Validation par onglet** : on peut modifier UN onglet sans toucher aux autres (PATCH partiel).
+- **Accès** : depuis l'écran Consultation, bouton « Modifier » (Admin, Bureau).
+
+## Composants UI à utiliser (`@malio/layer-ui`)
+
+- **Datatable** : `<MalioDataTable>` (+ `usePaginatedList`)
+- **Input texte** : `<MalioInputText>`
+- **Input nombre / montant** : `<MalioInputNumber>` (indexation, volume), `<MalioInputAmount>` (prix)
+- **Select simple** : `<MalioSelect>` (certification, pays, ville, client, fournisseur, adresses, sites, état du prix)
+- **Select multi (cases à cocher)** : `<MalioSelectCheckbox>` (filtres certification)
+- **Radio** : `<MalioRadioButton>` (Benne/Fond mouvant, Forfait/Tonne, Client/Fournisseur)
+- **Checkbox** : `<MalioCheckbox>` (Affréter, inclure archivés)
+- **Upload** : `<MalioInputUpload>` (Décharge — exception documentée si type non couvert)
+- **Bouton** : `<MalioButton>`, `<MalioButtonIcon>`
+- **Toasts** : standards via `useApi()`
+- **Validation par champ** : `useFormErrors` (mapping 422 inline — règle frontend obligatoire)
+
+**Exceptions autorisées** (commenter `// TODO migrer quand Malio couvre`) :
+- Modal de confirmation : wrapper partagé dans `frontend/shared/` (réutiliser celui du M1/M2/M3).
+- `<MalioInputUpload>` si le type fichier / drag & drop n'est pas couvert.
+
+## Composables & appels API
+
+- `usePaginatedList<Carrier>({ url: '/carriers' })` — liste paginée (obligatoire). Consomme `name`, `certificationType`, `qualimatCarrier.validityDate` (RG-4.04), `updatedAt` (cf. [`spec-back.md § 2.11 / § 4.0`](./spec-back.md)).
+- `useCarrier(id)` — charge le détail via `GET /api/carriers/{id}`, qui **embarque** `addresses`, `contacts`, `prices` (avec `client`/`supplier`/sites imbriqués) + `qualimatCarrier`. Écrans Consultation et Modification peuplés depuis cette seule réponse. **DoD avant intégration** : vérifier le JSON réel (cf. [`spec-back.md § 4.0.bis`](./spec-back.md)).
+- `useCarrierForm()` — workflow par onglet (POST principal + PATCH partiels par groupe), miroir de `useSupplierForm()`/`useProviderForm()` + gestion des **champs conditionnels** (Affréter, AUTRE→Décharge, cas LIOT).
+- `useQualimatSearch()` — saisie assistée du nom : `GET /api/qualimat_carriers?search=`, modal de confirmation, copie des champs + FK (RG-4.01).
+- `useAddressAutocomplete()` — **réutilisé** du M1/M2/M3 (BAN), pas de réécriture (RG-4.06).
+- `useUpload()` (NOUVEAU, infra Shared) — POST multipart `/api/uploaded_documents` → renvoie l'IRI à poser sur `carrier.dischargeDocument` (RG-4.02).
+- `usePermissions()` — masque l'item sidebar et les boutons selon les permissions.
+- Tous les appels passent par `useApi()` (jamais `$fetch` direct — règle ABSOLUE n°4).
+- Filter `formatPhoneFR()` — **réutilisé** pour l'affichage `XX XX XX XX XX`.
+
+## Règles de formatage et normalisation
+
+Le serveur normalise systématiquement (RG-4.13 — cf. [`spec-back.md`](./spec-back.md)) :
+
+| Champ | Normalisation serveur | Affichage front |
+|---|---|---|
+| Nom transporteur (`name`) | UPPERCASE intégral | UPPERCASE |
+| Nom + Prénom contact | Capitalize | identique |
+| Téléphones (`CarrierContact`) | Chiffres uniquement en BDD | Formaté `XX XX XX XX XX` (filter Vue) |
+| Email | lowercase intégral | identique |
+| Immatriculations LIOT | `;`-split, trim, UPPER | listées |
+
+> Le front **ne normalise pas** : il envoie la valeur saisie, le serveur normalise et renvoie la valeur normalisée que l'UI affiche.
+
+## API adresse postale
+
+Code postal + Ville + Adresse branchés sur **api-adresse.data.gouv.fr** (BAN) via le composable `useAddressAutocomplete()` **déjà créé au M1/M2/M3** (réutilisé tel quel) :
+- À la saisie du CP (5 chiffres) : `GET https://api-adresse.data.gouv.fr/search/?q={cp}&type=municipality` → alimente le select Ville (RG-4.06 : si plusieurs villes, choix dans le select).
+- À la saisie d'adresse : `?q={addr}&postcode={cp}&type=housenumber` → suggestions.
+- Cas dégradé (timeout / offline) : Ville en `<MalioInputText>` libre + toast d'avertissement.
+
+## Différences notables avec les modules précédents
+
+| Zone | M2/M3 | M4 transporteurs |
+|---|---|---|
+| Source du nom | saisie libre | **saisie assistée reliée à QUALIMAT** (référentiel synchronisé) |
+| Onglet Comptabilité / RIB | présent (M2/M3) | **Absent** |
+| Cloisonnement par site | M3 : oui | **Non** (référentiel global) |
+| Champs conditionnels formulaire principal | peu | **Nombreux** (Affréter, AUTRE→Décharge, cas LIOT) |
+| Onglet Prix | absent | **Présent** (Client/Fournisseur, sites départ/livraison) |
+| Upload de fichier | aucun | **Décharge** (infra upload Shared, réutilisable) |
+| Module | Commercial / Technique | **Transport** (existant, ERP-150) |
+
+## Points résolus côté back
+
+| # | Zone d'ombre | Résolution (cf. `spec-back.md`) |
+|---|---|---|
+| 1 | Lien QUALIMAT | FK `qualimatCarrier` + **copie éditable** des champs (§ 2.5) |
+| 2 | Cas LIOT | Champ `liotPlates` (`;`-séparé), autres champs masqués (RG-4.01) |
+| 3 | Certification QUALIMAT | Valeur `QUALIMAT` lecture seule si lié (§ 2.5) |
+| 4 | Décharge (upload) | Infra upload générique `Shared` réutilisable (§ 2.7) |
+| 5 | Onglet Prix — branches | M2M absentes : FK Client/Supplier + adresses + sites (RG-4.10/4.11, § 3.2) |
+| 6 | Adresse de départ/livraison 86/17/82 | = les 3 `Site` fixes (FK Site) |
+| 7 | Workflow par onglet | Sauvegarde incrémentale (POST principal + PATCH partiels) — pas d'état « draft » |
+| 8 | Archive vs delete | Flag `is_archived` séparé ; archivage Admin seul ; soft delete = HP |
+| 9 | Unicité métier | Nom seul (§ 2.6) |
+| 10 | Référentiel QUALIMAT | Endpoint lecture seule `GET /api/qualimat_carriers?search=` (§ 4.7) |
+| 11 | Format export | XLSX (répertoire + onglet Prix regroupé Benne/FM) |
+| 12 | RBAC | `transport.carriers.view/manage/archive` ; Compta + Usine sans accès (§ 5.2) |
+
+---
+
+## 📦 Tickets Lesstime
+
+**TaskGroup Lesstime** : à créer — `M4 — Répertoire transporteurs` (projet `ERP / Starseed`, projectId=6). Découpe détaillée (back en tête) → [`spec-back.md § Tickets Lesstime`](./spec-back.md#-tickets-lesstime-à-découper).
+
+| Ordre | Sujet | Tag |
+|---|---|---|
+| 0 | Permissions `transport.carriers.*` + sidebar + 3 sources RBAC | Backend |
+| 1 | Infra upload générique `Shared` (uploaded_document + FileUploader + endpoint) | Backend |
+| 2 | Migration BDD M4 (carrier + sous-collections + index + COMMENT) | Backend |
+| 3 | Entité `QualimatCarrier` (lecture seule) + endpoint recherche | Backend |
+| 4 | Entités + Repositories Carrier* | Backend |
+| 5 | CarrierProvider + CarrierProcessor (champs conditionnels, archive, LIOT) | Backend |
+| 6 | Sous-ressources Adresses / Contacts / Prix (RG-4.10/4.11) | Backend |
+| 7 | Export XLSX (répertoire + onglet Prix) | Backend |
+| 8 | Tests PHPUnit RG-4.01→4.14 + capture contrat JSON | Backend |
+| 9 | Page Répertoire (`/carriers`) + usePaginatedList | Frontend |
+| 10 | Page Ajouter + formulaire principal + saisie assistée QUALIMAT | Frontend |
+| 11 | Onglets Adresses (BAN) / Contacts / Prix | Frontend |
+| 12 | Pages Consultation + Modification | Frontend |
+| 13 | i18n + libellés audit + upload front (useUpload) | Frontend |

docs/specs/M4-transporteurs/tickets-lesstime.md

@@ -0,0 +1,307 @@
+# M4 — Répertoire transporteurs · Découpe en tickets Lesstime
+
+> **Statut** : ✅ **poussé dans Lesstime** — TaskGroup **#31 « M4 — Répertoire transporteurs »** (projet STARSEED), 19 tickets **ERP-153 → ERP-171** au statut **Prêt à dev**.
+> **Assignation** : tickets **Backend (1.1→1.11, ERP-153→163) → Matthieu** · tickets **Frontend (1.12→1.19, ERP-164→171) → Tristan**.
+>
+> | Pos | Ticket | Réf |
+> |---|---|---|
+> | 1.1 | Permissions transport.carriers.* + sidebar | ERP-153 |
+> | 1.2 | Infra upload générique Shared | ERP-154 |
+> | 1.3 | Migration BDD M4 | ERP-155 |
+> | 1.4 | QualimatCarrier + endpoint recherche | ERP-156 |
+> | 1.5 | Entités Carrier* + ApiResource + Provider | ERP-157 |
+> | 1.6 | CarrierProcessor (RG-4.01/02/03 + LIOT) | ERP-158 |
+> | 1.7 | Sous-ressource Adresses | ERP-159 |
+> | 1.8 | Sous-ressource Contacts | ERP-160 |
+> | 1.9 | Sous-ressource Prix + branches | ERP-161 |
+> | 1.10 | Export XLSX | ERP-162 |
+> | 1.11 | Tests PHPUnit + contrat JSON | ERP-163 |
+> | 1.12 | Page Répertoire /carriers | ERP-164 |
+> | 1.13 | Page Ajouter (layout + formulaire) | ERP-165 |
+> | 1.14 | Saisie assistée QUALIMAT + conditionnels | ERP-166 |
+> | 1.15 | Onglet Adresses (BAN) | ERP-167 |
+> | 1.16 | Onglet Contacts | ERP-168 |
+> | 1.17 | Onglet Prix | ERP-169 |
+> | 1.18 | Consultation + Modification | ERP-170 |
+> | 1.19 | Upload front + i18n + audit | ERP-171 |
+> **Specs sources** : [`spec-back.md`](./spec-back.md) · [`spec-front.md`](./spec-front.md) — validées (docx V0 du 27/05/2026).
+> **Maquette Figma** : node `1132-45376` ([lien](https://www.figma.com/design/jRYgT0T9c03VsEbjGhCwwS/Composants---Design-System?node-id=1132-45376&p=f&m=dev)).
+
+## ⚠️ Dépendance amont (socle Tristan — en cours de merge)
+
+Le M4 s'appuie sur le module `Transport` et le référentiel QUALIMAT, livrés par les PR de Tristan **en cours de merge** dans `develop` :
+
+- **ERP-150** (PR #97) — module `Transport` (`TransportModule`, layer front, `config/modules.php`). **Requis** par tout le M4.
+- **ERP-39** (PR #99) — sync QUALIMAT (`qualimat_carrier` + commande `app:qualimat:sync`). **Requis** par la saisie assistée (ticket 1.4).
+- **ERP-149** (PR #101) — sync IDTF (`idtf_product`). **NON requis** par le M4 (référentiel autonome, hors écrans transporteurs).
+
+> Les 3 PR sont **empilées** (`develop → ERP-150 → ERP-39 → ERP-149`). Démarrer le M4 une fois **ERP-150 + ERP-39 dans `develop`** (DoR des tickets 1.1 et 1.4). Brancher le M4 sur `develop` post-merge.
+
+## Vue d'ensemble (ordre d'exécution)
+
+| # | Ticket | Tag | Effort | RG / dépend |
+|---|---|---|---|---|
+| 1.1 | Déclarer permissions `transport.carriers.*` + sidebar | Backend | S | DoR : ERP-150 mergé |
+| 1.2 | Créer l'infra d'upload générique `Shared` | Backend | M | § 2.7 |
+| 1.3 | Migrer le schéma BDD M4 (carrier + sous-tables) | Backend | M | § 3.2 |
+| 1.4 | Exposer `QualimatCarrier` (lecture seule) + endpoint recherche | Backend | S | RG-4.01 · DoR : ERP-39 mergé |
+| 1.5 | Créer entités `Carrier*` + repos + `ApiResource` + `CarrierProvider` | Backend | M | § 3.3 / 4.0 |
+| 1.6 | Implémenter `CarrierProcessor` (RG-4.01/4.02/4.03 + LIOT + normalisation + archive) | Backend | M | RG-4.01→4.03, 4.13, 4.14 |
+| 1.7 | Sous-ressource Adresses (`carrier_address`) | Backend | S | RG-4.05→4.07 |
+| 1.8 | Sous-ressource Contacts (`carrier_contact`) | Backend | S | RG-4.08 |
+| 1.9 | Sous-ressource Prix (`carrier_price`) + RG branches | Backend | M | RG-4.09→4.11 |
+| 1.10 | Export XLSX (répertoire + onglet Prix regroupé) | Backend | M | § 4.6 |
+| 1.11 | Tests PHPUnit RG-4.01→4.14 + capture contrat JSON (DoD) | Backend | M | § 4.0.bis / 8.1 |
+| 1.12 | Page Répertoire `/carriers` (datatable, filtres, export) | Frontend | M | RG-4.04 |
+| 1.13 | Page Ajouter `/carriers/new` (layout, onglets, formulaire principal POST) | Frontend | M | RG-4.12 |
+| 1.14 | Saisie assistée QUALIMAT + champs conditionnels (Affréter / AUTRE→Décharge / LIOT) | Frontend | M | RG-4.01→4.03 |
+| 1.15 | Onglet Adresses (autocomplete BAN) | Frontend | M | RG-4.05→4.07 |
+| 1.16 | Onglet Contacts | Frontend | S | RG-4.08 |
+| 1.17 | Onglet Prix (Client/Fournisseur, sites) | Frontend | M | RG-4.09→4.11 |
+| 1.18 | Pages Consultation + Modification | Frontend | M | — |
+| 1.19 | Upload front (`useUpload`) + i18n + libellés audit | Frontend | S | § 2.8 |
+
+**Total** : 19 tickets · ~11 back / 8 front · mini-MR de 1 à 4h.
+
+---
+
+## Tickets — détail
+
+### 1.1 — Déclarer permissions `transport.carriers.*` + sidebar
+**Position** : 1.1 • Suit : — • Précède : Migrer le schéma BDD M4
+**Tag** : Backend • **Effort** : S
+**Contexte** : `TransportModule::permissions()` renvoie aujourd'hui `[]`. Ce ticket pose le socle RBAC du module et son entrée de menu, prérequis de toute opération sécurisée.
+**Spec liée** : [`spec-back.md § 5`](./spec-back.md) · [`spec-front.md § Accès`](./spec-front.md)
+**Critères d'acceptation** :
+- [ ] `TransportModule::permissions()` déclare `transport.carriers.view`, `transport.carriers.manage`, `transport.carriers.archive` ; `app:sync-permissions` les enregistre.
+- [ ] **Matrice § 5.2** : Admin (view+manage+archive), Bureau (view+manage), Commerciale (view), Compta + Usine (aucune).
+- [ ] **3 sources RBAC alignées dans le même commit** (règle ABSOLUE n°8) : `config/sidebar.php` (section Transport + item `/carriers` + permission), `personas.ts`, `SeedE2ECommand.php`.
+- [ ] Item sidebar masqué pour Compta/Usine ; visible Admin/Bureau/Commerciale.
+**Tests à prévoir** : permissions sync OK ; personas e2e cohérents (pas de drift).
+**Tips** : DoR — ERP-150 mergé (module Transport présent). Section sidebar « Transport » (ou « Logistique » — à trancher, cosmétique).
+
+### 1.2 — Créer l'infra d'upload générique `Shared`
+**Position** : 1.2 • Suit : permissions • Précède : Migration M4
+**Tag** : Backend • **Effort** : M
+**Contexte** : la « Décharge » (RG-4.02) est le 1er d'une série d'uploads à venir. On pose une infra réutilisable, pas un upload ad hoc.
+**Spec liée** : [`spec-back.md § 2.7`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] Table `uploaded_document` (`original_filename`, `stored_path`, `mime_type`, `size_bytes`, `checksum`, `created_at`, `created_by`) + COMMENT ON COLUMN.
+- [ ] Service `Shared\Infrastructure\Upload\FileUploader` : validation MIME **server-side via `$file->getMimeType()`** (jamais `getClientMimeType()`), bornage taille, checksum sha256, écriture disque (`var/uploads/{yyyy}/{mm}/`).
+- [ ] Endpoint `POST /api/uploaded_documents` (multipart) → renvoie l'IRI ; whitelist MIME explicite (PDF + images) ; hors whitelist → 422.
+**Tests à prévoir** : PHPUnit — MIME hors whitelist → 422 ; MIME valide → IRI + ligne persistée ; checksum calculé.
+**Tips** : générique et réutilisable (autres modules la consommeront). Antivirus / S3 / purge = HP (§ 9).
+
+### 1.3 — Migrer le schéma BDD M4 (carrier + sous-tables)
+**Position** : 1.3 • Suit : infra upload • Précède : QualimatCarrier
+**Tag** : Backend • **Effort** : M
+**Contexte** : créer le schéma du répertoire (entité éditable distincte du référentiel `qualimat_carrier`).
+**Spec liée** : [`spec-back.md § 3.2`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] Migration namespace racine `DoctrineMigrations`, **postérieure** à `Version20260612160000`.
+- [ ] Tables `carrier`, `carrier_address`, `carrier_contact`, `carrier_price` + FK (`qualimat_carrier`, `uploaded_document`, `client`, `client_address`, `supplier`, `supplier_address`, `site`, `user`).
+- [ ] `certification_type` **nullable** (null seulement en cas LIOT) + CHECK enum ; CHECK `container_type`, `direction`, `pricing_unit`, `price_state`, branches Prix client/fournisseur.
+- [ ] Index partiel `uq_carrier_name_active` (LOWER(name), WHERE non archivé & non supprimé).
+- [ ] **`COMMENT ON COLUMN` sur TOUTES les colonnes** (règle n°12) + helper Timestampable/Blamable. `ColumnsHaveSqlCommentTest` vert.
+- [ ] `make db-reset` passe ; schéma conforme.
+**Tests à prévoir** : `make db-reset` OK ; `ColumnsHaveSqlCommentTest` vert ; index partiel présent.
+**Tips** : PK `BIGINT` (cohérence module Transport) — à confirmer vs `INT`.
+
+### 1.4 — Exposer `QualimatCarrier` (lecture seule) + endpoint recherche
+**Position** : 1.4 • Suit : migration • Précède : entités Carrier*
+**Tag** : Backend • **Effort** : S
+**Contexte** : la saisie assistée du nom (RG-4.01) a besoin d'un endpoint de recherche sur le référentiel QUALIMAT, aujourd'hui alimenté en console mais non exposé.
+**Spec liée** : [`spec-back.md § 4.7`](./spec-back.md) · RG-4.01
+**Critères d'acceptation** :
+- [ ] Entité `QualimatCarrier` (lecture seule) mappée sur la table existante `qualimat_carrier` (aucune écriture exposée).
+- [ ] `GET /api/qualimat_carriers?search=` : fuzzy sur `name` (+ `siret`), **seulement `is_active = true`**, tri `name`, paginé (règle n°13).
+- [ ] **Security** `is_granted('transport.carriers.view')`. Champs exposés : `id, siret, name, address, postalCode, city, phone, department, status, validityDate, isActive`.
+**Tests à prévoir** : PHPUnit — recherche ne renvoie que les actifs ; pagination Hydra ; 403 sans permission.
+**Tips** : DoR — ERP-39 mergé. Ne pas toucher la commande de sync.
+
+### 1.5 — Créer entités `Carrier*` + repos + `ApiResource` + `CarrierProvider`
+**Position** : 1.5 • Suit : QualimatCarrier • Précède : CarrierProcessor
+**Tag** : Backend • **Effort** : M
+**Contexte** : poser les entités, le contrat de sérialisation (groupes) et la lecture (liste + détail).
+**Spec liée** : [`spec-back.md § 3.3 / 3.4 / 4.0 / 4.1 / 4.2`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] Entités `Carrier`, `CarrierAddress`, `CarrierContact`, `CarrierPrice` (`#[Auditable]`, `TimestampableBlamableTrait`), repos Doctrine.
+- [ ] `ApiResource` Carrier : `GetCollection` + `Get` + `Post` + `Patch` avec `security` (§ 3.3) ; **pas de Delete**.
+- [ ] Groupes de sérialisation : `carrier:read`, `carrier:item:read`, `qualimat:read`, embed `client:read`/`client_address:read`/`supplier:read`/`supplier_address:read`/`site:read` au détail (3 maillons § 4.0 — ⚠ les adresses de l'onglet Prix sont des entités `ClientAddress`/`SupplierAddress` distinctes).
+- [ ] `CarrierProvider` paginé (`ApiPlatform\Doctrine\Orm\Paginator`) ; liste **sans cloisonnement site** (§ 2.3) ; anti-N+1 (§ 2.11).
+- [ ] Piège booléen `isArchived` : `#[SerializedName('isArchived')]` sur le getter.
+**Tests à prévoir** : liste exclut archivés par défaut ; `?includeArchived=true` ; enveloppe Hydra ; `isArchived` présent dans le JSON.
+**Tips** : miroir `Supplier`/`Provider`. Pas d'onglet Comptabilité (≠ M2/M3).
+
+### 1.6 — Implémenter `CarrierProcessor`
+**Position** : 1.6 • Suit : entités • Précède : sous-ressource Adresses
+**Tag** : Backend • **Effort** : M
+**Contexte** : logique d'écriture du formulaire principal (POST/PATCH) : normalisation, champs conditionnels, archivage.
+**Spec liée** : [`spec-back.md § 4.3 / 4.4 / 7`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] **RG-4.01** : POST avec `qualimatCarrier` → `certificationType=QUALIMAT` + FK persistée ; cas LIOT : `name='LIOT'` ⇒ `certificationType` non requis, `liotPlates` accepté.
+- [ ] **RG-4.02** : `certificationType='AUTRE'` sans `dischargeDocument` → **422** (`#[Assert\Callback]`).
+- [ ] **RG-4.03** : `isChartered=true` sans `indexationRate`/`containerType`/`volumeM3` → **422**.
+- [ ] **RG-4.13** : normalisation (`name` UPPER, contacts Capitalize, phones digits, email lower, `liotPlates`).
+- [ ] **RG-4.12** : doublon `name` (actifs) → **409**.
+- [ ] **RG-4.14** : PATCH `isArchived` exige `transport.carriers.archive` (Admin) ; mode strict (403 sinon).
+**Tests à prévoir** : PHPUnit sur chaque RG ci-dessus (cf. § 8.1).
+**Tips** : `CarrierFieldNormalizer` miroir `SupplierFieldNormalizer`.
+
+### 1.7 — Sous-ressource Adresses (`carrier_address`)
+**Position** : 1.7 • Suit : CarrierProcessor • Précède : Contacts
+**Tag** : Backend • **Effort** : S
+**Spec liée** : [`spec-back.md § 4.5`](./spec-back.md) · RG-4.05→4.07
+**Critères d'acceptation** :
+- [ ] `POST /api/carriers/{id}/addresses`, `PATCH`/`DELETE /api/carrier_addresses/{id}` (security `manage`).
+- [ ] **RG-4.06** : `postalCode` matche `^[0-9]{4,5}$` (autocomplete ville = front).
+- [ ] **RG-4.05** : si affrété, adresse obligatoire (Pays/CP/Ville/Adresse) — validation conditionnelle.
+**Tests à prévoir** : PHPUnit — CP invalide → 422 ; adresse affrété incomplète → 422.
+**Tips** : RG-4.07 (bouton Valider masqué si QUALIMAT) = front, back accepte le PATCH.
+
+### 1.8 — Sous-ressource Contacts (`carrier_contact`)
+**Position** : 1.8 • Suit : Adresses • Précède : Prix
+**Tag** : Backend • **Effort** : S
+**Spec liée** : [`spec-back.md § 4.5`](./spec-back.md) · RG-4.08
+**Critères d'acceptation** :
+- [ ] `POST /api/carriers/{id}/contacts`, `PATCH`/`DELETE /api/carrier_contacts/{id}` (security `manage`).
+- [ ] **RG-4.08** : bloc valide si ≥ 1 champ rempli (CHECK `chk_carrier_contact_filled` + Processor) ; **max 2 téléphones**.
+**Tests à prévoir** : PHPUnit — contact vide → 422 ; 1 champ → 200.
+**Tips** : miroir contacts M2/M3.
+
+### 1.9 — Sous-ressource Prix (`carrier_price`) + RG branches
+**Position** : 1.9 • Suit : Contacts • Précède : Export
+**Tag** : Backend • **Effort** : M
+**Spec liée** : [`spec-back.md § 4.5 / 7`](./spec-back.md) · RG-4.09→4.11
+**Critères d'acceptation** :
+- [ ] `POST /api/carriers/{id}/prices`, `PATCH`/`DELETE /api/carrier_prices/{id}` (security `manage`).
+- [ ] **RG-4.10** (CLIENT) : `client`, `clientDeliveryAddress`, `departureSite` requis ; `clientDeliveryAddress` doit appartenir au `client` → sinon 422.
+- [ ] **RG-4.11** (FOURNISSEUR) : `supplier`, `supplierSupplyAddress`, `deliverySite` requis ; `supplierSupplyAddress` appartient au `supplier` → sinon 422.
+- [ ] Communs obligatoires : `containerType`, `pricingUnit`, `price`, `priceState` ; CHECK branches respectées.
+**Tests à prévoir** : PHPUnit — branche CLIENT/FOURNISSEUR incomplète → 422 ; adresse étrangère → 422.
+**Tips** : « Adresse départ/livraison 86/17/82 » = `Site` (FK) ; livraison client = `ClientAddress`, appro = `SupplierAddress` (relations ORM partagées).
+
+### 1.10 — Export XLSX (répertoire + onglet Prix regroupé)
+**Position** : 1.10 • Suit : Prix • Précède : Tests PHPUnit
+**Tag** : Backend • **Effort** : M
+**Spec liée** : [`spec-back.md § 4.6`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] `GET /api/carriers/export.xlsx` : transporteurs affichés (mêmes filtres) ; colonnes § 4.6.
+- [ ] `GET /api/carriers/{id}/prices/export.xlsx` : tableau Prix regroupé Benne / Fond Mouvant (colonnes docx p.10).
+- [ ] Controllers custom `#[Route(priority: 1)]` (conflit API Platform `{id}`) ; `Content-Disposition`.
+**Tests à prévoir** : PHPUnit — 200 + en-tête fichier ; respect des filtres.
+**Tips** : PhpSpreadsheet déjà présent.
+
+### 1.11 — Tests PHPUnit RG-4.01→4.14 + capture contrat JSON (DoD)
+**Position** : 1.11 • Suit : Export • Précède : Page Répertoire
+**Tag** : Backend • **Effort** : M
+**Spec liée** : [`spec-back.md § 4.0.bis / 8.1`](./spec-back.md)
+**Critères d'acceptation** :
+- [ ] Matrice RG-4.01→4.14 couverte (§ 8.1) + RBAC par rôle (Compta/Usine → 403).
+- [ ] `CarrierSerializationContractTest` : capture JSON réel **liste + détail** ; `prices[].client`/`.supplier`/sites **embarqués** (pas IRI) ; `qualimatCarrier` embarqué ; `isArchived` présent.
+- [ ] Anti-N+1 liste ; pagination Hydra ; audit (`entity_type='Carrier'`) ; `AuditableEntitiesHaveI18nLabelTest` vert.
+- [ ] `CarrierFixtures` idempotent (§ 8.4) : transporteur QUALIMAT (validité passée), AUTRE+décharge, affrété, LIOT, complet (contacts/adresses/prix CLIENT+FOURNISSEUR), 1 archivé.
+**Tests à prévoir** : suite complète `make test` verte.
+**Tips** : coller les JSON capturés dans § 4.0.bis (DoD avant front).
+
+### 1.12 — Page Répertoire `/carriers` (datatable, filtres, export)
+**Position** : 1.12 • Suit : Tests back • Précède : Page Ajouter
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Datatable / Filtres`](./spec-front.md) · Figma `1132-45377`
+**Critères d'acceptation** :
+- [ ] `<MalioDataTable>` + `usePaginatedList<Carrier>({url:'/carriers'})` ; colonnes Nom / Certification / Date de validité / Dernière activité.
+- [ ] **RG-4.04** : date de validité QUALIMAT < aujourd'hui → **fond rouge**.
+- [ ] Filtres (`search`, `certificationType`, `includeArchived`) → `setFilters` (page 1) ; **état 100 % local** (règle n°6).
+- [ ] Boutons « + Ajouter » (si `manage`) / « Filtrer » / « Exporter » (XLSX) ; clic ligne → Consultation.
+**Tests à prévoir** : Vitest — `usePaginatedList` (Hydra, exclusion archivés).
+**Tips** : `useApi()` obligatoire ; pas de persistance URL.
+
+### 1.13 — Page Ajouter `/carriers/new` (layout, onglets, formulaire principal POST)
+**Position** : 1.13 • Suit : Répertoire • Précède : Saisie assistée QUALIMAT
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Écran Ajouter / Formulaire principal`](./spec-front.md) · Figma node `1132-45382` (Ajouter – Qualimat)
+**Critères d'acceptation** :
+- [ ] Layout + barre d'onglets `Qualimat · Adresses · Contacts · Prix` ; validation incrémentale (onglet suivant accessible après validation).
+- [ ] Formulaire principal (Nom, Liste certification, Affréter, …) → `POST /api/carriers` ; succès → bascule onglet + champs readonly.
+- [ ] `useFormErrors` : mapping 422 inline par champ ; `{ toast:false }`.
+**Tests à prévoir** : Vitest — `useCarrierForm` (workflow par onglet, POST principal).
+**Tips** : miroir `useSupplierForm`/`useProviderForm`.
+
+### 1.14 — Saisie assistée QUALIMAT + champs conditionnels
+**Position** : 1.14 • Suit : Page Ajouter • Précède : Onglet Adresses
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Formulaire principal / Onglet Qualimat`](./spec-front.md) · RG-4.01→4.03 · Figma nodes `1132-50717` (Affréter), `1132-50982` (AUTRE→Décharge), `1132-45593` (LIOT)
+**Critères d'acceptation** :
+- [ ] **RG-4.01** : saisie du nom → `GET /api/qualimat_carriers?search=` → modal « Êtes-vous sûr… » → copie Nom + certification (`QUALIMAT`, readonly) + adresse + FK conservée.
+- [ ] **Cas LIOT** : nom `LIOT` → champ immatriculations seul, autres masqués.
+- [ ] **RG-4.02** : certification `AUTRE` → champ Décharge visible **et obligatoire** (upload).
+- [ ] **RG-4.03** : « Affréter » coché → indexation / benne-fond mouvant / volume visibles et obligatoires.
+**Tests à prévoir** : Vitest — affichage conditionnel (Affréter, AUTRE, LIOT) ; copie QUALIMAT.
+**Tips** : `useQualimatSearch()` ; `useUpload()` (ticket 1.19) pour la décharge.
+
+### 1.15 — Onglet Adresses (autocomplete BAN)
+**Position** : 1.15 • Suit : Saisie QUALIMAT • Précède : Onglet Contacts
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Onglet Adresses`](./spec-front.md) · RG-4.05→4.07 · Figma node `1132-45670`
+**Critères d'acceptation** :
+- [ ] Bloc adresse (Pays/CP/Ville/Adresse/complément) → `PATCH /api/carriers/{id}/addresses`.
+- [ ] **RG-4.06** : `useAddressAutocomplete()` (BAN) — ville auto depuis CP, dégradé texte libre.
+- [ ] **RG-4.05** : champs préremplis si QUALIMAT ; obligatoires si affrété. **RG-4.07** : pas de bouton Valider si QUALIMAT.
+**Tests à prévoir** : Vitest — autocomplete nominal + dégradé (réutilisation M1/M2/M3).
+**Tips** : ne pas réécrire `useAddressAutocomplete()`.
+
+### 1.16 — Onglet Contacts
+**Position** : 1.16 • Suit : Adresses • Précède : Onglet Prix
+**Tag** : Frontend • **Effort** : S
+**Spec liée** : [`spec-front.md § Onglet Contacts`](./spec-front.md) · RG-4.08 · Figma node `1132-45756`
+**Critères d'acceptation** :
+- [ ] Blocs contact (Nom/Prénom/Fonction/Téléphone x1-2/Email) → `PATCH /api/carriers/{id}/contacts`.
+- [ ] **RG-4.08** : « + Nouveau contact » bloqué tant que le bloc courant est vide ; suppression avec modal.
+**Tests à prévoir** : Vitest — règle « ≥ 1 champ », max 2 téléphones.
+**Tips** : `mapViolationsToRecord` par ligne (pattern collections M1/M2/M3).
+
+### 1.17 — Onglet Prix (Client/Fournisseur, sites)
+**Position** : 1.17 • Suit : Contacts • Précède : Consultation/Modification
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Onglet Prix`](./spec-front.md) · RG-4.09→4.11 · Figma node `1132-45859`
+**Critères d'acceptation** :
+- [ ] Radio `direction` (Client/Fournisseur) → bascule des champs (**RG-4.09**).
+- [ ] **RG-4.10** (Client) : Client + Adresse de livraison (du client) + Adresse de départ (86/17/82).
+- [ ] **RG-4.11** (Fournisseur) : Fournisseur + Adresse d'approvisionnement + Adresse de livraison (86/17/82).
+- [ ] Communs : Benne/FM, Forfait/Tonne, Prix (`MalioInputAmount`), État du prix → `PATCH /api/carriers/{id}/prices`.
+**Tests à prévoir** : Vitest — bascule Client/Fournisseur, champs requis.
+**Tips** : selects clients/fournisseurs/sites via endpoints existants (security élargie § 4.8).
+
+### 1.18 — Pages Consultation + Modification
+**Position** : 1.18 • Suit : Onglet Prix • Précède : Upload/i18n
+**Tag** : Frontend • **Effort** : M
+**Spec liée** : [`spec-front.md § Consultation / Modification`](./spec-front.md)
+**Critères d'acceptation** :
+- [ ] Consultation readonly (ouvre sur Adresses) ; flèche retour ; « Modifier » (si `manage`) ; « Archiver » (Admin) → PATCH `isArchived`.
+- [ ] Onglet Prix consultation = tableau regroupé Benne/FM + bouton Exporter (XLSX).
+- [ ] Modification = mêmes formulaires, champs pré-remplis, PATCH partiel par onglet.
+**Tests à prévoir** : Vitest — `useCarrier(id)` peuple les écrans depuis une seule réponse ; visibilité boutons par permission.
+**Tips** : « Restaurer » remplace « Archiver » sur un archivé.
+
+### 1.19 — Upload front (`useUpload`) + i18n + libellés audit
+**Position** : 1.19 • Suit : Consultation/Modification • Précède : —
+**Tag** : Frontend • **Effort** : S
+**Spec liée** : [`spec-back.md § 2.7 / 2.8`](./spec-back.md) · [`spec-front.md § Composables`](./spec-front.md)
+**Critères d'acceptation** :
+- [ ] Composable `useUpload()` : `POST /api/uploaded_documents` (multipart) → IRI posée sur `carrier.dischargeDocument` (RG-4.02).
+- [ ] Clés i18n : libellés certification, sidebar (`sidebar.transport.*`), **libellés audit** `audit.entity.transport_carrier/carrieraddress/carriercontact/carrierprice`.
+- [ ] `<MalioInputUpload>` (exception documentée si type non couvert).
+**Tests à prévoir** : Vitest — `useUpload` (succès + erreur MIME).
+**Tips** : `AuditableEntitiesHaveI18nLabelTest` exige les clés audit.
+
+---
+
+## Actions Lesstime (à exécuter au feu vert de Matthieu)
+
+1. `create-group` projectId 6, title « M4 — Répertoire transporteurs » → récupérer l'`id`.
+2. `create-task` ×19 (statut `Prêt à dev` = 6, priorité Moyen=2, effort dans la description), dans l'ordre 1.1 → 1.19 :
+   - Tickets **1.1 → 1.11** (Backend, tag `3`) → **assigné à Matthieu**.
+   - Tickets **1.12 → 1.19** (Frontend, tag `2`) → **assigné à Tristan**.
+3. Mettre à jour le frontmatter des specs (`lesstime_taskgroup_id`) + lien du groupe.
+
+> Au push : récupérer les `userId` via `list-users` (Matthieu = `5` selon le référentiel ; Tristan à confirmer) pour renseigner l'assignation à la création.

docs/specs/M5-tickets-pesee/prompts/ERP-181-module-logistique.md

@@ -0,0 +1,38 @@
+# Prompt d'implémentation — M5 · ERP-181 (1.1) — Scaffolder le module Logistique + RBAC
+
+Projet **Starseed** (modular monolith DDD). Tâche **back**. Lis d'abord `CLAUDE.md` + `.claude/rules/architecture.md` + `.claude/rules/backend.md`, puis la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 2.1, § 5).
+
+## Mission
+Créer le **nouveau module `Logistique`** et poser son socle RBAC, **avant toute entité**. Aucun écran fonctionnel ici, juste le squelette + permissions + sidebar + 3 miroirs RBAC.
+
+## Étapes
+1. Scaffolder via le skill projet **`create-module`** : `src/Module/Logistique/` avec `Domain/ Application/ Infrastructure/` et `LogistiqueModule.php` :
+   - `const string ID = 'logistique'` ; `const string LABEL = 'Logistique'` ; `const bool REQUIRED = false`.
+   - `permissions()` retourne :
+     - `['code' => 'logistique.weighing_tickets.view',   'label' => 'Voir les tickets de pesée']`
+     - `['code' => 'logistique.weighing_tickets.manage', 'label' => 'Créer / modifier les tickets de pesée']`
+2. Enregistrer `LogistiqueModule::class` dans `config/modules.php`.
+3. Créer le layer front minimal `frontend/modules/logistique/nuxt.config.ts` (kebab-case, auto-détecté).
+4. Ajouter à `config/sidebar.php` une section/item « Logistique » :
+   ```php
+   ['label' => 'sidebar.logistique.weighing_tickets', 'to' => '/weighing-tickets',
+    'icon' => 'mdi-scale', 'module' => 'logistique', 'permission' => 'logistique.weighing_tickets.view'],
+   ```
+   + la clé i18n `sidebar.logistique.*` dans `frontend/i18n/locales/fr.json`.
+5. **Règle ABSOLUE n°8 — 3 miroirs RBAC alignés ensemble** :
+   - `config/sidebar.php` (item + permission ci-dessus),
+   - `frontend/tests/e2e/_fixtures/personas.ts` (persona **Usine** gagne `weighing_tickets.view` + `manage` et `expectedAdminLinks` ; **Compta/Commerciale** : aucun accès),
+   - `src/Module/Core/Infrastructure/Console/SeedE2ECommand.php` (miroir back du même persona).
+6. `make shell` → `php bin/console app:sync-permissions`.
+
+## Garde-fous (règles ABSOLUES)
+- `declare(strict_types=1);` partout ; commentaires **en français**, code en anglais.
+- Permission au format `module.resource.action` snake_case.
+- Ne PAS créer d'entité ni de migration ici (ticket 1.2).
+- Pas de hardcode sidebar côté front : elle vient de `/api/sidebar`.
+
+## Vérification
+- `make test` (les tests Architecture ne cassent pas).
+- `make php-cs-fixer-allow-risky`.
+- `GET /api/modules` retourne `logistique` ; `GET /api/sidebar` : item présent pour Admin/Bureau/Usine, **absent** pour Compta/Commerciale.
+- Les 3 miroirs RBAC sont cohérents (sinon test E2E faux positif).

docs/specs/M5-tickets-pesee/prompts/ERP-182-migration.md

@@ -0,0 +1,28 @@
+# Prompt d'implémentation — M5 · ERP-182 (1.2) — Migrer le schéma M5
+
+Projet **Starseed**. Tâche **back / migration**. Lis `CLAUDE.md` (règles n°11 et n°12), `.claude/rules/backend.md` (§ Migrations) et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 3.2, § 3.2.bis, § 2.5, § 2.7).
+
+## Mission
+Écrire **une** migration Doctrine au namespace racine `DoctrineMigrations` (`migrations/VersionYYYYMMDDHHMMSS.php`, postérieure aux existantes) qui crée tout le schéma M5.
+
+## Étapes
+1. **`site.code`** : `ALTER TABLE site ADD COLUMN code VARCHAR(8)` **NULLABLE** → backfill `UPDATE site SET code = LEFT(postal_code, 2) WHERE code IS NULL` → index unique `uq_site_code` (tolère les NULL multiples Postgres).
+   - ⚠ **NE PAS poser `SET NOT NULL` ici.** Sur `make db-reset`, les fixtures `SitesFixtures` insèrent des sites via l'ORM, qui ne connaît `code` que si la propriété est mappée sur l'entité `Site.php` (fait en ERP-183) → sinon `INSERT` sans `code` → violation `NOT NULL` → db-reset plante. Le `NOT NULL` est posé en **ERP-183** (2ᵉ migration) une fois `Site::code` mappé + peuplé. Cf. spec § 2.5.
+2. Table **`weighing_ticket_counter (site_id PK → site, last_value INT NOT NULL DEFAULT 0)`** (séquence numéro par site, RG-5.02).
+3. Table **`weighbridge_dsd_counter (site_id PK → site, last_value INT NOT NULL DEFAULT 0)`** (compteur DSD par site, RG-5.04).
+4. Table **`weighing_ticket`** : copier le DDL de la spec § 3.2 (colonnes `site_id`, `number`, contrepartie `counterparty_type`/`client_id`/`supplier_id`/`other_label`, `immatriculation`/`plate_free_format`, `empty_*`, `full_*`, `net_weight`, `deleted_at` + 4 colonnes Timestampable/Blamable).
+   - Convention `INT GENERATED BY DEFAULT AS IDENTITY`, `TIMESTAMP(0) WITHOUT TIME ZONE` (§ 2.2).
+   - CHECK : `counterparty_type`, `empty_mode`/`full_mode`, et les **3 branches contrepartie** (RG-5.03).
+   - Index unique `(site_id, number)` + index FK (`site`, `client`, `supplier`, `deleted_at`, `created_by`, `updated_by`).
+5. **Règle ABSOLUE n°12** : `COMMENT ON COLUMN` (FR, ≤ 200 car., sémantique + RG) sur **chaque** colonne créée — cf. échantillon § 3.2.bis. Les 4 colonnes Timestampable/Blamable via `addStandardTimestampableBlamableComments($schema, 'weighing_ticket')`. Bonus `COMMENT ON TABLE`.
+6. Écrire `down()` symétrique (drop tables + drop colonne `site.code`).
+
+## Garde-fous
+- Noms de colonnes **en minuscules** (Postgres).
+- FK cross-module (`user`, `client`, `supplier`, `site`) → la migration **doit** vivre au namespace racine (règle n°11), sinon `make db-reset` casse l'ordre.
+- `ON DELETE` : `site` = RESTRICT, `client`/`supplier` = RESTRICT, `created_by`/`updated_by` = SET NULL, compteurs = CASCADE.
+
+## Vérification
+- `make db-reset` puis `make migration-migrate` (BDD fraîche) → OK.
+- `make test` : `ColumnsHaveSqlCommentTest` **vert** (aucune colonne `public` sans `col_description`).
+- `make php-cs-fixer-allow-risky`.

docs/specs/M5-tickets-pesee/prompts/ERP-183-entite-weighingticket.md

@@ -0,0 +1,40 @@
+# Prompt d'implémentation — M5 · ERP-183 (1.3) — Entité WeighingTicket + repository + contrat sérialisation
+
+Projet **Starseed**. Tâche **back**. Lis `CLAUDE.md`, `.claude/rules/backend.md` (Audit, Timestampable/Blamable, Serialization) et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 3.3, § 4.0, § 2.11). Prérequis : ERP-182 mergé.
+
+## Mission
+Créer l'entité Doctrine **`WeighingTicket`** + son `#[ApiResource]` (Get / GetCollection / Post / Patch) + le repository, avec le **contrat de sérialisation posé une seule fois** (read-groups sur chaque propriété affichée — RETEX M1→M4).
+
+## ⚠ Finaliser `site.code` (dette laissée par ERP-182 — à faire EN PREMIER)
+ERP-182 a créé `site.code` **nullable** (sinon `db-reset` cassait). Ici on le rend obligatoire, maintenant que l'ORM peut le remplir :
+1. Mapper la propriété `code` sur l'entité `src/Module/Sites/Domain/Entity/Site.php` (colonne + getter/setter + groupes de sérialisation cohérents avec les autres champs `site:*`).
+2. Peupler `code` (86 / 17 / 82) dans `SitesFixtures` **et** dans `SeedE2ECommand.php` (sites seedés).
+3. Ajuster les tests Sites en collision d'unicité : ex. `SiteApiTest` qui crée un site CP `86000` → `code` 86 entre en collision avec la fixture Châtellerault (86) → adapter le CP/code du test.
+4. **2ᵉ petite migration** (namespace racine) : `ALTER TABLE site ALTER COLUMN code SET NOT NULL;` (+ `COMMENT ON COLUMN` si pas déjà posé).
+5. `make db-reset` + `make test` doivent rester verts.
+
+## Étapes — WeighingTicket
+1. `src/Module/Logistique/Domain/Entity/WeighingTicket.php` (squelette spec § 3.3) :
+   - `#[Auditable]`, `use TimestampableBlamableTrait`, `implements TimestampableInterface, BlamableInterface`.
+   - Relations ORM **partagées** (PAS d'import de logique) : `Client` (M1), `Supplier` (M2), `Site` (Sites) en ManyToOne.
+   - Propriétés : `number`, `site`, `counterpartyType`, `client`, `supplier`, `otherLabel`, `immatriculation`, `plateFreeFormat`, `empty*` (date/weight/dsd/mode/manualNumber), `full*` (idem), `netWeight`.
+2. **Read-groups (3 maillons § 4.0)** :
+   - `weighing_ticket:read` = champs liste (`number`, `counterpartyType`, `client`, `supplier`, `otherLabel`, `displayDate`, `netWeight`, `plateFreeFormat`, timestamps).
+   - `weighing_ticket:item:read` = détail (`empty*`, `full*`, `site`, `immatriculation`).
+   - Contextes des opérations exactement comme § 3.3 (inclure `client:read`, `supplier:read`, `site:read`, `default:read`).
+3. Getter calculé **`displayDate`** (= `fullDate ?? emptyDate`) annoté `weighing_ticket:read`.
+4. Booléen **`plateFreeFormat`** : exposer via getter + `#[SerializedName('plateFreeFormat')]` (piège #3 M1 — la clé doit sortir dans le JSON).
+5. Sécurité opérations : GET = `is_granted('logistique.weighing_tickets.view')` ; POST/PATCH = `...manage`. **Pas de Delete, pas d'archive.** Provider/Processor référencés (implémentés en ERP-184/185).
+6. Contraintes `#[Assert\*]` avec **messages FR** ; `Assert\Length.max` aligné sur les colonnes ORM.
+7. **Libellé i18n audit** : `audit.entity.logistique_weighingticket` dans `frontend/i18n/locales/fr.json`.
+8. `src/Module/Logistique/Infrastructure/Doctrine/DoctrineWeighingTicketRepository.php`.
+
+## Garde-fous
+- `declare(strict_types=1);` ; commentaires FR.
+- Ne JAMAIS importer une classe d'un autre **module** pour de la logique — seules les entités de référence (Client/Supplier/Site) sont consommées en relation ORM (toléré M1→M4).
+- Pagination gérée par le Provider (ERP-185) — ne pas désactiver la pagination.
+
+## Vérification
+- `make test` : `EntitiesAreTimestampableBlamableTest`, `AuditableEntitiesHaveI18nLabelTest`, `EntityConstraintsHaveFrenchMessageTest` **verts**.
+- `make php-cs-fixer-allow-risky`.
+- (La capture JSON réelle du contrat est faite en ERP-187.)

docs/specs/M5-tickets-pesee/prompts/ERP-184-pont-bascule.md

@@ -0,0 +1,33 @@
+# Prompt d'implémentation — M5 · ERP-184 (1.4) — Pesée pont bascule (stub + DSD + endpoint)
+
+Projet **Starseed**. Tâche **back**. Lis `CLAUDE.md`, `.claude/rules/backend.md` et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 2.6, § 2.7, § 4.2). Prérequis : ERP-182.
+
+## Mission
+Implémenter la pesée déclenchée par les boutons « Pesée bascule » / « Pesée manuelle » : **stub** (pas de liaison matérielle au M5) + allocateur DSD + endpoint API.
+
+## Étapes
+1. Contrat `Logistique\Domain\Contract\WeighbridgeReaderInterface` :
+   ```php
+   public function read(SiteInterface $site): WeighbridgeReading; // {weight:int kg, dsd:int}
+   ```
+   + `WeighbridgeUnavailableException`.
+2. Impl `Logistique\Infrastructure\Weighbridge\RandomWeighbridgeReader` : `weight = random_int(10000, 50000)` (RG-5.06), `dsd = DsdAllocator::next($site)`.
+3. `DsdAllocator` (service) : compteur DSD **par site** sur `weighbridge_dsd_counter`, incrément avec **verrou ligne `SELECT ... FOR UPDATE`** dans une transaction.
+   - AUTO : incrémente et renvoie la nouvelle valeur.
+   - MANUAL : `dsd = dernier dsd du site + 1` (RG-5.04).
+4. Endpoint **`POST /api/weighbridge_readings`** — ressource virtuelle (DTO `WeighbridgeReadingInput`/`Output`) + Processor dédié, **pas de controller Symfony** :
+   - `{ "mode": "AUTO" }` → `{ weight, dsd, mode }` (site courant via `CurrentSiteProviderInterface`).
+   - `{ "mode": "MANUAL", "weight": <int>, "manualNumber": "<str>" }` → `{ weight, dsd, manualNumber, mode }`.
+   - Erreur `WeighbridgeUnavailableException` → **HTTP 503** explicite « Pont bascule indisponible — passez en pesée manuelle » (RG-5.06).
+   - Sécurité `is_granted('logistique.weighing_tickets.manage')`.
+5. Le `dsd` renvoyé est **prévisionnel** : noter en commentaire que l'attribution autoritaire est refaite à la création du ticket (ERP-185).
+
+## Garde-fous
+- `declare(strict_types=1);` ; commentaires FR.
+- Consommer `CurrentSiteProviderInterface` (contrat Sites) — pas d'import de logique d'un autre module.
+- Pas de controller sous `/api` (API Platform).
+
+## Vérification
+- `make test` : `WeighbridgeReaderStubTest` (poids ∈ [10000,50000] + chemin erreur → 503), `DsdAllocatorTest` (AUTO incrémente / MANUAL = dernier+1 / par site).
+- `make php-cs-fixer-allow-risky`.
+- Appel manuel `POST /api/weighbridge_readings {AUTO}` (token Usine) → poids + dsd cohérents.

docs/specs/M5-tickets-pesee/prompts/ERP-185-provider-processor.md

@@ -0,0 +1,31 @@
+# Prompt d'implémentation — M5 · ERP-185 (1.5) — Provider + Processor WeighingTicket
+
+Projet **Starseed**. Tâche **back**. Lis `CLAUDE.md`, `.claude/rules/backend.md` (Pagination, RBAC, Validation) et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 4.3, § 4.4, § 2.5, § 2.9, § 2.8, § 6, § 2.3). Prérequis : ERP-183, ERP-184.
+
+## Mission
+Implémenter la logique métier d'écriture (Processor) et de lecture (Provider) du ticket de pesée.
+
+## Étapes — `WeighingTicketProcessor` (POST/PATCH)
+1. **Site courant** : résoudre via `CurrentSiteProviderInterface` → `site_id` (à la création).
+2. **Numéro `{siteCode}-TP-{NNNN}`** (RG-5.02) : à la création, incrémenter `weighing_ticket_counter` du site avec **`SELECT ... FOR UPDATE`**, formater `%04d`. Numéro **immuable** au PATCH (RG-5.09).
+3. **DSD autoritaire** : (ré)attribuer `empty_dsd`/`full_dsd` via `DsdAllocator` (verrou) si pesée AUTO (RG-5.04).
+4. **RG-5.03** (contrepartie) : `#[Assert\Callback]` sur l'entité → selon `counterpartyType`, exiger `client` / `supplier` / `otherLabel` et forcer les autres à `null` (messages FR, `->atPath()` sur le bon champ).
+5. **RG-5.05** : `net_weight = full_weight - empty_weight` (plein − vide) si les 2 poids présents, sinon `null`.
+6. **RG-5.01 / RG-5.10** : `WeighingTicketFieldNormalizer` (service appelé avant validation) — `immatriculation` trim+UPPER ; si `!plateFreeFormat` reformate `XX-000-XX` et **rejette en 422** si invalide ; `otherLabel` trim.
+7. `site` immuable au PATCH (RG-5.09).
+
+## Étapes — `WeighingTicketProvider` (GET)
+8. Liste **paginée** via `ApiPlatform\Doctrine\Orm\Paginator` (jamais d'array brut — règle n°13).
+9. **Cloisonnement par site courant** (§ 2.3) : appliquer le `SiteScopedQueryExtension` existant (ou filtrer sur le site courant).
+10. Query params : `?search=` (sur `number`, nom client/fournisseur, `other_label`, `immatriculation`), tri `displayDate` (défaut `number DESC`).
+11. Anti-N+1 : fetch-join `client`/`supplier`/`site` (ManyToOne sûrs).
+
+## Garde-fous
+- `declare(strict_types=1);` ; commentaires FR ; messages de validation **FR**.
+- Toutes les violations 422 portent un `propertyPath` aligné sur les noms de champs (consommé par le front `useFormErrors`).
+- Pas de controller ; pas de `paginationEnabled: false`.
+
+## Vérification
+- `make test` (les tests dédiés sont écrits en ERP-187) : au minimum `CollectionsArePaginatedTest` **vert**.
+- `make php-cs-fixer-allow-risky`.
+- Smoke manuel : `POST /api/weighing_tickets` (Usine) → numéro `86-TP-0001` attribué, `net_weight` calculé ; second POST même site → `86-TP-0002`.

docs/specs/M5-tickets-pesee/prompts/ERP-186-export-xlsx.md

@@ -0,0 +1,23 @@
+# Prompt d'implémentation — M5 · ERP-186 (1.6) — Export XLSX des tickets de pesée
+
+Projet **Starseed**. Tâche **back**. Lis `CLAUDE.md`, `.claude/rules/backend.md` et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 4.5). Prérequis : ERP-185.
+
+## Mission
+Endpoint d'export XLSX de **toute la liste** des tickets de pesée (bouton « Exporter »).
+
+## Étapes
+1. Endpoint **`GET /api/weighing_tickets/export.xlsx`** : opération API Platform dédiée avec provider renvoyant un binaire (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`, `Content-Disposition: attachment`).
+2. Respecter le **site courant** + les filtres actifs (mêmes critères que la liste, mais **sans pagination** → export complet).
+3. Colonnes : Numéro, Contrepartie (type + nom Client/Fournisseur/Autre), Date, Immatriculation, Poids vide, Poids plein, **Poids net**, DSD vide, DSD plein.
+4. Sécurité `is_granted('logistique.weighing_tickets.view')`.
+5. Whitelister cette opération dans `CollectionsArePaginatedTest::EXCLUDED` (export complet légitime).
+
+## Garde-fous
+- `declare(strict_types=1);` ; commentaires FR.
+- Utiliser le helper XLSX standard du projet (cf. exports M1→M4) — ne pas réinventer.
+- Pas de controller custom sous `/api` sans `priority: 1` (préférer une opération API Platform).
+
+## Vérification
+- `make test` : test de l'export (colonnes + filtrage site) + `CollectionsArePaginatedTest` vert.
+- `make php-cs-fixer-allow-risky`.
+- Téléchargement manuel → fichier ouvrable, colonnes correctes, poids net = plein − vide.

docs/specs/M5-tickets-pesee/prompts/ERP-187-tests-phpunit.md

@@ -0,0 +1,31 @@
+# Prompt d'implémentation — M5 · ERP-187 (1.7) — Tests PHPUnit RG-5.01→5.10 + capture contrat JSON
+
+Projet **Starseed**. Tâche **back / tests**. Lis `CLAUDE.md`, `.claude/rules/testing.md` et la spec : `docs/specs/M5-tickets-pesee/spec-back.md` (§ 8, § 4.0.bis). Prérequis : ERP-183 → ERP-186 mergés.
+
+## Mission
+Couvrir les RG du M5 par des tests PHPUnit et **capturer la réponse JSON réelle** (DoD) à coller dans la spec avant le démarrage front.
+
+## Étapes
+1. **`WeighingTicketSerializationContractTest`** : seeder un ticket complet (contrepartie Client, pesée vide + plein), capturer le JSON **liste** + **détail** (via une variable d'env de dump, cf. pattern M4 `CARRIER_DOD_DUMP`). Vérifier les **4 pièges** :
+   - `client` / `supplier` sortent en **objet embarqué**, pas en IRI nu ;
+   - `plateFreeFormat` présent dans le JSON ;
+   - `number` présent et formaté `{siteCode}-TP-{NNNN}` ;
+   - `netWeight` = `full - empty` (plein − vide).
+   → **Coller le JSON capturé dans `spec-back.md § 4.0.bis`** (feu vert front).
+2. `WeighingTicketNumberingTest` : numéro par site, unicité, concurrence (`FOR UPDATE`), immuabilité au PATCH.
+3. `DsdAllocatorTest` : AUTO incrémente / MANUAL = dernier+1 / compteur par site.
+4. `WeighbridgeReaderStubTest` : poids ∈ [10000,50000] ; `WeighbridgeUnavailableException` → 503 (RG-5.06).
+5. `NetWeightTest` : plein − vide ; `null` si une pesée manque (RG-5.05).
+6. `CounterpartyValidationTest` : RG-5.03 (chaque branche valide + rejets des incohérences).
+7. `ImmatriculationNormalizationTest` : masque `XX-000-XX`, `plateFreeFormat`, 422 si invalide (RG-5.01).
+8. **RBAC** : Admin/Bureau/Usine OK ; Compta/Commerciale → 403 ; anonyme → 401.
+
+## Garde-fous
+- `declare(strict_types=1);` ; fixtures dédiées sous `tests/Fixtures/`.
+- **Pas de test E2E** (règle d'or) — PHPUnit uniquement.
+- Ne pas casser les tests Architecture existants.
+
+## Vérification
+- `make test` **vert** (suite complète, dont Architecture).
+- `spec-back.md § 4.0.bis` contient le JSON RÉEL avec les 4 pièges marqués verts.
+- `make php-cs-fixer-allow-risky`.

docs/specs/M5-tickets-pesee/spec-back.md

@@ -0,0 +1,727 @@
+---
+# === IDENTITÉ ===
+module: M5
+nom: "Tickets de pesée"
+ecran: tickets-pesee
+owner_spec: Matthieu
+backup_spec: Tristan
+version: V0.1
+date_redaction: 2026-06-17
+# Historique :
+#   V0.1 (2026-06-17) — Spec back initiale. Restitution + précisions back du docx fonctionnel
+#     « M5-ticket-de-pesee-V02 » (V0.2, 15/06/2026, validation client en attente).
+#     Décisions Matthieu (17/06) :
+#       (1) NOUVEAU module `Logistique` (pas une greffe sur Transport).
+#       (2) Pont bascule = PAS de liaison matérielle au M5 → stub renvoyant un poids
+#           aléatoire ∈ [10000, 50000] kg. Driver réel = hors périmètre (ticket dédié).
+#       (3) DSD = compteur de pesée du pont (en manuel : dernier dsd + 1).
+#       (4) Poids net (non précisé par le docx) = poids plein − poids vide, calculé serveur
+#           (CONFIRMÉ Matthieu 17/06 — § 2.8 / RG-5.05).
+#   Maquette Figma (node 1322-16774, board « Module 5 : Ticket de pesée ») intégrée le 17/06 :
+#     les DEUX blocs (vide + plein) portent « Pesée bascule » + « Pesée manuelle » ;
+#     DSD séquentiel +1 par pesée (16619 → 16620) ; contrepartie portée par le bloc vide.
+
+# === LIENS ===
+spec_front: ./spec-front.md
+maquette_figma: "https://www.figma.com/design/jRYgT0T9c03VsEbjGhCwwS/Composants---Design-System?node-id=1322-16774&p=f&m=dev"
+trace_fonctionnelle: "uploads/M5-ticket-de-pesee-V02.pdf (V0.2, 15/06/2026, validation client en attente)"
+
+# === LIEN LESSTIME ===
+lesstime_project_id: 6
+lesstime_taskgroup_id: 33   # M5 — Tickets de pesée (ERP-181 → ERP-192)
+statut_global: pret_a_dev
+
+# === DÉPENDANCES AMONT ===
+depend_de:
+  - Sites          # SitesModule + sélecteur de site (CurrentSiteProviderInterface) + SiteScopedQueryExtension → numérotation + cloisonnement
+  - Commercial     # Client (M1) + Supplier (M2) → contrepartie du ticket (Client / Fournisseur)
+  - Core           # User, Role, Permission, Audit, JWT
+  - Shared         # TimestampableBlamableTrait + Subscriber (ERP-52)
+---
+
+# Spec back — Module 5 : Tickets de pesée
+
+## 1. Contexte
+
+Cette spec **complète et précise** la [spec front V0.1](./spec-front.md) (docx `M5-ticket-de-pesee-V02`, V0.2 du 15/06/2026) avec tout ce qui touche au back : décisions d'archi, modèle de données, migration, API REST, RBAC, règles de gestion (RG-5.01 + précisions back RG-5.02 → RG-5.10), intégration pont bascule (stub), tests, hors-périmètre.
+
+**Module cible** : **NOUVEAU module `Logistique`** (`src/Module/Logistique/`) — DÉCISION Matthieu (17/06). Le docx parle de « page d'entrée du Module *Logistique* » : on en fait un module à part entière (scaffolding via le skill `create-module`), distinct de `Transport` (M4). Son premier périmètre fonctionnel exposé est le **ticket de pesée** (entité `WeighingTicket`).
+
+> **Distinction Transport (M4) vs Logistique (M5)** : `Transport` = référentiel des transporteurs (qui transporte). `Logistique` = opérations physiques sur site, à commencer par la **pesée au pont bascule**. Les deux peuvent à terme cohabiter dans une même section sidebar « Logistique » (cf. § 5.3), mais restent **deux modules** (activables/désactivables séparément).
+
+> **RETEX obligatoire (M1→M4)** : ~80 % des frictions venaient du **contrat de sérialisation** (groupes / sous-ressources / embed), pas du métier. La section § 4.0 applique ce RETEX au M5. On réutilise aussi le pattern Provider/Processor + normalisation serveur + Timestampable/Blamable + audit i18n posé aux modules précédents.
+
+**Dépendances déjà en place sur `develop`** :
+- `Sites` → 3 sites Châtellerault (86) / Saint-Jean (17) / Pommevic (82) ; **sélecteur de site** exposé via `Sites\Application\Service\CurrentSiteProviderInterface` ; `SiteScopedQueryExtension` (filtrage par site courant) ; `SiteInterface` (contrat partagé).
+- `Commercial` → `Client` (M1) + `Supplier` (M2).
+- `Shared` → `TimestampableBlamableTrait` + `Subscriber` (ERP-52).
+- `Core` → User, Role, Permission, Audit, JWT.
+
+## 2. Décisions d'archi
+
+### 2.1 Nouveau module `Logistique` + entité `WeighingTicket`
+
+Création du module **`Logistique`** :
+- `src/Module/Logistique/LogistiqueModule.php` — `ID = 'logistique'`, `LABEL = 'Logistique'`, `REQUIRED = false`, `permissions()` (§ 5.1).
+- Ajout dans `config/modules.php` : `LogistiqueModule::class`.
+- `Domain/`, `Application/`, `Infrastructure/` (arborescence DDD standard).
+- Layer front `frontend/modules/logistique/` (kebab-case — règle naming).
+
+Entité racine : **`WeighingTicket`** (ticket de pesée) sous `src/Module/Logistique/Domain/Entity/`, avec ses **deux pesées** (vide + plein) modélisées en colonnes plates (§ 2.4).
+
+**Référentiels cross-module consommés en relation ORM partagée (PAS d'import de logique)** — exactement comme M2/M3/M4 : le ticket référence `Client` (M1), `Supplier` (M2) et `Site` (Sites) via des **relations ORM** (ManyToOne). Ce sont des **données de référence partagées**, pas de la logique inter-module (aucun service/repository d'un autre module appelé). La seule logique cross-module consommée est `CurrentSiteProviderInterface` (déjà un **contrat** exposé par Sites — autorisé par la règle ABSOLUE n°1).
+
+### 2.2 IDs — convention `INT` (alignée Core/Commercial/Sites)
+
+Le module `Logistique` est un **nouveau** module métier hors périmètre Transport : on s'aligne sur la convention **`INT GENERATED BY DEFAULT AS IDENTITY`** des modules historiques (Core / Commercial / Sites), et **non** sur le `BIGINT` du module Transport. Horodatages en `TIMESTAMP(0) WITHOUT TIME ZONE` (le `TimestampableBlamableTrait` mappe `datetime_immutable`).
+
+### 2.3 Cloisonnement par site courant (DÉCISION par défaut — à confirmer)
+
+> **Décision par défaut** : les tickets de pesée sont des **données opérationnelles rattachées à un site physique** (le pont bascule est sur site). On **cloisonne la liste par le site courant** (sélecteur de site en haut de l'app) via le `SiteScopedQueryExtension` **déjà existant** (Sites). Un utilisateur voit les tickets du site actif.
+
+- Colonne `site_id` NOT NULL sur `weighing_ticket` (renseignée à la création depuis `CurrentSiteProviderInterface`).
+- `GET /api/weighing_tickets` filtré sur le site courant (extension automatique).
+- Le **numéro** du ticket encode déjà le site (RG-5.02) → cohérent avec le cloisonnement.
+
+> **À confirmer client** : si le métier veut une **vue multi-sites** (tous sites confondus), retirer le cloisonnement et ajouter un filtre `?siteId=`. Tracé HP-M5-01 (§ 9).
+
+### 2.4 Modélisation des deux pesées — colonnes plates (pas de sous-entité)
+
+Un ticket porte **exactement deux pesées** : une **à vide** (tare) et une **à plein** (brut). Plutôt qu'une sous-collection `Weighing` (1:n), on modélise **deux jeux de colonnes plates** sur `weighing_ticket` :
+
+| Groupe | Colonnes |
+|---|---|
+| Pesée à vide  | `empty_date`, `empty_weight`, `empty_dsd`, `empty_mode` (AUTO/MANUAL), `empty_manual_number` |
+| Pesée à plein | `full_date`,  `full_weight`,  `full_dsd`,  `full_mode`  (AUTO/MANUAL), `full_manual_number` |
+
+Justification : cardinalité **fixe** (toujours 1 vide + 1 plein), pas de tri/ajout dynamique, requêtes/exports plus simples, audit lisible. (Alternative sous-entité `Weighing` documentée mais non retenue — over-engineering pour 2 lignes figées.)
+
+> **Champs `*_manual_number`** : « numéro de pesée » saisi en **pesée manuelle** (référence d'un ticket papier / autre bascule — distinct du DSD, cf. RG-5.04). Nullable (rempli seulement si `mode = MANUAL`).
+> **Maquette (17/06)** : les **deux** blocs (vide ET plein) portent les boutons « Pesée bascule » + « Pesée manuelle » — le modèle symétrique (`empty_*` ET `full_*` avec mode AUTO/MANUAL) est donc bien utilisé des deux côtés. (Le texte du docx V0.2 ne mentionnait la manuelle que sur le bloc vide ; la maquette fait foi.)
+
+### 2.5 Numérotation `{siteCode}-TP-{NNNN}` (RG-5.02)
+
+> **Décision** : chaque ticket reçoit un **numéro unique par site** au format `{siteCode}-TP-{NNNN}` (ex. `86-TP-0001`). La séquence est **propre à chaque site** → `86-TP-0001` et `17-TP-0001` coexistent (cf. docx).
+
+- **`siteCode`** : le `Site` actuel n'a **pas** de colonne `code`. On **ajoute** `site.code` (VARCHAR court, ex. `86`/`17`/`82`) — backfill par défaut = 2 premiers chiffres du `postal_code`, valeur éditable ensuite côté admin Sites. Justification : un code explicite est plus robuste qu'une dérivation implicite du CP (collisions de département possibles). Petit débordement assumé sur le module Sites (1 colonne).
+- ⚠ **Cadencement en 2 temps (RETEX dev ERP-182, 17/06)** : `NOT NULL` ne peut PAS être posé dans la migration M5 seule. Sur base fraîche (`make db-reset`), les fixtures `SitesFixtures` font `new Site(...)` via l'ORM, qui ne connaît `code` que si la **propriété est mappée sur l'entité** `Site.php` (pas le cas avant ERP-183) → `INSERT` sans `code` → violation `NOT NULL`. Décision :
+  - **ERP-182 (migration)** : créer `site.code` **NULLABLE** + backfill + index unique (les `NULL` multiples sont tolérés par l'index unique Postgres). `make db-reset` passe, aucun test cassé.
+  - **ERP-183 (entité)** : mapper `Site::code` (propriété + getter/setter), le peupler dans `SitesFixtures` (86/17/82) + `SeedE2ECommand`, ajuster les tests Sites en collision d'unicité (ex. `SiteApiTest` créant un site CP `86000` → `code` 86 = collision avec Châtellerault), **puis** poser `NOT NULL` via une **2ᵉ petite migration**.
+- **Séquence par site** : table dédiée `weighing_ticket_counter (site_id PK, last_value INT)`. À la création : `SELECT ... FOR UPDATE` sur la ligne du site (verrou ligne) → `last_value + 1`, formaté `%04d` (zéro-padding 4 chiffres, débordement naturel au-delà de 9999). Garantit l'unicité même en concurrence.
+- Le numéro est **immuable** après création (pas modifiable à l'édition).
+- Index unique `uq_weighing_ticket_number (site_id, number)`.
+
+> **Alternative écartée** : séquence Postgres par site (création dynamique de séquences) — moins portable, plus lourde à seeder. La table compteur + `FOR UPDATE` est le pattern retenu.
+
+### 2.6 Intégration pont bascule — stub au M5 (RG-5.06)
+
+> **Décision Matthieu (17/06)** : **aucune liaison matérielle** au M5. Le « pont bascule » est **simulé** : il renvoie un **poids aléatoire ∈ [10000, 50000] kg**.
+
+- Contrat : `Logistique\Domain\Contract\WeighbridgeReaderInterface`
+  ```php
+  interface WeighbridgeReaderInterface
+  {
+      /** @throws WeighbridgeUnavailableException si la bascule ne répond pas (→ bascule manuelle). */
+      public function read(SiteInterface $site): WeighbridgeReading; // {weight: int (kg), dsd: int}
+  }
+  ```
+- Implémentation livrée au M5 : `Infrastructure\Weighbridge\RandomWeighbridgeReader` → `weight = random_int(10000, 50000)`, `dsd = nextDsd(site)` (RG-5.04).
+- **Driver matériel réel** (protocole série/TCP de l'indicateur de pesage, parsing trame, reconnexion) = **hors périmètre M5**, tracé HP-M5-02 (§ 9). Le jour venu, on substitue l'implémentation derrière l'interface — **zéro impact** sur les écrans / l'API.
+- **Gestion d'erreur** (RG-5.06) : si `read()` lève `WeighbridgeUnavailableException`, l'API renvoie un **422/503 explicite** « Pont bascule indisponible — passez en pesée manuelle ». Le front affiche le message dans la modal et propose la pesée manuelle (le stub ne lève jamais l'exception au M5, mais le chemin d'erreur est implémenté et testé).
+
+### 2.7 DSD — compteur de pesée du pont (RG-5.04)
+
+> **Décision Matthieu (17/06)** : le **DSD** est un **compteur de pesée** (index séquentiel des pesées du pont). Chaque pesée (vide OU plein) consomme **une** valeur DSD.
+
+- Compteur **par site** (un pont par site) : table `weighbridge_dsd_counter (site_id PK, last_value INT)` (verrou ligne `FOR UPDATE`, même pattern que le compteur de numéro).
+- **Pesée bascule (AUTO)** : la lecture incrémente le compteur du site et renvoie la nouvelle valeur (le stub fait pareil ; un vrai pont renverrait son propre index, qu'on persisterait).
+- **Pesée manuelle** : `dsd = dernier dsd du site + 1` (le docx : « le dsd est automatiquement calculé en fonction du dernier dsd en base de données »).
+- Un ticket complet (vide + plein en AUTO) consomme **2 incréments DSD** (`empty_dsd`, `full_dsd`).
+
+### 2.8 Poids net — `plein − vide`, calculé serveur (RG-5.05)
+
+> **Le docx ne définit pas** le calcul du poids affiché en liste (colonne « Poids »). **CONFIRMÉ Matthieu (17/06)** : **poids net = poids plein − poids vide**.
+
+- Stocké en colonne dérivée `net_weight` (INT, kg), **recalculé serveur** par le `WeighingTicketProcessor` à chaque POST/PATCH dès que `empty_weight` ET `full_weight` sont renseignés (sinon `null`).
+- La colonne **liste « Poids » = `net_weight`** (cf. § 4.0). Le détail/ticket affiche vide + plein + net.
+- Exemple maquette : plein `14 300` − vide `7 150` = **net `7 150` kg**.
+
+### 2.9 Contrepartie CLIENT / FOURNISSEUR / AUTRE (RG-5.03)
+
+Le formulaire principal porte un sélecteur **« Fournisseur / Client / Autre »** qui pilote des champs conditionnels (docx p.4). Le back **ne maintient pas de state machine** : il stocke et **valide la cohérence** au POST/PATCH.
+
+| `counterparty_type` | Champs requis | Champs forcés nuls |
+|---|---|---|
+| `CLIENT` | `client_id` (FK Client) | `supplier_id`, `other_label` |
+| `FOURNISSEUR` | `supplier_id` (FK Supplier) | `client_id`, `other_label` |
+| `AUTRE` | `other_label` (texte libre) | `client_id`, `supplier_id` |
+
+Validation via `#[Assert\Callback]` + CHECK Postgres (garde-fous miroir M4 § 3.2).
+
+### 2.10 Masque immatriculation & « Tout format » (RG-5.01)
+
+- `immatriculation` : par défaut **masque `XX-000-XX`** (plaque FR SIV). Si **`plate_free_format = true`** (« Tout format » coché), le masque est désactivé (saisie libre — anciennes plaques, étranger, engins).
+- **Champs connectés entre les deux formulaires** (vide ⇄ plein) : `immatriculation` et `plate_free_format` sont **portés par le ticket** (une seule valeur, partagée par les 2 formulaires) — c'est le même véhicule. Pas de duplication.
+- Normalisation serveur : `immatriculation` → trim + UPPER + (si masque) re-formatage `XX-000-XX` ; rejet 422 si format invalide et `plate_free_format = false`.
+
+### 2.11 Audit & traces temporelles
+
+Pattern Starseed standard (miroir M1→M4) :
+- `#[Auditable]` sur `WeighingTicket`. Pas de champ sensible (password/token) → pas d'`#[AuditIgnore]`.
+- Audit des FK (`client`, `supplier`, `site`) tracé automatiquement.
+- `WeighingTicket implements TimestampableInterface, BlamableInterface` + `use TimestampableBlamableTrait` (4 colonnes standard).
+- **Libellé i18n** (règle ABSOLUE backend — `AuditableEntitiesHaveI18nLabelTest`) : ajouter `audit.entity.logistique_weighingticket` dans `frontend/i18n/locales/fr.json` (clé = `strtolower(module)` + `_` + `strtolower(Entity)`).
+
+### 2.12 Impression du ticket / bon de pesée (RG-5.08)
+
+> **OWNER : Tristan.** La **réalisation du bon d'impression** (gabarit du ticket de pesée, mise en page, déclenchement de l'impression) est **prise en charge par Tristan lui-même** — hors de la découpe back/front standard du M5. Cette spec en pose **le contrat attendu** (déclencheur, contenu, données disponibles) pour qu'il puisse s'y brancher sans rétro-spec.
+
+Contrat attendu :
+- **Déclencheur** : à la **validation** (création), l'API renvoie le ticket complet ; le front ouvre une **modal d'impression**. En **modification**, un bouton **« Imprimer »** est disponible (absent à l'ajout — docx / RG-5.08).
+- **Contenu minimal du bon** : numéro (`{siteCode}-TP-{NNNN}`), site, contrepartie (Client / Fournisseur / Autre + libellé), immatriculation, **pesée à vide** (date/poids/DSD), **pesée à plein** (date/poids/DSD), **poids net** (= plein − vide), date d'édition.
+- **Données** : toutes disponibles dans la réponse `GET /api/weighing_tickets/{id}` (§ 4.0) — aucun champ supplémentaire requis côté API. Si Tristan opte pour un **PDF serveur**, prévoir l'endpoint `GET /api/weighing_tickets/{id}/print.pdf` (HP-M5-04) ; sinon impression navigateur d'un gabarit front.
+
+### 2.13 Pas d'archive ; soft delete préparé non exposé
+
+Le docx M5 **ne prévoit pas** d'archivage (contrairement au M4). On **n'expose pas** d'archive. On prépare néanmoins une colonne `deleted_at` (soft delete technique) **non exposée** au M5 (`DELETE` non exposé → 404). Cohérent avec le pattern projet.
+
+## 3. Modèle de données
+
+### 3.1 Diagramme
+
+```
+                +------------------+
+                |   site (Sites)   |  + NOUVELLE colonne `code` (86/17/82)
+                +------------------+
+                   ^   ^        ^
+          site_id  |   | site_id| site_id
+   +---------------+   |        +------------------------+
+   |                   |                                 |
++-----------------------+   +--------------------------+ +--------------------------+
+| weighing_ticket_counter|   | weighbridge_dsd_counter | |     weighing_ticket      |
+| site_id PK             |   | site_id PK              | | id (PK)                  |
+| last_value INT         |   | last_value INT          | | number (UNIQUE / site)   |
++-----------------------+   +--------------------------+ | site_id (FK)             |
+   (séquence n° ticket)        (compteur DSD pont)       | counterparty_type        |
+                                                         | client_id (FK M1, null)  |--> client (M1)
+                                                         | supplier_id (FK M2, null)|--> supplier (M2)
+                                                         | other_label (null)       |
+                                                         | immatriculation          |
+                                                         | plate_free_format        |
+                                                         | empty_* (date/weight/dsd/mode/manual_number) |
+                                                         | full_*  (date/weight/dsd/mode/manual_number)  |
+                                                         | net_weight (dérivé)      |
+                                                         | deleted_at (soft, non exposé) |
+                                                         +--------------------------+
+```
+
+### 3.2 Migration Doctrine — SQL Postgres
+
+Namespace : **`DoctrineMigrations` (racine `migrations/`)** — fichier `migrations/VersionYYYYMMDDHHMMSS.php` (à dater, postérieur aux migrations existantes).
+
+> **Même justification qu'aux M1→M4** : la migration crée un schéma avec **FK cross-module** (`user`, `client`, `supplier`, `site`). Le namespace modulaire casserait l'ordre (`make db-reset`) — exception racine de la règle ABSOLUE n°11.
+
+> **Rappel règle ABSOLUE n°12** : chaque colonne créée DOIT recevoir son `COMMENT ON COLUMN` (FR, ≤ 200 car., sémantique + contrainte/RG). Les 4 colonnes Timestampable/Blamable passent par le helper `addStandardTimestampableBlamableComments`. SQL ci-dessous *illustratif* (convention `INT GENERATED BY DEFAULT AS IDENTITY`, `TIMESTAMP(0)`).
+
+```sql
+-- =====================================================================
+-- Ajout d'un code de site (préfixe de numérotation TP) — § 2.5
+-- =====================================================================
+-- ⚠ NULLABLE au M5 (ERP-182). Le SET NOT NULL est posé en ERP-183, une fois Site::code
+--    mappé sur l'entité et peuplé dans les fixtures (sinon db-reset casse — cf. § 2.5).
+ALTER TABLE site ADD COLUMN code VARCHAR(8);
+-- Backfill : 2 premiers chiffres du code postal (dépt) par défaut, éditable ensuite.
+UPDATE site SET code = LEFT(postal_code, 2) WHERE code IS NULL;
+-- Index unique tolérant les NULL (Postgres : plusieurs NULL autorisés) — OK tant que code nullable.
+CREATE UNIQUE INDEX uq_site_code ON site (code);
+-- ERP-183 (2ᵉ migration) : ALTER TABLE site ALTER COLUMN code SET NOT NULL;
+
+-- =====================================================================
+-- Compteur de numéro de ticket (séquence par site) — RG-5.02
+-- =====================================================================
+CREATE TABLE weighing_ticket_counter (
+    site_id    INT PRIMARY KEY REFERENCES site(id) ON DELETE CASCADE,
+    last_value INT NOT NULL DEFAULT 0
+);
+
+-- =====================================================================
+-- Compteur DSD (pesée du pont, par site) — RG-5.04
+-- =====================================================================
+CREATE TABLE weighbridge_dsd_counter (
+    site_id    INT PRIMARY KEY REFERENCES site(id) ON DELETE CASCADE,
+    last_value INT NOT NULL DEFAULT 0
+);
+
+-- =====================================================================
+-- Table principale `weighing_ticket`
+-- =====================================================================
+CREATE TABLE weighing_ticket (
+    id                  INT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    site_id             INT NOT NULL REFERENCES site(id) ON DELETE RESTRICT,
+    number              VARCHAR(20) NOT NULL,            -- {siteCode}-TP-{NNNN} (RG-5.02)
+    -- Contrepartie (RG-5.03)
+    counterparty_type   VARCHAR(12) NOT NULL,            -- CLIENT|FOURNISSEUR|AUTRE
+    client_id           INT REFERENCES client(id) ON DELETE RESTRICT,
+    supplier_id         INT REFERENCES supplier(id) ON DELETE RESTRICT,
+    other_label         VARCHAR(255),
+    -- Véhicule (RG-5.01, partagé entre les 2 formulaires)
+    immatriculation     VARCHAR(20) NOT NULL,
+    plate_free_format   BOOLEAN NOT NULL DEFAULT FALSE,
+    -- Pesée à vide (§ 2.4)
+    empty_date          TIMESTAMP(0) WITHOUT TIME ZONE,
+    empty_weight        INT,                             -- kg
+    empty_dsd           INT,
+    empty_mode          VARCHAR(8),                      -- AUTO|MANUAL
+    empty_manual_number VARCHAR(50),                     -- numéro de pesée manuelle (RG-5.04)
+    -- Pesée à plein (§ 2.4)
+    full_date           TIMESTAMP(0) WITHOUT TIME ZONE,
+    full_weight         INT,                             -- kg
+    full_dsd            INT,
+    full_mode           VARCHAR(8),                      -- AUTO|MANUAL
+    full_manual_number  VARCHAR(50),
+    -- Dérivé (RG-5.05)
+    net_weight          INT,                             -- full_weight - empty_weight (RG-5.05)
+    -- Soft delete (préparé, non exposé au M5)
+    deleted_at          TIMESTAMP(0) WITHOUT TIME ZONE,
+    -- Timestampable + Blamable
+    created_at          TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL,
+    updated_at          TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL,
+    created_by          INT REFERENCES "user"(id) ON DELETE SET NULL,
+    updated_by          INT REFERENCES "user"(id) ON DELETE SET NULL,
+    CONSTRAINT chk_wt_counterparty_type
+        CHECK (counterparty_type IN ('CLIENT','FOURNISSEUR','AUTRE')),
+    CONSTRAINT chk_wt_empty_mode CHECK (empty_mode IS NULL OR empty_mode IN ('AUTO','MANUAL')),
+    CONSTRAINT chk_wt_full_mode  CHECK (full_mode  IS NULL OR full_mode  IN ('AUTO','MANUAL')),
+    -- RG-5.03 : cohérence contrepartie
+    CONSTRAINT chk_wt_client_branch CHECK (
+        counterparty_type <> 'CLIENT' OR (client_id IS NOT NULL AND supplier_id IS NULL AND other_label IS NULL)
+    ),
+    CONSTRAINT chk_wt_supplier_branch CHECK (
+        counterparty_type <> 'FOURNISSEUR' OR (supplier_id IS NOT NULL AND client_id IS NULL AND other_label IS NULL)
+    ),
+    CONSTRAINT chk_wt_other_branch CHECK (
+        counterparty_type <> 'AUTRE' OR (other_label IS NOT NULL AND client_id IS NULL AND supplier_id IS NULL)
+    )
+);
+CREATE UNIQUE INDEX uq_weighing_ticket_number ON weighing_ticket (site_id, number);
+CREATE INDEX idx_wt_site ON weighing_ticket (site_id);
+CREATE INDEX idx_wt_client ON weighing_ticket (client_id);
+CREATE INDEX idx_wt_supplier ON weighing_ticket (supplier_id);
+CREATE INDEX idx_wt_deleted_at ON weighing_ticket (deleted_at);
+CREATE INDEX idx_wt_created_by ON weighing_ticket (created_by);
+CREATE INDEX idx_wt_updated_by ON weighing_ticket (updated_by);
+```
+
+### 3.2.bis Commentaires SQL obligatoires (échantillon)
+
+```php
+$this->addSql("COMMENT ON TABLE weighing_ticket IS 'Tickets de pesée (M5 Logistique) — pesée à vide + à plein au pont bascule, contrepartie Client/Fournisseur/Autre.'");
+$this->addSql("COMMENT ON COLUMN site.code IS 'Code court du site (ex. 86/17/82) — préfixe de numérotation des tickets de pesée (RG-5.02). Unique.'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.number IS 'Numéro {siteCode}-TP-{NNNN}, unique par site, immuable. Séquence weighing_ticket_counter (RG-5.02).'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.counterparty_type IS 'Contrepartie : CLIENT, FOURNISSEUR ou AUTRE (RG-5.03). Pilote l''obligation client_id / supplier_id / other_label.'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.immatriculation IS 'Plaque du véhicule, partagée entre pesée vide et plein. Masque XX-000-XX sauf si plate_free_format (RG-5.01).'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.plate_free_format IS '« Tout format » : désactive le masque XX-000-XX de l''immatriculation (RG-5.01). Partagé entre les 2 formulaires.'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.empty_dsd IS 'Compteur DSD du pont à la pesée à vide. AUTO=valeur du pont ; MANUAL=dernier dsd du site +1 (RG-5.04).'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.empty_manual_number IS 'Numéro de pesée saisi en pesée manuelle (distinct du DSD) — formulaire à vide (RG-5.04).'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket.net_weight IS 'Poids net = full_weight - empty_weight (kg), calculé serveur (RG-5.05). Colonne Poids de la liste.'");
+$this->addSql("COMMENT ON COLUMN weighbridge_dsd_counter.last_value IS 'Dernière valeur DSD attribuée pour le site (pont bascule). Incrément verrouillé FOR UPDATE (RG-5.04).'");
+$this->addSql("COMMENT ON COLUMN weighing_ticket_counter.last_value IS 'Dernier numéro de ticket attribué pour le site. Incrément verrouillé FOR UPDATE (RG-5.02).'");
+// + COMMENT ON COLUMN sur TOUTES les autres colonnes métier (règle n°12)
+$this->addStandardTimestampableBlamableComments($schema, 'weighing_ticket');
+```
+
+### 3.3 Entité `WeighingTicket` — squelette (extrait)
+
+Pattern jumeau de `Carrier`/`Supplier` (`#[Auditable]`, `TimestampableBlamableTrait`). **Chaque propriété affichée porte un read-group** (RETEX M1).
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Logistique\Domain\Entity;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\Patch;
+use ApiPlatform\Metadata\Post;
+use App\Module\Commercial\Domain\Entity\Client;     // relation ORM partagée (§ 2.1)
+use App\Module\Commercial\Domain\Entity\Supplier;   // relation ORM partagée (§ 2.1)
+use App\Module\Sites\Domain\Entity\Site;            // relation ORM partagée (§ 2.1)
+use App\Module\Logistique\Infrastructure\ApiPlatform\State\Processor\WeighingTicketProcessor;
+use App\Module\Logistique\Infrastructure\ApiPlatform\State\Provider\WeighingTicketProvider;
+use App\Module\Logistique\Infrastructure\Doctrine\DoctrineWeighingTicketRepository;
+use App\Shared\Domain\Attribute\Auditable;
+use App\Shared\Domain\Contract\BlamableInterface;
+use App\Shared\Domain\Contract\TimestampableInterface;
+use App\Shared\Domain\Trait\TimestampableBlamableTrait;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Serializer\Attribute\Groups;
+use Symfony\Component\Serializer\Attribute\SerializedName;
+use Symfony\Component\Validator\Constraints as Assert;
+
+#[ApiResource(
+    operations: [
+        new GetCollection(
+            security: "is_granted('logistique.weighing_tickets.view')",
+            normalizationContext: ['groups' => ['weighing_ticket:read', 'client:read', 'supplier:read', 'site:read', 'default:read']],
+            provider: WeighingTicketProvider::class,
+        ),
+        new Get(
+            security: "is_granted('logistique.weighing_tickets.view')",
+            normalizationContext: ['groups' => ['weighing_ticket:read', 'weighing_ticket:item:read', 'client:read', 'supplier:read', 'site:read', 'default:read']],
+            provider: WeighingTicketProvider::class,
+        ),
+        new Post(
+            security: "is_granted('logistique.weighing_tickets.manage')",
+            normalizationContext: ['groups' => ['weighing_ticket:read', 'weighing_ticket:item:read', 'client:read', 'supplier:read', 'site:read', 'default:read']],
+            denormalizationContext: ['groups' => ['weighing_ticket:write']],
+            processor: WeighingTicketProcessor::class,
+        ),
+        new Patch(
+            security: "is_granted('logistique.weighing_tickets.manage')",
+            normalizationContext: ['groups' => ['weighing_ticket:read', 'weighing_ticket:item:read', 'client:read', 'supplier:read', 'site:read', 'default:read']],
+            denormalizationContext: ['groups' => ['weighing_ticket:write']],
+            provider: WeighingTicketProvider::class,
+            processor: WeighingTicketProcessor::class,
+        ),
+        // Pas de Delete au M5 (HP). Pas d'archive (hors docx).
+    ],
+)]
+#[ORM\Entity(repositoryClass: DoctrineWeighingTicketRepository::class)]
+#[ORM\Table(name: 'weighing_ticket')]
+#[Auditable]
+class WeighingTicket implements TimestampableInterface, BlamableInterface
+{
+    use TimestampableBlamableTrait;
+
+    #[ORM\Id, ORM\GeneratedValue, ORM\Column]
+    #[Groups(['weighing_ticket:read'])]
+    private ?int $id = null;
+
+    /** Numéro {siteCode}-TP-{NNNN} — attribué serveur, lecture seule (RG-5.02). */
+    #[ORM\Column(length: 20)]
+    #[Groups(['weighing_ticket:read'])]
+    private ?string $number = null;
+
+    #[ORM\ManyToOne(targetEntity: Site::class)]
+    #[ORM\JoinColumn(name: 'site_id', nullable: false, onDelete: 'RESTRICT')]
+    #[Groups(['weighing_ticket:read'])]   // renseigné serveur depuis le site courant (§ 2.3)
+    private ?Site $site = null;
+
+    #[ORM\Column(length: 12)]
+    #[Assert\Choice(choices: ['CLIENT', 'FOURNISSEUR', 'AUTRE'], message: 'Type de contrepartie invalide.')]
+    #[Assert\NotBlank(message: 'La contrepartie (Client / Fournisseur / Autre) est obligatoire.')]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private ?string $counterpartyType = null;
+
+    #[ORM\ManyToOne(targetEntity: Client::class)]
+    #[ORM\JoinColumn(name: 'client_id', nullable: true, onDelete: 'RESTRICT')]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private ?Client $client = null;       // requis si counterpartyType=CLIENT (Callback RG-5.03)
+
+    #[ORM\ManyToOne(targetEntity: Supplier::class)]
+    #[ORM\JoinColumn(name: 'supplier_id', nullable: true, onDelete: 'RESTRICT')]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private ?Supplier $supplier = null;   // requis si counterpartyType=FOURNISSEUR
+
+    #[ORM\Column(length: 255, nullable: true)]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private ?string $otherLabel = null;   // requis si counterpartyType=AUTRE
+
+    #[ORM\Column(length: 20)]
+    #[Assert\NotBlank(message: 'L''immatriculation est obligatoire.')]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private ?string $immatriculation = null;   // masque XX-000-XX sauf plateFreeFormat (RG-5.01)
+
+    #[ORM\Column(options: ['default' => false])]
+    #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
+    private bool $plateFreeFormat = false;
+
+    // === Pesée à vide ===
+    #[ORM\Column(name: 'empty_date', type: 'datetime_immutable', nullable: true)]
+    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
+    private ?\DateTimeImmutable $emptyDate = null;
+
+    #[ORM\Column(name: 'empty_weight', nullable: true)]
+    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
+    private ?int $emptyWeight = null;   // kg — readonly UI, rempli par la pesée (RG-5.07)
+
+    #[ORM\Column(name: 'empty_dsd', nullable: true)]
+    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
+    private ?int $emptyDsd = null;
+
+    #[ORM\Column(name: 'empty_mode', length: 8, nullable: true)]
+    #[Assert\Choice(choices: ['AUTO', 'MANUAL'], message: 'Mode de pesée invalide.')]
+    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
+    private ?string $emptyMode = null;
+
+    #[ORM\Column(name: 'empty_manual_number', length: 50, nullable: true)]
+    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
+    private ?string $emptyManualNumber = null;
+
+    // === Pesée à plein (mêmes colonnes, préfixe full*) ===
+    // fullDate / fullWeight / fullDsd / fullMode / fullManualNumber ...
+
+    /** Poids net dérivé — calculé serveur (RG-5.05). */
+    #[ORM\Column(name: 'net_weight', nullable: true)]
+    #[Groups(['weighing_ticket:read'])]
+    private ?int $netWeight = null;
+
+    // RG-5.03 (contrepartie) + RG-5.01 (immat) : cohérence via #[Assert\Callback] (§ 7).
+    // ... getters/setters ...
+}
+```
+
+> ⚠ `Client` / `Supplier` / `Site` appartiennent à d'autres modules — on consomme leurs read-groups (`client:read`, `supplier:read`, `site:read`), **pas de logique inter-module** (§ 2.1).
+
+## 4. API REST (API Platform)
+
+### 4.0 Contrat de sérialisation (RETEX M1 — section critique)
+
+> **Leçon M1→M4** : pour **chaque champ affiché** (liste OU détail), les **3 maillons** doivent être prouvés : (a) groupe sur la propriété, (b) groupe dans le `normalizationContext` de l'opération, (c) read-group de l'entité imbriquée présent dans le contexte parent.
+
+**Contexte par opération** :
+
+| Opération | `normalizationContext` (groupes) |
+|---|---|
+| `GetCollection` (liste) | `weighing_ticket:read` + `client:read` + `supplier:read` + `site:read` + `default:read` |
+| `Get` / `Post` / `Patch` (détail) | + `weighing_ticket:item:read` |
+
+**LISTE — colonne datatable → maillons** (docx p.3 : Numéro, Client, Fournisseur, Autre, Date, Poids) :
+
+| Colonne affichée | Propriété (a) | Dans contexte liste (b) | Imbriqué (c) |
+|---|---|---|---|
+| Numéro | `number` ∈ `weighing_ticket:read` | ✅ | — |
+| Client | `client` ∈ `weighing_ticket:read` (embed) | ✅ | `client:read` ✅ (RG-5.03) |
+| Fournisseur | `supplier` ∈ `weighing_ticket:read` (embed) | ✅ | `supplier:read` ✅ |
+| Autre | `otherLabel` ∈ `weighing_ticket:read` | ✅ | — |
+| Date | `fullDate` ?? `emptyDate` (date du ticket) ∈ `weighing_ticket:read` | ✅ | — |
+| Poids | `netWeight` ∈ `weighing_ticket:read` | ✅ | — |
+
+> **Note « Date » liste** : on expose une propriété calculée `displayDate` (getter) = `fullDate ?? emptyDate`, dans `weighing_ticket:read` (les `empty/full*` détaillées restent en `:item:read`).
+
+**DÉTAIL — maillons** : scalaires + `emptyDate/emptyWeight/emptyDsd/...` + `full*` ∈ `weighing_ticket:item:read` ; `client`/`supplier`/`site` embarqués (`client:read`/`supplier:read`/`site:read`).
+
+### 4.0.bis Réponse JSON de référence (DoD — à CAPTURER sur l'API réelle)
+
+> **Definition of Done** (miroir M2/M3/M4) : avant les écrans front, **capturer la réponse RÉELLE** via un test PHPUnit (`WeighingTicketSerializationContractTest`, ticket complet seedé : contrepartie Client, pesée vide + plein) et la coller ici. Toute donnée affichée par le front DOIT apparaître dans ce JSON.
+>
+> **Pièges à re-tester** :
+> 1. `client` / `supplier` doivent sortir en **objet embarqué**, pas en IRI nu → read-groups `client:read`/`supplier:read`.
+> 2. Booléen `plateFreeFormat` : clé présente (piège #3 M1 → getter + `SerializedName` si besoin).
+> 3. `number` présent et formaté `{siteCode}-TP-{NNNN}`.
+> 4. `netWeight` cohérent = `full - empty` (plein − vide, RG-5.05).
+
+**`GET /api/weighing_tickets` (LISTE)** — enveloppe Hydra AP4 (`member`/`totalItems`/`view`), filtrée site courant (§ 2.3) :
+
+```jsonc
+{
+  "@context": "/api/contexts/WeighingTicket",
+  "@id": "/api/weighing_tickets",
+  "@type": "Collection",
+  "totalItems": 1,
+  "member": [
+    {
+      "@id": "/api/weighing_tickets/1",
+      "@type": "WeighingTicket",
+      "id": 1,
+      "number": "86-TP-0001",
+      "counterpartyType": "CLIENT",
+      "client": { "@id": "/api/clients/117", "@type": "Client", "id": 117, "companyName": "NÉGOCE MÉTAUX ATLANTIQUE" },
+      "supplier": null,
+      "otherLabel": null,
+      "displayDate": "2026-06-17T09:12:00+02:00",
+      "netWeight": 12340,
+      "plateFreeFormat": false,
+      "createdAt": "2026-06-17T09:12:00+02:00",
+      "updatedAt": "2026-06-17T09:12:00+02:00"
+    }
+  ],
+  "view": { "@id": "/api/weighing_tickets", "@type": "PartialCollectionView" }
+}
+```
+
+**`GET /api/weighing_tickets/{id}` (DÉTAIL)** — ajoute les pesées :
+
+```jsonc
+{
+  "@id": "/api/weighing_tickets/1",
+  "@type": "WeighingTicket",
+  "id": 1,
+  "number": "86-TP-0001",
+  "site": { "@id": "/api/sites/1", "@type": "Site", "id": 1, "name": "Châtellerault", "code": "86" },
+  "counterpartyType": "CLIENT",
+  "client": { "@id": "/api/clients/117", "@type": "Client", "id": 117, "companyName": "NÉGOCE MÉTAUX ATLANTIQUE" },
+  "immatriculation": "AB-123-CD",
+  "plateFreeFormat": false,
+  "emptyDate": "2026-06-17T09:00:00+02:00", "emptyWeight": 14660, "emptyDsd": 41, "emptyMode": "AUTO", "emptyManualNumber": null,
+  "fullDate":  "2026-06-17T09:12:00+02:00", "fullWeight":  27000, "fullDsd":  42, "fullMode":  "AUTO", "fullManualNumber": null,
+  "netWeight": 12340
+}
+```
+
+### 4.1 Query params (LISTE)
+
+| Param | Effet |
+|---|---|
+| `?page` / `?itemsPerPage` | pagination standard (10 / 25 / 50, défaut 10) |
+| `?search=` | recherche sur `number`, nom client/fournisseur, `other_label`, `immatriculation` |
+| `?order[displayDate]=desc` | tri par date (défaut : `number DESC` = plus récents en tête) |
+| *(site courant)* | filtré automatiquement par `SiteScopedQueryExtension` (§ 2.3) |
+
+Pagination obligatoire (règle ABSOLUE n°13) — provider ORM via `ApiPlatform\Doctrine\Orm\Paginator`, jamais d'array brut.
+
+### 4.2 Endpoint pesée (pont bascule) — `POST /api/weighbridge_readings`
+
+Action **autonome** (le ticket n'est pas encore créé quand on déclenche la pesée du formulaire principal).
+
+- **Sécurité** : `is_granted('logistique.weighing_tickets.manage')`.
+- **AUTO (pesée bascule)** — body `{ "mode": "AUTO" }` → le site courant est résolu serveur (`CurrentSiteProviderInterface`).
+  - Réponse `200` : `{ "weight": 23187, "dsd": 42, "mode": "AUTO" }` (stub : `weight = random_int(10000,50000)`, `dsd = nextDsd(site)`).
+  - Réponse `503` (RG-5.06) si `WeighbridgeUnavailableException` : `{ "title": "Pont bascule indisponible", "detail": "Passez en pesée manuelle." }`.
+- **MANUAL (pesée manuelle)** — body `{ "mode": "MANUAL", "weight": 23187, "manualNumber": "PAP-555" }`.
+  - Réponse `200` : `{ "weight": 23187, "dsd": 43, "manualNumber": "PAP-555", "mode": "MANUAL" }` (`dsd = dernier dsd du site + 1`, RG-5.04).
+
+> **Implémentation** : `#[ApiResource]` non-Doctrine (DTO `WeighbridgeReadingInput`/`Output`) + Processor dédié, OU une ressource `WeighbridgeReading` virtuelle. **Pas de controller** Symfony (règle backend). Le Processor appelle `WeighbridgeReaderInterface` + le `DsdAllocator` (verrou `FOR UPDATE`).
+>
+> **Concurrence DSD** : le `dsd` renvoyé ici est **prévisionnel**. L'attribution **autoritaire** du `dsd` (et du `number`) est refaite/verrouillée à la **création du ticket** (`POST /api/weighing_tickets`) pour éviter les collisions si deux postes pèsent en parallèle. Front : afficher le dsd renvoyé, mais c'est le ticket persisté qui fait foi.
+
+### 4.3 `POST /api/weighing_tickets` (création)
+
+- Le client envoie : `counterpartyType` (+ `client`/`supplier`/`otherLabel`), `immatriculation`, `plateFreeFormat`, et les pesées (`emptyDate/Weight/Dsd/Mode/ManualNumber`, `full*`).
+- Le **Processor** :
+  1. Résout le **site courant** (`CurrentSiteProviderInterface`) → `site_id`.
+  2. Attribue le **numéro** `{siteCode}-TP-{NNNN}` (compteur verrouillé — RG-5.02).
+  3. (Re)attribue les `dsd` autoritaires si nécessaire (verrou — RG-5.04).
+  4. Normalise `immatriculation` (RG-5.01) ; valide la cohérence contrepartie (RG-5.03) et pesées.
+  5. Calcule `net_weight = full_weight - empty_weight` si les deux poids sont présents (RG-5.05).
+- Réponse `201` avec le ticket complet → le front ouvre la **modal d'impression** (RG-5.08).
+
+### 4.4 `PATCH /api/weighing_tickets/{id}` (modification)
+
+- Mise à jour partielle (mêmes règles). Le **numéro et le site sont immuables** (ignorés s'ils sont envoyés). `net_weight` recalculé. Le bouton d'impression est disponible (RG-5.08).
+
+### 4.5 Export — `GET /api/weighing_tickets/export.xlsx`
+
+- Exporte **toute la liste** des tickets (docx : bouton « Exporter » → « Exporte toute la liste des tickets de pesée »), filtrée par le site courant + filtres actifs.
+- Colonnes : Numéro, Contrepartie (Client/Fournisseur/Autre + nom), Date, Immatriculation, Poids vide, Poids plein, **Poids net**, DSD vide/plein.
+- Génération via le helper XLSX standard projet (skill `xlsx`). Endpoint : provider dédié renvoyant un binaire (`Content-Type` xlsx) — whitelisté pagination (`EXCLUDED`) car export complet.
+
+## 5. RBAC, module & sidebar
+
+### 5.1 `LogistiqueModule::permissions()`
+
+```php
+public static function permissions(): array
+{
+    return [
+        ['code' => 'logistique.weighing_tickets.view',   'label' => 'Voir les tickets de pesée'],
+        ['code' => 'logistique.weighing_tickets.manage', 'label' => 'Créer / modifier les tickets de pesée'],
+    ];
+}
+```
+Synchronisation : `app:sync-permissions`.
+
+### 5.2 Matrice rôle → permissions (docx p.3)
+
+| Rôle | `…view` | `…manage` |
+|---|:--:|:--:|
+| **Admin** | ✅ | ✅ |
+| **Bureau** | ✅ | ✅ |
+| **Usine** | ✅ | ✅ |
+| **Compta** | ❌ | ❌ |
+| **Commerciale** | ❌ | ❌ |
+
+> ⚠ **Changement vs M5 V0.1** : en V0.2 **Usine = Tout / Tout** (consultation + ajout/modif), alors que la V0.1 disait « Oui ». Compta et Commerciale = **aucun** accès (item sidebar masqué).
+
+### 5.3 Sidebar (`config/sidebar.php`)
+
+Nouvelle section **« Logistique »** (ou item rattaché à une section logistique mutualisée avec Transport — à confirmer). Item :
+
+```php
+[
+    'label'      => 'sidebar.logistique.weighing_tickets',
+    'to'         => '/weighing-tickets',
+    'icon'       => 'mdi-scale',
+    'module'     => 'logistique',
+    'permission' => 'logistique.weighing_tickets.view',
+],
+```
+
+### 5.4 Règle ABSOLUE n°8 — 3 miroirs RBAC
+
+Toute permission `logistique.*` doit être posée **simultanément** dans :
+1. `config/sidebar.php` (item + permission ci-dessus),
+2. `frontend/tests/e2e/_fixtures/personas.ts` (ajuster un persona existant : Usine gagne `weighing_tickets.view/manage` + `expectedAdminLinks`),
+3. `src/Module/Core/Infrastructure/Console/SeedE2ECommand.php` (miroir back du même persona).
+
+## 6. Normalisation serveur (RG-5.01 / RG-5.10)
+
+`WeighingTicketFieldNormalizer` (miroir `CarrierFieldNormalizer`), appelé par le Processor avant validation :
+
+```php
+final class WeighingTicketFieldNormalizer
+{
+    // RG-5.01 : trim + UPPER ; si !plateFreeFormat → reformate XX-000-XX (rejet 422 si invalide).
+    public function normalizeImmatriculation(?string $v, bool $freeFormat): ?string
+    public function normalizeOtherLabel(?string $v): ?string   // trim
+}
+```
+
+## 7. Règles de gestion (RG)
+
+| RG | Source | Énoncé |
+|---|---|---|
+| **RG-5.01** | docx | Immatriculation : masque par défaut `XX-000-XX` ; « Tout format » coché → masque désactivé (saisie libre). Les champs `immatriculation` et `plateFreeFormat` sont **connectés entre les 2 formulaires** (une seule valeur portée par le ticket — § 2.10). |
+| **RG-5.02** | back | Numéro `{siteCode}-TP-{NNNN}`, **unique par site**, attribué serveur à la création, immuable. Séquence verrouillée par site (§ 2.5). |
+| **RG-5.03** | docx+back | Contrepartie `CLIENT`/`FOURNISSEUR`/`AUTRE` → champ associé obligatoire, les autres forcés nuls (§ 2.9). |
+| **RG-5.04** | docx+back | DSD = compteur de pesée du pont, par site. AUTO = valeur du pont ; MANUAL = dernier dsd du site + 1. « Numéro de pesée » manuel = champ distinct (§ 2.7). |
+| **RG-5.05** | back | Poids net = `poids plein − poids vide`, calculé serveur, exposé en liste/détail (§ 2.8 — confirmé Matthieu 17/06). |
+| **RG-5.06** | docx+back | Pesée bascule indisponible → erreur explicite + bascule en pesée manuelle. Au M5, le pont est un **stub** (poids aléatoire ∈ [10000,50000] kg, § 2.6). |
+| **RG-5.07** | docx | Formulaire à vide : `Date` = date du jour par défaut ; `Poids` et `DSD` **readonly** (remplis par la pesée, pas saisis). |
+| **RG-5.08** | docx | « Valider » (création) → enregistre + ouvre la modal d'impression. En modification : bouton « Valider » → « Enregistrer », bouton d'impression disponible (absent à l'ajout). Le bouton « Enregistré » du bloc pesée à vide disparaît en modification. **Le bon d'impression est réalisé par Tristan** (§ 2.12). |
+| **RG-5.09** | back | Site & numéro immuables après création ; liste cloisonnée par site courant (§ 2.3, à confirmer). |
+| **RG-5.10** | back | Normalisation immatriculation (trim/UPPER/format) côté serveur (§ 6). |
+
+Cohérence inter-champs (RG-5.03, RG-5.01) implémentée via `#[Assert\Callback]` portant des messages FR + CHECK Postgres en garde-fou (§ 3.2).
+
+## 8. Tests (PHPUnit) — `make test`
+
+- **`WeighingTicketSerializationContractTest`** : capture JSON liste + détail (DoD § 4.0.bis), 4 pièges verts.
+- **`WeighingTicketNumberingTest`** : `{siteCode}-TP-{NNNN}`, séquence par site, unicité, concurrence (FOR UPDATE).
+- **`DsdAllocatorTest`** : AUTO incrémente ; MANUAL = dernier + 1 ; par site.
+- **`WeighbridgeReaderStubTest`** : poids ∈ [10000,50000] ; chemin d'erreur `WeighbridgeUnavailableException` → 503 (RG-5.06).
+- **`NetWeightTest`** : `plein − vide` ; null si une pesée manque (RG-5.05).
+- **`CounterpartyValidationTest`** : RG-5.03 (chaque branche + rejets).
+- **`ImmatriculationNormalizationTest`** : masque XX-000-XX, free format, 422 (RG-5.01).
+- **RBAC** : Usine/Bureau/Admin OK ; Compta/Commerciale 403.
+- **Architecture** (déjà en place, ne pas casser) : `ColumnsHaveSqlCommentTest`, `EntitiesAreTimestampableBlamableTest`, `AuditableEntitiesHaveI18nLabelTest`, `CollectionsArePaginatedTest`, `EntityConstraintsHaveFrenchMessageTest`.
+
+## 9. Hors périmètre (HP)
+
+| Réf | Sujet |
+|---|---|
+| HP-M5-01 | Vue multi-sites des tickets (retirer le cloisonnement + filtre `?siteId=`) si demandé (§ 2.3). |
+| HP-M5-02 | Driver matériel réel du pont bascule (protocole série/TCP, parsing trame, reconnexion) derrière `WeighbridgeReaderInterface` (§ 2.6). |
+| HP-M5-03 | Sens réception-expédition explicite + contrôle de signe du net (le net reste `plein − vide`, § 2.8). |
+| HP-M5-04 | Génération PDF serveur du ticket (`/print.pdf`) si l'impression navigateur ne suffit pas (§ 2.12). |
+| HP-M5-05 | Archivage fonctionnel des tickets (non prévu au docx — § 2.13). |
+
+## 10. Tickets Lesstime (à découper — back en tête)
+
+| Ordre | Sujet | Tag |
+|---|---|---|
+| 0 | Scaffolding module `Logistique` (create-module) + `config/modules.php` + sidebar + 3 miroirs RBAC | Backend |
+| 1 | Migration : `site.code` + compteurs + `weighing_ticket` (+ index + COMMENT) | Backend |
+| 2 | Entité `WeighingTicket` + Repository + contrat sérialisation | Backend |
+| 3 | `WeighbridgeReaderInterface` + `RandomWeighbridgeReader` + `DsdAllocator` + endpoint `weighbridge_readings` | Backend |
+| 4 | `WeighingTicketProvider` + `WeighingTicketProcessor` (numérotation, RG-5.03/5.05, normalisation) | Backend |
+| 5 | Export XLSX | Backend |
+| 6 | Tests PHPUnit RG-5.01→5.10 + capture contrat JSON | Backend |
+| 7 | Page liste `/weighing-tickets` (usePaginatedList) + export | Frontend |
+| 8 | Écran Ajouter (formulaires vide + plein, pesée bascule/manuelle, masque immat) | Frontend |
+| 9 | Écran Modification (la **modal/bon d'impression** = **Tristan**, § 2.12) | Frontend |
+| 10 | i18n + libellé audit + branchement site courant | Frontend |
+| — | **Bon d'impression du ticket de pesée** | **Tristan (hors découpe M5)** |

docs/specs/M5-tickets-pesee/spec-front.md

@@ -0,0 +1,246 @@
+---
+# === IDENTITÉ ===
+module: M5
+nom: "Tickets de pesée"
+ecran: tickets-pesee
+owner_spec: Matthieu
+backup_spec: Tristan
+version: V0.1
+date_redaction: 2026-06-17
+# Historique :
+#   V0.1 (2026-06-17) — Restitution Markdown du docx « M5-ticket-de-pesee-V02 » (V0.2, 15/06/2026,
+#     validation client en attente) + maquette Figma (node 1322-16774). Précisions techniques (back)
+#     dans spec-back.md. Réutilise le pattern et les composants M1/M2/M3/M4.
+#     Maquette : les 2 blocs (vide + plein) portent « Pesée bascule » + « Pesée manuelle » ;
+#     contrepartie portée par le bloc « Poids à vide » ; net = plein − vide (confirmé Matthieu).
+
+# === LIENS ===
+maquette_figma: "https://www.figma.com/design/jRYgT0T9c03VsEbjGhCwwS/Composants---Design-System?node-id=1322-16774&p=f&m=dev"
+regles_metier: [RG-5.01, RG-5.02, RG-5.03, RG-5.04, RG-5.05, RG-5.06, RG-5.07, RG-5.08, RG-5.09, RG-5.10]
+roles: [Admin, Bureau, Compta, Commerciale, Usine]
+lien_spec_back: ./spec-back.md
+
+# === VALIDATION CLIENT ===
+client_validation_1:
+  statut: validee
+  version: V0.2
+  date_doc: 2026-06-15
+  date_validation: 2026-06-17
+  valide_par: "Matthieu (CP MALIO)"
+
+# === LIEN LESSTIME ===
+lesstime_project_id: 6
+lesstime_taskgroup_id: 33   # M5 — Tickets de pesée (ERP-181 → ERP-192)
+statut_global: pret_a_dev
+---
+
+# Module 5 — Tickets de pesée (V0.1 front)
+
+> **Origine** : spec fonctionnelle `M5-ticket-de-pesee-V02` (V0.2, 15/06/2026, **validation client en attente**) + maquette Figma (node 1322-16774). Restitution Markdown pour intégration au workflow MALIO. Toute décision technique (back) vit dans [`spec-back.md`](./spec-back.md). Le M5 réutilise le pattern et les composants posés aux [M1 clients](../M1-clients/spec-front.md) → [M4 transporteurs](../M4-transporteurs/spec-front.md).
+
+> **Nouveau module `Logistique`** (DÉCISION Matthieu 17/06). La maquette montre une section sidebar **Logistique** plus large (Réception, Expédition, Validations, Triage, **Ticket de pesée**, Bons…) ; **le M5 ne livre que l'écran « Ticket de pesée »**. Les autres items sont hors périmètre (modules/écrans ultérieurs).
+
+> **Décisions (17/06)** : (1) **pont bascule = stub** renvoyant un poids aléatoire ∈ [10000, 50000] kg (pas de liaison matérielle — [`spec-back.md § 2.6`](./spec-back.md)) ; (2) **DSD = compteur de pesée** par site, +1 par pesée ([`§ 2.7`](./spec-back.md)) ; (3) **net = plein − vide** ([`§ 2.8`](./spec-back.md)) ; (4) numéro **`{siteCode}-TP-{NNNN}` par site** ([`§ 2.5`](./spec-back.md)).
+
+## But
+
+Lister les tickets de pesée et accéder à leur fiche : consultation, création (pesée à vide + pesée à plein au pont bascule), modification, impression. Chaque ticket porte un **numéro unique par site** (ex. `86-TP-0001`) et une **contrepartie** Client / Fournisseur / Autre.
+
+## Accès
+
+- **Depuis** : menu principal → section **Logistique** → item **« Ticket de pesée »** (route `/weighing-tickets`).
+- **Site** : l'écran dépend du **site courant** (sélecteur de site en haut de l'app — onglets `CHÂTELLERAULT` / `SAINT-JEAN` / `POMMEVIC`). Le site pilote la numérotation et (par défaut) le cloisonnement de la liste ([`spec-back.md § 2.3 / § 2.5`](./spec-back.md)).
+- **Rôles autorisés** (tableau « Rôles & permissions » du docx p.3, V0.2) :
+
+| Rôle | Consultation | Ajout / Modification |
+|---|---|---|
+| **Admin** | ✅ Tout | ✅ Tout |
+| **Bureau** | ✅ Tout | ✅ Tout |
+| **Usine** | ✅ Tout | ✅ Tout |
+| **Compta** | ❌ | ❌ |
+| **Commerciale** | ❌ | ❌ |
+
+> **Notes** :
+> - RBAC transposée sur `logistique.weighing_tickets.view` / `.manage` ([`spec-back.md § 5`](./spec-back.md)).
+> - ⚠ **Changement vs M5 V0.1** : en **V0.2, Usine = Tout / Tout**. **Compta** et **Commerciale** n'ont **aucun** accès (item sidebar masqué).
+
+## Navigation
+
+Page d'entrée de l'écran : **datatable** « Tickets de pesées ».
+
+- **Clic sur une ligne** → écran **Modification d'un ticket de pesée** (le docx ne prévoit pas d'écran de consultation séparé — clic = édition).
+- **Bouton « + Ajouter »** (haut droite, si `manage`) → écran **Ajouter un ticket de pesée**.
+- **Bouton « Exporter »** (bas de liste, maquette) → télécharge un **XLSX** de **toute la liste** (filtres + site courant appliqués). Format dans [`spec-back.md § 4.5`](./spec-back.md).
+
+## Datatable des tickets
+
+Composant : `<MalioDataTable>` branché sur `usePaginatedList<WeighingTicket>({ url: '/weighing_tickets' })` *(URL API en `snake_case` ; la route Nuxt reste `/weighing-tickets`)* (règle frontend obligatoire — pagination Hydra, état 100 % local). Colonnes (docx p.3 + maquette) :
+
+| Colonne | Source | Tri |
+|---|---|---|
+| **Numéro** | `ticket.number` (`{siteCode}-TP-{NNNN}`) | DESC par défaut (plus récents en tête) |
+| **Client** | `ticket.client.companyName` (vide si contrepartie ≠ Client) | Non |
+| **Fournisseur** | `ticket.supplier.companyName` (vide si ≠ Fournisseur) | Non |
+| **Autre** | `ticket.otherLabel` (vide si ≠ Autre) | Non |
+| **Date** | `ticket.displayDate` (`fullDate ?? emptyDate`, format `JJ-MM-AAAA`) | Oui |
+| **Poids** | `ticket.netWeight` (kg, = plein − vide — RG-5.05) | Oui |
+
+> **Clic ligne** → écran Modification. **Pagination** : standard Starseed 10 / 25 / 50 (défaut 10). Liste **cloisonnée par site courant** par défaut ([`spec-back.md § 2.3`](./spec-back.md)).
+
+## Écran « Ajouter un ticket de pesée »
+
+**Accès** : bouton « + Ajouter ». **Rôles** : Admin, Bureau, Usine.
+**Titre** : « ← Ticket de pesée » (flèche retour vers la liste).
+
+L'écran (maquette) est composé de **deux blocs empilés** — **« Poids à vide »** puis **« Poids à plein »** — et d'un bouton **« Valider »** en bas.
+
+### Bloc « Poids à vide »
+
+Boutons en haut à droite du bloc : **« Pesée bascule »** (`<MalioButton>` secondaire) + **« Pesée manuelle »** (`<MalioButton>` primaire).
+
+**Champs** :
+
+| Champ | Type composant | Obligatoire | Règle |
+|---|---|---|---|
+| **Fournisseur / Client / Autre** | `<MalioSelect>` (3 valeurs) | Oui | RG-5.03 — pilote le champ suivant |
+| **Nom du fournisseur** | `<MalioSelect>` (liste fournisseurs M2) | Conditionnel | RG-5.03 — visible + obligatoire si « Fournisseur » |
+| **Nom du client** | `<MalioSelect>` (liste clients M1) | Conditionnel | RG-5.03 — visible + obligatoire si « Client » |
+| **Autre** | `<MalioInputText>` | Conditionnel | RG-5.03 — visible + obligatoire si « Autre » |
+| **Date** | `<MalioInputText>` type `date` *(cf. note)* | Oui | RG-5.07 — **date du jour par défaut** |
+| **Poids** | `<MalioInputNumber>` (suffixe « Kg ») | Oui | RG-5.07 — **readonly**, rempli par la pesée |
+| **DSD** | `<MalioInputNumber>` | Oui | RG-5.04 / RG-5.07 — **readonly**, rempli par la pesée |
+| **Immatriculation** | `<MalioInputText>` (masque `XX-000-XX`) | Oui | RG-5.01 |
+| **Tout format** | `<MalioCheckbox>` | Non | RG-5.01 — désactive le masque |
+
+> **La contrepartie (Fournisseur/Client/Autre) + son champ associé est portée par le bloc « Poids à vide » uniquement** (maquette) — c'est une donnée du ticket, pas répétée sur le bloc plein. Côté back : champs `counterpartyType` / `client` / `supplier` / `otherLabel` du ticket ([`spec-back.md § 2.9`](./spec-back.md)).
+
+**Action « Enregistrer »** (sous le bloc, maquette) : POST `/api/weighing_tickets` (création initiale du ticket avec la pesée à vide) — [`spec-back.md § 4.3`](./spec-back.md). Le numéro `{siteCode}-TP-{NNNN}` est attribué serveur.
+
+### Bloc « Poids à plein »
+
+Mêmes boutons **« Pesée bascule »** + **« Pesée manuelle »**. **Champs** : Date (date du jour par défaut), Poids (readonly, Kg), DSD (readonly), Immatriculation (`XX-000-XX`), « Tout format ».
+
+> **Immatriculation + « Tout format » connectés entre les 2 blocs** (RG-5.01) : une seule valeur partagée — modifier l'un met à jour l'autre (même véhicule). Géré dans `useWeighingTicketForm()` (état partagé).
+
+### Boutons de pesée — comportement
+
+| Bouton | Déclencheur | Comportement |
+|---|---|---|
+| **Pesée bascule** | clic | Ouvre une **modal de confirmation** « Êtes-vous sûr de vouloir déclencher une pesée ? » (`<MalioButton>` « Valider »). Si confirmé → `POST /api/weighbridge_readings { mode: 'AUTO' }` ([`spec-back.md § 4.2`](./spec-back.md)) → remplit **Poids** et **DSD** du bloc, ferme la modal. **En cas d'erreur** (RG-5.06) : le message d'erreur s'affiche **dans la modal** et invite à passer en **pesée manuelle**. *(Au M5, le stub renvoie toujours un poids ∈ [10000,50000] — le chemin d'erreur est néanmoins géré.)* |
+| **Pesée manuelle** | clic | Ouvre une **modal « Pesée manuelle »** avec **Poids** et **Numéro de pesée** à saisir (`<MalioInputNumber>` + `<MalioInputText>`), bouton « Enregistrer ». Une fois validé → le **Poids** du bloc est rempli ; le **DSD** est **calculé automatiquement** = dernier dsd du site + 1 (`POST /api/weighbridge_readings { mode: 'MANUAL', weight, manualNumber }` — RG-5.04). |
+
+### Action « Valider » (bas d'écran)
+
+`<MalioButton>` « Valider » → finalise le ticket (PATCH `/api/weighing_tickets/{id}` avec la pesée à plein + recalcul du net — [`spec-back.md § 4.4`](./spec-back.md)) puis **ouvre la modal d'impression** du ticket (RG-5.08 — **bon d'impression réalisé par Tristan**, cf. § Modales).
+
+## Écran « Modification d'un ticket de pesée »
+
+**But** : modifier un ticket existant et/ou **imprimer** le ticket.
+**Accès** : clic sur une ligne de la liste. **Rôles** : Admin, Bureau, Usine.
+
+**Identique à l'écran d'ajout** — mêmes 2 blocs, mêmes règles (RG-5.01 → RG-5.10) — **sauf** (docx + maquette) :
+- Les champs sont **pré-remplis** avec les valeurs actuelles.
+- Le **bouton « Enregistrer » du bloc « Poids à vide » disparaît** (RG-5.08) — on enregistre via le bas d'écran.
+- En bas : **« Enregistrer »** (remplace « Valider ») + **« Imprimer »** (bouton d'impression **absent à l'ajout**, RG-5.08).
+- Le numéro et le site sont **immuables** (lecture seule).
+
+## Modales
+
+| Modale | Contenu | Source |
+|---|---|---|
+| **Confirmation pesée bascule** | « Êtes-vous sûr de vouloir déclencher une pesée ? » + bouton « Valider ». Erreur affichée inline → invite pesée manuelle (RG-5.06). | docx p.5 + maquette |
+| **Pesée manuelle** | Champs « Poids » + « Numéro de pesée » + bouton « Enregistrer ». DSD auto = dernier +1 (RG-5.04). | docx p.5 + maquette |
+| **Impression du ticket / bon de pesée** | Aperçu imprimable du ticket (numéro, contrepartie, immat, pesée vide/plein, net, DSD, date). **Réalisé par Tristan** (voir encadré ci-dessous). | docx p.5 / RG-5.08 ; [`spec-back.md § 2.12`](./spec-back.md) |
+
+> **⚠ Bon d'impression = Tristan.** La conception et la réalisation du **bon d'impression** (gabarit du ticket de pesée, mise en page, déclenchement) sont **prises en charge par Tristan lui-même**, hors de la découpe front standard du M5. Le reste de l'écran (modale de confirmation, modale pesée manuelle, formulaires) reste dans la découpe M5.
+> - **Déclencheur attendu** : modale d'impression à la **validation** (création) ; bouton **« Imprimer »** en **modification** (absent à l'ajout — RG-5.08).
+> - **Données disponibles** : toute la réponse `GET /api/weighing_tickets/{id}` (numéro, site, contrepartie, immat, pesées vide/plein, net, DSD, dates) — [`spec-back.md § 2.12 / § 4.0`](./spec-back.md).
+> - **Modales** : réutiliser le wrapper de modal partagé `frontend/shared/` (comme M1→M4).
+
+## Composants UI à utiliser (`@malio/layer-ui`)
+
+- **Datatable** : `<MalioDataTable>` (+ `usePaginatedList`)
+- **Select** : `<MalioSelect>` (contrepartie, nom client, nom fournisseur)
+- **Input texte** : `<MalioInputText>` (Autre, Immatriculation, Numéro de pesée)
+- **Input nombre** : `<MalioInputNumber>` (Poids, DSD)
+- **Checkbox** : `<MalioCheckbox>` (« Tout format »)
+- **Bouton** : `<MalioButton>`, `<MalioButtonIcon>` (Pesée bascule, Pesée manuelle, Valider, Enregistrer, Imprimer, + Ajouter, Exporter)
+- **Validation par champ** : `useFormErrors` (mapping 422 inline — règle frontend obligatoire)
+- **Toasts** : standards via `useApi()`
+
+**Exceptions autorisées** (commenter `// TODO migrer quand Malio couvre`) :
+- **Date** : `<MalioInput>` ne couvrant pas `date` nativement, utiliser un `<input type="date">` encapsulé OU `MalioDate` si dispo (cf. exceptions @.claude/rules/frontend.md — type `date` explicitement listé comme exception tolérée).
+- **Masque immatriculation `XX-000-XX`** : si non couvert par `<MalioInputText>`, masque local (directive) + `// TODO`. La validation de format reste **autoritaire côté serveur** (RG-5.01 / RG-5.10).
+- **Modales** : wrapper partagé `frontend/shared/`.
+
+## Composables & appels API
+
+- `usePaginatedList<WeighingTicket>({ url: '/weighing_tickets' })` — liste paginée (obligatoire). Consomme `number`, `client`/`supplier`/`otherLabel`, `displayDate`, `netWeight` ([`spec-back.md § 4.0`](./spec-back.md)).
+- `useWeighingTicket(id)` — charge le détail via `GET /api/weighing_tickets/{id}` (pesées vide + plein embarquées, client/supplier/site imbriqués). **DoD avant intégration** : vérifier le JSON réel ([`spec-back.md § 4.0.bis`](./spec-back.md)).
+- `useWeighingTicketForm()` — workflow 2 blocs (POST à l'« Enregistrer » du bloc vide, PATCH au « Valider ») + **état partagé** immatriculation/« Tout format » entre les 2 blocs (RG-5.01) + gestion des champs conditionnels de contrepartie (RG-5.03).
+- `useWeighbridge()` — déclenche la pesée : `POST /api/weighbridge_readings` (AUTO ou MANUAL), gère la modal de confirmation et le chemin d'erreur → pesée manuelle (RG-5.06).
+- `useClientOptions()` / `useSupplierOptions()` — alimentent les selects (référentiels M1/M2 via `?pagination=false` — échappatoire selects).
+- `useCurrentSite()` — site courant (sélecteur) — déjà exposé côté front (Sites). Le back lit le site courant pour la numérotation ; le front n'a pas à l'envoyer.
+- `usePermissions()` — masque l'item sidebar et les boutons selon `logistique.weighing_tickets.view/manage`.
+- Tous les appels passent par `useApi()` (jamais `$fetch` direct — règle ABSOLUE n°4).
+
+## Règles de formatage et normalisation
+
+Le serveur normalise systématiquement ([`spec-back.md § 6`](./spec-back.md)) :
+
+| Champ | Normalisation serveur | Affichage front |
+|---|---|---|
+| Immatriculation | trim + UPPER ; format `XX-000-XX` sauf « Tout format » (RG-5.01) | UPPER, masqué |
+| Autre (`otherLabel`) | trim | identique |
+| Poids / DSD | entiers (kg) | « 7 150 Kg », DSD brut |
+| Numéro de ticket | `{siteCode}-TP-{NNNN}` (serveur) | affiché tel quel |
+
+> Le front **ne normalise pas** : il envoie la valeur saisie, le serveur normalise et renvoie la valeur que l'UI affiche.
+
+## Différences notables avec les modules précédents
+
+| Zone | M1→M4 | M5 tickets de pesée |
+|---|---|---|
+| Module | Commercial / Transport… | **Logistique** (nouveau, ERP à venir) |
+| Saisie poids | — | **Pesée au pont bascule** (stub random) + pesée manuelle |
+| Cloisonnement par site | M3 oui / M4 non | **Oui** (site courant) + numéro par site |
+| Numérotation métier | id technique | **`{siteCode}-TP-{NNNN}`** par site (RG-5.02) |
+| Onglets | présents | **Aucun onglet** : 2 blocs empilés (vide + plein) |
+| Impression | aucune | **Modal d'impression** du ticket (RG-5.08) |
+| Contrepartie | — | **Client / Fournisseur / Autre** (conditionnel, RG-5.03) |
+
+## Points résolus côté back
+
+| # | Zone d'ombre | Résolution (cf. `spec-back.md`) |
+|---|---|---|
+| 1 | Module | **Nouveau module `Logistique`** (§ 2.1) |
+| 2 | Pont bascule | **Stub** poids aléatoire ∈ [10000,50000], interface réutilisable, driver réel HP (§ 2.6) |
+| 3 | DSD | **Compteur de pesée par site**, +1 par pesée ; manuel = dernier +1 (§ 2.7) |
+| 4 | Poids net | **plein − vide**, calculé serveur (§ 2.8) |
+| 5 | Numérotation | **`{siteCode}-TP-{NNNN}`** par site, séquence verrouillée (§ 2.5) ; ajout `site.code` |
+| 6 | Contrepartie | `counterpartyType` + FK Client/Supplier ou `otherLabel` (RG-5.03, § 2.9) |
+| 7 | Deux pesées | Colonnes plates `empty_*` / `full_*` ; les 2 blocs supportent bascule + manuelle (§ 2.4) |
+| 8 | Impression | Modal d'impression front ; bouton dispo en modif seulement (RG-5.08, § 2.12) |
+| 9 | Masque immat | `XX-000-XX` + « Tout format », connectés entre blocs (RG-5.01, § 2.10) |
+| 10 | RBAC | `logistique.weighing_tickets.view/manage` ; Usine = Tout ; Compta + Commerciale sans accès (§ 5.2) |
+
+---
+
+## 📦 Tickets Lesstime générés
+
+**TaskGroup Lesstime** : **#33 — M5 — Tickets de pesée** (projet `ERP / Starseed`, projectId=6) — créé le 17/06/2026, 12 tickets au statut « Prêt à dev ».
+
+| # | ERP | Ticket | Effort | Tag |
+|---|---|---|---|---|
+| 1.1 | ERP-181 | Scaffolder le module Logistique + RBAC | M | Backend |
+| 1.2 | ERP-182 | Migrer le schéma M5 (site.code, compteurs, weighing_ticket) | M | Backend |
+| 1.3 | ERP-183 | Créer l'entité WeighingTicket + repository + contrat sérialisation | M | Backend |
+| 1.4 | ERP-184 | Implémenter la pesée pont bascule (stub + DSD + endpoint) | M | Backend |
+| 1.5 | ERP-185 | Créer Provider + Processor (numérotation, RG, normalisation) | L | Backend |
+| 1.6 | ERP-186 | Implémenter l'export XLSX | S | Backend |
+| 1.7 | ERP-187 | Tests PHPUnit RG-5.01→5.10 + capture contrat JSON | M | Backend |
+| 1.8 | ERP-188 | Créer la page liste `/weighing-tickets` + export | M | Frontend |
+| 1.9 | ERP-189 | Implémenter l'écran Ajouter (blocs vide+plein, pesée, masque immat) | L | Frontend |
+| 1.10 | ERP-190 | Implémenter l'écran Modification + déclenchement impression | M | Frontend |
+| 1.11 | ERP-191 | i18n + libellés + branchement site courant | S | Frontend |
+| 1.12 | ERP-192 | **Bon d'impression du ticket de pesée — OWNER Tristan** | — | Frontend |

docs/specs/M6-field-sales/spec.md

@@ -1,322 +0,0 @@
----
-# === IDENTITÉ ===
-module: M6
-nom: "Tournées commerciales terrain"
-ecran: tournees-terrain
-owner_spec: Matthieu
-backup_spec: ""
-version: V0.2
-# Historique :
-#   V0.2 (2026-06-11) — RÉDUCTION DE SCOPE : suppression du volet « rapport de visite »
-#     (entité VisitReport, fichiers, offres de prix, note /5, saisie vocale, historique des
-#     visites) et du mode terrain mobile dédié. Périmètre recentré sur : géolocalisation,
-#     carte interactive, planification de tournées, et onglet « Carte » dans les fiches Tiers.
-#   V0.1 (2026-06-11) — Rédaction initiale (inspirée de Badger Maps, SPOTIO, Portatour, Nomadia).
-date_redaction: 2026-06-11
-
-# === LIENS ===
-spec_front: ./spec-front.md
-maquette_figma: ""
-
-# === LIEN LESSTIME ===
-lesstime_taskgroup_id: 28     # M6 — Tournées commerciales terrain (projet STARSEED #6)
-lesstime_project_id: 6
-statut_global: en_dev
-
-# === DÉPENDANCES AMONT ===
-depend_de:
-  - M1-clients      # Client / ClientAddress (cible de visite + onglet Carte)
-  - M2-suppliers    # Supplier / SupplierAddress (cible de visite + onglet Carte)
-  - Sites           # rattachement site d'une adresse (déjà en place)
-  - Core            # User (commercial), Role, Permission, JWT
-  - Shared          # TimestampableBlamableTrait + contrats inter-modules
----
-
-# Spec — Module 6 : Tournées commerciales terrain (`field_sales`)
-
-> **Périmètre V0.2 (réduit)** : géolocalisation des adresses Tiers, carte interactive, planification
-> de tournées (étapes, optimisation, navigation Waze/Maps, feuille de route PDF) et onglet « Carte »
-> dans les fiches Client/Fournisseur. **Hors scope : tout rapport de visite** (compte-rendu, note,
-> offres de prix, fichiers, saisie vocale) et le mode terrain mobile dédié.
-
-## 1. Contexte & objectif
-
-Donner aux commerciaux terrain (technico-commerciaux agricoles : visites d'exploitations, coopératives,
-négoces) un outil de **planification de tournées** intégré à Starseed, reposant sur le référentiel Tiers
-existant (Clients M1 + Fournisseurs M2). Fonctionne sur **desktop et mobile/tablette** (responsive, pas
-d'offline en V1).
-
-Le commercial doit pouvoir :
-
-1. Voir ses Tiers sur une **carte interactive** (pins colorés par type : client / fournisseur / prospect / custom).
-2. **Construire une tournée lui-même** : ajouter des étapes (une étape = une adresse précise d'un Tiers ou un
-   point libre), les **réordonner en drag & drop**, fixer une **heure de départ**.
-3. Obtenir le **temps total** et le **temps entre chaque étape** (calcul auto), avec heure d'arrivée estimée.
-4. Cliquer **« Trajet logique »** (V1, heuristique gratuite) puis **« Optimiser »** (V2, routier réel) pour
-   ordonner les étapes au mieux.
-5. **Lancer la navigation** (Waze / Google Maps / Plan) vers une étape en un tap.
-6. **Dupliquer** une tournée et **exporter une feuille de route PDF**.
-7. Consulter un **onglet « Carte »** dans la fiche Client/Fournisseur affichant les adresses géolocalisées du Tiers.
-
-## 2. Inspiration — logiciels de tournée de référence
-
-| Logiciel | Pattern repris | Application Starseed |
-|---|---|---|
-| **Badger Maps** | *Lasso tool* : on entoure des Tiers sur la carte → route optimisée auto. Pins colorés par type. | Sélection lasso/rectangle sur la carte pour bâtir la tournée. Pins par type. |
-| **SPOTIO** | Réordonnancement **drag & drop**, lieu de départ + bouton *Optimize*. | Liste d'étapes draggable, point de départ paramétrable, boutons « Trajet logique » / « Optimiser ». |
-| **Portatour** | Optimisation en quelques secondes, temps entre RDV. | Durée de visite paramétrable par étape, intégrée au temps total. |
-| **Nomadia Field Sales** | Carte + tournée dans un outil mobile responsive. | Écran de planification responsive desktop + mobile. |
-
-## 3. Décisions d'architecture
-
-### 3.1 Nouveau module `field_sales`
-
-La tournée est **transverse** : elle vise aussi bien des Clients (M1) que des Fournisseurs (M2). Module dédié
-`src/Module/FieldSales/` (ID `field_sales`, label « Tournées »), `REQUIRED = false` (activable via
-`config/modules.php`).
-
-**Règle ABSOLUE n°1 respectée** : `FieldSales` n'importe **aucune** classe de `Commercial`. Il référence les
-Tiers visités via un **contrat partagé** `App\Shared\Domain\Contract\VisitableInterface` (`getId()`,
-`getDisplayName()`, `getVisitableType()` = `client|supplier`) résolu par `resolve_target_entities`, comme
-`ClientAddress` référence `SiteInterface` / `CategoryInterface`.
-
-### 3.1.bis Une étape vise tout Tiers — et même un point libre
-
-Une étape n'est pas limitée à Client/Fournisseur : elle vise **tout type de Tiers** (Client, Fournisseur,
-**Prestataire** à venir) via `VisitableInterface` (extensible sans toucher au module FieldSales), **ou un point
-`custom`** (prospect/RDV sans fiche : libellé + adresse + coordonnées saisis à la main). L'enum `tier_type` est
-volontairement **ouvert** (string + Assert\Choice = types Visitable enregistrés + `custom`).
-
-### 3.2 Géolocalisation portée par l'adresse Tiers — **FAIT (ticket M6.1 / ERP-122)**
-
-`latitude` / `longitude` / `geo_manual` / `geocoded_at` sur `client_address` et `supplier_address`, géocodage
-api-adresse.data.gouv.fr + pin ajustable. Prérequis routage : une étape sans coordonnées reste utilisable mais
-**exclue du calcul de trajet** (badge « à géolocaliser »).
-
-### 3.3 Carte interactive — Leaflet + OpenStreetMap (pas Google Maps JS)
-
-Pour l'**affichage** carte/pins : **Leaflet** + tuiles **OpenStreetMap** (ou IGN). Gratuit, RGPD-friendly, pas
-de clé facturée pour le rendu. Composant carte encapsulé dans `frontend/modules/field-sales/` ; côté
-formulaire/filtre on reste sur les composants `Malio*`. La carte est une **exception documentée** à
-`@malio/layer-ui` (type non couvert). Le **routing réel** (matrice de temps) est un service distinct (§ 3.4).
-
-### 3.4 Stratégie de calcul de trajet — phasée
-
-| Phase | Bouton | Moteur | Coût |
-|---|---|---|---|
-| **V1** | « Trajet logique » | Heuristique maison **plus proche voisin** (Haversine), départ fixé. Temps estimé = distance × vitesse moyenne paramétrable. | 0 € |
-| **V2** | « Optimiser » | **Matrix API** (temps routiers réels) + optimisation TSP (OpenRouteService / OSRM / Mapbox). | Par appel (cache, debounce) |
-
-Contrat `RouteEngineInterface` (`computeMatrix`, `optimizeOrder`, `estimateLegDurations`) posé dès la V1 avec
-`HaversineRouteEngine`. La V2 ajoute `OrsRouteEngine` sans toucher au front. **On n'écrit jamais l'algo routier
-— on branche un fournisseur.**
-
-### 3.5 IDs entier auto-increment, Audit, Timestampable/Blamable
-
-Cohérent avec M0/M1/M2. Toutes les entités métier : `#[Auditable]`, `implements TimestampableInterface,
-BlamableInterface` + `use TimestampableBlamableTrait`. Entités auditées : `Tour`, `TourStop`.
-
-## 4. Modèle de données
-
-### 4.1 Adresses Tiers (M1 + M2) — **FAIT (ERP-122)**
-
-Colonnes `latitude` NUMERIC(10,7), `longitude` NUMERIC(10,7), `geo_manual` BOOLEAN, `geocoded_at` TIMESTAMPTZ
-sur `client_address` et `supplier_address` ; contrat `GeolocatableAddressInterface` côté `Shared`.
-
-### 4.2 `Tour` (tournée) — `tour`
-
-| Champ | Type | Règle |
-|---|---|---|
-| `id` | int PK | |
-| `owner_id` | FK User | Commercial propriétaire. Tournée **personnelle** (RG-6.01). |
-| `label` | varchar(120) | Nom libre. NotBlank. |
-| `tour_date` | date | Date de réalisation. NotBlank. |
-| `departure_time` | time | Heure de départ (alimente les ETA). Défaut 08:00. |
-| `start_latitude` / `start_longitude` | numeric null | Point de départ (site commercial ou adresse libre). NULL → départ = 1re étape. |
-| `start_label` | varchar(180) null | Libellé du point de départ. |
-| `default_visit_minutes` | smallint default 30 | Durée de visite par défaut (temps total). |
-| `status` | enum `draft\|planned\|in_progress\|done` | Cycle de vie (RG-6.02). |
-| `total_distance_m` / `total_duration_s` | int null | Derniers totaux calculés (cache d'affichage). |
-
-`#[Auditable]`, Timestampable/Blamable, soft delete (`deleted_at`). `GetCollection` paginée, filtrée par owner.
-
-### 4.3 `TourStop` (étape) — `tour_stop`
-
-| Champ | Type | Règle |
-|---|---|---|
-| `id` | int PK | |
-| `tour_id` | FK Tour | onDelete CASCADE. |
-| `tier_type` | string `client\|supplier\|…\|custom` | Cible (résolue via `VisitableInterface`). `custom` = point libre. |
-| `tier_id` | int null | ID du Tiers référentiel. NULL si `custom`. |
-| `address_id` | int null | Adresse précise visitée (un Tiers a plusieurs adresses — RG-6.03). NULL si `custom`. |
-| `custom_label` | varchar(180) null | Libellé du point libre (obligatoire ssi `custom`). |
-| `custom_address` | varchar(255) null | Adresse texte du point libre (ssi `custom`), géocodée. |
-| `custom_latitude` / `custom_longitude` | numeric null | Coordonnées du point libre (pin ajustable). |
-| `position` | smallint | Ordre dans la tournée (drag & drop). |
-| `visit_minutes` | smallint null | Durée de visite spécifique (sinon `tour.default_visit_minutes`). |
-| `leg_distance_m` / `leg_duration_s` | int null | Distance/temps **depuis l'étape précédente** (calculés). |
-| `eta` | time null | Heure d'arrivée estimée. |
-
-`#[Auditable]`, Timestampable/Blamable. Unicité `(tour_id, position)`. **Pas** de rapport rattaché (scope réduit).
-
-> Deux étapes peuvent viser le même Tiers (RG-6.07) — pas d'unicité sur `tier_id`.
-
-## 5. API (API Platform — providers/processors, jamais de controller)
-
-| Méthode | Endpoint | Sécurité | Note |
-|---|---|---|---|
-| GET | `/api/tours` | `field_sales.tours.view` | Paginé, filtré sur `owner` courant (admin/bureau voient tout). |
-| POST | `/api/tours` | `field_sales.tours.manage` | Crée une tournée draft. |
-| GET/PATCH/DELETE | `/api/tours/{id}` | view / manage | DELETE = soft delete. |
-| POST | `/api/tours/{tourId}/stops` | `field_sales.tours.manage` | Sous-ressource (Link toProperty `tour`, pattern ClientAddress). |
-| PATCH/DELETE | `/api/tour_stops/{id}` | `field_sales.tours.manage` | PATCH `position` = drag & drop. |
-| POST | `/api/tours/{id}/compute` | `field_sales.tours.manage` | Recalcule legs + ETA + totaux (`HaversineRouteEngine`). |
-| POST | `/api/tours/{id}/optimize` | `field_sales.tours.manage` | Réordonne via `optimizeOrder()` puis recompute. |
-| POST | `/api/tours/{id}/duplicate` | `field_sales.tours.manage` | Duplique étapes + départ à une nouvelle `tourDate` (RG-6.13). |
-| GET | `/api/tours/{id}/roadbook.pdf` | `field_sales.tours.view` | Feuille de route PDF (skill `pdf`). |
-| GET | `/api/visitable_tiers?bbox=...&q=...&type=client,supplier` | `field_sales.tours.view` | Pins dans la zone visible (carte). Paginé / `?pagination=false`. |
-
-Toutes les collections sont **paginées** (règle ABSOLUE n°13). `/api/visitable_tiers` retourne un Paginator,
-borné par `bbox`.
-
-## 6. Écrans
-
-### 6.1 Planification de tournée (carte interactive — responsive desktop + mobile)
-
-Layout **split** inspiré de Badger/SPOTIO :
-
-- **Carte interactive Leaflet** : pins des Tiers de la zone (couleur par type, filtrables). Sélection
-  **lasso/rectangle** → ajoute les Tiers entourés comme étapes. Clic pin → popup (nom, adresse, « + Ajouter »).
-  Tracé de la tournée dessiné par-dessus (polyline numérotée).
-- **Panneau tournée** : nom, date, **heure de départ**, point de départ, liste d'**étapes draggable**
-  (n° + nom + adresse + ETA + temps depuis étape précédente), totaux (distance / durée / nb visites).
-  Boutons **« Trajet logique »**, **« Optimiser »**, **« Dupliquer »**, **« PDF »**.
-- Chaque étape : menu **« Y aller »** (Waze / Google Maps / Plan via deep links), « Voir le Tiers ».
-- Ajout d'un **point libre `custom`** (libellé + adresse + pin).
-- En mobile, layout empilé : la navigation se fait via le bouton « Y aller » de chaque étape (pas de mode
-  terrain dédié).
-
-### 6.2 Onglet « Carte » dans la fiche Client / Fournisseur
-
-Nouvel onglet **« Carte »** dans la fiche **Client (M1)** et **Fournisseur (M2)** : **mini-carte Leaflet**
-affichant **toutes les adresses géolocalisées du Tiers** (un marqueur par adresse, popup avec le libellé de
-l'adresse). Vue d'ensemble des implantations du Tiers. Le **pin reste ajustable** par adresse (réutilise le
-composant de l'onglet Adresse, déjà livré en ERP-122). Adresses sans coordonnées listées comme
-« à géolocaliser ». Onglet visible sous `field_sales.tours.view` ; masqué si le module `field_sales` est désactivé.
-
-### 6.3 Ajustement du pin (fiche adresse) — **FAIT (ERP-122)**
-
-Mini-carte Leaflet avec marqueur déplaçable dans le bloc adresse M1/M2 ; drag → `latitude/longitude` +
-`geo_manual = true` ; bouton « Re-géocoder depuis l'adresse ».
-
-## 7. Géocodage des adresses — **FAIT (ERP-122)**
-
-Service `GeocoderInterface` / `BanGeocoder` (api-adresse.data.gouv.fr). Correction manuelle systématique via le
-pin (`geo_manual = true` fige — RG-6.08).
-
-## 8. RBAC — 3 miroirs obligatoires
-
-Permissions du module `field_sales` (méthode `permissions()` de `FieldSalesModule.php`) — **uniquement les
-tournées** (plus de permissions `reports.*` depuis la réduction de scope) :
-
-| Permission | Sens | Admin | Commerciale | Bureau |
-|---|---|---|---|---|
-| `field_sales.tours.view` | Voir les tournées + l'onglet Carte. | ✅ (toutes) | ✅ (les siennes) | ✅ (consultation) |
-| `field_sales.tours.manage` | Créer/éditer/optimiser/dupliquer/supprimer une tournée. | ✅ | ✅ | ❌ |
-
-Attribution : **Commerciale + Admin** = manage ; **Bureau** = view ; Compta exclue. À synchroniser dans les
-**3 miroirs** (règle ABSOLUE n°8) : `config/sidebar.php` (section « Tournées » : item `tours` + i18n
-`sidebar.field_sales.*`), `frontend/tests/e2e/_fixtures/personas.ts`, `SeedE2ECommand.php`. Sync :
-`app:sync-permissions`.
-
-## 9. Conventions & garde-fous (rappel)
-
-- `declare(strict_types=1);` partout ; commentaires FR, code EN.
-- Entités métier : `#[Auditable]` + Timestampable/Blamable. Libellés i18n `audit.entity.field_sales_tour` /
-  `_tourstop` dans `fr.json` (sinon `AuditableEntitiesHaveI18nLabelTest` casse `make test`).
-- Migration modulaire : `COMMENT ON COLUMN` sur **chaque** colonne (FR ≤ 200 car.) + helper
-  `addStandardTimestampableBlamableComments()`.
-- Toute collection paginée (`CollectionsArePaginatedTest`).
-- Front : `useApi()` uniquement, composants `Malio*`, `MalioDataTable` + `usePaginatedList` pour les listes,
-  **pas d'état de tableau dans l'URL**. Carte Leaflet = exception documentée.
-
-## 10. Règles de gestion (RG)
-
-| RG | Règle | Garde-fou |
-|---|---|---|
-| **RG-6.01** | Tournée **personnelle** (`owner`). Commerciale ne voit/édite que les siennes ; Admin/Bureau voient tout en lecture. | Filtre Provider sur `owner` + RBAC. |
-| **RG-6.02** | Cycle de vie `draft → planned → in_progress → done` (transitions libres en V1). | Enum + Assert\Choice. |
-| **RG-6.03** | Une étape sur Tiers référentiel vise une adresse de ce Tiers (qui en a plusieurs). Ne s'applique pas aux `custom`. | Assert\Callback. |
-| **RG-6.05** | Une étape n'entre dans le calcul que si son adresse a `latitude` ET `longitude`. Sinon « à géolocaliser », exclue des totaux. | `RouteEngine` + signalement front. |
-| **RG-6.07** | Deux étapes peuvent viser le même Tiers (repasser plus tard). Unicité uniquement sur `(tour_id, position)`. | Index unique partiel. |
-| **RG-6.08** | `geo_manual = true` fige les coordonnées (le géocodage auto ne réécrit plus). | Garde dans le géocodeur (FAIT). |
-| **RG-6.11** | `eta` = `departure_time` + Σ(trajets précédents) + Σ(durées de visite précédentes). | `RouteEngine::estimateLegDurations()`. |
-| **RG-6.12** | Une étape vise tout Tiers ou un point `custom`. Si `custom` : `tier_id`/`address_id` NULL, `custom_label` + coordonnées obligatoires. | Assert\Choice + Assert\Callback. |
-| **RG-6.13** | Dupliquer copie départ + étapes (ordre/adresses/durées) à une nouvelle date ; ne copie pas les calculs (ETA/legs recalculés). | Service `TourDuplicator`. |
-
-## 11. Tests à automatiser
-
-- **Architecture (cassent `make test`)** : `ColumnsHaveSqlCommentTest`, `AuditableEntitiesHaveI18nLabelTest`
-  (`audit.entity.field_sales_tour` / `_tourstop`), `EntitiesAreTimestampableBlamableTest` (Tour, TourStop),
-  `CollectionsArePaginatedTest`, `EntityConstraintsHaveFrenchMessageTest`.
-- **Back (PHPUnit)** : RG-6.03 (adresse hors Tiers → 422), RG-6.05 (étape sans coord exclue), RG-6.07 (doublon
-  Tiers accepté), RG-6.11 (ETA), RG-6.12 (custom cohérent), RG-6.13 (duplication sans calculs), filtre `owner`,
-  `HaversineRouteEngine` (ordre plus proche voisin sur un jeu de coordonnées connu).
-- **Front (Vitest)** : `usePaginatedList` sur tournées, composable de planification (réordonnancement, totaux,
-  deep links), onglet Carte (marqueurs des adresses). **Pas de E2E** (règle d'or).
-
-## 12. Hors-périmètre (HP)
-
-- **HP-M6-1** : **rapport de visite** (compte-rendu, note /5, offres de prix, fichiers, catégorie, saisie
-  vocale, historique des visites) — **retiré du scope (V0.2)**, à réintroduire dans un module/lot ultérieur si besoin.
-- **HP-M6-2** : mode terrain mobile dédié (vue du jour + check-in) — retiré ; navigation via l'écran de
-  planification responsive.
-- **HP-M6-3** : routing routier réel + optimisation TSP (Matrix API) — V2 (V1 = heuristique Haversine).
-- **HP-M6-4** : suggestion automatique des Tiers « à visiter » (façon Portatour) — V2.
-- **HP-M6-5** : offline réel (PWA + synchro) — V3.
-- **HP-M6-6** : partage / affectation de tournées entre commerciaux, planning d'équipe — V3.
-- **HP-M6-7** : navigation multi-étapes poussée dans Waze (impossible techniquement) — navigation étape par étape.
-
-## 13. Phasage
-
-- **V1 (livrable)** : géoloc adresses + pin (FAIT) ; carte interactive + lasso ; tournée (création, drag & drop,
-  heure de départ, point de départ) sur tout Tiers + point `custom` ; **« Trajet logique »** + ETA + totaux ;
-  deep links Waze/Maps ; **duplication** ; **feuille de route PDF** ; **onglet Carte** dans les fiches
-  Client/Fournisseur ; responsive desktop + mobile.
-- **V2** : bouton **« Optimiser »** (routing routier réel ORS/OSRM), temps trafic, suggestion des Tiers proches.
-- **V3** : offline réel, partage/affectation de tournées.
-
-## 14. Risques / points ouverts
-
-- **Coût/quota routing en V2** : multi-tenant → cache, debounce, plafonds par tenant.
-- **Limite Waze multi-étapes** : Waze ne prend qu'une destination → navigation étape par étape (assumé).
-- **Reste à cadrer techniquement** : périmètre de visibilité Bureau (toutes les tournées vs les siennes).
-
----
-
-## 📦 Tickets Lesstime (scope réduit V0.2)
-
-TaskGroup Lesstime : **#28 — M6 Tournées commerciales terrain** (projet STARSEED #6). Tickets gros grain, chacun
-avec un **prompt Fable** prêt à coller (consigne « adapte-toi à la config actuelle » incluse).
-
-| # | Réf | Ticket | Effort | Tag | État |
-|---|---|---|---|---|---|
-| M6.1 | ERP-122 | Géolocaliser les adresses Tiers (lat/lng + pin) | L | Back+Front | ✅ Fait |
-| M6.2 | ERP-123 | Fondations module field_sales + VisitableInterface + RBAC (tournées) | M | Back | Prêt à dev |
-| M6.3 | ERP-124 | Entités & API Tournée + Étape | L | Back | Prêt à dev |
-| M6.4 | ERP-125 | Calcul trajet, optimisation, duplication & roadbook PDF | L | Back | Prêt à dev |
-| M6.5 | ERP-127 | Carte interactive + écran planification (responsive) | L | Front | Prêt à dev |
-| M6.6 | ERP-129 | Onglet « Carte » dans les fiches Client & Fournisseur | M | Front | Prêt à dev |
-| M6.7 | ERP-130 | Vérification : garde-fous archi, tests RG & golden path | M | Back+Front | Prêt à dev |
-
-Supprimés à la réduction de scope : **ERP-126** (rapport de visite) et **ERP-128** (mode terrain mobile + formulaire rapport).
-
-Ordre d'exécution : M6.2 → M6.3 → M6.4 → M6.5 → M6.6 → M6.7.
-
----
-
-### Sources d'inspiration (logiciels de référence)
-- Badger Maps — *Lasso* + carte : https://www.badgermapping.com/features/
-- SPOTIO — drag & drop des étapes + optimize : https://support.spotio.com/hc/en-us/articles/360061370754-Routing-How-to-Build-and-Manage-Routes
-- Portatour — multi-stop + recalcul auto : https://www.portatour.com/features/en
-- Nomadia Field Sales — carte + tournée mobile : https://www.nomadia.com/ressources/blog/logiciel-commerciaux-itinerants/

docs/specs/_RETEX-M1-pour-M2.md

@@ -0,0 +1,80 @@
+# RETEX M1 (Clients) → à appliquer pour M2 (Fournisseurs)
+
+> But : éviter de reproduire en M2 les erreurs de **contrat de sérialisation** qui ont bloqué M1.
+> ~80 % des frictions M1 venaient du contrat API (sérialisation / groupes / sous-ressources), **pas** du métier.
+> À lire AVANT de rédiger `spec-back.md` et `spec-front.md` du M2, et à garder ouvert pendant la rédaction.
+
+---
+
+## 0. TL;DR (les 3 erreurs à ne jamais refaire)
+
+1. **Affirmer qu'un champ est « embarqué » sans vérifier les 3 maillons de sérialisation.** En M1 : `Category.code` annoncé dans `client:read`, détail annoncé embarquant contacts/adresses/ribs → **faux dans le code**. Résultat : colonnes liste vides, onglets détail impossibles à peupler.
+2. **Livrer des sous-ressources en POST-only** (pas de `GetCollection`, pas d'embed) → le front ne peut pas lister les enfants de l'agrégat.
+3. **Écrire la spec/les tickets sur une intention, pas sur le contrat réel.** Le docblock `Client` décrivait un embed jamais implémenté.
+
+---
+
+## 1. Contrat de sérialisation : les 3 maillons obligatoires
+
+Pour **chaque champ affiché** (liste OU détail), la spec back doit prouver les trois maillons. Si un seul manque → le champ sort en quasi-IRI (`@id`/`@type` seulement) ou pas du tout.
+
+| Maillon | Question | Exemple M1 raté |
+|---|---|---|
+| (a) Groupe sur la **propriété** | `#[Groups([...])]` contient-il un read-group ? | `Supplier::$addresses` sans groupe → jamais sérialisé |
+| (b) Groupe dans le **`normalizationContext` de l'opération** | l'opération (`GetCollection`/`Get`) liste-t-elle ce groupe ? | `GetCollection` en `['client:read','default:read']` |
+| (c) Read-group de l'**entité imbriquée** dans le contexte parent | pour embarquer les champs d'une relation (catégorie, site…), le contexte parent inclut-il `category:read` / `site:read` ? | `Category.code` ∈ `category:read`, absent du contexte client → pas de `code` |
+
+**Règle de rédaction** : dans `spec-back.md`, faire un tableau « champ → groupe propriété → groupe(s) à ajouter au contexte de chaque opération » pour la liste ET le détail. Inclure explicitement les **relations imbriquées** (ex. catégories d'une adresse, sites d'une adresse).
+
+## 2. Collections enfant d'un agrégat : décider embed vs GetCollection, et câbler en ENTIER
+
+Décision à acter dès la spec back pour chaque sous-collection (contacts, adresses, RIB, lignes…) :
+
+- **Embed dans le détail (recommandé pour un agrégat DDD)** : poser `#[Groups(['<root>:item:read'])]` sur la propriété + ajouter au `normalizationContext` du `Get` racine les read-groups des entités enfant **et** de leurs relations imbriquées. 1 requête, cohérent avec un composable `useX(id)`. Réservé aux ensembles **bornés** (ne viole pas la règle n°13 : elle vise les collections exposées, pas un embed borné d'item).
+- **GetCollection sous-ressource** : `/<root>/{id}/children` paginé. À réserver aux collections potentiellement volumineuses. Si choisi, **créer l'opération** (pas seulement POST).
+
+❌ Anti-pattern M1 : sous-ressources avec `POST` + `Get` unitaire seulement → **aucun moyen de lister** (ids non découvrables). Interdit.
+
+## 3. Vérifier le contrat sur l'API RÉELLE avant d'écrire les tickets front
+
+Le blocage M1 (codes/sites/sous-collections) aurait été vu en 5 min. À mettre dans la **definition of done de la spec back** :
+
+> Créer un enregistrement de test, appeler `GET /api/<resource>` (liste) ET `GET /api/<resource>/{id}` (détail), **coller la réponse JSON réelle** dans la spec. Toute donnée affichée par le front doit apparaître dans ce JSON collé.
+
+## 4. La spec décrit le RÉEL, pas l'intention
+
+- Bannir les « devrait être embarqué », « est exposé » non vérifiés. Décrire ce qui existe (ou ce qui sera livré dans le ticket, en le marquant clairement « à livrer »).
+- Si un docblock/commentaire existant contredit le code, le **corriger**, pas le recopier.
+
+## 5. Réutiliser les acquis M1 (ne pas réinventer)
+
+- **Taxonomie ERP-78** : si M2 catégorise les fournisseurs, repartir du modèle **type unique + `code` stable** (slug MAJUSCULE auto-généré, NOT NULL, figé, **lecture seule** `category:read`), filtrage métier via `?categoryCode=`. Réutiliser le contrat partagé `CategoryInterface` (pas d'import inter-module).
+- **Front** : `usePaginatedList` (listes), composants `Malio*`, `useApi()`, `formatPhoneFR`, blocs réutilisables (Contact/Adresse), pattern de blocs dynamiques + modal de confirmation.
+- **Archive** : flag `is_archived` **distinct** de `deleted_at` (soft delete). Restauration → gérer le 409 homonyme.
+- **Normalisation = serveur** (UPPERCASE nom société, Capitalize noms, lowercase email, téléphone en chiffres). Le front envoie la saisie, réaffiche la valeur normalisée renvoyée. À documenter dans la spec.
+- **Gating fin + mode strict PATCH** : PATCH par groupe de sérialisation ; tout champ hors-permission dans le payload = **403 sur l'intégralité** (pas de filtrage silencieux). Spécifier la matrice rôle × onglet.
+
+## 6. Règles ABSOLUES transverses à rappeler dans la spec M2
+
+- **Pagination obligatoire** (règle n°13) sur toute `GetCollection` ; échappatoire `?pagination=false` réservée aux selects de référentiels bornés.
+- **`COMMENT ON COLUMN`** (règle n°12) sur chaque colonne créée/modifiée (sinon `make test` casse). Helper standard pour les colonnes Timestampable/Blamable.
+- **Timestampable + Blamable** sur toute nouvelle entité métier (4 colonnes + trait) ; garde-fou archi.
+- **`#[Auditable]`** sur les entités métier ; **`#[AuditIgnore]`** sur les champs sensibles (équivalents BIC/IBAN/secret).
+- **`declare(strict_types=1);`** partout ; commentaires FR, code EN.
+- **Routes front à plat** (pas de préfixe module), état tableau **jamais** dans l'URL.
+- **3 miroirs RBAC** à toucher ensemble : `config/sidebar.php`, `frontend/tests/e2e/_fixtures/personas.ts`, `SeedE2ECommand.php`.
+- **Communication inter-module** uniquement via `Shared/Domain/Contract/` ou domain events — jamais d'import direct.
+
+## 7. Fixtures & seed dès le départ
+
+M1 a subi un aller-retour (ERP-68) faute de fixtures alignées. Pour M2 : prévoir dès la spec un seed de fournisseurs démo **couvrant tous les cas des règles métier** (relations, catégories codées, archivés, cas comptables) + comptes de rôles démo, pour vérifier le gating et le golden path sans bricolage.
+
+## 8. Mini-checklist de relecture de la spec M2 (avant de la déclarer prête)
+
+- [ ] Chaque champ affiché (liste + détail) a ses 3 maillons de sérialisation documentés (propriété, contexte opération, relations imbriquées).
+- [ ] Chaque sous-collection a une décision **embed vs GetCollection** explicite et **complètement câblée** (pas de POST-only).
+- [ ] Réponses JSON réelles (liste + détail) collées dans la spec back.
+- [ ] Matrice RBAC rôle × écran × onglet + mode strict PATCH spécifiés.
+- [ ] Pagination, COMMENT ON COLUMN, Timestampable/Blamable, Audit, routes à plat : rappelés.
+- [ ] Réutilisations M1 identifiées (taxonomie code, usePaginatedList, blocs, archive, normalisation).
+- [ ] Seed/fixtures démo planifiés.

frontend/i18n/locales/fr.json

@@ -2,6 +2,7 @@
     "common": {
         "loading": "Chargement...",
         "save": "Enregistrer",
+        "validate": "Valider",
         "cancel": "Annuler",
         "delete": "Supprimer",
         "edit": "Modifier",
@@ -30,6 +31,18 @@
             "clients": "Répertoire clients",
             "suppliers": "Répertoire fournisseurs"
         },
+        "technique": {
+            "section": "Technique",
+            "providers": "Répertoire prestataires"
+        },
+        "transport": {
+            "section": "Transport",
+            "carriers": "Répertoire transporteurs"
+        },
+        "logistique": {
+            "section": "Logistique",
+            "weighing_tickets": "Tickets de pesée"
+        },
         "core": {
             "roles": "Gestion des rôles",
             "users": "Utilisateurs",
@@ -40,123 +53,15 @@
         },
         "catalog": {
             "categories": "Gestion des catégories"
-        },
-        "field_sales": {
-            "section": "Tournées",
-            "tours": "Tournées"
         }
     },
     "dashboard": {
         "title": "Tableau de bord",
         "welcome": "Bienvenue sur Starseed"
     },
-    "field_sales": {
-        "tours": {
-            "title": "Tournées",
-            "add": "Nouvelle tournée",
-            "empty": "Aucune tournée pour l'instant.",
-            "column": {
-                "label": "Nom",
-                "date": "Date",
-                "status": "Statut",
-                "stops": "Étapes",
-                "distance": "Distance",
-                "duration": "Durée"
-            },
-            "status": {
-                "draft": "Brouillon",
-                "planned": "Planifiée",
-                "in_progress": "En cours",
-                "done": "Terminée"
-            },
-            "new": {
-                "title": "Nouvelle tournée",
-                "label": "Nom de la tournée",
-                "date": "Date",
-                "create": "Créer la tournée",
-                "cancel": "Annuler",
-                "error": "Impossible de créer la tournée."
-            }
-        },
-        "plan": {
-            "title": "Planification",
-            "back": "Retour aux tournées",
-            "panel": {
-                "title": "Tournée",
-                "label": "Nom de la tournée",
-                "date": "Date",
-                "departureTime": "Heure de départ",
-                "startLabel": "Point de départ",
-                "startModeSite": "Mes sites",
-                "startModeCustom": "Adresse libre",
-                "startSitePrefix": "Site de {name}",
-                "startSitePlaceholder": "Choisir un site…",
-                "startNoResults": "Adresse introuvable — saisie conservée.",
-                "defaultVisitMinutes": "Durée de visite (min)",
-                "stops": "Étapes",
-                "noStops": "Aucune étape. Sélectionnez des Tiers sur la carte ou ajoutez un point libre.",
-                "distance": "Distance",
-                "duration": "Durée totale",
-                "visits": "Visites"
-            },
-            "actions": {
-                "compute": "Trajet logique",
-                "optimize": "Optimiser",
-                "duplicate": "Dupliquer",
-                "pdf": "PDF",
-                "save": "Enregistrer"
-            },
-            "stop": {
-                "eta": "Arrivée",
-                "fromPrevious": "depuis l'étape précédente",
-                "toGeolocate": "À géolocaliser",
-                "goThere": "Y aller",
-                "viewTier": "Voir le Tiers",
-                "remove": "Supprimer l'étape",
-                "waze": "Waze",
-                "google": "Google Maps",
-                "apple": "Plan (Apple)"
-            },
-            "map": {
-                "typeClient": "Clients",
-                "typeSupplier": "Fournisseurs",
-                "search": "Rechercher un Tiers",
-                "add": "Ajouter",
-                "startPoint": "Point de départ",
-                "lassoHint": "Maintenez Maj et dessinez un rectangle pour sélectionner plusieurs Tiers."
-            },
-            "duplicateModal": {
-                "title": "Dupliquer la tournée",
-                "date": "Date de la nouvelle tournée",
-                "confirm": "Dupliquer",
-                "cancel": "Annuler"
-            },
-            "toast": {
-                "computeError": "Le calcul du trajet a échoué.",
-                "optimizeError": "L'optimisation a échoué.",
-                "duplicateError": "La duplication a échoué.",
-                "saveError": "L'enregistrement a échoué.",
-                "loadError": "Impossible de charger la tournée.",
-                "stopError": "L'opération sur l'étape a échoué.",
-                "duplicated": "Tournée dupliquée."
-            }
-        }
-    },
     "commercial": {
         "title": "Commercial",
         "welcome": "Module Commercial",
-        "geo": {
-            "title": "Position géographique",
-            "toGeolocate": "À géolocaliser",
-            "manualPin": "Pin ajusté manuellement",
-            "dragHint": "Déplacez le marqueur pour ajuster la position exacte (lieu-dit, entrée de site...).",
-            "regeocode": "Re-géocoder depuis l'adresse",
-            "regeocodeFailed": "Adresse introuvable — position inchangée.",
-            "map": {
-                "noLocated": "Aucune adresse géolocalisée à afficher sur la carte.",
-                "missingTitle": "Adresses à géolocaliser"
-            }
-        },
         "suppliers": {
             "title": "Répertoire fournisseurs",
             "add": "Ajouter",
@@ -174,7 +79,7 @@
                 "categories": "Catégories",
                 "sites": "Sites",
                 "status": "Statut",
-                "includeArchived": "Inclure les archivés",
+                "archivedOnly": "Voir les archivés",
                 "apply": "Voir les résultats",
                 "reset": "Réinitialiser"
             },
@@ -197,8 +102,7 @@
                 "accounting": "Comptabilité",
                 "statistics": "Statistiques",
                 "reports": "Rapports",
-                "exchanges": "Échanges",
-                "carte": "Carte"
+                "exchanges": "Échanges"
             },
             "action": {
                 "edit": "Modifier",
@@ -224,7 +128,7 @@
                 "back": "Retour au répertoire",
                 "loading": "Chargement du fournisseur…",
                 "notFound": "Fournisseur introuvable.",
-                "save": "Valider"
+                "save": "Enregistrer"
             },
             "form": {
                 "title": "Ajouter un fournisseur",
@@ -331,8 +235,7 @@
                 "accounting": "Comptabilité",
                 "statistics": "Statistiques",
                 "reports": "Rapports",
-                "exchanges": "Échanges",
-                "carte": "Carte"
+                "exchanges": "Échanges"
             },
             "action": {
                 "edit": "Modifier",
@@ -368,7 +271,7 @@
                 "back": "Retour au répertoire",
                 "loading": "Chargement du client…",
                 "notFound": "Client introuvable.",
-                "save": "Valider"
+                "save": "Enregistrer"
             },
             "validation": {
                 "informationRequiredForCommercial": "Les informations de l'entreprise sont obligatoires pour le rôle Commerciale.",
@@ -472,6 +375,323 @@
             }
         }
     },
+    "technique": {
+        "providers": {
+            "title": "Répertoire prestataires",
+            "add": "Ajouter",
+            "export": "Exporter",
+            "empty": "Aucun prestataire pour l'instant.",
+            "column": {
+                "companyName": "Nom",
+                "categories": "Catégories",
+                "sites": "Site",
+                "lastActivity": "Dernière activité"
+            },
+            "filters": {
+                "title": "Filtres",
+                "search": "Recherche",
+                "categories": "Catégories",
+                "sites": "Sites",
+                "status": "Statut",
+                "archivedOnly": "Voir les archivés",
+                "apply": "Voir les résultats",
+                "reset": "Réinitialiser"
+            },
+            "tab": {
+                "contact": "Contact",
+                "contacts": "Contacts",
+                "address": "Adresse",
+                "reports": "Rapports",
+                "exchanges": "Échanges",
+                "accounting": "Comptabilité"
+            },
+            "action": {
+                "edit": "Modifier",
+                "archive": "Archiver",
+                "restore": "Restaurer"
+            },
+            "consultation": {
+                "title": "Fiche prestataire",
+                "back": "Retour au répertoire",
+                "loading": "Chargement…",
+                "notFound": "Prestataire introuvable.",
+                "confirmArchive": "Archiver ce prestataire ? Il n'apparaîtra plus dans le répertoire actif.",
+                "confirmRestore": "Restaurer ce prestataire ? Il réapparaîtra dans le répertoire actif."
+            },
+            "edit": {
+                "title": "Modifier le prestataire",
+                "back": "Retour à la fiche",
+                "loading": "Chargement…",
+                "notFound": "Prestataire introuvable.",
+                "save": "Enregistrer"
+            },
+            "form": {
+                "title": "Ajouter un prestataire",
+                "back": "Précédent",
+                "submit": "Valider",
+                "duplicateCompany": "Un prestataire portant ce nom de société existe déjà.",
+                "main": {
+                    "companyName": "Nom du prestataire (Entreprise)",
+                    "categories": "Catégorie",
+                    "sites": "Site"
+                },
+                "errors": {
+                    "nameRequired": "Le nom du prestataire est obligatoire.",
+                    "siteRequired": "Sélectionnez au moins un site.",
+                    "categoryRequired": "Sélectionnez au moins une catégorie."
+                },
+                "contact": {
+                    "lastName": "Nom",
+                    "firstName": "Prénom",
+                    "jobTitle": "Fonction",
+                    "email": "Email",
+                    "phonePrimary": "Téléphone",
+                    "phoneSecondary": "Téléphone (2)",
+                    "addPhone": "Ajouter un numéro",
+                    "remove": "Supprimer le contact",
+                    "add": "Nouveau contact"
+                },
+                "address": {
+                    "sites": "Sites",
+                    "categories": "Catégorie",
+                    "contacts": "Contact(s) rattaché(s)",
+                    "country": "Pays",
+                    "postalCode": "Code postal",
+                    "city": "Ville",
+                    "street": "Adresse",
+                    "streetNotFound": "Adresse introuvable ? Saisissez-la directement.",
+                    "streetComplement": "Adresse complémentaire",
+                    "remove": "Supprimer l'adresse",
+                    "add": "Nouvelle adresse",
+                    "degraded": "Service d'adresse indisponible : saisie de la ville et de l'adresse en mode libre."
+                },
+                "accounting": {
+                    "siren": "SIREN",
+                    "accountNumber": "Numéro de compte",
+                    "tvaMode": "Mode de TVA",
+                    "nTva": "N° de TVA",
+                    "paymentDelay": "Délai de règlement",
+                    "paymentType": "Type de règlement",
+                    "bank": "Banque",
+                    "ribLabel": "Libellé",
+                    "ribBic": "BIC",
+                    "ribIban": "IBAN",
+                    "addRib": "Ajouter un RIB",
+                    "removeRib": "Supprimer le RIB"
+                },
+                "confirmDelete": {
+                    "title": "Confirmer la suppression",
+                    "cancel": "Annuler",
+                    "confirm": "Supprimer",
+                    "contact": "Supprimer ce contact ?",
+                    "address": "Supprimer cette adresse ?",
+                    "rib": "Supprimer ce RIB ?"
+                }
+            },
+            "toast": {
+                "error": "Une erreur est survenue. Réessayez.",
+                "exportError": "L'export du répertoire prestataires a échoué. Réessayez.",
+                "createSuccess": "Prestataire créé avec succès",
+                "updateSuccess": "Prestataire mis à jour avec succès",
+                "addComplete": "Prestataire ajouté",
+                "archiveSuccess": "Prestataire archivé avec succès",
+                "restoreSuccess": "Prestataire restauré avec succès"
+            }
+        }
+    },
+    "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é",
+                "addressSaved": "Adresse enregistrée",
+                "contactSaved": "Contact enregistré",
+                "priceSaved": "Prix enregistré",
+                "updateSuccess": "Transporteur mis à jour avec succès",
+                "archiveSuccess": "Transporteur archivé avec succès",
+                "restoreSuccess": "Transporteur restauré avec succès"
+            },
+            "action": {
+                "edit": "Modifier",
+                "archive": "Archiver",
+                "restore": "Restaurer"
+            },
+            "consultation": {
+                "title": "Consultation transporteur",
+                "back": "Retour au répertoire",
+                "loading": "Chargement du transporteur…",
+                "notFound": "Transporteur introuvable.",
+                "confirmArchive": {
+                    "title": "Archiver le transporteur",
+                    "message": "Ce transporteur n'apparaîtra plus dans le répertoire actif. Confirmer l'archivage ?"
+                },
+                "confirmRestore": {
+                    "title": "Restaurer le transporteur",
+                    "message": "Ce transporteur réapparaîtra dans le répertoire actif. Confirmer la restauration ?"
+                },
+                "price": {
+                    "group": "Type de transport",
+                    "carrier": "Transporteurs",
+                    "aproOrSite": "Adresse sites",
+                    "delivery": "Adresse livraisons",
+                    "forfait": "Forfait (€)",
+                    "tonne": "Tonne (€)",
+                    "indexation": "Indexation",
+                    "state": "État du prix",
+                    "export": "Exporter",
+                    "empty": "Aucun prix pour ce transporteur."
+                }
+            },
+            "edit": {
+                "title": "Modifier le transporteur",
+                "back": "Retour à la consultation",
+                "loading": "Chargement du transporteur…",
+                "notFound": "Transporteur introuvable.",
+                "save": "Enregistrer"
+            },
+            "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é.",
+                    "searchHint": "Saisissez le nom du transporteur pour lancer la recherche.",
+                    "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é.",
+                    "uploadFailed": "Le téléversement de la décharge a échoué."
+                },
+                "address": {
+                    "country": "Pays",
+                    "postalCode": "Code postal",
+                    "city": "Ville",
+                    "street": "Adresse",
+                    "streetComplement": "Adresse complémentaire",
+                    "streetNotFound": "Adresse introuvable ? Saisissez-la directement.",
+                    "degraded": "Service d'adresse indisponible : saisie de la ville et de l'adresse en mode libre."
+                },
+                "contact": {
+                    "lastName": "Nom",
+                    "firstName": "Prénom",
+                    "jobTitle": "Fonction",
+                    "phonePrimary": "Téléphone",
+                    "phoneSecondary": "Téléphone (2)",
+                    "addPhone": "Ajouter un numéro",
+                    "email": "Email",
+                    "add": "Nouveau contact",
+                    "remove": "Supprimer le contact"
+                },
+                "confirmDelete": {
+                    "title": "Supprimer ce bloc",
+                    "message": "Cette suppression est définitive. Confirmer ?",
+                    "cancel": "Annuler",
+                    "confirm": "Supprimer"
+                },
+                "price": {
+                    "direction": "Sens",
+                    "directionClient": "Client",
+                    "directionSupplier": "Fournisseur",
+                    "client": "Client",
+                    "clientDeliveryAddress": "Adresse de livraison",
+                    "departureSite": "Adresse de départ",
+                    "supplier": "Fournisseur",
+                    "supplierSupplyAddress": "Adresse d'approvisionnement",
+                    "deliverySite": "Adresse de livraison",
+                    "containerType": "Benne / Fond mouvant",
+                    "pricingUnit": "Forfait / Tonne",
+                    "pricingForfait": "Forfait",
+                    "pricingTonne": "Tonne",
+                    "price": "Prix",
+                    "priceState": "État du prix",
+                    "stateEnCours": "En cours",
+                    "stateValide": "Validé",
+                    "stateNonValide": "Non validé",
+                    "add": "Nouveau prix",
+                    "remove": "Supprimer le prix",
+                    "errors": {
+                        "direction": "Le sens du prix est obligatoire.",
+                        "client": "Le client est obligatoire pour un prix client.",
+                        "clientDeliveryAddress": "L'adresse de livraison du client est obligatoire pour un prix client.",
+                        "departureSite": "Le site de départ est obligatoire pour un prix client.",
+                        "supplier": "Le fournisseur est obligatoire pour un prix fournisseur.",
+                        "supplierSupplyAddress": "L'adresse d'approvisionnement est obligatoire pour un prix fournisseur.",
+                        "deliverySite": "Le site de livraison est obligatoire pour un prix fournisseur.",
+                        "containerType": "Le type de contenant est obligatoire.",
+                        "pricingUnit": "L'unité de tarification est obligatoire.",
+                        "price": "Le prix est obligatoire.",
+                        "priceState": "L'état du prix est obligatoire."
+                    }
+                }
+            }
+        }
+    },
     "auth": {
         "login": "Connexion",
         "logout": "Deconnexion",
@@ -496,7 +716,10 @@
         },
         "title": "Erreur",
         "generic": "Une erreur est survenue.",
-        "unknown": "Erreur inconnue."
+        "unknown": "Erreur inconnue.",
+        "validation": {
+            "invalidDate": "Date invalide"
+        }
     },
     "sites": {
         "selector": {
@@ -511,21 +734,28 @@
             "delete": "Suppression"
         },
         "entity": {
-            "core_user":              "Utilisateur",
-            "core_role":              "Rôle",
-            "core_permission":        "Permission",
-            "sites_site":             "Site",
-            "catalog_category":       "Catégorie",
-            "commercial_client":      "Client",
+            "core_user": "Utilisateur",
+            "core_role": "Rôle",
+            "core_permission": "Permission",
+            "sites_site": "Site",
+            "catalog_category": "Catégorie",
+            "commercial_client": "Client",
             "commercial_clientaddress": "Adresse client",
             "commercial_clientcontact": "Contact client",
-            "commercial_clientrib":   "RIB client",
-            "commercial_supplier":    "Fournisseur",
+            "commercial_clientrib": "RIB client",
+            "commercial_supplier": "Fournisseur",
             "commercial_supplieraddress": "Adresse fournisseur",
             "commercial_suppliercontact": "Contact fournisseur",
             "commercial_supplierrib": "RIB fournisseur",
-            "fieldsales_tour":        "Tournée",
-            "fieldsales_tourstop":    "Étape de tournée"
+            "technique_provider": "Prestataire",
+            "technique_provideraddress": "Adresse prestataire",
+            "technique_providercontact": "Contact prestataire",
+            "technique_providerrib": "RIB prestataire",
+            "transport_carrier": "Transporteur",
+            "transport_carrieraddress": "Adresse transporteur",
+            "transport_carriercontact": "Contact transporteur",
+            "transport_carrierprice": "Prix transporteur",
+            "logistique_weighingticket": "Ticket de pesée"
         },
         "empty": "Aucune activité enregistrée",
         "no_results": "Aucun résultat pour ces filtres",

frontend/modules/catalog/components/CategoryDrawer.vue

@@ -59,7 +59,7 @@
             />
             <MalioButton
                 v-if="canShowSave"
-                :label="t('common.save')"
+                :label="isCreateMode ? t('common.validate') : t('common.save')"
                 variant="primary"
                 button-class="w-m-btn-action"
                 :disabled="form.submitting.value || loadingTypes"

frontend/modules/commercial/components/AddressGeoPin.vue

@@ -1,216 +0,0 @@
-<template>
-    <div data-testid="geo-pin">
-        <div class="mb-1 flex items-center gap-2">
-            <span class="text-sm font-medium text-gray-700">{{ t('commercial.geo.title') }}</span>
-            <!-- Badge « a geolocaliser » : adresse valide mais sans coordonnees
-                 (spec M6 § 3.2 — exclue du calcul de tournee, RG-6.05). -->
-            <span
-                v-if="!hasCoords"
-                class="inline-flex items-center rounded-full bg-yellow-100 px-2 py-0.5 text-xs font-medium text-yellow-800"
-                data-testid="geo-badge-missing"
-            >
-                {{ t('commercial.geo.toGeolocate') }}
-            </span>
-            <!-- Pin fige a la main (RG-6.08) : informatif. -->
-            <span
-                v-else-if="geoManual"
-                class="inline-flex items-center rounded-full bg-blue-100 px-2 py-0.5 text-xs font-medium text-blue-800"
-                data-testid="geo-badge-manual"
-            >
-                {{ t('commercial.geo.manualPin') }}
-            </span>
-        </div>
-
-        <!-- Mini-carte Leaflet (exception documentee a @malio/layer-ui : carte
-             interactive, type non couvert par la lib — cf. frontend.md
-             § Composants formulaires). TODO : migrer si la lib couvre un jour
-             les cartes. -->
-        <div
-            v-if="hasCoords"
-            ref="mapEl"
-            class="h-48 w-full rounded border border-gray-200"
-            data-testid="geo-map"
-        />
-        <p v-if="hasCoords && !readonly" class="mt-1 text-xs text-gray-500">
-            {{ t('commercial.geo.dragHint') }}
-        </p>
-
-        <div v-if="!readonly" class="mt-2 flex items-center gap-4">
-            <MalioButton
-                variant="secondary"
-                :label="t('commercial.geo.regeocode')"
-                :disabled="regeocoding || !canRegeocode"
-                data-testid="geo-regeocode"
-                @click="regeocode"
-            />
-            <span v-if="regeocodeFailed" class="text-xs text-red-600" data-testid="geo-regeocode-failed">
-                {{ t('commercial.geo.regeocodeFailed') }}
-            </span>
-        </div>
-    </div>
-</template>
-
-<script setup lang="ts">
-import type { Map as LeafletMap, Marker } from 'leaflet'
-import { useAddressAutocomplete } from '~/shared/composables/useAddressAutocomplete'
-
-/**
- * Mini-carte d'ajustement du pin d'une adresse Tiers (M6.1, spec § 8.3).
- *
- * - Marqueur deplacable : au drag, emet les coordonnees corrigees avec
- *   geoManual = true (RG-6.08 : le geocodage auto ne reecrira plus). Le parent
- *   met a jour le brouillon ; la persistance suit le submit du formulaire
- *   (POST/PATCH de l'adresse), comme tous les champs du bloc.
- * - « Re-geocoder depuis l'adresse » : previsualise la position BAN cote front
- *   et emet geoManual = false — au save, le back (BanGeocoder) refait autorite
- *   et pose geocodedAt.
- * - Sans coordonnees : pas de carte, badge « a geolocaliser ».
- */
-const props = defineProps<{
-    /** Latitude WGS84 (chaine decimale) ou null si non geolocalisee. */
-    latitude: string | null
-    /** Longitude WGS84 (chaine decimale) ou null si non geolocalisee. */
-    longitude: string | null
-    /** RG-6.08 : pin deja corrige a la main. */
-    geoManual: boolean
-    /** Adresse postale a re-geocoder (« rue, code postal ville »). */
-    geocodeQuery: string | null
-    readonly?: boolean
-}>()
-
-const emit = defineEmits<{
-    /** Nouveau positionnement du pin (drag manuel ou re-geocodage previsualise). */
-    'update:coords': [value: { latitude: string, longitude: string, geoManual: boolean }]
-}>()
-
-const { t } = useI18n()
-const autocomplete = useAddressAutocomplete()
-
-const mapEl = ref<HTMLElement | null>(null)
-const regeocoding = ref(false)
-const regeocodeFailed = ref(false)
-
-const hasCoords = computed(() =>
-    props.latitude !== null && props.latitude !== ''
-    && props.longitude !== null && props.longitude !== '',
-)
-
-const canRegeocode = computed(() => (props.geocodeQuery ?? '').trim().length >= 3)
-
-// Instances Leaflet (hors reactivite Vue : un proxy sur la Map casse Leaflet).
-let map: LeafletMap | null = null
-let marker: Marker | null = null
-
-/** Zoom d'affichage du pin (niveau rue). */
-const PIN_ZOOM = 16
-
-/**
- * Monte la carte Leaflet dans le conteneur (import dynamique : la lib n'est
- * chargee que si l'adresse a des coordonnees).
- */
-async function ensureMap(): Promise<void> {
-    if (map !== null || mapEl.value === null || !hasCoords.value) {
-        return
-    }
-
-    const mod = await import('leaflet')
-    const L = mod.default ?? mod
-    await import('leaflet/dist/leaflet.css')
-
-    // Le conteneur peut avoir disparu pendant le chargement async (v-if).
-    if (mapEl.value === null) {
-        return
-    }
-
-    const position: [number, number] = [Number(props.latitude), Number(props.longitude)]
-
-    map = L.map(mapEl.value, { scrollWheelZoom: false }).setView(position, PIN_ZOOM)
-    L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
-        attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a>',
-        maxZoom: 19,
-    }).addTo(map)
-
-    // divIcon SVG inline : evite les assets PNG de Leaflet (chemins casses par
-    // le bundler Vite sans configuration dediee).
-    const icon = L.divIcon({
-        className: '',
-        html: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="28" height="40" fill="#2563eb" stroke="#1e40af" stroke-width="0.5"><path d="M12 0C7 0 3 4 3 9c0 6.6 9 15 9 15s9-8.4 9-15c0-5-4-9-9-9zm0 12.5A3.5 3.5 0 1 1 12 5.5a3.5 3.5 0 0 1 0 7z"/></svg>',
-        iconSize: [28, 40],
-        iconAnchor: [14, 40],
-    })
-
-    marker = L.marker(position, { icon, draggable: !props.readonly }).addTo(map)
-    marker.on('dragend', onMarkerDragEnd)
-}
-
-/** Drag du pin -> coordonnees corrigees + geoManual (RG-6.08). */
-function onMarkerDragEnd(): void {
-    if (marker === null) {
-        return
-    }
-    const position = marker.getLatLng()
-    emit('update:coords', {
-        latitude: position.lat.toFixed(7),
-        longitude: position.lng.toFixed(7),
-        geoManual: true,
-    })
-}
-
-/**
- * « Re-geocoder depuis l'adresse » : previsualisation BAN cote front. Emet
- * geoManual = false — le geocodage serveur refait autorite au save.
- */
-async function regeocode(): Promise<void> {
-    regeocodeFailed.value = false
-    const query = (props.geocodeQuery ?? '').trim()
-    if (query.length < 3) {
-        regeocodeFailed.value = true
-        return
-    }
-
-    regeocoding.value = true
-    try {
-        const coords = await autocomplete.geocode(query)
-        if (coords === null) {
-            regeocodeFailed.value = true
-            return
-        }
-        emit('update:coords', { ...coords, geoManual: false })
-    }
-    catch {
-        // BAN indisponible : position inchangee, message inline.
-        regeocodeFailed.value = true
-    }
-    finally {
-        regeocoding.value = false
-    }
-}
-
-// Coordonnees modifiees par le parent (drag deja applique, re-geocodage,
-// rechargement) : recale le marqueur, ou monte la carte si elle n'existe pas
-// encore (premieres coordonnees d'une adresse « a geolocaliser »).
-watch(
-    () => [props.latitude, props.longitude] as const,
-    async () => {
-        if (!hasCoords.value) {
-            return
-        }
-        if (map === null) {
-            await nextTick()
-            await ensureMap()
-            return
-        }
-        const position: [number, number] = [Number(props.latitude), Number(props.longitude)]
-        marker?.setLatLng(position)
-        map.panTo(position)
-    },
-)
-
-onMounted(ensureMap)
-
-onBeforeUnmount(() => {
-    map?.remove()
-    map = null
-    marker = null
-})
-</script>

frontend/modules/commercial/components/ClientAddressBlock.vue

@@ -178,19 +178,6 @@
             />
         </div>
 
-        <!-- Pin geographique de l'adresse (M6.1, spec § 8.3) : mini-carte avec
-             marqueur ajustable, persiste au submit comme le reste du bloc. -->
-        <div class="col-span-4">
-            <AddressGeoPin
-                :latitude="model.latitude"
-                :longitude="model.longitude"
-                :geo-manual="model.geoManual"
-                :geocode-query="geocodeQuery"
-                :readonly="readonly"
-                @update:coords="onCoordsUpdate"
-            />
-        </div>
-
     </div>
 </template>
 
@@ -200,7 +187,7 @@ import {
     addressTypeFromFlags,
     isBillingEmailRequired,
     type AddressType,
-} from '~/modules/commercial/utils/clientFormRules'
+} from '~/modules/commercial/utils/forms/clientFormRules'
 import { useAddressAutocomplete, type AddressSuggestion } from '~/shared/composables/useAddressAutocomplete'
 import type { CategoryOption, RefOption } from '~/modules/commercial/composables/useClientReferentials'
 import type { AddressFormDraft } from '~/modules/commercial/types/clientForm'
@@ -302,24 +289,6 @@ function update<K extends keyof AddressFormDraft>(field: K, value: AddressFormDr
     emit('update:modelValue', { ...props.modelValue, [field]: value })
 }
 
-// Adresse postale a re-geocoder (« rue, code postal ville ») — miroir du
-// getDisplayLabel() serveur (le complement bruite le geocodage, exclu).
-const geocodeQuery = computed<string | null>(() => {
-    const locality = [model.value.postalCode, model.value.city].filter(Boolean).join(' ')
-    const parts = [model.value.street, locality].filter(part => part && String(part).trim() !== '')
-    return parts.length > 0 ? parts.join(', ') : null
-})
-
-/** Pin deplace / re-geocode : repercute coordonnees + drapeau manuel (RG-6.08). */
-function onCoordsUpdate(coords: { latitude: string, longitude: string, geoManual: boolean }): void {
-    emit('update:modelValue', {
-        ...props.modelValue,
-        latitude: coords.latitude,
-        longitude: coords.longitude,
-        geoManual: coords.geoManual,
-    })
-}
-
 /** Revele le 2e champ email de facturation (clic sur le « + »). */
 function revealSecondaryBillingEmail(): void {
     emit('update:modelValue', { ...props.modelValue, hasSecondaryBillingEmail: true })

frontend/modules/commercial/components/SupplierAddressBlock.vue

@@ -162,19 +162,6 @@
             :readonly="readonly"
             @update:model-value="(v: boolean) => update('triageProvider', v)"
         />
-
-        <!-- Pin geographique de l'adresse (M6.1, spec § 8.3) : mini-carte avec
-             marqueur ajustable, persiste au submit comme le reste du bloc. -->
-        <div class="col-span-4">
-            <AddressGeoPin
-                :latitude="model.latitude"
-                :longitude="model.longitude"
-                :geo-manual="model.geoManual"
-                :geocode-query="geocodeQuery"
-                :readonly="readonly"
-                @update:coords="onCoordsUpdate"
-            />
-        </div>
     </div>
 </template>
 
@@ -256,24 +243,6 @@ function update<K extends keyof SupplierAddressFormDraft>(field: K, value: Suppl
     emit('update:modelValue', { ...props.modelValue, [field]: value })
 }
 
-// Adresse postale a re-geocoder (« rue, code postal ville ») — miroir du
-// getDisplayLabel() serveur (le complement bruite le geocodage, exclu).
-const geocodeQuery = computed<string | null>(() => {
-    const locality = [model.value.postalCode, model.value.city].filter(Boolean).join(' ')
-    const parts = [model.value.street, locality].filter(part => part && String(part).trim() !== '')
-    return parts.length > 0 ? parts.join(', ') : null
-})
-
-/** Pin deplace / re-geocode : repercute coordonnees + drapeau manuel (RG-6.08). */
-function onCoordsUpdate(coords: { latitude: string, longitude: string, geoManual: boolean }): void {
-    emit('update:modelValue', {
-        ...props.modelValue,
-        latitude: coords.latitude,
-        longitude: coords.longitude,
-        geoManual: coords.geoManual,
-    })
-}
-
 /** Previent le parent (toast unique) que l'autocompletion est indisponible. */
 function notifyUnavailable(): void {
     if (!unavailableNotified) {

frontend/modules/commercial/components/TierAddressMap.vue

@@ -1,230 +0,0 @@
-<template>
-    <div data-testid="tier-address-map">
-        <!-- Carte d'ensemble : un marqueur par adresse geolocalisee du Tiers,
-             cadree sur l'ensemble (fitBounds). Pin ajustable par drag (M6.6,
-             spec § 6.2) : au drag, PATCH direct des coordonnees + geoManual=true
-             (RG-6.08), sans passer par le formulaire d'edition. -->
-        <div
-            v-if="located.length > 0"
-            ref="mapEl"
-            class="h-96 w-full rounded border border-gray-200"
-            data-testid="tier-map"
-        />
-        <p v-else class="rounded border border-dashed border-gray-300 bg-gray-50 py-8 text-center text-sm text-gray-500">
-            {{ t('commercial.geo.map.noLocated') }}
-        </p>
-
-        <p v-if="located.length > 0 && editable" class="mt-1 text-xs text-gray-500">
-            {{ t('commercial.geo.dragHint') }}
-        </p>
-
-        <!-- Adresses sans coordonnees : listees a part (« a geolocaliser »),
-             exclues de la carte et du calcul de tournee (RG-6.05). -->
-        <div v-if="missing.length > 0" class="mt-6" data-testid="tier-map-missing-list">
-            <h3 class="mb-2 flex items-center gap-2 text-sm font-medium text-gray-700">
-                {{ t('commercial.geo.map.missingTitle') }}
-                <span class="inline-flex items-center rounded-full bg-yellow-100 px-2 py-0.5 text-xs font-medium text-yellow-800">
-                    {{ missing.length }}
-                </span>
-            </h3>
-            <ul class="flex flex-col gap-2">
-                <li
-                    v-for="address in missing"
-                    :key="address.id"
-                    class="rounded border border-gray-200 bg-white px-3 py-2 text-sm"
-                    data-testid="tier-map-missing"
-                >
-                    <span class="font-medium text-gray-800">{{ address.title }}</span>
-                    <span v-if="address.typeLabel" class="ml-2 text-xs text-gray-500">{{ address.typeLabel }}</span>
-                </li>
-            </ul>
-        </div>
-    </div>
-</template>
-
-<script lang="ts">
-import type { Map as LeafletMap, Marker } from 'leaflet'
-
-/**
- * Adresse normalisee pour la carte d'ensemble d'un Tiers. La page parente
- * (fiche Client / Fournisseur) construit la liste : elle resout le libelle, le
- * type traduit et l'endpoint PATCH des coordonnees (les modeles d'adresse
- * client/fournisseur different — drapeaux vs enum).
- */
-export interface TierMapAddress {
-    /** Id serveur de l'adresse. */
-    id: number
-    /** Latitude WGS84 (chaine decimale) ou null si non geolocalisee. */
-    latitude: string | null
-    /** Longitude WGS84 (chaine decimale) ou null si non geolocalisee. */
-    longitude: string | null
-    /** RG-6.08 : pin deja corrige a la main. */
-    geoManual: boolean
-    /** Libelle principal (rue + code postal ville). */
-    title: string
-    /** Type d'adresse traduit (Prospect / Livraison / Depart...). */
-    typeLabel: string
-    /** Endpoint PATCH des coordonnees (ex: /client_addresses/12). */
-    patchPath: string
-}
-</script>
-
-<script setup lang="ts">
-const props = withDefaults(defineProps<{
-    /** Toutes les adresses du Tiers (geolocalisees ou non). */
-    addresses: TierMapAddress[]
-    /** Drag du pin actif (PATCH des coordonnees) — exige le droit d'edition. */
-    editable?: boolean
-}>(), {
-    editable: false,
-})
-
-const emit = defineEmits<{
-    /** Coordonnees d'une adresse mises a jour par drag (PATCH reussi). */
-    updated: [value: { id: number, latitude: string, longitude: string }]
-}>()
-
-const { t } = useI18n()
-const api = useApi()
-
-const mapEl = ref<HTMLElement | null>(null)
-
-/** Vrai si l'adresse porte des coordonnees exploitables. */
-function hasCoords(address: TierMapAddress): boolean {
-    return address.latitude !== null && address.latitude !== ''
-        && address.longitude !== null && address.longitude !== ''
-}
-
-const located = computed(() => props.addresses.filter(hasCoords))
-const missing = computed(() => props.addresses.filter(a => !hasCoords(a)))
-
-// Instances Leaflet (hors reactivite Vue : un proxy casse l'API Leaflet).
-let L: typeof import('leaflet') | null = null
-let map: LeafletMap | null = null
-let markers: Marker[] = []
-
-/** Zoom max applique par fitBounds (evite un zoom excessif sur un seul pin). */
-const MAX_FIT_ZOOM = 16
-
-/** Monte la carte Leaflet (import dynamique : chargee seulement si besoin). */
-async function ensureMap(): Promise<void> {
-    if (map !== null || mapEl.value === null || located.value.length === 0) {
-        return
-    }
-
-    const mod = await import('leaflet')
-    L = mod.default ?? mod
-    await import('leaflet/dist/leaflet.css')
-
-    // Le conteneur peut avoir disparu pendant le chargement async (v-if).
-    if (mapEl.value === null) {
-        return
-    }
-
-    map = L.map(mapEl.value, { scrollWheelZoom: false })
-    L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
-        attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a>',
-        maxZoom: 19,
-    }).addTo(map)
-
-    renderMarkers()
-}
-
-/** Pin SVG inline (evite les assets PNG Leaflet casses par Vite). */
-function pinIcon() {
-    return L!.divIcon({
-        className: '',
-        html: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="28" height="40" fill="#2563eb" stroke="#1e40af" stroke-width="0.5"><path d="M12 0C7 0 3 4 3 9c0 6.6 9 15 9 15s9-8.4 9-15c0-5-4-9-9-9zm0 12.5A3.5 3.5 0 1 1 12 5.5a3.5 3.5 0 0 1 0 7z"/></svg>',
-        iconSize: [28, 40],
-        iconAnchor: [14, 40],
-        popupAnchor: [0, -36],
-    })
-}
-
-/** Contenu HTML du popup : libelle + type de l'adresse. */
-function popupHtml(address: TierMapAddress): string {
-    const title = escapeHtml(address.title)
-    const type = address.typeLabel ? `<div class="text-gray-600">${escapeHtml(address.typeLabel)}</div>` : ''
-    return `<div class="text-sm"><div class="font-semibold">${title}</div>${type}</div>`
-}
-
-/** (Re)pose un marqueur par adresse geolocalisee et cadre la carte dessus. */
-function renderMarkers(): void {
-    if (map === null || L === null) {
-        return
-    }
-
-    markers.forEach(m => m.remove())
-    markers = []
-
-    const points: [number, number][] = []
-    for (const address of located.value) {
-        const position: [number, number] = [Number(address.latitude), Number(address.longitude)]
-        const marker = L.marker(position, { icon: pinIcon(), draggable: props.editable }).addTo(map)
-        marker.bindPopup(popupHtml(address))
-        if (props.editable) {
-            marker.on('dragend', () => onMarkerDragEnd(address, marker))
-        }
-        markers.push(marker)
-        points.push(position)
-    }
-
-    // Cadre sur l'ensemble des marqueurs (fitBounds), borne pour un pin isole.
-    if (points.length > 0) {
-        map.fitBounds(L.latLngBounds(points), { padding: [40, 40], maxZoom: MAX_FIT_ZOOM })
-    }
-}
-
-/**
- * Drag d'un pin -> PATCH direct des coordonnees + geoManual=true (RG-6.08).
- * Contrairement au formulaire d'edition (persistance differee au submit), la
- * carte d'ensemble enregistre immediatement le nouveau positionnement.
- */
-async function onMarkerDragEnd(address: TierMapAddress, marker: Marker): Promise<void> {
-    const position = marker.getLatLng()
-    const latitude = position.lat.toFixed(7)
-    const longitude = position.lng.toFixed(7)
-    try {
-        await api.patch(address.patchPath, { latitude, longitude, geoManual: true }, { toast: false })
-        address.geoManual = true
-        address.latitude = latitude
-        address.longitude = longitude
-        emit('updated', { id: address.id, latitude, longitude })
-    }
-    catch {
-        // Echec d'enregistrement : on remet le pin a sa derniere position connue.
-        marker.setLatLng([Number(address.latitude), Number(address.longitude)])
-    }
-}
-
-function escapeHtml(value: string): string {
-    return value
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-}
-
-// (Re)monte ou rafraichit la carte quand la liste des adresses geolocalisees
-// change (chargement async de la fiche, ajout de coordonnees).
-watch(located, async () => {
-    if (located.value.length === 0) {
-        return
-    }
-    if (map === null) {
-        await nextTick()
-        await ensureMap()
-        return
-    }
-    renderMarkers()
-}, { deep: true })
-
-onMounted(ensureMap)
-
-onBeforeUnmount(() => {
-    map?.remove()
-    map = null
-    L = null
-    markers = []
-})
-</script>

frontend/modules/commercial/components/__tests__/AddressGeoPin.spec.ts

@@ -1,151 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { mount, flushPromises } from '@vue/test-utils'
-import { ref, computed, watch, nextTick, onMounted, onBeforeUnmount } from 'vue'
-import AddressGeoPin from '../AddressGeoPin.vue'
-
-// Mock Leaflet (hoisted) : capture le handler `dragend` et pilote la position
-// renvoyee par getLatLng — permet de simuler un drag du marqueur sans DOM reel.
-const leafletState = vi.hoisted(() => ({
-    dragendHandler: null as (() => void) | null,
-    markerPosition: { lat: 0, lng: 0 },
-}))
-
-vi.mock('leaflet', () => {
-    const marker = {
-        addTo: vi.fn().mockReturnThis(),
-        on: vi.fn((event: string, handler: () => void) => {
-            if (event === 'dragend') {
-                leafletState.dragendHandler = handler
-            }
-        }),
-        getLatLng: vi.fn(() => leafletState.markerPosition),
-        setLatLng: vi.fn(),
-    }
-    const map = {
-        setView: vi.fn().mockReturnThis(),
-        panTo: vi.fn(),
-        remove: vi.fn(),
-    }
-    const L = {
-        map: vi.fn(() => map),
-        tileLayer: vi.fn(() => ({ addTo: vi.fn() })),
-        divIcon: vi.fn(() => ({})),
-        marker: vi.fn(() => marker),
-    }
-    return { default: L, ...L }
-})
-vi.mock('leaflet/dist/leaflet.css', () => ({ default: {} }))
-
-// Mock controlable du geocodage BAN (bouton « Re-geocoder »).
-const { geocodeMock } = vi.hoisted(() => ({ geocodeMock: vi.fn() }))
-vi.mock('~/shared/composables/useAddressAutocomplete', () => ({
-    useAddressAutocomplete: () => ({ geocode: geocodeMock }),
-}))
-
-// Auto-imports Nuxt/Vue utilises sans import explicite par le composant.
-vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
-vi.stubGlobal('ref', ref)
-vi.stubGlobal('computed', computed)
-vi.stubGlobal('watch', watch)
-vi.stubGlobal('nextTick', nextTick)
-vi.stubGlobal('onMounted', onMounted)
-vi.stubGlobal('onBeforeUnmount', onBeforeUnmount)
-
-interface PinProps {
-    latitude?: string | null
-    longitude?: string | null
-    geoManual?: boolean
-    geocodeQuery?: string | null
-    readonly?: boolean
-}
-
-function mountPin(props: PinProps = {}) {
-    return mount(AddressGeoPin, {
-        props: {
-            latitude: null,
-            longitude: null,
-            geoManual: false,
-            geocodeQuery: '1 rue du Test, 86100 Châtellerault',
-            ...props,
-        },
-        global: {
-            stubs: { MalioButton: true },
-        },
-    })
-}
-
-beforeEach(() => {
-    leafletState.dragendHandler = null
-    geocodeMock.mockReset()
-})
-
-describe('AddressGeoPin — adresse sans coordonnees', () => {
-    it('affiche le badge « a geolocaliser » et aucune carte', () => {
-        const wrapper = mountPin()
-
-        expect(wrapper.find('[data-testid="geo-badge-missing"]').exists()).toBe(true)
-        expect(wrapper.find('[data-testid="geo-map"]').exists()).toBe(false)
-    })
-})
-
-describe('AddressGeoPin — drag du marqueur (RG-6.08)', () => {
-    it('emet les coordonnees corrigees avec geoManual=true au dragend', async () => {
-        const wrapper = mountPin({ latitude: '46.5802596', longitude: '0.3404333' })
-        await flushPromises() // import dynamique de Leaflet + montage carte
-
-        expect(leafletState.dragendHandler).not.toBeNull()
-
-        // L'utilisateur depose le pin ailleurs (lieu-dit mal geocode).
-        leafletState.markerPosition = { lat: 48.1234567, lng: -1.6543217 }
-        leafletState.dragendHandler?.()
-
-        const emitted = wrapper.emitted('update:coords')
-        expect(emitted).toHaveLength(1)
-        expect(emitted?.[0]?.[0]).toEqual({
-            latitude: '48.1234567',
-            longitude: '-1.6543217',
-            geoManual: true,
-        })
-    })
-
-    it('affiche le badge « pin manuel » quand geoManual est vrai', () => {
-        const wrapper = mountPin({ latitude: '46.58', longitude: '0.34', geoManual: true })
-
-        expect(wrapper.find('[data-testid="geo-badge-manual"]').exists()).toBe(true)
-        expect(wrapper.find('[data-testid="geo-badge-missing"]').exists()).toBe(false)
-    })
-})
-
-describe('AddressGeoPin — re-geocodage depuis l\'adresse', () => {
-    it('emet la position BAN avec geoManual=false (le back refera autorite au save)', async () => {
-        geocodeMock.mockResolvedValueOnce({ latitude: '46.5802596', longitude: '0.3404333' })
-        const wrapper = mountPin()
-
-        await wrapper.find('[data-testid="geo-regeocode"]').trigger('click')
-        await flushPromises()
-
-        expect(geocodeMock).toHaveBeenCalledWith('1 rue du Test, 86100 Châtellerault')
-        expect(wrapper.emitted('update:coords')?.[0]?.[0]).toEqual({
-            latitude: '46.5802596',
-            longitude: '0.3404333',
-            geoManual: false,
-        })
-    })
-
-    it('signale l\'echec sans emettre quand la BAN ne trouve rien', async () => {
-        geocodeMock.mockResolvedValueOnce(null)
-        const wrapper = mountPin()
-
-        await wrapper.find('[data-testid="geo-regeocode"]').trigger('click')
-        await flushPromises()
-
-        expect(wrapper.emitted('update:coords')).toBeUndefined()
-        expect(wrapper.find('[data-testid="geo-regeocode-failed"]').exists()).toBe(true)
-    })
-
-    it('masque le bouton en lecture seule', () => {
-        const wrapper = mountPin({ readonly: true })
-
-        expect(wrapper.find('[data-testid="geo-regeocode"]').exists()).toBe(false)
-    })
-})

frontend/modules/commercial/components/__tests__/ClientAddressBlock.spec.ts

@@ -65,8 +65,6 @@ function mountBlock(street: string | null) {
                 MalioSelectCheckbox: true,
                 MalioInputText: true,
                 MalioInputAutocomplete: MalioInputAutocompleteStub,
-                // Pin geographique (M6.1) : teste dans AddressGeoPin.spec.ts.
-                AddressGeoPin: true,
             },
         },
     })
@@ -132,8 +130,6 @@ describe('ClientAddressBlock — mapping erreur par champ (ERP-101)', () => {
                     MalioSelectCheckbox: true,
                     MalioInputAutocomplete: MalioInputAutocompleteStub,
                     MalioInputText: MalioInputTextProbe,
-                    // Pin geographique (M6.1) : teste dans AddressGeoPin.spec.ts.
-                    AddressGeoPin: true,
                 },
             },
         })

frontend/modules/commercial/components/__tests__/TierAddressMap.spec.ts

@@ -1,158 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { mount, flushPromises } from '@vue/test-utils'
-import { ref, computed, watch, nextTick, onMounted, onBeforeUnmount } from 'vue'
-import TierAddressMap, { type TierMapAddress } from '../TierAddressMap.vue'
-
-// Mock Leaflet (hoisted) : capture les marqueurs crees (un par adresse
-// geolocalisee) et leur handler `dragend`, et trace l'appel a fitBounds.
-const leafletState = vi.hoisted(() => ({
-    markers: [] as Array<{
-        _latlng: { lat: number, lng: number }
-        dragend: (() => void) | null
-        setLatLng: ReturnType<typeof vi.fn>
-    }>,
-    fitBoundsCalled: false,
-}))
-
-vi.mock('leaflet', () => {
-    function makeMarker(lat: number, lng: number) {
-        const marker = {
-            _latlng: { lat, lng },
-            dragend: null as (() => void) | null,
-            addTo: vi.fn().mockReturnThis(),
-            bindPopup: vi.fn().mockReturnThis(),
-            on: vi.fn((event: string, handler: () => void) => {
-                if (event === 'dragend') marker.dragend = handler
-            }),
-            getLatLng: vi.fn(() => marker._latlng),
-            setLatLng: vi.fn(),
-            remove: vi.fn(),
-        }
-        return marker
-    }
-    const map = {
-        fitBounds: vi.fn(() => { leafletState.fitBoundsCalled = true }),
-        setView: vi.fn().mockReturnThis(),
-        remove: vi.fn(),
-    }
-    const L = {
-        map: vi.fn(() => map),
-        tileLayer: vi.fn(() => ({ addTo: vi.fn() })),
-        divIcon: vi.fn(() => ({})),
-        latLngBounds: vi.fn((points: unknown) => points),
-        marker: vi.fn((pos: [number, number]) => {
-            const marker = makeMarker(pos[0], pos[1])
-            leafletState.markers.push(marker)
-            return marker
-        }),
-    }
-    return { default: L, ...L }
-})
-vi.mock('leaflet/dist/leaflet.css', () => ({ default: {} }))
-
-// Mock controlable de l'API (PATCH des coordonnees au drag).
-const { patchMock } = vi.hoisted(() => ({ patchMock: vi.fn() }))
-
-// Auto-imports Nuxt/Vue utilises sans import explicite par le composant.
-vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
-vi.stubGlobal('useApi', () => ({ patch: patchMock }))
-vi.stubGlobal('ref', ref)
-vi.stubGlobal('computed', computed)
-vi.stubGlobal('watch', watch)
-vi.stubGlobal('nextTick', nextTick)
-vi.stubGlobal('onMounted', onMounted)
-vi.stubGlobal('onBeforeUnmount', onBeforeUnmount)
-
-function address(over: Partial<TierMapAddress> = {}): TierMapAddress {
-    return {
-        id: 1,
-        latitude: '47.218',
-        longitude: '-1.553',
-        geoManual: false,
-        title: '1 rue du Test, 44000 Nantes',
-        typeLabel: 'Livraison',
-        patchPath: '/client_addresses/1',
-        ...over,
-    }
-}
-
-beforeEach(() => {
-    leafletState.markers = []
-    leafletState.fitBoundsCalled = false
-    patchMock.mockReset()
-    patchMock.mockResolvedValue({})
-})
-
-describe('TierAddressMap — marqueurs', () => {
-    it('pose un marqueur par adresse geolocalisee et liste a part celles sans coordonnees', async () => {
-        const wrapper = mount(TierAddressMap, {
-            props: {
-                addresses: [
-                    address({ id: 1, patchPath: '/client_addresses/1' }),
-                    address({ id: 2, latitude: '48.85', longitude: '2.35', patchPath: '/client_addresses/2' }),
-                    address({ id: 3, latitude: null, longitude: null, patchPath: '/client_addresses/3', title: '5 rue Sans Geo' }),
-                ],
-            },
-        })
-        await flushPromises() // import dynamique de Leaflet + montage carte
-
-        // Deux adresses geolocalisees -> deux marqueurs ; la troisieme (sans
-        // coords) n'est pas posee sur la carte mais listee a part.
-        expect(leafletState.markers).toHaveLength(2)
-        expect(leafletState.fitBoundsCalled).toBe(true)
-
-        const missing = wrapper.findAll('[data-testid="tier-map-missing"]')
-        expect(missing).toHaveLength(1)
-        expect(missing[0]?.text()).toContain('5 rue Sans Geo')
-        expect(wrapper.find('[data-testid="tier-map"]').exists()).toBe(true)
-    })
-
-    it('affiche un etat vide quand aucune adresse n\'est geolocalisee', async () => {
-        const wrapper = mount(TierAddressMap, {
-            props: { addresses: [address({ latitude: null, longitude: null })] },
-        })
-        await flushPromises()
-
-        expect(leafletState.markers).toHaveLength(0)
-        expect(wrapper.find('[data-testid="tier-map"]').exists()).toBe(false)
-        expect(wrapper.findAll('[data-testid="tier-map-missing"]')).toHaveLength(1)
-    })
-})
-
-describe('TierAddressMap — pin ajustable (RG-6.08)', () => {
-    it('PATCH les coordonnees + geoManual=true au drag quand editable', async () => {
-        const wrapper = mount(TierAddressMap, {
-            props: { addresses: [address({ id: 7, patchPath: '/client_addresses/7' })], editable: true },
-        })
-        await flushPromises()
-
-        const marker = leafletState.markers[0]
-        expect(marker?.dragend).not.toBeNull()
-
-        // L'utilisateur depose le pin ailleurs (entree de site mal geocodee).
-        marker!._latlng = { lat: 48.1234567, lng: -1.6543217 }
-        marker!.dragend?.()
-        await flushPromises()
-
-        expect(patchMock).toHaveBeenCalledWith(
-            '/client_addresses/7',
-            { latitude: '48.1234567', longitude: '-1.6543217', geoManual: true },
-            { toast: false },
-        )
-        expect(wrapper.emitted('updated')?.[0]?.[0]).toEqual({
-            id: 7,
-            latitude: '48.1234567',
-            longitude: '-1.6543217',
-        })
-    })
-
-    it('ne rend pas les marqueurs draggables (pas de PATCH) en lecture seule', async () => {
-        mount(TierAddressMap, {
-            props: { addresses: [address()], editable: false },
-        })
-        await flushPromises()
-
-        // Aucun handler dragend cable -> pas de drag possible.
-        expect(leafletState.markers[0]?.dragend).toBeNull()
-    })
-})

frontend/modules/commercial/composables/__tests__/useSuppliersRepository.spec.ts

@@ -51,7 +51,7 @@ describe('useSuppliersRepository', () => {
                 search: 'acme',
                 'categoryCode[]': ['NEGOCIANT', 'TRANSPORTEUR'],
                 'siteId[]': ['86', '17'],
-                includeArchived: true,
+                archivedOnly: true,
             },
             { replace: true },
         )
@@ -63,7 +63,7 @@ describe('useSuppliersRepository', () => {
                 search: 'acme',
                 'categoryCode[]': ['NEGOCIANT', 'TRANSPORTEUR'],
                 'siteId[]': ['86', '17'],
-                includeArchived: true,
+                archivedOnly: true,
                 page: 1,
                 itemsPerPage: 10,
             },
@@ -73,7 +73,7 @@ describe('useSuppliersRepository', () => {
 
     it('repasse a une query propre apres reinitialisation des filtres', async () => {
         const repo = useSuppliersRepository()
-        await repo.setFilters({ search: 'acme', includeArchived: true }, { replace: true })
+        await repo.setFilters({ search: 'acme', archivedOnly: true }, { replace: true })
         await repo.setFilters({}, { replace: true })
 
         expect(mockGet).toHaveBeenLastCalledWith(

frontend/modules/commercial/composables/useClient.ts

@@ -1,5 +1,5 @@
 import { ref } from 'vue'
-import type { ClientDetail } from '~/modules/commercial/utils/clientConsultation'
+import type { ClientDetail } from '~/modules/commercial/utils/forms/clientConsultation'
 
 /**
  * Chargement et actions d'archivage d'un client unique (ecran « Consultation

frontend/modules/commercial/composables/useSupplier.ts

@@ -1,5 +1,5 @@
 import { ref } from 'vue'
-import type { SupplierDetail } from '~/modules/commercial/utils/supplierConsultation'
+import type { SupplierDetail } from '~/modules/commercial/utils/forms/supplierConsultation'
 
 /**
  * Chargement et actions d'archivage d'un fournisseur unique (ecran « Consultation

frontend/modules/commercial/composables/useSuppliersRepository.ts

@@ -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

frontend/modules/commercial/pages/__tests__/suppliersIndex.spec.ts

@@ -172,16 +172,16 @@ describe('Répertoire fournisseurs (page /suppliers)', () => {
         )
     })
 
-    it('repercute le filtre « Inclure les archivés » dans setFilters sans toucher l\'URL', async () => {
+    it('repercute le filtre « Voir les archivés » dans setFilters sans toucher l\'URL', async () => {
         const wrapper = mountPage()
         await flushPromises()
 
-        // Coche « Inclure les archivés » puis applique les filtres.
-        await wrapper.find('input[data-id="filter-include-archived"]').setValue(true)
+        // 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="commercial.suppliers.filters.apply"]').trigger('click')
 
         expect(mockSetFilters).toHaveBeenLastCalledWith(
-            { includeArchived: true },
+            { archivedOnly: true },
             { replace: true },
         )
         // Etat 100 % local (regle n°6) : aucune navigation/query string declenchee.
@@ -192,7 +192,7 @@ describe('Répertoire fournisseurs (page /suppliers)', () => {
         const wrapper = mountPage()
         await flushPromises()
 
-        await wrapper.find('input[data-id="filter-include-archived"]').setValue(true)
+        await wrapper.find('input[data-id="filter-archived-only"]').setValue(true)
         await wrapper.find('[data-label="commercial.suppliers.filters.apply"]').trigger('click')
 
         // Le libelle du bouton Filtrer porte le compteur (1 filtre actif).

frontend/modules/commercial/pages/clients/[id]/edit.vue

@@ -116,6 +116,7 @@
                             :readonly="businessReadonly"
                             :editable="true"
                             :error="informationErrors.errors.foundedAt"
+                            @update:raw-value="(v: string) => information.foundedAtRaw = v"
                         />
                         <MalioInputText
                             v-model="information.employeesCount"
@@ -156,12 +157,16 @@
                 <!-- Onglet Contact -->
                 <template #contact>
                     <div class="mt-12 flex flex-col gap-6">
+                        <!-- ERP-172 : poubelle visible seulement s'il reste un AUTRE bloc deja
+                             enregistre (id en base) — cf. isRowRemovable. Empeche de supprimer un
+                             bloc tant que rien n'est sauvegarde, et de supprimer son dernier
+                             bloc enregistre. -->
                         <ClientContactBlock
                             v-for="(contact, index) in contacts"
                             :key="contact.id ?? `new-${index}`"
                             :model-value="contact"
                             :title="t('commercial.clients.form.contact.title', { n: index + 1 })"
-                            :removable="contacts.length > 1"
+                            :removable="isRowRemovable(contacts, index)"
                             :readonly="businessReadonly"
                             :errors="contactErrors[index]"
                             @update:model-value="(v) => contacts[index] = v"
@@ -198,7 +203,7 @@
                             :site-options="siteOptions"
                             :contact-options="contactOptions"
                             :country-options="countryOptions"
-                            :removable="addresses.length > 1"
+                            :removable="isRowRemovable(addresses, index)"
                             :readonly="businessReadonly"
                             :errors="addressErrors[index]"
                             @update:model-value="(v) => addresses[index] = v"
@@ -303,7 +308,7 @@
                             class="relative bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]"
                         >
                             <MalioButtonIcon
-                                v-if="!accountingReadonly && visibleRibs.length > 1"
+                                v-if="!accountingReadonly && isRowRemovable(visibleRibs, index)"
                                 icon="mdi:delete-outline"
                                 variant="ghost"
                                 button-class="absolute top-3 right-3"
@@ -401,7 +406,7 @@ import {
     mapAddressToDraft,
     mapRibToDraft,
     type ClientDetail,
-} from '~/modules/commercial/utils/clientConsultation'
+} from '~/modules/commercial/utils/forms/clientConsultation'
 import {
     buildAccountingPayload,
     buildAddressPayload,
@@ -417,7 +422,7 @@ import {
     type ClientEditAbilities,
     type InformationFormDraft,
     type MainFormDraft,
-} from '~/modules/commercial/utils/clientEdit'
+} from '~/modules/commercial/utils/forms/clientEdit'
 import {
     buildClientFormTabKeys,
     isAddressValid,
@@ -429,7 +434,7 @@ import {
     isRibComplete,
     isRibRequiredForPaymentType,
     showsRelationAndTriageFields,
-} from '~/modules/commercial/utils/clientFormRules'
+} from '~/modules/commercial/utils/forms/clientFormRules'
 import {
     emptyAddress,
     emptyContact,
@@ -439,6 +444,7 @@ import {
     type RibFormDraft,
 } from '~/modules/commercial/types/clientForm'
 import { extractApiErrorMessage } from '~/shared/utils/api'
+import { isRowRemovable, removeCollectionRow } from '~/shared/utils/collectionRow'
 import { readHistoryTab } from '~/shared/utils/historyTab'
 
 // Masques de saisie (la normalisation finale reste serveur).
@@ -489,10 +495,6 @@ const contacts = ref<ContactFormDraft[]>([])
 const addresses = ref<AddressFormDraft[]>([])
 const ribs = ref<RibFormDraft[]>([])
 
-// Ids des sous-ressources existantes supprimees (DELETE differe au « Valider »).
-const removedContactIds = ref<number[]>([])
-const removedAddressIds = ref<number[]>([])
-const removedRibIds = ref<number[]>([])
 
 const mainSubmitting = ref(false)
 const tabSubmitting = ref(false)
@@ -753,32 +755,31 @@ function addContact(): void {
     if (canAddContact.value) contacts.value.push(emptyContact())
 }
 
+// ERP-172 : DELETE immediat de la sous-ressource a la confirmation de la modale
+// (et non plus differe au « Enregistrer »). Bloc jamais persiste (id null) : retrait
+// local. Echec serveur : bloc conserve + erreur remontee.
 function askRemoveContact(index: number): void {
-    askConfirm(t('commercial.clients.form.confirmDelete.contact'), () => {
-        const removed = contacts.value[index]
-        if (removed?.id != null) removedContactIds.value.push(removed.id)
-        contacts.value.splice(index, 1)
-        contactErrors.value.splice(index, 1)
-        // Garde au moins un bloc visible (cf. amorce a l'hydratation).
-        if (contacts.value.length === 0) contacts.value.push(emptyContact())
-    })
+    askConfirm(t('commercial.clients.form.confirmDelete.contact'), () => removeCollectionRow({
+        rows: contacts.value,
+        errors: contactErrors.value,
+        index,
+        endpoint: '/client_contacts',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyContact,
+        onError: showError,
+    }))
 }
 
 /**
- * Valide l'onglet Contact : DELETE des contacts retires (existants), puis
- * POST/PATCH des blocs restants sur la sous-ressource. Strictement scope a la
- * collection contacts (endpoints client_contact dedies).
+ * Valide l'onglet Contact : POST/PATCH des blocs restants sur la sous-ressource.
+ * Strictement scope a la collection contacts (endpoints client_contact dedies). La
+ * suppression est traitee a part, en DELETE immediat (askRemoveContact, ERP-172).
  */
 async function submitContacts(): Promise<void> {
     if (businessReadonly.value || tabSubmitting.value) return
     tabSubmitting.value = true
     contactErrors.value = []
     try {
-        for (const id of removedContactIds.value) {
-            await api.delete(`/client_contacts/${id}`, {}, { toast: false })
-        }
-        removedContactIds.value = []
-
         // RG-1.14 : au moins un contact requis. Si l'onglet ne contient QUE des
         // amorces neuves vides (ex. tous les contacts existants supprimes), on ne
         // les skippe pas -> le back renvoie la 422 RG-1.05 « prénom ou nom
@@ -835,14 +836,15 @@ function addAddress(): void {
 }
 
 function askRemoveAddress(index: number): void {
-    askConfirm(t('commercial.clients.form.confirmDelete.address'), () => {
-        const removed = addresses.value[index]
-        if (removed?.id != null) removedAddressIds.value.push(removed.id)
-        addresses.value.splice(index, 1)
-        addressErrors.value.splice(index, 1)
-        // Garde au moins un bloc visible (cf. amorce a l'hydratation).
-        if (addresses.value.length === 0) addresses.value.push(emptyAddress())
-    })
+    askConfirm(t('commercial.clients.form.confirmDelete.address'), () => removeCollectionRow({
+        rows: addresses.value,
+        errors: addressErrors.value,
+        index,
+        endpoint: '/client_addresses',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyAddress,
+        onError: showError,
+    }))
 }
 
 function onAddressDegraded(): void {
@@ -854,17 +856,12 @@ function onAddressDegraded(): void {
     })
 }
 
-/** Valide l'onglet Adresse : DELETE des adresses retirees puis POST/PATCH. */
+/** Valide l'onglet Adresse : POST/PATCH des blocs restants (suppression en DELETE immediat, ERP-172). */
 async function submitAddresses(): Promise<void> {
     if (businessReadonly.value || tabSubmitting.value) return
     tabSubmitting.value = true
     addressErrors.value = []
     try {
-        for (const id of removedAddressIds.value) {
-            await api.delete(`/client_addresses/${id}`, {}, { toast: false })
-        }
-        removedAddressIds.value = []
-
         // On tente TOUS les blocs d'adresse (collecte des erreurs par index, ERP-110).
         const hasError = await submitRows(
             addresses.value,
@@ -936,29 +933,32 @@ function addRib(): void {
     if (canAddRib.value) ribs.value.push(emptyRib())
 }
 
+// ERP-172 : DELETE immediat du RIB. Le back refuse la suppression du dernier RIB
+// d'une LCR (RG-1.13) -> 409 remonte via showError (message back), bloc conserve.
 function askRemoveRib(index: number): void {
-    askConfirm(t('commercial.clients.form.confirmDelete.rib'), () => {
-        const removed = ribs.value[index]
-        if (removed?.id != null) removedRibIds.value.push(removed.id)
-        ribs.value.splice(index, 1)
-        ribErrors.value.splice(index, 1)
-        // Garde au moins un bloc RIB visible (cf. amorce a l'hydratation).
-        if (ribs.value.length === 0) ribs.value.push(emptyRib())
-    })
+    askConfirm(t('commercial.clients.form.confirmDelete.rib'), () => removeCollectionRow({
+        rows: ribs.value,
+        errors: ribErrors.value,
+        index,
+        endpoint: '/client_ribs',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyRib,
+        onError: showError,
+    }))
 }
 
 /**
  * Valide l'onglet Comptabilite : POST/PATCH des RIB sur la sous-ressource PUIS
  * PATCH des scalaires (groupe client:write:accounting, exige accounting.manage cote
- * back) PUIS DELETE des RIB explicitement retires. Les RIB crees d'abord : le back
- * valide RG-1.13 (LCR => au moins un RIB persiste) sur le PATCH scalaires.
+ * back). Les RIB crees d'abord : le back valide RG-1.13 (LCR => au moins un RIB
+ * persiste) sur le PATCH scalaires.
  *
+ * ERP-172 : la suppression d'un RIB est traitee en DELETE immediat (askRemoveRib),
+ * plus de DELETE differe ici.
  * ERP-121 : les RIB ne sont (re)soumis QUE sous LCR — hors-LCR ce sont des
  * coordonnees dormantes conservees telles quelles, masquees a l'ecran et jamais
- * re-ecrites. `removedRibIds` ne contient plus que les suppressions EXPLICITES
- * (corbeille d'un bloc, toujours sous LCR), plus l'auto-suppression au changement
- * de type de reglement. Aucun champ main/information dans le payload (mode strict
- * RG-1.28 : sinon 403 sur tout le payload).
+ * re-ecrites. Aucun champ main/information dans le payload (mode strict RG-1.28 :
+ * sinon 403 sur tout le payload).
  */
 async function submitAccounting(): Promise<void> {
     if (accountingReadonly.value || tabSubmitting.value) return
@@ -1012,14 +1012,6 @@ async function submitAccounting(): Promise<void> {
             return
         }
 
-        // 3) DELETE des RIB explicitement retires (corbeille d'un bloc) : APRES le
-        // PATCH scalaires (le guard back refuse la suppression du dernier RIB d'une
-        // LCR). ERP-121 : plus aucune suppression automatique au passage hors-LCR.
-        for (const id of removedRibIds.value) {
-            await api.delete(`/client_ribs/${id}`, {}, { toast: false })
-        }
-        removedRibIds.value = []
-
         toast.success({ title: t('commercial.clients.toast.updateSuccess') })
     }
     catch (e) {

frontend/modules/commercial/pages/clients/[id]/index.vue

@@ -242,13 +242,6 @@
                     </div>
                 </template>
 
-                <!-- Onglet Carte (M6.6) : vue d'ensemble des implantations du client. -->
-                <template v-if="showMapTab" #carte>
-                    <div class="mt-12 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
-                        <TierAddressMap :addresses="mapAddresses" :editable="canEditAddresses" />
-                    </div>
-                </template>
-
                 <!-- Onglets non encore implementes : frame vide (navigation libre). -->
                 <template #transport><ComingSoonPlaceholder /></template>
                 <template #statistics><ComingSoonPlaceholder /></template>
@@ -287,8 +280,7 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue'
 import { useClient } from '~/modules/commercial/composables/useClient'
-import { addressTypeFromFlags, buildClientFormTabKeys, isRibRequiredForPaymentType, type AddressType } from '~/modules/commercial/utils/clientFormRules'
-import type { TierMapAddress } from '~/modules/commercial/components/TierAddressMap.vue'
+import { buildClientFormTabKeys, isRibRequiredForPaymentType } from '~/modules/commercial/utils/forms/clientFormRules'
 import { readHistoryTab } from '~/shared/utils/historyTab'
 import {
     canEditClient,
@@ -305,7 +297,7 @@ import {
     showRestoreAction,
     type ClientDetail,
     type SelectOption,
-} from '~/modules/commercial/utils/clientConsultation'
+} from '~/modules/commercial/utils/forms/clientConsultation'
 import { emptyAddress, emptyContact } from '~/modules/commercial/types/clientForm'
 
 // Masque d'affichage (purement visuel, la donnee reste celle du serveur).
@@ -316,7 +308,6 @@ const route = useRoute()
 const router = useRouter()
 const toast = useToast()
 const { can, canAny } = usePermissions()
-const { isModuleActive } = useModules()
 const authStore = useAuthStore()
 
 // Gating de la route : la consultation exige `view`. Usine (sans view) est
@@ -420,54 +411,10 @@ const paymentDelayOptions = computed(() => referentialOptionOf(client.value?.pay
 const paymentTypeOptions = computed(() => referentialOptionOf(client.value?.paymentType))
 const bankOptions = computed(() => referentialOptionOf(client.value?.bank))
 
-// ── Onglet « Carte » (M6.6, module field_sales) ────────────────────────────
-// Visible uniquement si le module field_sales est actif ET que l'utilisateur a
-// la permission de consultation des tournees. Le drag du pin (PATCH direct) est
-// reserve aux roles pouvant editer un client.
-const showMapTab = computed(() => isModuleActive('field_sales') && can('field_sales.tours.view'))
-const canEditAddresses = computed(() => can('commercial.clients.manage'))
-
-// Cles i18n du type d'adresse (RG-1.06/07/08) pour le libelle du popup carte.
-const CLIENT_ADDRESS_TYPE_I18N: Record<AddressType, string> = {
-    prospect: 'addressTypeProspect',
-    delivery: 'addressTypeDelivery',
-    billing: 'addressTypeBilling',
-    delivery_billing: 'addressTypeDeliveryBilling',
-    broker: 'addressTypeBroker',
-    distributor: 'addressTypeDistributor',
-}
-
-/** Adresses du client normalisees pour la carte d'ensemble (M6.6). */
-const mapAddresses = computed<TierMapAddress[]>(() =>
-    (client.value?.addresses ?? []).map((a) => {
-        const type = addressTypeFromFlags({
-            isProspect: a.isProspect ?? false,
-            isDelivery: a.isDelivery ?? false,
-            isBilling: a.isBilling ?? false,
-            isBroker: a.isBroker ?? false,
-            isDistributor: a.isDistributor ?? false,
-        })
-        const cityLine = [a.postalCode, a.city].filter(Boolean).join(' ')
-        return {
-            id: a.id,
-            latitude: a.latitude ?? null,
-            longitude: a.longitude ?? null,
-            geoManual: a.geoManual === true,
-            title: [a.street, cityLine].filter(Boolean).join(', ') || t('commercial.clients.form.address.title', { n: a.id }),
-            typeLabel: type ? t(`commercial.clients.form.address.${CLIENT_ADDRESS_TYPE_I18N[type]}`) : '',
-            patchPath: `/client_addresses/${a.id}`,
-        }
-    }),
-)
-
 // ── Onglets : navigation LIBRE (pas de sequence forcee en consultation) ────
 // 4 onglets actifs (Information, Contact, Adresse, + Comptabilite si droit) et
-// 4 coquilles (Transport, Statistiques, Rapports, Echanges) ; + Carte si M6.6.
-const tabKeys = computed(() => {
-    const keys = buildClientFormTabKeys(canAccountingView.value, { includeEditOnlyTabs: true })
-    if (showMapTab.value) keys.push('carte')
-    return keys
-})
+// 4 coquilles (Transport, Statistiques, Rapports, Echanges).
+const tabKeys = computed(() => buildClientFormTabKeys(canAccountingView.value, { includeEditOnlyTabs: true }))
 
 const TAB_ICONS: Record<string, string> = {
     information: 'mdi:account-outline',
@@ -478,7 +425,6 @@ const TAB_ICONS: Record<string, string> = {
     statistics: 'mdi:finance',
     reports: 'mdi:file-document-edit-outline',
     exchanges: 'mdi:account-group-outline',
-    carte: 'mdi:map-outline',
 }
 
 const tabs = computed(() => tabKeys.value.map(key => ({

frontend/modules/commercial/pages/clients/new.vue

@@ -111,6 +111,7 @@
                         :readonly="isValidated('information')"
                         :editable="true"
                         :error="informationErrors.errors.foundedAt"
+                        @update:raw-value="(v: string) => information.foundedAtRaw = v"
                     />
                     <MalioInputText
                         v-model="information.employeesCount"
@@ -155,12 +156,16 @@
             <!-- Onglet Contact -->
             <template #contact>
                 <div class="mt-12 flex flex-col gap-6">
+                    <!-- ERP-172 : poubelle visible seulement s'il reste un AUTRE bloc deja
+                         enregistre (id en base) — cf. isRowRemovable. Empeche de supprimer un
+                         bloc tant que rien n'est sauvegarde, et de supprimer son dernier
+                         bloc enregistre. -->
                     <ClientContactBlock
                         v-for="(contact, index) in contacts"
                         :key="index"
                         :model-value="contact"
                         :title="t('commercial.clients.form.contact.title', { n: index + 1 })"
-                        :removable="index > 0"
+                        :removable="isRowRemovable(contacts, index)"
                         :readonly="isValidated('contact')"
                         :errors="contactErrors[index]"
                         @update:model-value="(v) => contacts[index] = v"
@@ -197,7 +202,7 @@
                         :site-options="referentials.sites.value"
                         :contact-options="contactOptions"
                         :country-options="countryOptions"
-                        :removable="index > 0"
+                        :removable="isRowRemovable(addresses, index)"
                         :readonly="isValidated('address')"
                         :errors="addressErrors[index]"
                         @update:model-value="(v) => addresses[index] = v"
@@ -302,7 +307,7 @@
                     >
                         <!-- ariaLabel via v-bind objet (prop camelCase ; aria-* serait un attribut HTML). -->
                         <MalioButtonIcon
-                            v-if="!accountingReadonly && visibleRibs.length > 1"
+                            v-if="!accountingReadonly && isRowRemovable(visibleRibs, index)"
                             icon="mdi:delete-outline"
                             variant="ghost"
                             button-class="absolute top-3 right-3"
@@ -401,12 +406,12 @@ import {
     isRibRequiredForPaymentType,
     lastFillableTabKey,
     showsRelationAndTriageFields,
-} from '~/modules/commercial/utils/clientFormRules'
+} from '~/modules/commercial/utils/forms/clientFormRules'
 import {
     buildAddressPayload,
     buildMainPayload,
     buildRibPayload,
-} from '~/modules/commercial/utils/clientEdit'
+} from '~/modules/commercial/utils/forms/clientEdit'
 import {
     emptyAddress,
     emptyContact,
@@ -416,6 +421,7 @@ import {
     type RibFormDraft,
 } from '~/modules/commercial/types/clientForm'
 import { extractApiErrorMessage } from '~/shared/utils/api'
+import { isRowRemovable } from '~/shared/utils/collectionRow'
 
 // Masques de saisie (la normalisation finale reste serveur).
 const SIREN_MASK = '#########'
@@ -651,6 +657,8 @@ const information = reactive({
     description: null as string | null,
     competitors: null as string | null,
     foundedAt: null as string | null,
+    // Saisie brute invalide remontee par MalioDate (cf. foundedAtRaw, MUI-44).
+    foundedAtRaw: '',
     employeesCount: null as string | null,
     revenueAmount: null as string | null,
     profitAmount: null as string | null,
@@ -666,7 +674,8 @@ async function submitInformation(): Promise<void> {
         await api.patch(`/clients/${clientId.value}`, {
             description: information.description || null,
             competitors: information.competitors || null,
-            foundedAt: information.foundedAt || null,
+            // Saisie invalide prioritaire -> 422 back sur foundedAt (cf. foundedAtRaw).
+            foundedAt: information.foundedAtRaw || information.foundedAt || null,
             employeesCount: information.employeesCount ? Number(information.employeesCount) : null,
             revenueAmount: information.revenueAmount || null,
             profitAmount: information.profitAmount || null,

frontend/modules/commercial/pages/suppliers/[id]/edit.vue

@@ -77,6 +77,7 @@
                             :readonly="businessReadonly"
                             :editable="true"
                             :error="informationErrors.errors.foundedAt"
+                            @update:raw-value="(v: string) => information.foundedAtRaw = v"
                         />
                         <MalioInputText
                             v-model="information.employeesCount"
@@ -125,12 +126,16 @@
                 <!-- Onglet Contacts -->
                 <template #contacts>
                     <div class="mt-12 flex flex-col gap-6">
+                        <!-- ERP-172 : poubelle visible seulement s'il reste un AUTRE bloc deja
+                             enregistre (id en base) — cf. isRowRemovable. Empeche de supprimer un
+                             bloc tant que rien n'est sauvegarde, et de supprimer son dernier
+                             bloc enregistre. -->
                         <SupplierContactBlock
                             v-for="(contact, index) in contacts"
                             :key="contact.id ?? `new-${index}`"
                             :model-value="contact"
                             :title="t('commercial.suppliers.form.contact.title', { n: index + 1 })"
-                            :removable="contacts.length > 1"
+                            :removable="isRowRemovable(contacts, index)"
                             :readonly="businessReadonly"
                             :errors="contactErrors[index]"
                             @update:model-value="(v) => contacts[index] = v"
@@ -167,7 +172,7 @@
                             :site-options="siteOptions"
                             :contact-options="contactOptions"
                             :country-options="countryOptions"
-                            :removable="addresses.length > 1"
+                            :removable="isRowRemovable(addresses, index)"
                             :readonly="businessReadonly"
                             :errors="addressErrors[index]"
                             @update:model-value="(v) => addresses[index] = v"
@@ -272,7 +277,7 @@
                             class="relative bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]"
                         >
                             <MalioButtonIcon
-                                v-if="!accountingReadonly && visibleRibs.length > 1"
+                                v-if="!accountingReadonly && isRowRemovable(visibleRibs, index)"
                                 icon="mdi:delete-outline"
                                 variant="ghost"
                                 button-class="absolute top-3 right-3"
@@ -370,7 +375,7 @@ import {
     mapAddressToDraft,
     mapRibToDraft,
     type SupplierDetail,
-} from '~/modules/commercial/utils/supplierConsultation'
+} from '~/modules/commercial/utils/forms/supplierConsultation'
 import {
     buildAccountingPayload,
     buildAddressPayload,
@@ -386,7 +391,7 @@ import {
     type InformationFormDraft,
     type MainFormDraft,
     type SupplierEditAbilities,
-} from '~/modules/commercial/utils/supplierEdit'
+} from '~/modules/commercial/utils/forms/supplierEdit'
 import {
     buildSupplierFormTabKeys,
     isAddressValid,
@@ -396,7 +401,7 @@ import {
     isRibBlank,
     isRibComplete,
     isRibRequiredForPaymentType,
-} from '~/modules/commercial/utils/supplierFormRules'
+} from '~/modules/commercial/utils/forms/supplierFormRules'
 import {
     emptyAddress,
     emptyContact,
@@ -406,6 +411,7 @@ import {
     type SupplierRibFormDraft,
 } from '~/modules/commercial/types/supplierForm'
 import { extractApiErrorMessage } from '~/shared/utils/api'
+import { isRowRemovable, removeCollectionRow } from '~/shared/utils/collectionRow'
 import { readHistoryTab } from '~/shared/utils/historyTab'
 
 // Masques de saisie (la normalisation finale reste serveur).
@@ -455,10 +461,6 @@ const contacts = ref<SupplierContactFormDraft[]>([])
 const addresses = ref<SupplierAddressFormDraft[]>([])
 const ribs = ref<SupplierRibFormDraft[]>([])
 
-// Ids des sous-ressources existantes supprimees (DELETE differe au « Valider »).
-const removedContactIds = ref<number[]>([])
-const removedAddressIds = ref<number[]>([])
-const removedRibIds = ref<number[]>([])
 
 const mainSubmitting = ref(false)
 const tabSubmitting = ref(false)
@@ -652,32 +654,31 @@ function addContact(): void {
     if (canAddContact.value) contacts.value.push(emptyContact())
 }
 
+// ERP-172 : DELETE immediat de la sous-ressource a la confirmation de la modale
+// (et non plus differe au « Enregistrer »). Bloc jamais persiste (id null) : retrait
+// local. Echec serveur : bloc conserve + erreur remontee.
 function askRemoveContact(index: number): void {
-    askConfirm(t('commercial.suppliers.form.confirmDelete.contact'), () => {
-        const removed = contacts.value[index]
-        if (removed?.id != null) removedContactIds.value.push(removed.id)
-        contacts.value.splice(index, 1)
-        contactErrors.value.splice(index, 1)
-        // Garde au moins un bloc visible (cf. amorce a l'hydratation).
-        if (contacts.value.length === 0) contacts.value.push(emptyContact())
-    })
+    askConfirm(t('commercial.suppliers.form.confirmDelete.contact'), () => removeCollectionRow({
+        rows: contacts.value,
+        errors: contactErrors.value,
+        index,
+        endpoint: '/supplier_contacts',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyContact,
+        onError: showError,
+    }))
 }
 
 /**
- * Valide l'onglet Contacts : DELETE des contacts retires (existants), puis
- * POST/PATCH des blocs restants sur la sous-ressource. Strictement scope a la
- * collection contacts (endpoints supplier_contact dedies).
+ * Valide l'onglet Contacts : POST/PATCH des blocs restants sur la sous-ressource.
+ * Strictement scope a la collection contacts (endpoints supplier_contact dedies).
+ * La suppression est traitee a part, en DELETE immediat (askRemoveContact, ERP-172).
  */
 async function submitContacts(): Promise<void> {
     if (businessReadonly.value || tabSubmitting.value) return
     tabSubmitting.value = true
     contactErrors.value = []
     try {
-        for (const id of removedContactIds.value) {
-            await api.delete(`/supplier_contacts/${id}`, {}, { toast: false })
-        }
-        removedContactIds.value = []
-
         // RG-2.13 : au moins un contact requis. Si l'onglet ne contient QUE des
         // amorces neuves vides, on les soumet -> 422 RG-2.04 inline (nom OU prenom).
         const hasSubmittableContact = contacts.value.some(c => c.id !== null || !isContactBlank(c))
@@ -725,14 +726,15 @@ function addAddress(): void {
 }
 
 function askRemoveAddress(index: number): void {
-    askConfirm(t('commercial.suppliers.form.confirmDelete.address'), () => {
-        const removed = addresses.value[index]
-        if (removed?.id != null) removedAddressIds.value.push(removed.id)
-        addresses.value.splice(index, 1)
-        addressErrors.value.splice(index, 1)
-        // Garde au moins un bloc visible (cf. amorce a l'hydratation).
-        if (addresses.value.length === 0) addresses.value.push(emptyAddress())
-    })
+    askConfirm(t('commercial.suppliers.form.confirmDelete.address'), () => removeCollectionRow({
+        rows: addresses.value,
+        errors: addressErrors.value,
+        index,
+        endpoint: '/supplier_addresses',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyAddress,
+        onError: showError,
+    }))
 }
 
 function onAddressDegraded(): void {
@@ -744,17 +746,12 @@ function onAddressDegraded(): void {
     })
 }
 
-/** Valide l'onglet Adresses : DELETE des adresses retirees puis POST/PATCH. */
+/** Valide l'onglet Adresses : POST/PATCH des blocs restants (suppression en DELETE immediat, ERP-172). */
 async function submitAddresses(): Promise<void> {
     if (businessReadonly.value || tabSubmitting.value) return
     tabSubmitting.value = true
     addressErrors.value = []
     try {
-        for (const id of removedAddressIds.value) {
-            await api.delete(`/supplier_addresses/${id}`, {}, { toast: false })
-        }
-        removedAddressIds.value = []
-
         const hasError = await submitRows(
             addresses.value,
             addressErrors,
@@ -825,15 +822,18 @@ function addRib(): void {
     if (canAddRib.value) ribs.value.push(emptyRib())
 }
 
+// ERP-172 : DELETE immediat du RIB. Le back refuse la suppression du dernier RIB
+// d'une LCR (RG-2.08) -> 409 remonte via showError (message back), bloc conserve.
 function askRemoveRib(index: number): void {
-    askConfirm(t('commercial.suppliers.form.confirmDelete.rib'), () => {
-        const removed = ribs.value[index]
-        if (removed?.id != null) removedRibIds.value.push(removed.id)
-        ribs.value.splice(index, 1)
-        ribErrors.value.splice(index, 1)
-        // Garde au moins un bloc RIB visible (cf. amorce a l'hydratation).
-        if (ribs.value.length === 0) ribs.value.push(emptyRib())
-    })
+    askConfirm(t('commercial.suppliers.form.confirmDelete.rib'), () => removeCollectionRow({
+        rows: ribs.value,
+        errors: ribErrors.value,
+        index,
+        endpoint: '/supplier_ribs',
+        deleteRow: url => api.delete(url, {}, { toast: false }),
+        makeEmpty: emptyRib,
+        onError: showError,
+    }))
 }
 
 /**
@@ -842,11 +842,12 @@ function askRemoveRib(index: number): void {
  * cote back) PUIS DELETE des RIB explicitement retires. Les RIB crees d'abord : le
  * back valide RG-2.08 (LCR => au moins un RIB persiste) sur le PATCH scalaires.
  *
+ * ERP-172 : la suppression d'un RIB est traitee en DELETE immediat (askRemoveRib),
+ * plus de DELETE differe ici.
  * ERP-121 : les RIB ne sont (re)soumis QUE sous LCR — hors-LCR ce sont des
  * coordonnees dormantes conservees telles quelles, masquees a l'ecran et jamais
- * re-ecrites. `removedRibIds` ne contient plus que les suppressions EXPLICITES
- * (corbeille d'un bloc, toujours sous LCR). Aucun champ main/information dans le
- * payload (mode strict RG-2.16 : sinon 403 sur tout le payload).
+ * re-ecrites. Aucun champ main/information dans le payload (mode strict RG-2.16 :
+ * sinon 403 sur tout le payload).
  */
 async function submitAccounting(): Promise<void> {
     if (accountingReadonly.value || tabSubmitting.value) return
@@ -896,14 +897,6 @@ async function submitAccounting(): Promise<void> {
             return
         }
 
-        // 3) DELETE des RIB explicitement retires (corbeille d'un bloc) : APRES le
-        // PATCH scalaires (le guard back refuse la suppression du dernier RIB d'une
-        // LCR). ERP-121 : plus aucune suppression automatique au passage hors-LCR.
-        for (const id of removedRibIds.value) {
-            await api.delete(`/supplier_ribs/${id}`, {}, { toast: false })
-        }
-        removedRibIds.value = []
-
         toast.success({ title: t('commercial.suppliers.toast.updateSuccess') })
     }
     catch (e) {

frontend/modules/commercial/pages/suppliers/[id]/index.vue

@@ -225,13 +225,6 @@
                     </div>
                 </template>
 
-                <!-- Onglet Carte (M6.6) : vue d'ensemble des implantations du fournisseur. -->
-                <template v-if="showMapTab" #carte>
-                    <div class="mt-12 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
-                        <TierAddressMap :addresses="mapAddresses" :editable="canEditAddresses" />
-                    </div>
-                </template>
-
                 <!-- Onglets non encore implementes : frame vide (navigation libre). -->
                 <template #transport><ComingSoonPlaceholder /></template>
                 <template #statistics><ComingSoonPlaceholder /></template>
@@ -270,7 +263,7 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue'
 import { useSupplier } from '~/modules/commercial/composables/useSupplier'
-import { buildSupplierFormTabKeys, isRibRequiredForPaymentType } from '~/modules/commercial/utils/supplierFormRules'
+import { buildSupplierFormTabKeys, isRibRequiredForPaymentType } from '~/modules/commercial/utils/forms/supplierFormRules'
 import { readHistoryTab } from '~/shared/utils/historyTab'
 import {
     canEditSupplier,
@@ -287,9 +280,8 @@ import {
     showRestoreAction,
     type SelectOption,
     type SupplierDetail,
-} from '~/modules/commercial/utils/supplierConsultation'
-import { emptyContact, type SupplierAddressType } from '~/modules/commercial/types/supplierForm'
-import type { TierMapAddress } from '~/modules/commercial/components/TierAddressMap.vue'
+} from '~/modules/commercial/utils/forms/supplierConsultation'
+import { emptyContact } from '~/modules/commercial/types/supplierForm'
 
 // Masque d'affichage (purement visuel, la donnee reste celle du serveur).
 const SIREN_MASK = '#########'
@@ -299,7 +291,6 @@ const route = useRoute()
 const router = useRouter()
 const toast = useToast()
 const { can, canAny } = usePermissions()
-const { isModuleActive } = useModules()
 const authStore = useAuthStore()
 
 // Gating de la route : la consultation exige `view`. Usine (sans view) est
@@ -395,44 +386,10 @@ const paymentDelayOptions = computed(() => referentialOptionOf(supplier.value?.p
 const paymentTypeOptions = computed(() => referentialOptionOf(supplier.value?.paymentType))
 const bankOptions = computed(() => referentialOptionOf(supplier.value?.bank))
 
-// ── Onglet « Carte » (M6.6, module field_sales) ────────────────────────────
-// Visible uniquement si le module field_sales est actif ET que l'utilisateur a
-// la permission de consultation des tournees. Le drag du pin (PATCH direct) est
-// reserve aux roles pouvant editer un fournisseur.
-const showMapTab = computed(() => isModuleActive('field_sales') && can('field_sales.tours.view'))
-const canEditAddresses = computed(() => can('commercial.suppliers.manage'))
-
-// Cles i18n du type d'adresse fournisseur (enum PROSPECT/DEPART/RENDU, RG-2.09).
-const SUPPLIER_ADDRESS_TYPE_I18N: Record<SupplierAddressType, string> = {
-    PROSPECT: 'addressTypeProspect',
-    DEPART: 'addressTypeDepart',
-    RENDU: 'addressTypeRendu',
-}
-
-/** Adresses du fournisseur normalisees pour la carte d'ensemble (M6.6). */
-const mapAddresses = computed<TierMapAddress[]>(() =>
-    (supplier.value?.addresses ?? []).map((a) => {
-        const cityLine = [a.postalCode, a.city].filter(Boolean).join(' ')
-        return {
-            id: a.id,
-            latitude: a.latitude ?? null,
-            longitude: a.longitude ?? null,
-            geoManual: a.geoManual === true,
-            title: [a.street, cityLine].filter(Boolean).join(', ') || t('commercial.suppliers.form.address.title', { n: a.id }),
-            typeLabel: a.addressType ? t(`commercial.suppliers.form.address.${SUPPLIER_ADDRESS_TYPE_I18N[a.addressType]}`) : '',
-            patchPath: `/supplier_addresses/${a.id}`,
-        }
-    }),
-)
-
 // ── Onglets : navigation LIBRE (pas de sequence forcee en consultation) ────
 // 3 onglets actifs (Information, Contacts, Adresses, + Comptabilite si droit) et
-// 4 coquilles (Transport, Statistiques, Rapports, Echanges) ; + Carte si M6.6.
-const tabKeys = computed(() => {
-    const keys = buildSupplierFormTabKeys(canAccountingView.value, { includeEditOnlyTabs: true })
-    if (showMapTab.value) keys.push('carte')
-    return keys
-})
+// 4 coquilles (Transport, Statistiques, Rapports, Echanges).
+const tabKeys = computed(() => buildSupplierFormTabKeys(canAccountingView.value, { includeEditOnlyTabs: true }))
 
 const TAB_ICONS: Record<string, string> = {
     information: 'mdi:account-outline',
@@ -443,7 +400,6 @@ const TAB_ICONS: Record<string, string> = {
     statistics: 'mdi:finance',
     reports: 'mdi:file-document-edit-outline',
     exchanges: 'mdi:account-group-outline',
-    carte: 'mdi:map-outline',
 }
 
 const tabs = computed(() => tabKeys.value.map(key => ({

frontend/modules/commercial/pages/suppliers/index.vue

@@ -128,13 +128,13 @@
                     </div>
                 </MalioAccordionItem>
 
-                <!-- Statut : bool unique. Coche = inclut aussi les archives (sinon actifs seuls). -->
+                <!-- Statut : bool unique. Coche = archives uniquement, sinon actifs. -->
                 <MalioAccordionItem :title="t('commercial.suppliers.filters.status')" value="status">
                     <MalioCheckbox
-                        id="filter-include-archived"
-                        :label="t('commercial.suppliers.filters.includeArchived')"
-                        :model-value="draftIncludeArchived"
-                        @update:model-value="(val: boolean) => draftIncludeArchived = val"
+                        id="filter-archived-only"
+                        :label="t('commercial.suppliers.filters.archivedOnly')"
+                        :model-value="draftArchivedOnly"
+                        @update:model-value="(val: boolean) => draftArchivedOnly = val"
                     />
                 </MalioAccordionItem>
             </MalioAccordion>
@@ -254,12 +254,12 @@ const filterDrawerOpen = ref(false)
 const draftSearch = ref('')
 const draftCategoryCodes = ref<string[]>([])
 const draftSiteIds = ref<string[]>([])
-const draftIncludeArchived = ref(false)
+const draftArchivedOnly = ref(false)
 
 const appliedSearch = ref('')
 const appliedCategoryCodes = ref<string[]>([])
 const appliedSiteIds = ref<string[]>([])
-const appliedIncludeArchived = ref(false)
+const appliedArchivedOnly = ref(false)
 
 // Options des selects multi, chargees une fois (referentiels courts).
 const categoryOptions = ref<FilterOption[]>([])
@@ -270,7 +270,7 @@ const activeFilterCount = computed(() => {
     if (appliedSearch.value.trim() !== '') count++
     if (appliedCategoryCodes.value.length > 0) count++
     if (appliedSiteIds.value.length > 0) count++
-    if (appliedIncludeArchived.value) count++
+    if (appliedArchivedOnly.value) count++
     return count
 })
 
@@ -285,7 +285,7 @@ function openFilters(): void {
     draftSearch.value = appliedSearch.value
     draftCategoryCodes.value = [...appliedCategoryCodes.value]
     draftSiteIds.value = [...appliedSiteIds.value]
-    draftIncludeArchived.value = appliedIncludeArchived.value
+    draftArchivedOnly.value = appliedArchivedOnly.value
     filterDrawerOpen.value = true
 }
 
@@ -311,7 +311,7 @@ function buildFilterPayload(): Record<string, string | string[] | boolean> {
     if (appliedSearch.value.trim() !== '') payload.search = appliedSearch.value.trim()
     if (appliedCategoryCodes.value.length > 0) payload['categoryCode[]'] = [...appliedCategoryCodes.value]
     if (appliedSiteIds.value.length > 0) payload['siteId[]'] = [...appliedSiteIds.value]
-    if (appliedIncludeArchived.value) payload.includeArchived = true
+    if (appliedArchivedOnly.value) payload.archivedOnly = true
     return payload
 }
 
@@ -321,7 +321,7 @@ function applyFilters(): void {
     appliedSearch.value = draftSearch.value.trim()
     appliedCategoryCodes.value = [...draftCategoryCodes.value]
     appliedSiteIds.value = [...draftSiteIds.value]
-    appliedIncludeArchived.value = draftIncludeArchived.value
+    appliedArchivedOnly.value = draftArchivedOnly.value
 
     setFilters(buildFilterPayload(), { replace: true })
     filterDrawerOpen.value = false
@@ -333,12 +333,12 @@ function resetFilters(): void {
     draftSearch.value = ''
     draftCategoryCodes.value = []
     draftSiteIds.value = []
-    draftIncludeArchived.value = false
+    draftArchivedOnly.value = false
 
     appliedSearch.value = ''
     appliedCategoryCodes.value = []
     appliedSiteIds.value = []
-    appliedIncludeArchived.value = false
+    appliedArchivedOnly.value = false
 
     setFilters({}, { replace: true })
 }

frontend/modules/commercial/pages/suppliers/new.vue

@@ -71,6 +71,7 @@
                         :readonly="isValidated('information')"
                         :editable="true"
                         :error="informationErrors.errors.foundedAt"
+                        @update:raw-value="(v: string) => information.foundedAtRaw = v"
                     />
                     <MalioInputText
                         v-model="information.employeesCount"
@@ -120,12 +121,16 @@
             <!-- Onglet Contacts -->
             <template #contacts>
                 <div class="mt-12 flex flex-col gap-6">
+                    <!-- ERP-172 : poubelle visible seulement s'il reste un AUTRE bloc deja
+                         enregistre (id en base) — cf. isRowRemovable. Empeche de supprimer un
+                         bloc tant que rien n'est sauvegarde, et de supprimer son dernier
+                         bloc enregistre. -->
                     <SupplierContactBlock
                         v-for="(contact, index) in contacts"
                         :key="index"
                         :model-value="contact"
                         :title="t('commercial.suppliers.form.contact.title', { n: index + 1 })"
-                        :removable="index > 0"
+                        :removable="isRowRemovable(contacts, index)"
                         :readonly="isValidated('contacts')"
                         :errors="contactErrors[index]"
                         @update:model-value="(v) => contacts[index] = v"
@@ -162,7 +167,7 @@
                         :site-options="referentials.sites.value"
                         :contact-options="contactOptions"
                         :country-options="countryOptions"
-                        :removable="index > 0"
+                        :removable="isRowRemovable(addresses, index)"
                         :readonly="isValidated('addresses')"
                         :errors="addressErrors[index]"
                         @update:model-value="(v) => addresses[index] = v"
@@ -266,7 +271,7 @@
                         class="relative bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]"
                     >
                         <MalioButtonIcon
-                            v-if="!accountingReadonly && visibleRibs.length > 1"
+                            v-if="!accountingReadonly && isRowRemovable(visibleRibs, index)"
                             icon="mdi:delete-outline"
                             variant="ghost"
                             button-class="absolute top-3 right-3"
@@ -361,7 +366,7 @@ import {
     isRibComplete,
     isRibRequiredForPaymentType,
     lastFillableTabKey,
-} from '~/modules/commercial/utils/supplierFormRules'
+} from '~/modules/commercial/utils/forms/supplierFormRules'
 import {
     buildAccountingPayload,
     buildAddressPayload,
@@ -369,7 +374,7 @@ import {
     buildInformationPayload,
     buildMainPayload,
     buildRibPayload,
-} from '~/modules/commercial/utils/supplierEdit'
+} from '~/modules/commercial/utils/forms/supplierEdit'
 import {
     emptyAddress,
     emptyContact,
@@ -379,6 +384,7 @@ import {
     type SupplierRibFormDraft,
 } from '~/modules/commercial/types/supplierForm'
 import { extractApiErrorMessage } from '~/shared/utils/api'
+import { isRowRemovable } from '~/shared/utils/collectionRow'
 
 // Masques de saisie (la normalisation finale reste serveur).
 const SIREN_MASK = '#########'
@@ -549,6 +555,8 @@ const information = reactive({
     description: null as string | null,
     competitors: null as string | null,
     foundedAt: null as string | null,
+    // Saisie brute invalide remontee par MalioDate (cf. foundedAtRaw, MUI-44).
+    foundedAtRaw: '',
     employeesCount: null as string | null,
     revenueAmount: null as string | null,
     profitAmount: null as string | null,

frontend/modules/commercial/types/clientForm.ts

@@ -51,12 +51,6 @@ export interface AddressFormDraft {
     billingEmailSecondary: string | null
     /** Drapeau UI : 2e champ email revele (comme hasSecondaryPhone). */
     hasSecondaryBillingEmail: boolean
-    /** Latitude WGS84 (chaine decimale NUMERIC(10,7)), null si non geolocalisee (M6.1). */
-    latitude: string | null
-    /** Longitude WGS84 (chaine decimale NUMERIC(10,7)), null si non geolocalisee (M6.1). */
-    longitude: string | null
-    /** RG-6.08 : pin corrige a la main — le geocodage auto ne reecrit plus. */
-    geoManual: boolean
 }
 
 /** Un RIB du client (onglet Comptabilite). */
@@ -102,9 +96,6 @@ export function emptyAddress(): AddressFormDraft {
         billingEmail: null,
         billingEmailSecondary: null,
         hasSecondaryBillingEmail: false,
-        latitude: null,
-        longitude: null,
-        geoManual: false,
     }
 }
 

frontend/modules/commercial/types/supplierForm.ts

@@ -55,12 +55,6 @@ export interface SupplierAddressFormDraft {
     bennes: string | null
     /** Prestation de triage (specifique fournisseur, portee par l'adresse — RG). */
     triageProvider: boolean
-    /** Latitude WGS84 (chaine decimale NUMERIC(10,7)), null si non geolocalisee (M6.1). */
-    latitude: string | null
-    /** Longitude WGS84 (chaine decimale NUMERIC(10,7)), null si non geolocalisee (M6.1). */
-    longitude: string | null
-    /** RG-6.08 : pin corrige a la main — le geocodage auto ne reecrit plus. */
-    geoManual: boolean
 }
 
 /** Un RIB du fournisseur (onglet Comptabilite). */
@@ -101,9 +95,6 @@ export function emptyAddress(): SupplierAddressFormDraft {
         contactIris: [],
         bennes: '0',
         triageProvider: false,
-        latitude: null,
-        longitude: null,
-        geoManual: false,
     }
 }
 

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

@@ -36,6 +36,7 @@ function informationDraft(overrides: Partial<InformationFormDraft> = {}): Inform
         description: 'desc',
         competitors: 'concurrents',
         foundedAt: '2010-05-01',
+        foundedAtRaw: '',
         employeesCount: '42',
         revenueAmount: '1000000',
         profitAmount: '50000',
@@ -140,6 +141,16 @@ describe('buildInformationPayload — scoping strict groupe client:write:informa
         expect(payload.description).toBeNull()
         expect(payload.directorName).toBeNull()
     })
+
+    it('envoie la saisie invalide (foundedAtRaw) en priorite -> le back tranchera (422)', () => {
+        // Saisie malformee : on transmet le texte brut tel quel pour declencher la
+        // 422 back sur foundedAt (validation autoritaire du format, MUI-44).
+        expect(buildInformationPayload(informationDraft({ foundedAt: null, foundedAtRaw: '32/13/2026' })).foundedAt)
+            .toBe('32/13/2026')
+        // Saisie valide : foundedAtRaw vide -> on envoie la date ISO.
+        expect(buildInformationPayload(informationDraft({ foundedAt: '2010-05-01', foundedAtRaw: '' })).foundedAt)
+            .toBe('2010-05-01')
+    })
 })
 
 describe('buildAccountingPayload — scoping strict groupe client:write:accounting', () => {

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

@@ -11,7 +11,7 @@ import {
     mapMainDraft,
     resolveTabEditability,
 } from '../supplierEdit'
-import type { SupplierDetail } from '~/modules/commercial/utils/supplierConsultation'
+import type { SupplierDetail } from '~/modules/commercial/utils/forms/supplierConsultation'
 import { emptyAddress, emptyContact, emptyRib } from '~/modules/commercial/types/supplierForm'
 
 describe('buildMainPayload (groupe supplier:write:main)', () => {
@@ -37,7 +37,7 @@ describe('buildMainPayload (groupe supplier:write:main)', () => {
 
 describe('buildInformationPayload (groupe supplier:write:information)', () => {
     const base = {
-        description: null, competitors: null, foundedAt: null, employeesCount: null,
+        description: null, competitors: null, foundedAt: null, foundedAtRaw: '', employeesCount: null,
         revenueAmount: null, profitAmount: null, directorName: null, volumeForecast: null,
     }
 
@@ -48,6 +48,15 @@ describe('buildInformationPayload (groupe supplier:write:information)', () => {
         })
         expect(buildInformationPayload(base)).toMatchObject({ employeesCount: null, volumeForecast: null })
     })
+
+    it('envoie la saisie invalide (foundedAtRaw) en priorite -> le back tranchera (422)', () => {
+        // Saisie malformee transmise telle quelle pour declencher la 422 back (MUI-44).
+        expect(buildInformationPayload({ ...base, foundedAt: null, foundedAtRaw: '32/13/2026' }).foundedAt)
+            .toBe('32/13/2026')
+        // Saisie valide : foundedAtRaw vide -> on envoie la date ISO.
+        expect(buildInformationPayload({ ...base, foundedAt: '2008-04-01', foundedAtRaw: '' }).foundedAt)
+            .toBe('2008-04-01')
+    })
 })
 
 describe('buildContactPayload (sous-ressource supplier_contact)', () => {

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

@@ -69,10 +69,6 @@ export interface AddressRead extends HydraRef {
     isBilling?: boolean
     isBroker?: boolean
     isDistributor?: boolean
-    /** Geolocalisation (M6.1) : chaines decimales NUMERIC(10,7) cote API. */
-    latitude?: string | null
-    longitude?: string | null
-    geoManual?: boolean
     sites?: SiteRead[]
     categories?: CategoryRead[]
     // L'embed M2M des contacts d'adresse peut etre un objet (partiel) ou un IRI nu.
@@ -229,9 +225,6 @@ export function mapAddressToDraft(address: AddressRead): AddressFormDraft {
         billingEmail: address.billingEmail ?? null,
         billingEmailSecondary: address.billingEmailSecondary ?? null,
         hasSecondaryBillingEmail: (address.billingEmailSecondary ?? null) !== null && address.billingEmailSecondary !== '',
-        latitude: address.latitude ?? null,
-        longitude: address.longitude ?? null,
-        geoManual: address.geoManual === true,
     }
 }
 

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

@@ -20,14 +20,14 @@ import {
     iriOf,
     relationOf,
     type ClientDetail,
-} from '~/modules/commercial/utils/clientConsultation'
+} from '~/modules/commercial/utils/forms/clientConsultation'
 import {
     ADDRESS_REQUIRED_NON_NULLABLE_KEYS,
     blankEmptyRequired,
     MAIN_REQUIRED_NON_NULLABLE_KEYS,
     omitEmptyRequired,
     RIB_REQUIRED_NON_NULLABLE_KEYS,
-} from '~/modules/commercial/utils/clientFormRules'
+} from '~/modules/commercial/utils/forms/clientFormRules'
 import type { AddressFormDraft, ContactFormDraft, RibFormDraft } from '~/modules/commercial/types/clientForm'
 
 /**
@@ -53,6 +53,13 @@ export interface InformationFormDraft {
     competitors: string | null
     /** Date de creation de l'entreprise au format YYYY-MM-DD (MalioDate). */
     foundedAt: string | null
+    /**
+     * Saisie brute invalide remontee par MalioDate (`@update:rawValue`) : '' tant
+     * que la saisie est valide/vide, sinon le texte tel que tape. On l'envoie au
+     * back en priorite sur `foundedAt` pour que la 422 (validation autoritaire du
+     * format, ERP-101) porte sur le champ et s'affiche inline. Cf. MUI-44.
+     */
+    foundedAtRaw: string
     /** Nombre de salaries en chaine (saisie masquee), converti en number au PATCH. */
     employeesCount: string | null
     revenueAmount: string | null
@@ -118,6 +125,8 @@ export function mapInformationDraft(client: ClientDetail): InformationFormDraft
         competitors: client.competitors ?? null,
         // MalioDate attend strictement YYYY-MM-DD : on tronque l'ISO datetime.
         foundedAt: client.foundedAt ? client.foundedAt.slice(0, 10) : null,
+        // Aucune saisie brute invalide au chargement (la valeur stockee est valide).
+        foundedAtRaw: '',
         employeesCount: client.employeesCount != null ? String(client.employeesCount) : null,
         revenueAmount: client.revenueAmount ?? null,
         profitAmount: client.profitAmount ?? null,
@@ -191,7 +200,9 @@ export function buildInformationPayload(information: InformationFormDraft): Reco
     return {
         description: information.description || null,
         competitors: information.competitors || null,
-        foundedAt: information.foundedAt || null,
+        // Saisie invalide (foundedAtRaw) prioritaire : on l'envoie telle quelle
+        // pour que le back renvoie une 422 sur foundedAt (cf. foundedAtRaw).
+        foundedAt: information.foundedAtRaw || information.foundedAt || null,
         employeesCount: information.employeesCount ? Number(information.employeesCount) : null,
         revenueAmount: information.revenueAmount || null,
         profitAmount: information.profitAmount || null,
@@ -254,11 +265,6 @@ export function buildAddressPayload(
         contacts: address.contactIris,
         billingEmail: isBillingEmailRequired ? (address.billingEmail || null) : null,
         billingEmailSecondary: isBillingEmailRequired && address.hasSecondaryBillingEmail ? (address.billingEmailSecondary || null) : null,
-        // Geolocalisation (M6.1) : pin manuel persiste avec geoManual=true ;
-        // geoManual=false laisse le back regeocoder depuis l'adresse postale.
-        latitude: address.latitude || null,
-        longitude: address.longitude || null,
-        geoManual: address.geoManual,
     }, ADDRESS_REQUIRED_NON_NULLABLE_KEYS, options)
 }
 

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

@@ -76,10 +76,6 @@ export interface AddressRead extends HydraRef {
     streetComplement?: string | null
     bennes?: number | null
     triageProvider?: boolean
-    /** Geolocalisation (M6.1) : chaines decimales NUMERIC(10,7) cote API. */
-    latitude?: string | null
-    longitude?: string | null
-    geoManual?: boolean
     sites?: SiteRead[]
     categories?: CategoryRead[]
     // L'embed M2M des contacts d'adresse peut etre un objet (partiel) ou un IRI nu.
@@ -204,9 +200,6 @@ export function mapAddressToDraft(address: AddressRead): SupplierAddressFormDraf
         contactIris: (address.contacts ?? []).map(c => (typeof c === 'string' ? c : c['@id'])),
         bennes: address.bennes != null ? String(address.bennes) : '0',
         triageProvider: address.triageProvider ?? false,
-        latitude: address.latitude ?? null,
-        longitude: address.longitude ?? null,
-        geoManual: address.geoManual === true,
     }
 }
 

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

@@ -17,8 +17,8 @@ import {
     MAIN_REQUIRED_NON_NULLABLE_KEYS,
     omitEmptyRequired,
     RIB_REQUIRED_NON_NULLABLE_KEYS,
-} from '~/modules/commercial/utils/supplierFormRules'
-import { iriOf, type SupplierDetail } from '~/modules/commercial/utils/supplierConsultation'
+} from '~/modules/commercial/utils/forms/supplierFormRules'
+import { iriOf, type SupplierDetail } from '~/modules/commercial/utils/forms/supplierConsultation'
 import type {
     SupplierAddressFormDraft,
     SupplierContactFormDraft,
@@ -38,6 +38,13 @@ export interface InformationFormDraft {
     competitors: string | null
     /** Date de creation de l'entreprise au format YYYY-MM-DD (MalioDate). */
     foundedAt: string | null
+    /**
+     * Saisie brute invalide remontee par MalioDate (`@update:rawValue`) : '' tant
+     * que la saisie est valide/vide, sinon le texte tel que tape. On l'envoie au
+     * back en priorite sur `foundedAt` pour que la 422 (validation autoritaire du
+     * format, ERP-101) porte sur le champ et s'affiche inline. Cf. MUI-44.
+     */
+    foundedAtRaw: string
     /** Nombre de salaries en chaine (saisie masquee), converti en number au PATCH. */
     employeesCount: string | null
     revenueAmount: string | null
@@ -95,6 +102,8 @@ export function mapInformationDraft(supplier: SupplierDetail): InformationFormDr
         competitors: supplier.competitors ?? null,
         // MalioDate attend strictement YYYY-MM-DD : on tronque l'ISO datetime.
         foundedAt: supplier.foundedAt ? supplier.foundedAt.slice(0, 10) : null,
+        // Aucune saisie brute invalide au chargement (la valeur stockee est valide).
+        foundedAtRaw: '',
         employeesCount: supplier.employeesCount != null ? String(supplier.employeesCount) : null,
         revenueAmount: supplier.revenueAmount ?? null,
         profitAmount: supplier.profitAmount ?? null,
@@ -177,7 +186,9 @@ export function buildInformationPayload(information: InformationFormDraft): Reco
     return {
         description: information.description || null,
         competitors: information.competitors || null,
-        foundedAt: information.foundedAt || null,
+        // Saisie invalide (foundedAtRaw) prioritaire : on l'envoie telle quelle
+        // pour que le back renvoie une 422 sur foundedAt (cf. foundedAtRaw).
+        foundedAt: information.foundedAtRaw || information.foundedAt || null,
         employeesCount: information.employeesCount ? Number(information.employeesCount) : null,
         revenueAmount: information.revenueAmount || null,
         profitAmount: information.profitAmount || null,
@@ -237,11 +248,6 @@ export function buildAddressPayload(address: SupplierAddressFormDraft, options:
         contacts: address.contactIris,
         bennes: address.bennes !== null && address.bennes !== '' ? Number(address.bennes) : null,
         triageProvider: address.triageProvider,
-        // Geolocalisation (M6.1) : pin manuel persiste avec geoManual=true ;
-        // geoManual=false laisse le back regeocoder depuis l'adresse postale.
-        latitude: address.latitude || null,
-        longitude: address.longitude || null,
-        geoManual: address.geoManual,
     }, ADDRESS_REQUIRED_NON_NULLABLE_KEYS, options)
 }
 

frontend/modules/core/components/RoleDrawer.vue

@@ -83,7 +83,7 @@
                 @click="emit('update:modelValue', false)"
             />
             <MalioButton
-                :label="t('common.save')"
+                :label="isEditMode ? t('common.save') : t('common.validate')"
                 variant="primary"
                 button-class="w-m-btn-action"
                 :disabled="saving || permissionsLoadFailed"

frontend/modules/field-sales/components/TourMap.vue

@@ -1,441 +0,0 @@
-<template>
-    <!-- Carte Leaflet (exception documentee a @malio/layer-ui : carte interactive,
-         type non couvert par la lib — cf. frontend.md § Composants formulaires).
-         TODO : migrer si la lib couvre un jour les cartes. -->
-    <div class="relative h-full w-full">
-        <div ref="mapEl" class="h-full w-full" data-testid="tour-map" />
-        <!-- Aide a la selection rectangle (lasso facon Badger Maps). -->
-        <div class="pointer-events-none absolute bottom-2 left-2 z-[400] rounded bg-white/90 px-2 py-1 text-xs text-gray-600 shadow">
-            {{ t('field_sales.plan.map.lassoHint') }}
-        </div>
-    </div>
-</template>
-
-<script setup lang="ts">
-import type { Map as LeafletMap, Marker, Polyline, Rectangle } from 'leaflet'
-import type { PlanningStop } from '~/modules/field-sales/composables/useTourPlanning'
-import type { VisitableTier } from '~/modules/field-sales/types/tour'
-
-/**
- * Carte interactive de planification de tournee (M6.5, spec § 6.1).
- *
- * - Charge les pins des Tiers geolocalises de la zone visible
- *   (GET /api/visitable_tiers?bbox=...), colores par type (client/fournisseur),
- *   filtrables (types + recherche). Recharge au deplacement/zoom (debounce).
- * - Popup au clic : nom, adresse, bouton « + Ajouter » (emet `add-tier`).
- * - Selection rectangle (Maj + glisser) : ajoute tous les Tiers entoures
- *   (emet `add-tiers`).
- * - Trace la tournee par-dessus : polyline + marqueurs numerotes suivant l'ordre
- *   des etapes geolocalisees.
- *
- * Instances Leaflet hors reactivite Vue (un proxy casse l'API Leaflet).
- */
-const props = withDefaults(defineProps<{
-    /** Etapes geolocalisees a tracer (polyline numerotee). */
-    stops: PlanningStop[]
-    /** Types de pins affiches. */
-    types: Array<'client' | 'supplier'>
-    /** Recherche raison sociale / ville. */
-    search: string
-    /** Centre initial (defaut : Nantes). */
-    center?: [number, number]
-    /** Point de depart de la tournee (marqueur « maison »), si geolocalise. */
-    start?: { latitude: number, longitude: number, label?: string } | null
-}>(), {
-    center: () => [47.218, -1.553],
-    start: null,
-})
-
-const emit = defineEmits<{
-    /** Ajout d'un seul Tiers (popup « + Ajouter »). */
-    'add-tier': [tier: VisitableTier]
-    /** Ajout d'un lot de Tiers (selection rectangle). */
-    'add-tiers': [tiers: VisitableTier[]]
-}>()
-
-const { t } = useI18n()
-const api = useApi()
-
-const mapEl = ref<HTMLElement | null>(null)
-
-// Instances Leaflet (hors reactivite).
-let L: typeof import('leaflet') | null = null
-let map: LeafletMap | null = null
-let pinLayer: Marker[] = []
-let pinTiers: Array<{ tier: VisitableTier, marker: Marker }> = []
-let routeLine: Polyline | null = null
-let stopMarkers: Marker[] = []
-let startMarker: Marker | null = null
-let selectionRect: Rectangle | null = null
-// Signature du dernier cadrage automatique (ensemble des points geolocalises).
-// Evite de re-cadrer la carte a chaque recompute (memes points, ETA mises a jour)
-// ou reorder (memes points, ordre different) : on ne recadre qu'a l'ajout/retrait.
-let lastFitSignature = ''
-// Observe les changements de taille du conteneur (layout flex/responsive) pour
-// reparer le rendu des tuiles (invalidateSize).
-let resizeObserver: ResizeObserver | null = null
-
-/** Zoom initial (niveau agglomeration). */
-const INITIAL_ZOOM = 12
-
-/** Couleur du pin par type de Tiers. */
-const PIN_COLORS: Record<string, string> = {
-    client: '#2563eb', // bleu
-    supplier: '#16a34a', // vert
-}
-
-/** Debounce du rechargement des pins au deplacement de la carte. */
-let fetchTimer: ReturnType<typeof setTimeout> | null = null
-
-async function ensureMap(): Promise<void> {
-    if (map !== null || mapEl.value === null) {
-        return
-    }
-
-    const mod = await import('leaflet')
-    L = mod.default ?? mod
-    await import('leaflet/dist/leaflet.css')
-
-    if (mapEl.value === null) {
-        return
-    }
-
-    map = L.map(mapEl.value, {
-        // Conserve les tuiles hors-cadre un court instant : panning plus fluide.
-        preferCanvas: true,
-    }).setView(props.center, INITIAL_ZOOM)
-    L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
-        attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a>',
-        maxZoom: 19,
-        // Garde les tuiles deja chargees pendant le zoom (moins de gris/clignotement).
-        keepBuffer: 4,
-    }).addTo(map)
-
-    // Selection rectangle a la place du box-zoom natif (Maj + glisser).
-    map.boxZoom.disable()
-    map.on('mousedown', onMouseDown)
-
-    // Rechargement des pins quand la zone visible change.
-    map.on('moveend', scheduleFetch)
-
-    // Le conteneur est dans un layout flex (lg:flex-1) : sa taille n'est pas
-    // toujours stabilisee a la creation de la map → tuiles partielles/grises et
-    // panning saccade. On force un recalcul de taille apres le 1er rendu, puis a
-    // chaque resize du conteneur (passage responsive, ouverture panneau, etc.).
-    requestAnimationFrame(() => map?.invalidateSize())
-    resizeObserver = new ResizeObserver(() => map?.invalidateSize())
-    resizeObserver.observe(mapEl.value)
-
-    drawRoute()
-    await fetchPins()
-}
-
-/** bbox de la zone visible au format Leaflet (minLng,minLat,maxLng,maxLat). */
-function currentBbox(): string | null {
-    if (map === null) {
-        return null
-    }
-
-    return map.getBounds().toBBoxString()
-}
-
-function scheduleFetch(): void {
-    if (fetchTimer !== null) {
-        clearTimeout(fetchTimer)
-    }
-    fetchTimer = setTimeout(() => {
-        void fetchPins()
-    }, 300)
-}
-
-/**
- * Charge les pins de la zone visible. `?pagination=false` : la carte affiche
- * TOUS les pins de la bbox (le volume est borne par la zone, pas par la page).
- */
-async function fetchPins(): Promise<void> {
-    if (map === null || L === null) {
-        return
-    }
-    if (props.types.length === 0) {
-        clearPins()
-        return
-    }
-
-    const bbox = currentBbox()
-    if (bbox === null) {
-        return
-    }
-
-    const query: Record<string, string> = {
-        bbox,
-        type: props.types.join(','),
-        pagination: 'false',
-    }
-    if (props.search.trim() !== '') {
-        query.q = props.search.trim()
-    }
-
-    try {
-        const response = await api.get<{ member?: VisitableTier[] }>(
-            '/visitable_tiers',
-            query,
-            { headers: { Accept: 'application/ld+json' }, toast: false },
-        )
-        renderPins(response.member ?? [])
-    }
-    catch {
-        // Echec non bloquant : la carte reste utilisable, les pins ne se mettent
-        // simplement pas a jour.
-    }
-}
-
-function clearPins(): void {
-    pinLayer.forEach(m => m.remove())
-    pinLayer = []
-    pinTiers = []
-}
-
-function renderPins(tiers: VisitableTier[]): void {
-    if (map === null || L === null) {
-        return
-    }
-    clearPins()
-
-    for (const tier of tiers) {
-        const marker = L.marker([tier.latitude, tier.longitude], {
-            icon: pinIcon(PIN_COLORS[tier.tierType] ?? '#6b7280'),
-        }).addTo(map)
-
-        marker.bindPopup(popupHtml(tier))
-        marker.on('popupopen', () => bindPopupButton(tier))
-
-        pinLayer.push(marker)
-        pinTiers.push({ tier, marker })
-    }
-}
-
-/** divIcon SVG inline colore (evite les assets PNG Leaflet casses par Vite). */
-function pinIcon(color: string) {
-    return L!.divIcon({
-        className: '',
-        html: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="26" height="38" fill="${color}" stroke="#ffffff" stroke-width="1"><path d="M12 0C7 0 3 4 3 9c0 6.6 9 15 9 15s9-8.4 9-15c0-5-4-9-9-9zm0 12.5A3.5 3.5 0 1 1 12 5.5a3.5 3.5 0 0 1 0 7z"/></svg>`,
-        iconSize: [26, 38],
-        iconAnchor: [13, 38],
-        popupAnchor: [0, -34],
-    })
-}
-
-/** Contenu HTML du popup (le bouton est cable a l'ouverture, cf. bindPopupButton). */
-function popupHtml(tier: VisitableTier): string {
-    const name = escapeHtml(tier.displayName)
-    const address = escapeHtml(tier.address)
-
-    return `<div class="text-sm">
-        <div class="font-semibold">${name}</div>
-        <div class="text-gray-600">${address}</div>
-        <button type="button" data-add-tier class="mt-2 rounded bg-blue-600 px-2 py-1 text-xs font-medium text-white">${t('field_sales.plan.map.add')}</button>
-    </div>`
-}
-
-/** Cable le bouton « + Ajouter » du popup ouvert vers l'emit `add-tier`. */
-function bindPopupButton(tier: VisitableTier): void {
-    const el = map?.getContainer().querySelector('[data-add-tier]')
-    el?.addEventListener('click', () => {
-        emit('add-tier', tier)
-        map?.closePopup()
-    }, { once: true })
-}
-
-// ── Selection rectangle (lasso) ─────────────────────────────────────────────
-let selectStart: import('leaflet').LatLng | null = null
-
-function onMouseDown(e: import('leaflet').LeafletMouseEvent): void {
-    if (map === null || L === null || !e.originalEvent.shiftKey) {
-        return
-    }
-    // Empeche le drag de la carte pendant la selection.
-    map.dragging.disable()
-    selectStart = e.latlng
-    selectionRect = L.rectangle(L.latLngBounds(e.latlng, e.latlng), {
-        color: '#2563eb',
-        weight: 1,
-        fillOpacity: 0.1,
-    }).addTo(map)
-
-    map.on('mousemove', onMouseMove)
-    map.on('mouseup', onMouseUp)
-}
-
-function onMouseMove(e: import('leaflet').LeafletMouseEvent): void {
-    if (selectStart === null || selectionRect === null || L === null) {
-        return
-    }
-    selectionRect.setBounds(L.latLngBounds(selectStart, e.latlng))
-}
-
-function onMouseUp(): void {
-    if (map === null) {
-        return
-    }
-    const bounds = selectionRect?.getBounds() ?? null
-    cleanupSelection()
-
-    if (bounds === null) {
-        return
-    }
-    const selected = pinTiers
-        .filter(({ marker }) => bounds.contains(marker.getLatLng()))
-        .map(({ tier }) => tier)
-
-    if (selected.length > 0) {
-        emit('add-tiers', selected)
-    }
-}
-
-function cleanupSelection(): void {
-    selectionRect?.remove()
-    selectionRect = null
-    selectStart = null
-    map?.off('mousemove', onMouseMove)
-    map?.off('mouseup', onMouseUp)
-    map?.dragging.enable()
-}
-
-// ── Trace de la tournee ──────────────────────────────────────────────────────
-function drawRoute(): void {
-    if (map === null || L === null) {
-        return
-    }
-    routeLine?.remove()
-    routeLine = null
-    stopMarkers.forEach(m => m.remove())
-    stopMarkers = []
-    startMarker?.remove()
-    startMarker = null
-
-    // Point de depart : marqueur « maison » distinctif, en tete du trace.
-    const start = props.start
-    if (start != null && start.latitude != null && start.longitude != null) {
-        startMarker = L.marker([start.latitude, start.longitude], {
-            icon: startIcon(),
-            zIndexOffset: 1100,
-        }).addTo(map)
-        startMarker.bindTooltip(start.label && start.label.trim() !== '' ? start.label : t('field_sales.plan.map.startPoint'), { direction: 'top' })
-    }
-
-    const located = props.stops.filter(s => s.latitude != null && s.longitude != null)
-    const stopPoints = located.map(s => [s.latitude as number, s.longitude as number] as [number, number])
-
-    // La polyline part du point de depart (si geolocalise) puis enchaine les etapes.
-    const linePoints: Array<[number, number]> = start != null && start.latitude != null && start.longitude != null
-        ? [[start.latitude, start.longitude], ...stopPoints]
-        : stopPoints
-
-    if (linePoints.length >= 2) {
-        routeLine = L.polyline(linePoints, { color: '#1e40af', weight: 3, opacity: 0.7 }).addTo(map)
-    }
-
-    located.forEach((stop, index) => {
-        const marker = L!.marker([stop.latitude as number, stop.longitude as number], {
-            icon: numberedIcon(index + 1),
-            zIndexOffset: 1000,
-        }).addTo(map!)
-        marker.bindTooltip(stop.label, { direction: 'top' })
-        stopMarkers.push(marker)
-    })
-
-    fitToRoute(linePoints)
-}
-
-/**
- * Cadre la carte sur l'ensemble des points de la tournee (depart + etapes).
- * Ne recadre que si l'ensemble des points a change (ajout/retrait d'etape ou de
- * depart) : un recompute (memes points) ou un reorder ne doit pas faire sauter la
- * vue. Signature triee → independante de l'ordre des etapes.
- */
-function fitToRoute(points: Array<[number, number]>): void {
-    if (map === null || L === null || points.length === 0) {
-        return
-    }
-    const signature = points
-        .map(([lat, lng]) => `${lat.toFixed(5)},${lng.toFixed(5)}`)
-        .sort()
-        .join('|')
-    if (signature === lastFitSignature) {
-        return
-    }
-    lastFitSignature = signature
-
-    if (points.length === 1) {
-        map.setView(points[0]!, Math.max(map.getZoom(), 13))
-        return
-    }
-    map.fitBounds(L.latLngBounds(points), { padding: [40, 40], maxZoom: 15 })
-}
-
-/** Pastille numerotee pour une etape de la tournee. */
-function numberedIcon(n: number) {
-    return L!.divIcon({
-        className: '',
-        html: `<div style="display:flex;align-items:center;justify-content:center;width:24px;height:24px;border-radius:9999px;background:#1e40af;color:#fff;font-size:12px;font-weight:700;border:2px solid #fff;box-shadow:0 1px 2px rgba(0,0,0,.4)">${n}</div>`,
-        iconSize: [24, 24],
-        iconAnchor: [12, 12],
-    })
-}
-
-/**
- * Marqueur du point de depart : pastille « maison » ambre, visuellement distincte
- * des pins de Tiers (goutte) et des etapes numerotees (rond bleu).
- */
-function startIcon() {
-    return L!.divIcon({
-        className: '',
-        html: `<div style="display:flex;align-items:center;justify-content:center;width:30px;height:30px;border-radius:9999px;background:#f59e0b;border:2px solid #fff;box-shadow:0 1px 3px rgba(0,0,0,.5)">
-            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="18" height="18" fill="#ffffff"><path d="M12 3 2 12h3v8h6v-6h2v6h6v-8h3z"/></svg>
-        </div>`,
-        iconSize: [30, 30],
-        iconAnchor: [15, 15],
-    })
-}
-
-function escapeHtml(value: string): string {
-    return value
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-}
-
-// Recharge les pins quand les filtres changent.
-watch(() => [props.types, props.search], scheduleFetch, { deep: true })
-
-// Redessine le trace quand les etapes ou le point de depart changent.
-watch(() => props.stops, drawRoute, { deep: true })
-watch(() => props.start, drawRoute, { deep: true })
-
-onMounted(ensureMap)
-
-onBeforeUnmount(() => {
-    if (fetchTimer !== null) {
-        clearTimeout(fetchTimer)
-    }
-    resizeObserver?.disconnect()
-    resizeObserver = null
-    map?.remove()
-    map = null
-    L = null
-    pinLayer = []
-    pinTiers = []
-    stopMarkers = []
-    startMarker = null
-    routeLine = null
-    selectionRect = null
-})
-
-defineExpose({
-    /** Recentre la carte sur une cible (ex: depuis le panneau). */
-    panTo(target: { latitude: number, longitude: number }) {
-        map?.panTo([target.latitude, target.longitude])
-    },
-})
-</script>

frontend/modules/field-sales/components/TourStopList.vue

@@ -1,148 +0,0 @@
-<template>
-    <div>
-        <p v-if="stops.length === 0" class="py-6 text-center text-sm text-gray-500" data-testid="stops-empty">
-            {{ t('field_sales.plan.panel.noStops') }}
-        </p>
-
-        <!-- Liste draggable (vuedraggable / SortableJS) : au drop, on emet le
-             nouvel ordre. La poignee limite le drag a l'icone (le reste de la
-             ligne reste cliquable). Etat 100 % local cote parent. -->
-        <draggable
-            v-else
-            :model-value="stops"
-            item-key="id"
-            handle=".drag-handle"
-            ghost-class="opacity-50"
-            class="flex flex-col gap-2"
-            @update:model-value="onReorder"
-        >
-            <template #item="{ element, index }">
-                <div
-                    class="flex items-start gap-2 rounded border border-gray-200 bg-white p-2"
-                    :data-testid="`stop-${element.id}`"
-                >
-                    <!-- Poignee de drag + numero d'ordre. -->
-                    <button
-                        type="button"
-                        class="drag-handle mt-0.5 flex h-7 w-7 shrink-0 cursor-grab items-center justify-center rounded-full bg-blue-800 text-xs font-bold text-white"
-                        :aria-label="t('field_sales.plan.panel.stops')"
-                    >
-                        {{ index + 1 }}
-                    </button>
-
-                    <div class="min-w-0 flex-1">
-                        <div class="flex items-center gap-2">
-                            <span class="truncate font-medium text-gray-900">{{ element.label }}</span>
-                            <span
-                                v-if="!isStopLocated(element)"
-                                class="shrink-0 rounded-full bg-yellow-100 px-2 py-0.5 text-xs font-medium text-yellow-800"
-                            >
-                                {{ t('field_sales.plan.stop.toGeolocate') }}
-                            </span>
-                        </div>
-                        <p class="truncate text-xs text-gray-500">{{ element.displayAddress }}</p>
-
-                        <!-- ETA + temps depuis l'etape precedente. -->
-                        <p v-if="isStopLocated(element)" class="mt-0.5 text-xs text-gray-600">
-                            <span class="font-medium">{{ t('field_sales.plan.stop.eta') }}</span>
-                            {{ formatTime(element.eta) }}
-                            <span v-if="index > 0" class="text-gray-400">
-                                · {{ formatDuration(element.legDurationS) }} / {{ formatDistance(element.legDistanceM) }}
-                                {{ t('field_sales.plan.stop.fromPrevious') }}
-                            </span>
-                        </p>
-
-                        <!-- Actions : Y aller (deep links) · Voir le Tiers. -->
-                        <div class="mt-1 flex flex-wrap items-center gap-x-3 gap-y-1 text-xs">
-                            <div class="relative">
-                                <button
-                                    type="button"
-                                    class="font-medium text-blue-700 hover:underline disabled:text-gray-300"
-                                    :disabled="navLinks(element) === null"
-                                    @click="toggleMenu(element.id)"
-                                >
-                                    {{ t('field_sales.plan.stop.goThere') }}
-                                </button>
-                                <div
-                                    v-if="openMenuId === element.id && navLinks(element) !== null"
-                                    class="absolute z-10 mt-1 flex flex-col rounded border border-gray-200 bg-white py-1 shadow-lg"
-                                >
-                                    <a :href="navLinks(element)!.waze" target="_blank" rel="noopener" class="px-3 py-1 hover:bg-gray-100" @click="openMenuId = null">{{ t('field_sales.plan.stop.waze') }}</a>
-                                    <a :href="navLinks(element)!.google" target="_blank" rel="noopener" class="px-3 py-1 hover:bg-gray-100" @click="openMenuId = null">{{ t('field_sales.plan.stop.google') }}</a>
-                                    <a :href="navLinks(element)!.apple" target="_blank" rel="noopener" class="px-3 py-1 hover:bg-gray-100" @click="openMenuId = null">{{ t('field_sales.plan.stop.apple') }}</a>
-                                </div>
-                            </div>
-
-                            <button
-                                v-if="element.tierType !== 'custom'"
-                                type="button"
-                                class="text-gray-600 hover:underline"
-                                @click="emit('view-tier', element)"
-                            >
-                                {{ t('field_sales.plan.stop.viewTier') }}
-                            </button>
-                        </div>
-                    </div>
-
-                    <!-- Suppression de l'etape. -->
-                    <button
-                        type="button"
-                        class="mt-0.5 shrink-0 text-gray-400 hover:text-red-600"
-                        :aria-label="t('field_sales.plan.stop.remove')"
-                        @click="emit('remove', element)"
-                    >
-                        <Icon name="mdi:close" size="18" />
-                    </button>
-                </div>
-            </template>
-        </draggable>
-    </div>
-</template>
-
-<script setup lang="ts">
-import draggable from 'vuedraggable'
-import {
-    buildNavigationLinks,
-    isStopLocated,
-    formatDistance,
-    formatDuration,
-    formatTime,
-    type PlanningStop,
-} from '~/modules/field-sales/composables/useTourPlanning'
-import type { NavigationLinks } from '~/modules/field-sales/types/tour'
-
-/**
- * Liste ordonnee et draggable des etapes d'une tournee (panneau de
- * planification, M6.5). Le reordonnancement (drag & drop) emet le nouvel ordre ;
- * la persistance (POST /reorder) est a la charge de la page.
- */
-defineProps<{
-    stops: PlanningStop[]
-}>()
-
-const emit = defineEmits<{
-    /** Nouvel ordre des etapes apres drop. */
-    'reorder': [stops: PlanningStop[]]
-    /** Retrait d'une etape. */
-    'remove': [stop: PlanningStop]
-    /** « Voir le Tiers » (etape sur Tiers referentiel). */
-    'view-tier': [stop: PlanningStop]
-}>()
-
-const { t } = useI18n()
-
-/** Menu « Y aller » ouvert (id de l'etape) ou null. */
-const openMenuId = ref<number | null>(null)
-
-function toggleMenu(id: number): void {
-    openMenuId.value = openMenuId.value === id ? null : id
-}
-
-function navLinks(stop: PlanningStop): NavigationLinks | null {
-    return buildNavigationLinks(stop)
-}
-
-function onReorder(next: PlanningStop[]): void {
-    emit('reorder', next)
-}
-</script>

frontend/modules/field-sales/composables/__tests__/useTourPlanning.test.ts

@@ -1,132 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import {
-    reorderStops,
-    computeTotals,
-    buildNavigationLinks,
-    isStopLocated,
-    formatDistance,
-    formatDuration,
-    formatTime,
-    type PlanningStop,
-} from '../useTourPlanning'
-
-/** Fabrique une etape de planification minimale pour les tests. */
-function makeStop(overrides: Partial<PlanningStop> = {}): PlanningStop {
-    return {
-        id: overrides.id ?? 1,
-        tierType: overrides.tierType ?? 'client',
-        tierId: overrides.tierId ?? null,
-        addressId: overrides.addressId ?? null,
-        customLabel: null,
-        customAddress: null,
-        customLatitude: null,
-        customLongitude: null,
-        position: overrides.position ?? 0,
-        visitMinutes: overrides.visitMinutes ?? null,
-        legDistanceM: overrides.legDistanceM ?? null,
-        legDurationS: overrides.legDurationS ?? null,
-        eta: overrides.eta ?? null,
-        label: overrides.label ?? 'Étape',
-        displayAddress: overrides.displayAddress ?? '',
-        latitude: overrides.latitude ?? null,
-        longitude: overrides.longitude ?? null,
-    }
-}
-
-describe('reorderStops', () => {
-    it('deplace une etape et renumerote les positions de maniere contigue', () => {
-        const stops = [
-            makeStop({ id: 1, position: 0, label: 'A' }),
-            makeStop({ id: 2, position: 1, label: 'B' }),
-            makeStop({ id: 3, position: 2, label: 'C' }),
-        ]
-
-        // Deplace C (index 2) en tete (index 0).
-        const result = reorderStops(stops, 2, 0)
-
-        expect(result.map(s => s.label)).toEqual(['C', 'A', 'B'])
-        expect(result.map(s => s.position)).toEqual([0, 1, 2])
-    })
-
-    it('ne mute pas le tableau source', () => {
-        const stops = [makeStop({ id: 1, position: 0 }), makeStop({ id: 2, position: 1 })]
-        reorderStops(stops, 0, 1)
-        expect(stops.map(s => s.id)).toEqual([1, 2])
-    })
-
-    it('retourne une copie inchangee si un index est hors borne', () => {
-        const stops = [makeStop({ id: 1, position: 0 })]
-        const result = reorderStops(stops, 0, 5)
-        expect(result.map(s => s.id)).toEqual([1])
-    })
-})
-
-describe('computeTotals', () => {
-    it('somme distances/trajets et ajoute les visites (defaut + specifique)', () => {
-        const stops = [
-            // 1re etape : pas de leg (point de depart). Visite = defaut 30 min.
-            makeStop({ id: 1, legDistanceM: null, legDurationS: null }),
-            // 2e : 10 km / 12 min de trajet, visite specifique 15 min.
-            makeStop({ id: 2, legDistanceM: 10_000, legDurationS: 720, visitMinutes: 15 }),
-            // 3e : 5 km / 6 min, visite par defaut.
-            makeStop({ id: 3, legDistanceM: 5_000, legDurationS: 360, visitMinutes: null }),
-        ]
-
-        const totals = computeTotals(stops, 30)
-
-        expect(totals.totalDistanceM).toBe(15_000)
-        expect(totals.travelDurationS).toBe(1_080)
-        // Visites : 30 + 15 + 30 = 75 min = 4500 s.
-        expect(totals.visitDurationS).toBe(4_500)
-        expect(totals.totalDurationS).toBe(1_080 + 4_500)
-        expect(totals.visitCount).toBe(3)
-    })
-
-    it('renvoie des totaux nuls pour une tournee vide', () => {
-        const totals = computeTotals([], 30)
-        expect(totals.totalDistanceM).toBe(0)
-        expect(totals.totalDurationS).toBe(0)
-        expect(totals.visitCount).toBe(0)
-    })
-})
-
-describe('buildNavigationLinks', () => {
-    it('construit les trois deep links Waze/Google/Apple', () => {
-        const links = buildNavigationLinks({ latitude: 47.218, longitude: -1.553 })
-
-        expect(links).not.toBeNull()
-        expect(links!.waze).toBe('https://waze.com/ul?ll=47.218,-1.553&navigate=yes')
-        expect(links!.google).toBe('https://www.google.com/maps/dir/?api=1&destination=47.218,-1.553')
-        expect(links!.apple).toBe('https://maps.apple.com/?daddr=47.218,-1.553')
-    })
-
-    it('retourne null sans coordonnees (etape a geolocaliser)', () => {
-        expect(buildNavigationLinks(null)).toBeNull()
-        expect(buildNavigationLinks({ latitude: 47.2 })).toBeNull()
-        expect(buildNavigationLinks({ latitude: null, longitude: null })).toBeNull()
-    })
-})
-
-describe('isStopLocated', () => {
-    it('distingue une etape geolocalisee d\'une etape sans coordonnees', () => {
-        expect(isStopLocated({ latitude: 47.2, longitude: -1.5 })).toBe(true)
-        expect(isStopLocated({ latitude: null, longitude: null })).toBe(false)
-    })
-})
-
-describe('formatteurs', () => {
-    it('formate distances et durees', () => {
-        expect(formatDistance(850)).toBe('850 m')
-        expect(formatDistance(12_340)).toBe('12,3 km')
-        expect(formatDistance(null)).toBe('—')
-
-        expect(formatDuration(1_500)).toBe('25 min')
-        expect(formatDuration(5_100)).toBe('1 h 25')
-        expect(formatDuration(null)).toBe('—')
-    })
-
-    it('extrait l\'heure HH:MM d\'une chaine ISO', () => {
-        expect(formatTime('1970-01-01T08:30:00+00:00')).toBe('08:30')
-        expect(formatTime(null)).toBe('—')
-    })
-})

frontend/modules/field-sales/composables/useTourPlanning.ts

@@ -1,178 +0,0 @@
-import type { NavigationLinks, TierType, TourStop, TourTotals } from '~/modules/field-sales/types/tour'
-
-/**
- * Composable de planification de tournee (M6.5).
- *
- * Porte la logique PURE de l'ecran de planification, isolee de Vue/Nuxt pour
- * etre testable directement (Vitest) :
- *  - reordonnancement des etapes (drag & drop) + renumerotation des positions ;
- *  - recalcul instantane des totaux (trajets + visites) pour le feedback UI,
- *    avant le retour serveur du /compute ;
- *  - construction des deep links de navigation « Y aller » (Waze/Google/Apple).
- *
- * Les coordonnees et libelles des etapes sur Tiers referentiel ne sont pas
- * portes par tour_stop:read : l'ecran les resout via GET /visitable_tiers/{id}
- * et alimente un `PlanningStop` enrichi, sur lequel operent ces fonctions.
- */
-
-/** Coordonnees WGS84 minimales d'une cible. */
-export interface LatLng {
-    latitude: number
-    longitude: number
-}
-
-/**
- * Etape « enrichie » manipulee par l'ecran : l'etape API + le libelle, l'adresse
- * et les coordonnees resolus (depuis le Tiers pour une etape referentiel, depuis
- * les colonnes custom_* pour un point libre).
- */
-export interface PlanningStop extends TourStop {
-    /** Nom affichable (raison sociale du Tiers ou libelle du point libre). */
-    label: string
-    /** Adresse formatee sur une ligne. */
-    displayAddress: string
-    /** Coordonnees resolues, ou null si l'etape n'est pas geolocalisee (RG-6.05). */
-    latitude: number | null
-    longitude: number | null
-}
-
-/** Vitesse moyenne par defaut (km/h) — alignee sur HaversineRouteEngine (back). */
-const DEFAULT_SPEED_KMH = 50
-
-/**
- * Deplace l'etape `fromIndex` vers `toIndex` et renumerote toutes les positions
- * (0-indexees, contigues). Retourne un NOUVEAU tableau (pas de mutation).
- */
-export function reorderStops<T extends { position: number }>(stops: readonly T[], fromIndex: number, toIndex: number): T[] {
-    const next = [...stops]
-    if (fromIndex < 0 || fromIndex >= next.length || toIndex < 0 || toIndex >= next.length) {
-        return next
-    }
-    const [moved] = next.splice(fromIndex, 1)
-    if (moved === undefined) {
-        return next
-    }
-    next.splice(toIndex, 0, moved)
-
-    return next.map((stop, index) => ({ ...stop, position: index }))
-}
-
-/**
- * Recalcule les totaux d'une tournee a partir des legs deja calcules et des
- * durees de visite (RG-6.11). Duree totale = trajets + visites.
- */
-export function computeTotals(stops: readonly PlanningStop[], defaultVisitMinutes: number): TourTotals {
-    let totalDistanceM = 0
-    let travelDurationS = 0
-    let visitDurationS = 0
-
-    for (const stop of stops) {
-        totalDistanceM += stop.legDistanceM ?? 0
-        travelDurationS += stop.legDurationS ?? 0
-        visitDurationS += (stop.visitMinutes ?? defaultVisitMinutes) * 60
-    }
-
-    return {
-        totalDistanceM,
-        travelDurationS,
-        visitDurationS,
-        totalDurationS: travelDurationS + visitDurationS,
-        visitCount: stops.length,
-    }
-}
-
-/**
- * Deep links de navigation vers une cible geolocalisee (spec M6 § 6.1).
- * Waze/Google Maps ne prennent qu'UNE destination -> navigation etape par etape
- * (HP-M6-7 assume). Retourne null si la cible n'a pas de coordonnees.
- */
-export function buildNavigationLinks(target: { latitude?: number | null, longitude?: number | null } | null): NavigationLinks | null {
-    if (target == null || target.latitude == null || target.longitude == null) {
-        return null
-    }
-    const lat = target.latitude
-    const lng = target.longitude
-
-    return {
-        waze: `https://waze.com/ul?ll=${lat},${lng}&navigate=yes`,
-        google: `https://www.google.com/maps/dir/?api=1&destination=${lat},${lng}`,
-        apple: `https://maps.apple.com/?daddr=${lat},${lng}`,
-    }
-}
-
-/** Vrai si l'etape est geolocalisee (entre dans le calcul de trajet, RG-6.05). */
-export function isStopLocated(stop: Pick<PlanningStop, 'latitude' | 'longitude'>): boolean {
-    return stop.latitude != null && stop.longitude != null
-}
-
-/** Estime une duree de trajet (s) a partir d'une distance (m) et la vitesse moyenne. */
-export function estimateDurationSeconds(distanceMeters: number, speedKmh: number = DEFAULT_SPEED_KMH): number {
-    if (speedKmh <= 0) {
-        return 0
-    }
-
-    return Math.round((distanceMeters / 1000) / speedKmh * 3600)
-}
-
-/** Formate une distance (m) en « 12,3 km » ou « 850 m ». */
-export function formatDistance(meters: number | null): string {
-    if (meters == null) {
-        return '—'
-    }
-    if (meters < 1000) {
-        return `${Math.round(meters)} m`
-    }
-
-    return `${(meters / 1000).toFixed(1).replace('.', ',')} km`
-}
-
-/** Formate une duree (s) en « 1 h 25 » ou « 25 min ». */
-export function formatDuration(seconds: number | null): string {
-    if (seconds == null) {
-        return '—'
-    }
-    const totalMinutes = Math.round(seconds / 60)
-    const hours = Math.floor(totalMinutes / 60)
-    const minutes = totalMinutes % 60
-    if (hours === 0) {
-        return `${minutes} min`
-    }
-
-    return `${hours} h ${String(minutes).padStart(2, '0')}`
-}
-
-/** Extrait l'heure « HH:MM » d'une chaine ISO (eta / departureTime). */
-export function formatTime(iso: string | null): string {
-    if (iso == null || iso === '') {
-        return '—'
-    }
-    const match = iso.match(/(\d{2}):(\d{2})/)
-
-    return match ? `${match[1]}:${match[2]}` : '—'
-}
-
-/** Libelle FR court d'un type de Tiers (pour la couleur/le badge du pin). */
-export function tierTypeLabel(type: TierType): string {
-    switch (type) {
-        case 'client':
-            return 'Client'
-        case 'supplier':
-            return 'Fournisseur'
-        default:
-            return 'Point libre'
-    }
-}
-
-export function useTourPlanning() {
-    return {
-        reorderStops,
-        computeTotals,
-        buildNavigationLinks,
-        isStopLocated,
-        estimateDurationSeconds,
-        formatDistance,
-        formatDuration,
-        formatTime,
-        tierTypeLabel,
-    }
-}

frontend/modules/field-sales/composables/useToursRepository.ts

@@ -1,15 +0,0 @@
-import { usePaginatedList } from '~/shared/composables/usePaginatedList'
-import type { Tour } from '~/modules/field-sales/types/tour'
-
-/**
- * Liste paginee des tournees (GET /api/tours), branchee sur usePaginatedList
- * (regle ABSOLUE n°13 : toute collection est paginee). Tri par date decroissante
- * par defaut. Le filtre `owner` est applique cote back (RG-6.01) — rien a passer
- * ici.
- */
-export function useToursRepository() {
-    return usePaginatedList<Tour>({
-        url: '/tours',
-        defaultSort: { field: 'tourDate', direction: 'desc' },
-    })
-}

frontend/modules/field-sales/nuxt.config.ts

@@ -1,4 +0,0 @@
-// Layer Nuxt du module « Tournées » (field_sales, M6). Auto-detecte par le
-// shell via le scan de frontend/modules/*/. Config minimale : pages,
-// composants et composables sont decouverts par convention.
-export default defineNuxtConfig({})

frontend/modules/field-sales/pages/tours/[id]/plan.vue

@@ -1,739 +0,0 @@
-<template>
-    <div>
-        <!-- Entete : retour + nom de la tournee. -->
-        <div class="flex items-center gap-3 pt-6 pb-4">
-            <MalioButtonIcon icon="mdi:arrow-left" :aria-label="t('field_sales.plan.back')" @click="goBack" />
-            <h1 class="truncate text-[24px] font-semibold text-primary-500">
-                {{ tour?.label ?? t('field_sales.plan.title') }}
-            </h1>
-        </div>
-
-        <!-- Layout split responsive : carte + panneau cote a cote en desktop,
-             empile en mobile (carte au-dessus). Etat 100 % local. -->
-        <div class="flex flex-col gap-4 lg:h-[calc(100vh-180px)] lg:flex-row">
-            <!-- Carte interactive. -->
-            <div class="relative h-[45vh] overflow-hidden rounded border border-gray-200 lg:h-auto lg:flex-1">
-                <TourMap
-                    ref="mapRef"
-                    :stops="stops"
-                    :types="activeTypes"
-                    :search="mapSearch"
-                    :center="mapCenter"
-                    :start="mapStart"
-                    @add-tier="addTier"
-                    @add-tiers="addTiers"
-                />
-                <!-- Filtres de la carte (types + recherche). -->
-                <div class="absolute right-2 top-2 z-[400] flex flex-col gap-2 rounded bg-white/95 p-2 shadow">
-                    <MalioInputText
-                        v-model="mapSearch"
-                        :placeholder="t('field_sales.plan.map.search')"
-                        icon-name="mdi:magnify"
-                        :reserve-message-space="false"
-                        input-class="w-44"
-                    />
-                    <div class="flex gap-3 text-xs">
-                        <label class="flex items-center gap-1">
-                            <input v-model="showClients" type="checkbox" class="accent-blue-600"> {{ t('field_sales.plan.map.typeClient') }}
-                        </label>
-                        <label class="flex items-center gap-1">
-                            <input v-model="showSuppliers" type="checkbox" class="accent-green-600"> {{ t('field_sales.plan.map.typeSupplier') }}
-                        </label>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Panneau tournee. -->
-            <div class="flex flex-col gap-4 overflow-y-auto rounded border border-gray-200 p-4 lg:w-[420px]">
-                <!-- Parametres de la tournee. -->
-                <div class="flex flex-col gap-3">
-                    <MalioInputText
-                        v-model="panel.label"
-                        :label="t('field_sales.plan.panel.label')"
-                        @update:model-value="debouncedSaveLabel"
-                    />
-                    <div class="flex gap-3">
-                        <MalioDate v-model="panel.tourDate" :label="t('field_sales.plan.panel.date')" class="flex-1" @update:model-value="saveDate" />
-                        <MalioTime v-model="panel.departureTime" :label="t('field_sales.plan.panel.departureTime')" class="flex-1" @update:model-value="saveDepartureTime" />
-                    </div>
-                    <!-- Point de départ : un de mes sites OU une adresse libre (BAN). -->
-                    <div class="flex flex-col gap-2">
-                        <span class="text-sm font-medium text-gray-700">{{ t('field_sales.plan.panel.startLabel') }}</span>
-                        <div class="flex gap-4">
-                            <MalioRadioButton
-                                v-model="startMode"
-                                name="start-mode"
-                                value="site"
-                                :label="t('field_sales.plan.panel.startModeSite')"
-                                :disabled="userSites.length === 0"
-                                group-class="mt-0"
-                            />
-                            <MalioRadioButton
-                                v-model="startMode"
-                                name="start-mode"
-                                value="custom"
-                                :label="t('field_sales.plan.panel.startModeCustom')"
-                                group-class="mt-0"
-                            />
-                        </div>
-                        <MalioSelect
-                            v-if="startMode === 'site'"
-                            :model-value="selectedSiteId"
-                            :options="siteOptions"
-                            :empty-option-label="t('field_sales.plan.panel.startSitePlaceholder')"
-                            @update:model-value="onSiteSelect"
-                        />
-                        <MalioInputAutocomplete
-                            v-else
-                            :model-value="panel.startLabel"
-                            :options="startAddressOptions"
-                            :loading="startAddressLoading"
-                            :min-search-length="3"
-                            :allow-create="true"
-                            :no-results-text="t('field_sales.plan.panel.startNoResults')"
-                            @update:model-value="onStartLabelInput"
-                            @search="onStartAddressSearch"
-                            @select="onStartAddressSelect"
-                        />
-                    </div>
-                    <MalioInputNumber
-                        v-model="panel.defaultVisitMinutes"
-                        :label="t('field_sales.plan.panel.defaultVisitMinutes')"
-                        :min="0"
-                        @update:model-value="debouncedSaveVisitMinutes"
-                    />
-                </div>
-
-                <!-- Totaux. -->
-                <div class="grid grid-cols-3 gap-2 rounded bg-gray-50 p-3 text-center">
-                    <div>
-                        <p class="text-xs text-gray-500">{{ t('field_sales.plan.panel.distance') }}</p>
-                        <p class="font-semibold">{{ formatDistance(totals.totalDistanceM) }}</p>
-                    </div>
-                    <div>
-                        <p class="text-xs text-gray-500">{{ t('field_sales.plan.panel.duration') }}</p>
-                        <p class="font-semibold">{{ formatDuration(totals.totalDurationS) }}</p>
-                    </div>
-                    <div>
-                        <p class="text-xs text-gray-500">{{ t('field_sales.plan.panel.visits') }}</p>
-                        <p class="font-semibold">{{ totals.visitCount }}</p>
-                    </div>
-                </div>
-
-                <!-- Actions tournee. -->
-                <div class="flex flex-wrap gap-2">
-                    <MalioButton variant="primary" :label="t('field_sales.plan.actions.compute')" :disabled="busy" @click="runCompute" />
-                    <MalioButton variant="secondary" :label="t('field_sales.plan.actions.optimize')" :disabled="busy" @click="runOptimize" />
-                    <MalioButton variant="tertiary" :label="t('field_sales.plan.actions.duplicate')" :disabled="busy" @click="duplicateOpen = true" />
-                    <MalioButton variant="tertiary" :label="t('field_sales.plan.actions.pdf')" @click="openPdf" />
-                </div>
-
-                <!-- Etapes draggables. -->
-                <div>
-                    <div class="mb-2 flex items-center justify-between">
-                        <h2 class="font-semibold text-gray-800">{{ t('field_sales.plan.panel.stops') }}</h2>
-                    </div>
-                    <TourStopList
-                        :stops="stops"
-                        @reorder="onReorder"
-                        @remove="removeStop"
-                        @view-tier="viewTier"
-                    />
-                </div>
-            </div>
-        </div>
-
-        <!-- Modale : duplication. -->
-        <MalioModal v-model="duplicateOpen" modal-class="max-w-md">
-            <template #header>
-                <h2 class="text-[22px] font-bold">{{ t('field_sales.plan.duplicateModal.title') }}</h2>
-            </template>
-            <MalioDate v-model="duplicateDate" :label="t('field_sales.plan.duplicateModal.date')" required :error="duplicateError" />
-            <template #footer>
-                <MalioButton variant="secondary" :label="t('field_sales.plan.duplicateModal.cancel')" button-class="flex-1" @click="duplicateOpen = false" />
-                <MalioButton variant="primary" :label="t('field_sales.plan.duplicateModal.confirm')" button-class="flex-1" :disabled="busy" @click="confirmDuplicate" />
-            </template>
-        </MalioModal>
-    </div>
-</template>
-
-<script setup lang="ts">
-import { computed, onMounted, reactive, ref } from 'vue'
-import TourMap from '~/modules/field-sales/components/TourMap.vue'
-import TourStopList from '~/modules/field-sales/components/TourStopList.vue'
-import {
-    computeTotals,
-    formatDistance,
-    formatDuration,
-    formatTime,
-    type PlanningStop,
-} from '~/modules/field-sales/composables/useTourPlanning'
-import { useAddressAutocomplete, type AddressSuggestion } from '~/shared/composables/useAddressAutocomplete'
-import { siteFullAddress, siteOptionLabel } from '~/modules/field-sales/utils/startPoint'
-import type { Tour, TourStop, VisitableTier } from '~/modules/field-sales/types/tour'
-import type { Site } from '~/shared/types/sites'
-
-/**
- * Ecran de planification d'une tournee (M6.5, spec § 6.1).
- *
- * Carte interactive (pins + lasso + trace) a gauche, panneau (parametres,
- * totaux, actions, etapes draggables) a droite ; empile en mobile. Etat 100 %
- * LOCAL (jamais dans l'URL, regle ABSOLUE n°6).
- *
- * Les etapes sur Tiers referentiel ne portent pas leurs coordonnees/nom dans
- * tour_stop:read : on les resout via GET /visitable_tiers/{type}-{addressId}
- * (cache local) pour alimenter des `PlanningStop` enrichis.
- */
-const { t } = useI18n()
-const api = useApi()
-const router = useRouter()
-const route = useRoute()
-const toast = useToast()
-const autocomplete = useAddressAutocomplete()
-const authStore = useAuthStore()
-
-const tourId = computed(() => Number(route.params.id))
-
-// ── Point de départ : choix entre « mes sites » et « adresse libre » ─────────
-// Les sites de l'utilisateur (embarqués dans /api/me) servent de départs
-// pré-enregistrés ; sinon une adresse libre géocodée via la BAN.
-const userSites = computed<Site[]>(() => authStore.user?.sites ?? [])
-const startMode = ref<'site' | 'custom'>('custom')
-const selectedSiteId = ref<number | null>(null)
-// Le mode de départ n'est dérivé du back qu'au premier chargement (cf. applyTour).
-const startModeInitialized = ref(false)
-const siteOptions = computed(() => userSites.value.map(s => ({ value: s.id, label: siteOptionLabel(s) })))
-// Suggestions BAN du champ « adresse libre » (mode custom).
-const startAddressOptions = ref<Array<{ value: string, label: string }>>([])
-const startAddressLoading = ref(false)
-let startAddressSuggestions: AddressSuggestion[] = []
-
-/** Libellé stocké quand on choisit un site : « Site de {nom} — {adresse} ». */
-function composeSiteStartLabel(site: Site): string {
-    return `${t('field_sales.plan.panel.startSitePrefix', { name: site.name })} — ${siteFullAddress(site)}`
-}
-
-const tour = ref<Tour | null>(null)
-const stops = ref<PlanningStop[]>([])
-const busy = ref(false)
-const mapRef = ref<InstanceType<typeof TourMap> | null>(null)
-
-useHead({ title: () => tour.value?.label ?? t('field_sales.plan.title') })
-
-// Cache des infos Tiers (nom/adresse/coords) par cle « type-addressId » : evite
-// de refetcher /visitable_tiers/{id} a chaque recompute.
-const tierCache = new Map<string, { label: string, displayAddress: string, latitude: number, longitude: number }>()
-
-// ── Panneau (formulaire local synchronise avec la tournee) ──────────────────
-// defaultVisitMinutes est une chaine (MalioInputNumber est un v-model string).
-const panel = reactive<{
-    label: string
-    tourDate: string | null
-    departureTime: string | null
-    startLabel: string
-    defaultVisitMinutes: string
-}>({
-    label: '',
-    tourDate: null,
-    departureTime: null,
-    startLabel: '',
-    defaultVisitMinutes: '30',
-})
-
-/** Debounce simple (les saves lisent l'etat `panel`, donc sans argument). */
-function debounce(fn: () => void, ms: number): () => void {
-    let handle: ReturnType<typeof setTimeout> | null = null
-
-    return () => {
-        if (handle !== null) {
-            clearTimeout(handle)
-        }
-        handle = setTimeout(fn, ms)
-    }
-}
-const debouncedSaveLabel = debounce(() => { void saveLabel() }, 600)
-const debouncedSaveStart = debounce(() => { void saveStart() }, 800)
-const debouncedSaveVisitMinutes = debounce(() => { void saveVisitMinutes() }, 600)
-
-// ── Carte : filtres ──────────────────────────────────────────────────────────
-const showClients = ref(true)
-const showSuppliers = ref(true)
-const mapSearch = ref('')
-const activeTypes = computed<Array<'client' | 'supplier'>>(() => {
-    const types: Array<'client' | 'supplier'> = []
-    if (showClients.value) {
-        types.push('client')
-    }
-    if (showSuppliers.value) {
-        types.push('supplier')
-    }
-
-    return types
-})
-const mapCenter = ref<[number, number]>([47.218, -1.553])
-
-// Point de départ géolocalisé à afficher sur la carte (marqueur « maison »).
-// Le back stocke lat/lng en chaînes ; null tant que la BAN n'a rien géocodé.
-const mapStart = computed<{ latitude: number, longitude: number, label?: string } | null>(() => {
-    const lat = tour.value?.startLatitude
-    const lng = tour.value?.startLongitude
-    if (lat == null || lng == null) {
-        return null
-    }
-    const latNum = Number(lat)
-    const lngNum = Number(lng)
-    if (!Number.isFinite(latNum) || !Number.isFinite(lngNum)) {
-        return null
-    }
-
-    return { latitude: latNum, longitude: lngNum, label: tour.value?.startLabel ?? undefined }
-})
-
-// ── Totaux recalcules localement (feedback instantane) ──────────────────────
-const totals = computed(() => computeTotals(stops.value, Number(panel.defaultVisitMinutes) || 0))
-
-// ── Modales ──────────────────────────────────────────────────────────────────
-const duplicateOpen = ref(false)
-const duplicateDate = ref<string | null>(null)
-const duplicateError = ref('')
-
-// =============================================================================
-// Chargement + enrichissement
-// =============================================================================
-onMounted(loadTour)
-
-async function loadTour(): Promise<void> {
-    try {
-        const raw = await api.get<Tour>(`/tours/${tourId.value}`, {}, {
-            headers: { Accept: 'application/ld+json' },
-            toast: false,
-        })
-        await applyTour(raw, true)
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.loadError') })
-        router.push('/tours')
-    }
-}
-
-/** Applique une reponse Tour au state local. `withStops` re-enrichit les etapes. */
-async function applyTour(raw: Tour, withStops: boolean): Promise<void> {
-    tour.value = raw
-    panel.label = raw.label
-    panel.tourDate = raw.tourDate ? raw.tourDate.slice(0, 10) : null
-    panel.departureTime = extractTime(raw.departureTime)
-    panel.startLabel = raw.startLabel ?? ''
-    panel.defaultVisitMinutes = String(raw.defaultVisitMinutes)
-
-    // Mode du point de départ : dérivé UNE SEULE FOIS, au premier chargement de
-    // la tournée. Les `patchTour` suivants (sauvegardes) rappellent `applyTour`
-    // mais ne doivent pas réécraser le choix explicite de l'utilisateur (sinon
-    // sélectionner un site, qui déclenche un PATCH, ré-évalue le mode et peut
-    // retomber en « adresse libre » sur la moindre divergence de libellé).
-    if (!startModeInitialized.value) {
-        const matchedSite = userSites.value.find(s => composeSiteStartLabel(s) === panel.startLabel)
-        if (matchedSite) {
-            startMode.value = 'site'
-            selectedSiteId.value = matchedSite.id
-        }
-        else {
-            startMode.value = panel.startLabel === '' && userSites.value.length > 0 ? 'site' : 'custom'
-            selectedSiteId.value = null
-        }
-        startModeInitialized.value = true
-    }
-
-    if (withStops) {
-        stops.value = await enrichStops(raw.stops ?? [])
-        recenterOnFirstStop()
-    }
-}
-
-/** Resout nom/adresse/coords de chaque etape en `PlanningStop`. */
-async function enrichStops(rawStops: TourStop[]): Promise<PlanningStop[]> {
-    const ordered = [...rawStops].sort((a, b) => a.position - b.position)
-
-    return Promise.all(ordered.map(async (stop): Promise<PlanningStop> => {
-        if (stop.tierType === 'custom') {
-            return {
-                ...stop,
-                label: stop.customLabel ?? '',
-                displayAddress: stop.customAddress ?? '',
-                latitude: stop.customLatitude != null ? Number(stop.customLatitude) : null,
-                longitude: stop.customLongitude != null ? Number(stop.customLongitude) : null,
-            }
-        }
-
-        const info = await resolveTier(stop.tierType, stop.addressId)
-
-        return {
-            ...stop,
-            label: info?.label ?? `#${stop.tierId}`,
-            displayAddress: info?.displayAddress ?? '',
-            latitude: info?.latitude ?? null,
-            longitude: info?.longitude ?? null,
-        }
-    }))
-}
-
-/** Infos d'un Tiers (cache + GET /visitable_tiers/{type-addressId}). */
-async function resolveTier(tierType: string, addressId: number | null) {
-    if (addressId === null) {
-        return null
-    }
-    const key = `${tierType}-${addressId}`
-    const cached = tierCache.get(key)
-    if (cached) {
-        return cached
-    }
-    try {
-        const tier = await api.get<VisitableTier>(`/visitable_tiers/${key}`, {}, {
-            headers: { Accept: 'application/ld+json' },
-            toast: false,
-        })
-        const info = {
-            label: tier.displayName,
-            displayAddress: tier.address,
-            latitude: tier.latitude,
-            longitude: tier.longitude,
-        }
-        tierCache.set(key, info)
-
-        return info
-    }
-    catch {
-        return null
-    }
-}
-
-function recenterOnFirstStop(): void {
-    const located = stops.value.find(s => s.latitude != null && s.longitude != null)
-    if (located) {
-        mapCenter.value = [located.latitude as number, located.longitude as number]
-    }
-}
-
-// =============================================================================
-// Ajout d'etapes (carte)
-// =============================================================================
-async function addTier(tier: VisitableTier): Promise<void> {
-    // Pre-alimente le cache (la carte connait deja nom/adresse/coords du pin).
-    tierCache.set(`${tier.tierType}-${tier.addressId}`, {
-        label: tier.displayName,
-        displayAddress: tier.address,
-        latitude: tier.latitude,
-        longitude: tier.longitude,
-    })
-    await postStop({
-        tierType: tier.tierType,
-        tierId: tier.tierId,
-        addressId: tier.addressId,
-        position: stops.value.length,
-    })
-}
-
-async function addTiers(tiers: VisitableTier[]): Promise<void> {
-    if (busy.value) {
-        return
-    }
-    busy.value = true
-    try {
-        let position = stops.value.length
-        for (const tier of tiers) {
-            tierCache.set(`${tier.tierType}-${tier.addressId}`, {
-                label: tier.displayName,
-                displayAddress: tier.address,
-                latitude: tier.latitude,
-                longitude: tier.longitude,
-            })
-            await api.post('/tours/' + tourId.value + '/stops', {
-                tierType: tier.tierType,
-                tierId: tier.tierId,
-                addressId: tier.addressId,
-                position: position++,
-            }, { toast: false })
-        }
-        await runCompute()
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.stopError') })
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-/** POST d'une etape puis recompute (factorise add tier / custom). */
-async function postStop(payload: Record<string, unknown>): Promise<void> {
-    if (busy.value) {
-        return
-    }
-    busy.value = true
-    try {
-        await api.post('/tours/' + tourId.value + '/stops', payload, { toast: false })
-        await runCompute()
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.stopError') })
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-// =============================================================================
-// Reordonnancement / suppression / navigation
-// =============================================================================
-async function onReorder(next: PlanningStop[]): Promise<void> {
-    if (busy.value) {
-        return
-    }
-    // Optimisme : on reflete l'ordre immediatement, le serveur recalcule ensuite.
-    stops.value = next.map((s, i) => ({ ...s, position: i }))
-    busy.value = true
-    try {
-        const raw = await api.post<Tour>('/tours/' + tourId.value + '/reorder', {
-            stopIds: next.map(s => s.id),
-        }, { headers: { Accept: 'application/ld+json' }, toast: false })
-        await applyTour(raw, true)
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.stopError') })
-        await loadTour()
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-async function removeStop(stop: PlanningStop): Promise<void> {
-    if (busy.value) {
-        return
-    }
-    busy.value = true
-    try {
-        await api.delete(`/tour_stops/${stop.id}`, {}, { toast: false })
-        await runCompute()
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.stopError') })
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-function viewTier(stop: PlanningStop): void {
-    if (stop.tierId === null) {
-        return
-    }
-    router.push(stop.tierType === 'supplier' ? `/suppliers/${stop.tierId}` : `/clients/${stop.tierId}`)
-}
-
-// =============================================================================
-// Actions tournee : compute / optimize / duplicate / pdf
-// =============================================================================
-async function runCompute(): Promise<void> {
-    await runTourAction('/compute', 'computeError')
-}
-
-async function runOptimize(): Promise<void> {
-    await runTourAction('/optimize', 'optimizeError')
-}
-
-/** Factorise compute/optimize : POST sans corps -> reapplique la tournee. */
-async function runTourAction(path: string, errorKey: string): Promise<void> {
-    const wasBusy = busy.value
-    busy.value = true
-    try {
-        const raw = await api.post<Tour>('/tours/' + tourId.value + path, {}, {
-            headers: { Accept: 'application/ld+json' },
-            toast: false,
-        })
-        await applyTour(raw, true)
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t(`field_sales.plan.toast.${errorKey}`) })
-    }
-    finally {
-        busy.value = wasBusy ? busy.value : false
-    }
-}
-
-async function confirmDuplicate(): Promise<void> {
-    duplicateError.value = ''
-    if (duplicateDate.value === null || duplicateDate.value === '') {
-        duplicateError.value = t('field_sales.plan.duplicateModal.date')
-        return
-    }
-    busy.value = true
-    try {
-        const copy = await api.post<Tour>('/tours/' + tourId.value + '/duplicate', {
-            tourDate: duplicateDate.value,
-        }, { headers: { Accept: 'application/ld+json' }, toast: false })
-        toast.success({ title: t('field_sales.tours.title'), message: t('field_sales.plan.toast.duplicated') })
-        duplicateOpen.value = false
-        router.push(`/tours/${copy.id}/plan`)
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.duplicateError') })
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-/** Ouvre la feuille de route PDF (le cookie JWT est envoye avec la requete). */
-function openPdf(): void {
-    window.open(`/api/tours/${tourId.value}/roadbook.pdf`, '_blank')
-}
-
-// =============================================================================
-// Sauvegarde des parametres du panneau (PATCH, recompute si ETA impactee)
-// =============================================================================
-async function saveLabel(): Promise<void> {
-    if (panel.label.trim() !== '' && panel.label !== tour.value?.label) {
-        await patchTour({ label: panel.label.trim() }, false)
-    }
-}
-
-async function saveDate(): Promise<void> {
-    if (panel.tourDate) {
-        await patchTour({ tourDate: panel.tourDate }, false)
-    }
-}
-
-async function saveDepartureTime(): Promise<void> {
-    if (panel.departureTime) {
-        await patchTour({ departureTime: panel.departureTime }, true)
-    }
-}
-
-async function saveVisitMinutes(): Promise<void> {
-    const minutes = Number(panel.defaultVisitMinutes)
-    if (!Number.isFinite(minutes) || minutes < 0) {
-        return
-    }
-    await patchTour({ defaultVisitMinutes: minutes }, true)
-}
-
-/**
- * Persiste le point de départ : `label` est ce qui est stocké/affiché (ex.
- * « Site de Châtellerault — … » ou l'adresse libre), `geocodeQuery` l'adresse
- * postale réellement géocodée via la BAN. Coords nulles si la BAN ne trouve rien
- * (le badge « à géolocaliser » s'affiche, la tournée reste sauvegardable).
- */
-async function persistStart(label: string, geocodeQuery: string): Promise<void> {
-    const trimmed = label.trim()
-    if (trimmed === '' && (tour.value?.startLabel ?? '') === '') {
-        return
-    }
-    let coords: { latitude: string, longitude: string } | null = null
-    if (geocodeQuery.trim() !== '') {
-        try {
-            coords = await autocomplete.geocode(geocodeQuery.trim())
-        }
-        catch {
-            coords = null
-        }
-    }
-    await patchTour({
-        startLabel: trimmed === '' ? null : trimmed,
-        startLatitude: coords?.latitude ?? null,
-        startLongitude: coords?.longitude ?? null,
-    }, true)
-}
-
-/** Mode « adresse libre » : saisie au clavier → géocode le texte tel quel. */
-async function saveStart(): Promise<void> {
-    await persistStart(panel.startLabel, panel.startLabel)
-}
-
-/** Met à jour le texte du champ « adresse libre » (puis save débouncé). */
-function onStartLabelInput(value: string | number | null): void {
-    panel.startLabel = value === null ? '' : String(value)
-    debouncedSaveStart()
-}
-
-/** Mode « mes sites » : choix d'un site → libellé « Site de … » + géocodage de son adresse. */
-async function onSiteSelect(value: string | number | null): Promise<void> {
-    const id = value === null || value === '' ? null : Number(value)
-    selectedSiteId.value = id
-    const site = userSites.value.find(s => s.id === id)
-    if (!site) {
-        panel.startLabel = ''
-        await persistStart('', '')
-        return
-    }
-    const label = composeSiteStartLabel(site)
-    panel.startLabel = label
-    await persistStart(label, siteFullAddress(site))
-}
-
-/** Recherche d'adresse assistée (event de MalioInputAutocomplete, mode libre). */
-async function onStartAddressSearch(query: string): Promise<void> {
-    if (query.trim().length < 3) {
-        startAddressOptions.value = []
-        return
-    }
-    startAddressLoading.value = true
-    try {
-        const suggestions = await autocomplete.searchAddress(query)
-        startAddressSuggestions = suggestions
-        startAddressOptions.value = suggestions.map(s => ({ value: s.label, label: s.label }))
-    }
-    catch {
-        // Erreur transitoire : on vide les suggestions (la frappe suivante réessaie).
-        startAddressOptions.value = []
-    }
-    finally {
-        startAddressLoading.value = false
-    }
-}
-
-/** Sélection d'une suggestion d'adresse libre → libellé = adresse, puis géocodage. */
-async function onStartAddressSelect(option: { label: string, value: string | number } | null): Promise<void> {
-    if (option === null) {
-        return
-    }
-    const suggestion = startAddressSuggestions.find(s => s.label === option.value)
-    const label = suggestion?.label ?? String(option.value)
-    panel.startLabel = label
-    await persistStart(label, label)
-}
-
-/** PATCH /tours/{id}. `recompute` enchaine /compute (ETA impactee). */
-async function patchTour(partial: Record<string, unknown>, recompute: boolean): Promise<void> {
-    busy.value = true
-    try {
-        const raw = await api.patch<Tour>(`/tours/${tourId.value}`, partial, {
-            headers: { Accept: 'application/ld+json' },
-            toast: false,
-        })
-        // PATCH renvoie tour:read SANS etapes : on ne touche pas a `stops`.
-        await applyTour(raw, false)
-        if (recompute) {
-            await runCompute()
-        }
-    }
-    catch {
-        toast.error({ title: t('errors.title'), message: t('field_sales.plan.toast.saveError') })
-    }
-    finally {
-        busy.value = false
-    }
-}
-
-// =============================================================================
-// Utilitaires
-// =============================================================================
-function extractTime(iso: string | null): string | null {
-    const formatted = formatTime(iso)
-
-    return formatted === '—' ? null : formatted
-}
-
-function goBack(): void {
-    router.push('/tours')
-}
-</script>

frontend/modules/field-sales/pages/tours/index.vue

@@ -1,124 +0,0 @@
-<template>
-    <div>
-        <PageHeader>
-            {{ t('field_sales.tours.title') }}
-            <template #actions>
-                <MalioButton
-                    v-if="canManage"
-                    variant="secondary"
-                    :label="t('field_sales.tours.add')"
-                    icon-name="mdi:add-bold"
-                    icon-position="left"
-                    @click="goToCreate"
-                />
-            </template>
-        </PageHeader>
-
-        <MalioDataTable
-            :columns="columns"
-            :items="rows"
-            :total-items="totalItems"
-            :page="currentPage"
-            :per-page="itemsPerPage"
-            :per-page-options="itemsPerPageOptions"
-            row-clickable
-            :empty-message="t('field_sales.tours.empty')"
-            @row-click="onRowClick"
-            @update:page="goToPage"
-            @update:per-page="setItemsPerPage"
-        >
-            <template #cell-tourDate="{ item }">
-                {{ formatDate(item.tourDate as string) }}
-            </template>
-            <template #cell-status="{ item }">
-                <span class="inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium" :class="statusClass(item.status as TourStatus)">
-                    {{ t(`field_sales.tours.status.${item.status}`) }}
-                </span>
-            </template>
-            <template #cell-distance="{ item }">
-                {{ formatDistance((item.totalDistanceM as number | null) ?? null) }}
-            </template>
-            <template #cell-duration="{ item }">
-                {{ formatDuration((item.totalDurationS as number | null) ?? null) }}
-            </template>
-        </MalioDataTable>
-    </div>
-</template>
-
-<script setup lang="ts">
-import { computed, onMounted } from 'vue'
-import { useToursRepository } from '~/modules/field-sales/composables/useToursRepository'
-import { formatDistance, formatDuration } from '~/modules/field-sales/composables/useTourPlanning'
-import type { Tour, TourStatus } from '~/modules/field-sales/types/tour'
-
-const { t } = useI18n()
-const router = useRouter()
-const { can } = usePermissions()
-
-useHead({ title: t('field_sales.tours.title') })
-
-const canManage = computed(() => can('field_sales.tours.manage'))
-
-const {
-    items: tours,
-    totalItems,
-    currentPage,
-    itemsPerPage,
-    itemsPerPageOptions,
-    fetch: loadTours,
-    goToPage,
-    setItemsPerPage,
-} = useToursRepository()
-
-const rows = computed(() => tours.value.map(tour => ({
-    id: tour.id,
-    label: tour.label,
-    tourDate: tour.tourDate,
-    status: tour.status,
-    totalDistanceM: tour.totalDistanceM,
-    totalDurationS: tour.totalDurationS,
-})))
-
-const columns = [
-    { key: 'label', label: t('field_sales.tours.column.label') },
-    { key: 'tourDate', label: t('field_sales.tours.column.date') },
-    { key: 'status', label: t('field_sales.tours.column.status') },
-    { key: 'distance', label: t('field_sales.tours.column.distance') },
-    { key: 'duration', label: t('field_sales.tours.column.duration') },
-]
-
-/** Couleur du badge de statut. */
-function statusClass(status: TourStatus): string {
-    switch (status) {
-        case 'planned':
-            return 'bg-blue-100 text-blue-800'
-        case 'in_progress':
-            return 'bg-amber-100 text-amber-800'
-        case 'done':
-            return 'bg-green-100 text-green-800'
-        default:
-            return 'bg-gray-100 text-gray-700'
-    }
-}
-
-/** Date courte FR (la date arrive en ISO depuis l'API). */
-function formatDate(iso: string): string {
-    if (!iso) {
-        return ''
-    }
-    const date = new Date(iso)
-
-    return Number.isNaN(date.getTime()) ? '' : date.toLocaleDateString('fr-FR')
-}
-
-/** Clic ligne → ecran de planification de la tournee. */
-function onRowClick(item: Record<string, unknown>): void {
-    router.push(`/tours/${(item as { id: Tour['id'] }).id}/plan`)
-}
-
-function goToCreate(): void {
-    router.push('/tours/new')
-}
-
-onMounted(loadTours)
-</script>

frontend/modules/field-sales/pages/tours/new.vue

@@ -1,96 +0,0 @@
-<template>
-    <div>
-        <PageHeader>
-            {{ t('field_sales.tours.new.title') }}
-        </PageHeader>
-
-        <div class="mx-auto max-w-xl">
-            <form class="flex flex-col gap-4" @submit.prevent="submit">
-                <MalioInputText
-                    v-model="form.label"
-                    :label="t('field_sales.tours.new.label')"
-                    required
-                    :error="errors.label"
-                />
-                <MalioDate
-                    v-model="form.tourDate"
-                    :label="t('field_sales.tours.new.date')"
-                    required
-                    :error="errors.tourDate"
-                />
-
-                <div class="mt-2 flex justify-end gap-3">
-                    <MalioButton
-                        variant="secondary"
-                        :label="t('field_sales.tours.new.cancel')"
-                        type="button"
-                        @click="cancel"
-                    />
-                    <MalioButton
-                        variant="primary"
-                        :label="t('field_sales.tours.new.create')"
-                        type="submit"
-                        :disabled="submitting"
-                    />
-                </div>
-            </form>
-        </div>
-    </div>
-</template>
-
-<script setup lang="ts">
-import { reactive, ref } from 'vue'
-import { useFormErrors } from '~/shared/composables/useFormErrors'
-import type { Tour } from '~/modules/field-sales/types/tour'
-
-/**
- * Creation d'une tournee (draft). Formulaire minimal (nom + date) : le reste de
- * la planification (etapes, point de depart, heure) se fait sur l'ecran de
- * planification une fois la tournee creee. Validation inline 422 via useFormErrors.
- */
-const { t } = useI18n()
-const api = useApi()
-const router = useRouter()
-const { can } = usePermissions()
-const { errors, clearErrors, handleApiError } = useFormErrors()
-
-useHead({ title: t('field_sales.tours.new.title') })
-
-// Garde-fou : sans manage, on renvoie vers la liste (le back refuse de toute facon).
-if (!can('field_sales.tours.manage')) {
-    router.replace('/tours')
-}
-
-const form = reactive<{ label: string, tourDate: string | null }>({
-    label: '',
-    tourDate: null,
-})
-const submitting = ref(false)
-
-async function submit(): Promise<void> {
-    if (submitting.value) {
-        return
-    }
-    clearErrors()
-    submitting.value = true
-    try {
-        const tour = await api.post<Tour>('/tours', {
-            label: form.label,
-            tourDate: form.tourDate,
-        }, { toast: false })
-
-        // Enchaine directement sur la planification de la tournee creee.
-        router.push(`/tours/${tour.id}/plan`)
-    }
-    catch (e) {
-        handleApiError(e, { fallbackMessage: t('field_sales.tours.new.error') })
-    }
-    finally {
-        submitting.value = false
-    }
-}
-
-function cancel(): void {
-    router.push('/tours')
-}
-</script>

frontend/modules/field-sales/types/tour.ts

@@ -1,84 +0,0 @@
-/**
- * Types du module « Tournées » (field_sales, M6.5).
- *
- * Reflet des DTO exposes par l'API (groupes `tour:read` / `tour_stop:read` /
- * VisitableTier). Les dates/heures arrivent en chaines ISO 8601 ; le formatage
- * d'affichage (HH:MM, jj/mm/aaaa) est fait dans les ecrans.
- */
-
-/** Type de Tiers visitable cote front (aligne sur l'enum ouvert du back). */
-export type TierType = 'client' | 'supplier' | 'custom'
-
-/** Cycle de vie d'une tournee (RG-6.02). */
-export type TourStatus = 'draft' | 'planned' | 'in_progress' | 'done'
-
-/** Une etape de tournee (tour_stop:read). */
-export interface TourStop {
-    id: number
-    tierType: TierType
-    tierId: number | null
-    addressId: number | null
-    customLabel: string | null
-    customAddress: string | null
-    customLatitude: string | null
-    customLongitude: string | null
-    position: number
-    visitMinutes: number | null
-    /** Distance depuis l'etape precedente (m), calculee (compute). */
-    legDistanceM: number | null
-    /** Duree de trajet depuis l'etape precedente (s), calculee. */
-    legDurationS: number | null
-    /** Heure d'arrivee estimee (ISO time), calculee (RG-6.11). */
-    eta: string | null
-}
-
-/** Une tournee (tour:read + stops embarquees en tour:item:read). */
-export interface Tour {
-    id: number
-    label: string
-    /** Date de realisation (ISO date). */
-    tourDate: string
-    /** Heure de depart (ISO time). */
-    departureTime: string
-    startLatitude: string | null
-    startLongitude: string | null
-    startLabel: string | null
-    defaultVisitMinutes: number
-    status: TourStatus
-    totalDistanceM: number | null
-    totalDurationS: number | null
-    stops?: TourStop[]
-}
-
-/** Un pin de la carte = une adresse geolocalisee d'un Tiers (VisitableTier). */
-export interface VisitableTier {
-    id: string
-    tierType: Exclude<TierType, 'custom'>
-    tierId: number
-    addressId: number
-    displayName: string
-    address: string
-    latitude: number
-    longitude: number
-}
-
-/** Liens d'ouverture de navigation externe (« Y aller »). */
-export interface NavigationLinks {
-    waze: string
-    google: string
-    apple: string
-}
-
-/** Totaux d'une tournee recalcules cote front (feedback instantane). */
-export interface TourTotals {
-    /** Distance cumulee des trajets (m). */
-    totalDistanceM: number
-    /** Duree totale = trajets + visites (s). */
-    totalDurationS: number
-    /** Duree de trajet seule (s). */
-    travelDurationS: number
-    /** Duree de visite cumulee (s). */
-    visitDurationS: number
-    /** Nombre de visites (etapes). */
-    visitCount: number
-}

frontend/modules/field-sales/utils/__tests__/startPoint.spec.ts

@@ -1,35 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import { siteFullAddress, siteOptionLabel, type StartSite } from '../startPoint'
-
-function site(over: Partial<StartSite> = {}): StartSite {
-    return {
-        name: 'Châtellerault',
-        street: "14 allée d'Argenson",
-        postalCode: '86100',
-        city: 'Châtellerault',
-        ...over,
-    }
-}
-
-describe('startPoint — siteFullAddress', () => {
-    it('utilise fullAddress du backend quand il est présent', () => {
-        expect(siteFullAddress(site({ fullAddress: "14 allée d'Argenson, 86100 Châtellerault" })))
-            .toBe("14 allée d'Argenson, 86100 Châtellerault")
-    })
-
-    it('recompose « rue, CP ville » quand fullAddress est absent', () => {
-        expect(siteFullAddress(site({ fullAddress: undefined })))
-            .toBe("14 allée d'Argenson, 86100 Châtellerault")
-    })
-
-    it('ignore les segments vides à la recomposition', () => {
-        expect(siteFullAddress({ name: 'X', street: '', postalCode: '79000', city: 'Niort' }))
-            .toBe('79000 Niort')
-    })
-})
-
-describe('startPoint — siteOptionLabel', () => {
-    it('formate « nom — code postal »', () => {
-        expect(siteOptionLabel(site())).toBe('Châtellerault — 86100')
-    })
-})

frontend/modules/field-sales/utils/startPoint.ts

@@ -1,37 +0,0 @@
-/**
- * Helpers purs du « Point de départ » d'une tournée (M6.5+).
- *
- * Le point de départ peut être choisi parmi les sites de l'utilisateur ou saisi
- * en adresse libre (autocomplete BAN). Ces helpers ne touchent ni à l'API ni à
- * l'état réactif : ils formatent des libellés à partir d'un site, donc testables
- * unitairement (cf. startPoint.spec.ts). La composition du libellé stocké
- * (`startLabel`) reste dans le composant car elle dépend d'i18n (préfixe
- * « Site de … »).
- */
-
-/** Sous-ensemble d'un site nécessaire au formatage du point de départ. */
-export interface StartSite {
-    name: string
-    street: string
-    postalCode: string
-    city: string
-    /** Adresse complète reconstituée côté backend (peut être absente). */
-    fullAddress?: string
-}
-
-/**
- * Adresse postale complète d'un site (« rue, CP ville »), à géocoder via la BAN.
- * Utilise `fullAddress` du backend si présent, sinon recompose depuis les champs.
- */
-export function siteFullAddress(site: StartSite): string {
-    if (site.fullAddress && site.fullAddress.trim() !== '') {
-        return site.fullAddress.trim()
-    }
-    const cityLine = [site.postalCode, site.city].filter(Boolean).join(' ')
-    return [site.street, cityLine].filter(Boolean).join(', ')
-}
-
-/** Libellé d'une option du select de sites : « {nom} — {code postal} ». */
-export function siteOptionLabel(site: Pick<StartSite, 'name' | 'postalCode'>): string {
-    return `${site.name} — ${site.postalCode}`
-}

frontend/modules/logistique/nuxt.config.ts

@@ -0,0 +1 @@
+export default defineNuxtConfig({})

frontend/modules/sites/components/SiteDrawer.vue

@@ -103,7 +103,7 @@
                 @click="emit('update:modelValue', false)"
             />
             <MalioButton
-                :label="t('common.save')"
+                :label="isEditMode ? t('common.save') : t('common.validate')"
                 variant="primary"
                 button-class="w-m-btn-action"
                 :disabled="saving || !isValidHex"

frontend/modules/technique/components/ProviderAddressBlock.vue

@@ -0,0 +1,269 @@
+<template>
+    <div class="relative grid grid-cols-4 gap-x-[44px] gap-y-4 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
+        <!-- Suppression : modal de confirmation cote parent. -->
+        <MalioButtonIcon
+            v-if="removable && !readonly"
+            icon="mdi:delete-outline"
+            variant="ghost"
+            button-class="absolute top-3 right-3"
+            v-bind="{ ariaLabel: t('technique.providers.form.address.remove') }"
+            @click="$emit('remove')"
+        />
+
+        <!-- Sites Starseed : multiselect a tags (>= 1 obligatoire, RG-3.05). -->
+        <MalioSelectCheckbox
+            :model-value="model.siteIris"
+            :options="siteOptions"
+            :label="t('technique.providers.form.address.sites')"
+            :display-tag="true"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.sites"
+            @update:model-value="(v: (string | number)[]) => update('siteIris', v.map(String))"
+        />
+
+        <!-- Categories de type PRESTATAIRE (>= 1 obligatoire, RG-3.09). -->
+        <MalioSelectCheckbox
+            :model-value="model.categoryIris"
+            :options="categoryOptions"
+            :label="t('technique.providers.form.address.categories')"
+            :display-tag="true"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.categories"
+            @update:model-value="(v: (string | number)[]) => update('categoryIris', v.map(String))"
+        />
+
+        <!-- Contacts rattaches (M2M, facultatif) : alimente par l'onglet Contact. -->
+        <MalioSelectCheckbox
+            :model-value="model.contactIris"
+            :options="contactOptions"
+            :label="t('technique.providers.form.address.contacts')"
+            :display-tag="true"
+            :readonly="readonly"
+            @update:model-value="(v: (string | number)[]) => update('contactIris', v.map(String))"
+        />
+
+        <MalioSelect
+            :model-value="model.country"
+            :options="countryOptions"
+            :label="t('technique.providers.form.address.country')"
+            :readonly="readonly"
+            :required="true"
+            @update:model-value="(v: string | number | null) => update('country', String(v ?? 'France'))"
+        />
+
+        <MalioInputText
+            :model-value="model.postalCode"
+            :label="t('technique.providers.form.address.postalCode')"
+            :mask="POSTAL_CODE_MASK"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.postalCode"
+            @update:model-value="onPostalCodeChange"
+        />
+
+        <!-- Ville : MalioSelect alimente par le code postal (BAN). Saisie libre si BAN indispo. -->
+        <MalioSelect
+            v-if="!degraded"
+            :model-value="model.city"
+            :options="cityOptions"
+            :label="t('technique.providers.form.address.city')"
+            :readonly="readonly"
+            empty-option-label=""
+            :required="true"
+            :error="errors?.city"
+            @update:model-value="(v: string | number | null) => update('city', v === null ? null : String(v))"
+        />
+        <MalioInputText
+            v-else
+            :model-value="model.city"
+            :label="t('technique.providers.form.address.city')"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.city"
+            @update:model-value="(v: string) => update('city', v)"
+        />
+
+        <!-- Adresse (BAN) sur 2 colonnes + Adresse complementaire. allow-create : le
+             texte saisi est conserve si la BAN ne propose rien (saisie manuelle). -->
+        <div class="col-span-2">
+            <MalioInputAutocomplete
+                v-if="!readonly"
+                :model-value="model.street"
+                :options="addressOptions"
+                :loading="addressLoading"
+                :min-search-length="3"
+                :label="t('technique.providers.form.address.street')"
+                :readonly="readonly"
+                :required="true"
+                :error="errors?.street"
+                :allow-create="true"
+                :no-results-text="t('technique.providers.form.address.streetNotFound')"
+                @update:model-value="(v: string | number | null) => update('street', v === null ? null : String(v))"
+                @search="onAddressSearch"
+                @select="onAddressSelect"
+            />
+            <MalioInputText
+                v-else
+                :model-value="model.street"
+                :label="t('technique.providers.form.address.street')"
+                :readonly="readonly"
+                :required="true"
+                :error="errors?.street"
+                @update:model-value="(v: string) => update('street', v)"
+            />
+        </div>
+
+        <div class="col-span-1">
+            <MalioInputText
+                :model-value="model.streetComplement"
+                :label="t('technique.providers.form.address.streetComplement')"
+                :readonly="readonly"
+                :error="errors?.streetComplement"
+                @update:model-value="(v: string) => update('streetComplement', v)"
+            />
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+import { useAddressAutocomplete, type AddressSuggestion } from '~/shared/composables/useAddressAutocomplete'
+import type { RefOption } from '~/modules/technique/composables/useProviderReferentials'
+import type { ProviderAddressFormDraft } from '~/modules/technique/types/providerForm'
+
+// Masque code postal FR : 5 chiffres.
+const POSTAL_CODE_MASK = '#####'
+
+const props = defineProps<{
+    /** Brouillon de l'adresse (v-model). */
+    modelValue: ProviderAddressFormDraft
+    /** Categories autorisees sur une adresse (type PRESTATAIRE). */
+    categoryOptions: RefOption[]
+    /** Sites Starseed disponibles. */
+    siteOptions: RefOption[]
+    /** Contacts deja saisis, rattachables a l'adresse. */
+    contactOptions: RefOption[]
+    /** Pays disponibles (France par defaut). */
+    countryOptions: RefOption[]
+    removable?: boolean
+    readonly?: boolean
+    /** Erreurs serveur 422 de cette ligne, indexees par champ (ERP-101). */
+    errors?: Record<string, string>
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: ProviderAddressFormDraft]
+    'remove': []
+    /** Emis une fois quand le service d'autocompletion bascule en indisponible. */
+    'degraded': []
+}>()
+
+const { t } = useI18n()
+const autocomplete = useAddressAutocomplete()
+
+const model = computed(() => props.modelValue)
+
+// Repli saisie libre de la VILLE quand la BAN est indisponible (recuperable).
+const degraded = ref(false)
+let unavailableNotified = false
+const banCityOptions = ref<RefOption[]>([])
+const banAddressOptions = ref<RefOption[]>([])
+
+// Options ville effectives : on garantit que la ville courante figure toujours
+// dans la liste, sinon MalioSelect afficherait un champ vide en lecture seule.
+const cityOptions = computed<RefOption[]>(() => {
+    const current = props.modelValue.city
+    if (current && !banCityOptions.value.some(o => o.value === current)) {
+        return [{ value: current, label: current }, ...banCityOptions.value]
+    }
+    return banCityOptions.value
+})
+
+// Meme garantie pour le champ Adresse : la rue courante doit toujours figurer
+// dans les options, sinon MalioInputAutocomplete laisse le champ vide.
+const addressOptions = computed<RefOption[]>(() => {
+    const current = props.modelValue.street
+    if (current && !banAddressOptions.value.some(o => o.value === current)) {
+        return [{ value: current, label: current }, ...banAddressOptions.value]
+    }
+    return banAddressOptions.value
+})
+const addressLoading = ref(false)
+// Conserve les suggestions d'adresse pour retrouver ville/CP au moment du select.
+let lastAddressSuggestions: AddressSuggestion[] = []
+
+/** Emet un nouveau brouillon avec le champ modifie (immutabilite). */
+function update<K extends keyof ProviderAddressFormDraft>(field: K, value: ProviderAddressFormDraft[K]): void {
+    emit('update:modelValue', { ...props.modelValue, [field]: value })
+}
+
+/** Previent le parent (toast unique) que l'autocompletion est indisponible. */
+function notifyUnavailable(): void {
+    if (!unavailableNotified) {
+        unavailableNotified = true
+        emit('degraded')
+    }
+}
+
+/** Saisie du code postal → met a jour le champ + interroge la BAN pour la ville (RG-3.06). */
+async function onPostalCodeChange(value: string): Promise<void> {
+    update('postalCode', value)
+
+    const digits = (value ?? '').replace(/\D/g, '')
+    if (digits.length < 5) {
+        return
+    }
+    try {
+        const suggestions = await autocomplete.searchCity(digits)
+        banCityOptions.value = suggestions.map(s => ({ value: s.city, label: s.city }))
+        degraded.value = false
+    }
+    catch {
+        degraded.value = true
+        notifyUnavailable()
+    }
+}
+
+/** Recherche d'adresse assistee (event de MalioInputAutocomplete). */
+async function onAddressSearch(query: string): Promise<void> {
+    // La BAN exige au moins 3 caracteres : on n'envoie rien en deca (evite un 400).
+    if (query.trim().length < 3) {
+        banAddressOptions.value = []
+        return
+    }
+    addressLoading.value = true
+    try {
+        const postalCode = (model.value.postalCode ?? '').replace(/\D/g, '') || undefined
+        const suggestions = await autocomplete.searchAddress(query, postalCode)
+        lastAddressSuggestions = suggestions
+        banAddressOptions.value = suggestions.map(s => ({ value: s.street, label: s.label }))
+    }
+    catch {
+        // Erreur transitoire : on vide les suggestions, la prochaine frappe reessaie.
+        banAddressOptions.value = []
+        notifyUnavailable()
+    }
+    finally {
+        addressLoading.value = false
+    }
+}
+
+/** Selection d'une suggestion d'adresse → remplit rue + ville + CP. */
+function onAddressSelect(option: { label: string, value: string | number } | null): void {
+    if (option === null) {
+        return
+    }
+    const suggestion = lastAddressSuggestions.find(s => s.street === option.value)
+    if (!suggestion) {
+        update('street', String(option.value))
+        return
+    }
+    emit('update:modelValue', {
+        ...props.modelValue,
+        street: suggestion.street,
+        city: suggestion.city,
+        postalCode: suggestion.postalCode,
+    })
+}
+</script>

frontend/modules/technique/components/ProviderContactBlock.vue

@@ -0,0 +1,108 @@
+<template>
+    <div class="relative grid grid-cols-4 gap-x-[44px] gap-y-4 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
+        <!-- Suppression : ouvre une modal de confirmation cote parent. Masquee si
+             non supprimable (1er bloc) ou en lecture seule. -->
+        <MalioButtonIcon
+            v-if="removable && !readonly"
+            icon="mdi:delete-outline"
+            variant="ghost"
+            button-class="absolute top-3 right-3"
+            v-bind="{ ariaLabel: t('technique.providers.form.contact.remove') }"
+            @click="$emit('remove')"
+        />
+
+        <MalioInputText
+            :model-value="model.lastName"
+            :label="t('technique.providers.form.contact.lastName')"
+            :readonly="readonly"
+            :error="errors?.lastName"
+            @update:model-value="(v: string) => update('lastName', v)"
+        />
+        <MalioInputText
+            :model-value="model.firstName"
+            :label="t('technique.providers.form.contact.firstName')"
+            :readonly="readonly"
+            :error="errors?.firstName"
+            @update:model-value="(v: string) => update('firstName', v)"
+        />
+        <!-- Fonction sur 2 colonnes : on wrappe car MalioInputText
+             (inheritAttrs:false) renvoie `class` sur l'input interne, pas sur la
+             cellule de grille. Le wrapper porte le col-span-2, le champ le remplit. -->
+        <div class="col-span-2">
+            <MalioInputText
+                :model-value="model.jobTitle"
+                :label="t('technique.providers.form.contact.jobTitle')"
+                :readonly="readonly"
+                :error="errors?.jobTitle"
+                @update:model-value="(v: string) => update('jobTitle', v)"
+            />
+        </div>
+        <MalioInputEmail
+            :model-value="model.email"
+            :label="t('technique.providers.form.contact.email')"
+            :readonly="readonly"
+            :lowercase="true"
+            :error="errors?.email"
+            @update:model-value="(v: string) => update('email', v)"
+        />
+        <MalioInputPhone
+            :model-value="model.phonePrimary"
+            :label="t('technique.providers.form.contact.phonePrimary')"
+            :mask="PHONE_MASK"
+            :readonly="readonly"
+            :error="errors?.phonePrimary"
+            :addable="!model.hasSecondaryPhone && !readonly"
+            :add-button-label="t('technique.providers.form.contact.addPhone')"
+            @update:model-value="(v: string) => update('phonePrimary', v)"
+            @add="revealSecondaryPhone"
+        />
+        <!-- 2e numero : revele a la demande (max 2 telephones par contact). -->
+        <MalioInputPhone
+            v-if="model.hasSecondaryPhone"
+            :model-value="model.phoneSecondary"
+            :label="t('technique.providers.form.contact.phoneSecondary')"
+            :mask="PHONE_MASK"
+            :readonly="readonly"
+            :error="errors?.phoneSecondary"
+            @update:model-value="(v: string) => update('phoneSecondary', v)"
+        />
+    </div>
+</template>
+
+<script setup lang="ts">
+import type { ProviderContactFormDraft } from '~/modules/technique/types/providerForm'
+
+// Masque telephone FR : 5 groupes de 2 chiffres (la normalisation finale reste serveur).
+const PHONE_MASK = '## ## ## ## ##'
+
+const props = defineProps<{
+    /** Brouillon du contact (v-model). */
+    modelValue: ProviderContactFormDraft
+    /** Affiche l'icone de suppression (1er bloc non supprimable). */
+    removable?: boolean
+    /** Bloc en lecture seule (onglet valide). */
+    readonly?: boolean
+    /** Erreurs serveur 422 de cette ligne, indexees par champ (ERP-101). */
+    errors?: Record<string, string>
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: ProviderContactFormDraft]
+    'remove': []
+}>()
+
+const { t } = useI18n()
+
+// Alias local pour la lisibilite du template.
+const model = computed(() => props.modelValue)
+
+/** Emet un nouveau brouillon avec le champ modifie (immutabilite). */
+function update<K extends keyof ProviderContactFormDraft>(field: K, value: ProviderContactFormDraft[K]): void {
+    emit('update:modelValue', { ...props.modelValue, [field]: value })
+}
+
+/** Revele le 2e numero (max 1 secondaire, le « + » disparait). */
+function revealSecondaryPhone(): void {
+    emit('update:modelValue', { ...props.modelValue, hasSecondaryPhone: true })
+}
+</script>

frontend/modules/technique/components/__tests__/ProviderAddressBlock.spec.ts

@@ -0,0 +1,157 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { mount, flushPromises } from '@vue/test-utils'
+import { defineComponent, h, ref, computed } from 'vue'
+import { emptyProviderAddress } from '~/modules/technique/types/providerForm'
+import ProviderAddressBlock from '../ProviderAddressBlock.vue'
+
+// Mocks controlables du composable BAN (hoisted), reutilise tel quel du M1/M2.
+const { searchCityMock, searchAddressMock } = vi.hoisted(() => ({
+    searchCityMock: vi.fn(),
+    searchAddressMock: vi.fn(),
+}))
+vi.mock('~/shared/composables/useAddressAutocomplete', () => ({
+    useAddressAutocomplete: () => ({
+        searchCity: searchCityMock,
+        searchAddress: searchAddressMock,
+    }),
+}))
+
+// Auto-imports Nuxt/Vue utilises sans import explicite par le composant.
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('ref', ref)
+vi.stubGlobal('computed', computed)
+
+// Stub de MalioInputAutocomplete : expose les `value` des options + allowCreate.
+const MalioInputAutocompleteStub = defineComponent({
+    name: 'MalioInputAutocomplete',
+    props: {
+        modelValue: { type: [String, Number, null], default: undefined },
+        options: { type: Array as () => { value: string | number, label: string }[], default: () => [] },
+        loading: { type: Boolean, default: false },
+        minSearchLength: { type: Number, default: 0 },
+        label: { type: String, default: '' },
+        readonly: { type: Boolean, default: false },
+        allowCreate: { type: Boolean, default: false },
+    },
+    emits: ['update:modelValue', 'search', 'select'],
+    setup(props) {
+        return () => h('div', {
+            'data-testid': 'addr-autocomplete',
+            'data-options': JSON.stringify(props.options.map(o => o.value)),
+        })
+    },
+})
+
+function mountBlock(overrides: Record<string, unknown> = {}, errors?: Record<string, string>) {
+    return mount(ProviderAddressBlock, {
+        props: {
+            modelValue: { ...emptyProviderAddress(), ...overrides },
+            categoryOptions: [],
+            siteOptions: [],
+            contactOptions: [],
+            countryOptions: [],
+            ...(errors ? { errors } : {}),
+        },
+        global: {
+            stubs: {
+                MalioButtonIcon: true,
+                MalioSelect: true,
+                MalioSelectCheckbox: true,
+                MalioInputText: true,
+                MalioInputAutocomplete: MalioInputAutocompleteStub,
+            },
+        },
+    })
+}
+
+describe('ProviderAddressBlock — version simplifiee M3 (pas de type/bennes/triage)', () => {
+    it('ne rend NI type d\'adresse, NI bennes, NI prestation de triage (difference M2)', () => {
+        const wrapper = mountBlock()
+        // Pas de stepper (bennes) ni de case a cocher (triage) dans le bloc M3.
+        expect(wrapper.find('malio-input-number-stub').exists()).toBe(false)
+        expect(wrapper.find('malio-checkbox-stub').exists()).toBe(false)
+        // Aucun select ne porte le label « type d'adresse ».
+        const hasAddressType = wrapper.findAll('malio-select-stub').some(
+            el => el.attributes('label') === 'technique.providers.form.address.addressType',
+        )
+        expect(hasAddressType).toBe(false)
+    })
+})
+
+describe('ProviderAddressBlock — mapping erreur par champ (ERP-101)', () => {
+    it('affiche les erreurs serveur sur sites et categories (RG-3.05 / RG-3.09)', () => {
+        const wrapper = mountBlock({}, {
+            sites: 'Au moins un site est obligatoire.',
+            categories: 'Au moins une catégorie est obligatoire.',
+        })
+        const checkboxes = wrapper.findAll('malio-select-checkbox-stub')
+        const sitesField = checkboxes.find(el => el.attributes('label') === 'technique.providers.form.address.sites')
+        const categoriesField = checkboxes.find(el => el.attributes('label') === 'technique.providers.form.address.categories')
+
+        expect(sitesField?.attributes('error')).toBe('Au moins un site est obligatoire.')
+        expect(categoriesField?.attributes('error')).toBe('Au moins une catégorie est obligatoire.')
+    })
+
+    it('affiche l\'erreur serveur sur le code postal', () => {
+        const wrapper = mountBlock({}, { postalCode: 'Code postal invalide.' })
+        const field = wrapper.findAll('malio-input-text-stub').find(
+            el => el.attributes('label') === 'technique.providers.form.address.postalCode',
+        )
+        expect(field?.attributes('error')).toBe('Code postal invalide.')
+    })
+})
+
+describe('ProviderAddressBlock — autocompletion BAN (RG-3.06)', () => {
+    beforeEach(() => {
+        searchCityMock.mockReset()
+        searchAddressMock.mockReset()
+    })
+
+    it('n\'appelle pas la BAN en deca de 3 caracteres', async () => {
+        const wrapper = mountBlock()
+        wrapper.findComponent(MalioInputAutocompleteStub).vm.$emit('search', 'ab')
+        await flushPromises()
+        expect(searchAddressMock).not.toHaveBeenCalled()
+    })
+
+    it('relance la recherche apres une erreur (pas de bascule definitive)', async () => {
+        searchAddressMock
+            .mockRejectedValueOnce(new Error('BAN indisponible'))
+            .mockResolvedValueOnce([
+                { label: '1 rue du Test, Châtellerault', street: '1 rue du Test', postalCode: '86100', city: 'Châtellerault' },
+            ])
+        const wrapper = mountBlock()
+        const auto = wrapper.findComponent(MalioInputAutocompleteStub)
+
+        auto.vm.$emit('search', 'rue du test')
+        await flushPromises()
+        auto.vm.$emit('search', 'rue du teste')
+        await flushPromises()
+
+        expect(searchAddressMock).toHaveBeenCalledTimes(2)
+    })
+
+    it('cas degrade : la BAN echoue -> emet « degraded » une seule fois (RG-3.06)', async () => {
+        searchAddressMock.mockRejectedValue(new Error('BAN indisponible'))
+        const wrapper = mountBlock()
+        const auto = wrapper.findComponent(MalioInputAutocompleteStub)
+
+        auto.vm.$emit('search', 'rue du test')
+        await flushPromises()
+        auto.vm.$emit('search', 'rue du teste')
+        await flushPromises()
+
+        expect(wrapper.emitted('degraded')).toHaveLength(1)
+    })
+
+    it('active allow-create sur le champ Adresse (saisie manuelle libre)', () => {
+        const wrapper = mountBlock()
+        expect(wrapper.findComponent(MalioInputAutocompleteStub).props('allowCreate')).toBe(true)
+    })
+
+    it('inclut la rue courante dans les options meme sans recherche BAN', () => {
+        const wrapper = mountBlock({ street: '1 rue du Test' })
+        const values = JSON.parse(wrapper.find('[data-testid="addr-autocomplete"]').attributes('data-options') ?? '[]')
+        expect(values).toContain('1 rue du Test')
+    })
+})

frontend/modules/technique/components/__tests__/ProviderContactBlock.spec.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect, vi } from 'vitest'
+import { mount } from '@vue/test-utils'
+import { defineComponent, h, ref, computed } from 'vue'
+import { emptyProviderContact } from '~/modules/technique/types/providerForm'
+import ProviderContactBlock from '../ProviderContactBlock.vue'
+
+// Auto-imports Nuxt/Vue utilises sans import explicite par le composant.
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('ref', ref)
+vi.stubGlobal('computed', computed)
+
+/** Stub d'un champ Malio qui re-expose la prop `error` recue dans un data-* attribut. */
+function errorProbe(testid: string) {
+    return defineComponent({
+        name: `Probe-${testid}`,
+        props: {
+            modelValue: { type: [String, Number, null], default: undefined },
+            error: { type: String, default: '' },
+            label: { type: String, default: '' },
+            readonly: { type: Boolean, default: false },
+        },
+        setup(props) {
+            return () => h('div', { 'data-testid': testid, 'data-error': props.error })
+        },
+    })
+}
+
+function mountBlock(errors?: Record<string, string>) {
+    return mount(ProviderContactBlock, {
+        props: {
+            modelValue: emptyProviderContact(),
+            ...(errors ? { errors } : {}),
+        },
+        global: {
+            stubs: {
+                MalioButtonIcon: true,
+                MalioInputPhone: true,
+                MalioInputText: errorProbe('contact-text'),
+                MalioInputEmail: errorProbe('contact-email'),
+            },
+        },
+    })
+}
+
+describe('ProviderContactBlock — mapping erreur par champ (ERP-101)', () => {
+    it('affiche l\'erreur serveur sur le champ email via la prop errors', () => {
+        const wrapper = mountBlock({ email: 'L\'adresse email n\'est pas valide.' })
+        expect(wrapper.find('[data-testid="contact-email"]').attributes('data-error')).toBe('L\'adresse email n\'est pas valide.')
+    })
+
+    it('laisse les champs sans erreur quand errors est absent', () => {
+        const wrapper = mountBlock()
+        expect(wrapper.find('[data-testid="contact-email"]').attributes('data-error')).toBe('')
+    })
+})

frontend/modules/technique/composables/__tests__/useProviderForm.test.ts

@@ -0,0 +1,653 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+/**
+ * Tests du workflow « Ajouter un prestataire » (M3 Technique, ERP-141).
+ *
+ * `useProviderForm` porte le formulaire principal (Nom + Categorie + Site) et
+ * l'orchestration des onglets de creation. On verifie ici le CONTRAT propre a la
+ * creation :
+ *  - RG-3.03 (front) : au moins un site requis ; RG-3.09 : au moins une categorie
+ *    -> POST bloque, erreurs inline, aucun appel reseau.
+ *  - POST /providers (groupe provider:write:main) : payload IRIs + Accept ld+json
+ *    + toast:false ; au succes, verrouillage + bascule sur l'onglet Contact +
+ *    reaffichage du nom normalise.
+ *  - 409 doublon (RG-3.10) -> erreur inline dediee sur companyName.
+ *  - 422 -> mapping inline par champ (propertyPath).
+ *  - Onglets : « Comptabilite » present uniquement avec accounting.view ;
+ *    completeTab deverrouille/avance et signale le dernier onglet.
+ */
+
+const mockPost = vi.hoisted(() => vi.fn())
+const mockPatch = vi.hoisted(() => vi.fn())
+// Permissions comptables pilotables par test (presence/edition de l'onglet Comptabilite).
+const permState = vi.hoisted(() => ({ accountingView: false, accountingManage: false }))
+
+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(),
+}))
+vi.stubGlobal('usePermissions', () => ({
+    can: (perm: string) => {
+        if (perm === 'technique.providers.accounting.view') return permState.accountingView
+        if (perm === 'technique.providers.accounting.manage') return permState.accountingManage
+        return true
+    },
+}))
+
+const { useProviderForm, buildProviderCreateTabKeys } = await import('../useProviderForm')
+const { emptyProviderContact, emptyProviderAddress } = await import('~/modules/technique/types/providerForm')
+type ProviderForm = ReturnType<typeof useProviderForm>
+
+const SITE_86 = '/api/sites/1'
+const CAT_MAINT = '/api/categories/7'
+
+/** Accede a un bloc contact (cast : sous noUncheckedIndexedAccess l'index est optionnel). */
+function contactAt(form: ProviderForm, index = 0) {
+    return form.contacts.value[index] ?? emptyProviderContact()
+}
+
+/** Accede a un bloc adresse (idem). */
+function addressAt(form: ProviderForm, index = 0) {
+    return form.addresses.value[index] ?? emptyProviderAddress()
+}
+
+describe('useProviderForm', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        permState.accountingView = false
+        permState.accountingManage = false
+    })
+
+    it('front : formulaire principal vide -> erreurs sur nom + site + categorie, pas de POST', async () => {
+        const form = useProviderForm()
+
+        const created = await form.submitMain()
+
+        expect(created).toBe(false)
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(form.mainErrors.errors.companyName).toBe('technique.providers.form.errors.nameRequired')
+        expect(form.mainErrors.errors.sites).toBe('technique.providers.form.errors.siteRequired')
+        expect(form.mainErrors.errors.categories).toBe('technique.providers.form.errors.categoryRequired')
+        expect(form.mainLocked.value).toBe(false)
+    })
+
+    it('RG-3.03 (front) : un site present sans categorie n\'erre que sur categories', async () => {
+        const form = useProviderForm()
+        form.main.companyName = 'Maintenance Pro'
+        form.main.siteIris = [SITE_86]
+
+        await form.submitMain()
+
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(form.mainErrors.errors.sites).toBeUndefined()
+        expect(form.mainErrors.errors.categories).toBe('technique.providers.form.errors.categoryRequired')
+    })
+
+    it('POST /providers avec IRIs + Accept ld+json, verrouille et bascule sur Contact', async () => {
+        mockPost.mockResolvedValueOnce({ id: 42, companyName: 'MAINTENANCE PRO' })
+        const form = useProviderForm()
+        form.main.companyName = 'Maintenance Pro'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const created = await form.submitMain()
+
+        expect(created).toBe(true)
+        expect(mockPost).toHaveBeenCalledTimes(1)
+        const [url, body, opts] = mockPost.mock.calls[0] ?? []
+        expect(url).toBe('/providers')
+        expect(body).toEqual({
+            companyName: 'Maintenance Pro',
+            categories: [CAT_MAINT],
+            sites: [SITE_86],
+        })
+        expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
+
+        expect(form.providerId.value).toBe(42)
+        // RG-3.11 : reaffiche le nom normalise (UPPERCASE) renvoye par le serveur.
+        expect(form.main.companyName).toBe('MAINTENANCE PRO')
+        expect(form.mainLocked.value).toBe(true)
+        expect(form.activeTab.value).toBe('contact')
+        expect(form.unlockedIndex.value).toBe(0)
+    })
+
+    it('front : nom vide/espaces -> erreur inline sur companyName, pas de POST', async () => {
+        const form = useProviderForm()
+        form.main.companyName = '   '
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const created = await form.submitMain()
+
+        expect(created).toBe(false)
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(form.mainErrors.errors.companyName).toBe('technique.providers.form.errors.nameRequired')
+    })
+
+    it('409 doublon (RG-3.10) : erreur inline dediee sur companyName, pas de verrouillage', async () => {
+        mockPost.mockRejectedValueOnce({ response: { status: 409 } })
+        const form = useProviderForm()
+        form.main.companyName = 'Doublon'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const created = await form.submitMain()
+
+        expect(created).toBe(false)
+        expect(form.mainErrors.errors.companyName).toBe('technique.providers.form.duplicateCompany')
+        expect(form.mainLocked.value).toBe(false)
+    })
+
+    it('422 : mappe les violations serveur inline par champ', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'sites', message: 'Au moins un site est requis.' }] },
+            },
+        })
+        const form = useProviderForm()
+        form.main.companyName = 'X'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const created = await form.submitMain()
+
+        expect(created).toBe(false)
+        expect(form.mainErrors.errors.sites).toBe('Au moins un site est requis.')
+    })
+
+    it('onglet Comptabilite : absent sans accounting.view, present avec', () => {
+        expect(buildProviderCreateTabKeys(false)).toEqual(['contact', 'address'])
+        expect(buildProviderCreateTabKeys(true)).toEqual(['contact', 'address', 'accounting'])
+
+        permState.accountingView = true
+        const form = useProviderForm()
+        expect(form.tabKeys.value).toEqual(['contact', 'address', 'accounting'])
+    })
+
+    it('completeTab : deverrouille/avance, et signale le dernier onglet du flux', () => {
+        const form = useProviderForm()
+
+        // Contact -> Adresse (pas le dernier).
+        expect(form.completeTab('contact')).toBe(false)
+        expect(form.isValidated('contact')).toBe(true)
+        expect(form.activeTab.value).toBe('address')
+        expect(form.unlockedIndex.value).toBe(1)
+
+        // Adresse = dernier onglet remplissable (sans accounting.view) -> true.
+        expect(form.completeTab('address')).toBe(true)
+        expect(form.isValidated('address')).toBe(true)
+    })
+
+    it('patchProvider : PATCH /providers/{id} en mode strict, no-op avant creation', async () => {
+        const form = useProviderForm()
+
+        await form.patchProvider({ siren: '123456789' })
+        expect(mockPatch).not.toHaveBeenCalled()
+
+        mockPost.mockResolvedValueOnce({ id: 9, companyName: 'ACME' })
+        form.main.companyName = 'Acme'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+        await form.submitMain()
+
+        await form.patchProvider({ siren: '123456789' })
+        expect(mockPatch).toHaveBeenCalledWith('/providers/9', { siren: '123456789' }, { toast: false })
+    })
+})
+
+describe('useProviderForm — onglet Contact (ERP-142)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        permState.accountingView = false
+        permState.accountingManage = false
+    })
+
+    /** Place le formulaire en etat « prestataire cree » (onglet Contact accessible). */
+    function createdForm() {
+        const form = useProviderForm()
+        form.providerId.value = 7
+        return form
+    }
+
+    it('RG-3.04 : « + Nouveau contact » desactive tant que le dernier bloc est vide', () => {
+        const form = createdForm()
+        expect(form.canAddContact.value).toBe(false)
+
+        // addContact est un no-op tant que le bloc est vide.
+        form.addContact()
+        expect(form.contacts.value).toHaveLength(1)
+
+        contactAt(form).lastName = 'Doe'
+        expect(form.canAddContact.value).toBe(true)
+        form.addContact()
+        expect(form.contacts.value).toHaveLength(2)
+    })
+
+    it('removeContact retire le bloc et son erreur de ligne', () => {
+        const form = createdForm()
+        contactAt(form).lastName = 'Doe'
+        form.addContact()
+        form.contactErrors.value = [{}, { lastName: 'x' }]
+
+        form.removeContact(1)
+        expect(form.contacts.value).toHaveLength(1)
+        expect(form.contactErrors.value).toHaveLength(1)
+    })
+
+    it('submitContacts : POST des nouveaux, capture id + IRI, finalise l\'onglet', async () => {
+        mockPost.mockResolvedValueOnce({ '@id': '/api/provider_contacts/55', id: 55 })
+        const form = createdForm()
+        contactAt(form).lastName = 'Doe'
+
+        const ok = await form.submitContacts(vi.fn())
+
+        expect(ok).toBe(true)
+        const [url, body, opts] = mockPost.mock.calls[0] ?? []
+        expect(url).toBe('/providers/7/contacts')
+        expect(body).toMatchObject({ lastName: 'Doe' })
+        expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
+        expect(contactAt(form).id).toBe(55)
+        expect(contactAt(form).iri).toBe('/api/provider_contacts/55')
+        expect(form.isValidated('contact')).toBe(true)
+    })
+
+    it('submitContacts : PATCH des contacts existants sur /provider_contacts/{id}', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        contactAt(form).id = 55
+        contactAt(form).lastName = 'Doe'
+
+        await form.submitContacts(vi.fn())
+
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith('/provider_contacts/55', expect.objectContaining({ lastName: 'Doe' }), { toast: false })
+    })
+
+    it('RG-3.12 : onglet vide -> soumet l\'amorce pour declencher la 422 firstName inline', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'firstName', message: 'Au moins un champ du contact est obligatoire.' }] },
+            },
+        })
+        const form = createdForm()
+
+        const ok = await form.submitContacts(vi.fn())
+
+        expect(ok).toBe(false)
+        expect(mockPost).toHaveBeenCalledTimes(1)
+        expect(form.contactErrors.value[0]?.firstName).toBe('Au moins un champ du contact est obligatoire.')
+        expect(form.isValidated('contact')).toBe(false)
+    })
+
+    it('mappe les erreurs 422 PAR LIGNE (le bloc 2 echoue, le bloc 1 passe)', async () => {
+        mockPost
+            .mockResolvedValueOnce({ '@id': '/api/provider_contacts/1', id: 1 })
+            .mockRejectedValueOnce({
+                response: {
+                    status: 422,
+                    _data: { violations: [{ propertyPath: 'email', message: 'L\'adresse email n\'est pas valide.' }] },
+                },
+            })
+        const form = createdForm()
+        contactAt(form).lastName = 'Doe'
+        form.addContact()
+        contactAt(form, 1).email = 'invalide'
+
+        const ok = await form.submitContacts(vi.fn())
+
+        expect(ok).toBe(false)
+        expect(form.contactErrors.value[0]).toBeUndefined()
+        expect(form.contactErrors.value[1]?.email).toBe('L\'adresse email n\'est pas valide.')
+    })
+})
+
+describe('useProviderForm — onglet Adresse (ERP-143)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        permState.accountingView = false
+        permState.accountingManage = false
+    })
+
+    /** Place le formulaire en etat « prestataire cree » (onglet Adresse accessible). */
+    function createdForm() {
+        const form = useProviderForm()
+        form.providerId.value = 7
+        return form
+    }
+
+    /** Remplit un bloc adresse valide (site + categorie + scalaires requis). */
+    function fillValidAddress(form: ProviderForm, index = 0): void {
+        const a = addressAt(form, index)
+        a.siteIris = [SITE_86]
+        a.categoryIris = [CAT_MAINT]
+        a.postalCode = '86100'
+        a.city = 'Châtellerault'
+        a.street = '1 rue du Test'
+    }
+
+    it('RG-3.05 : « + Nouvelle adresse » desactive tant que site + categorie manquent', () => {
+        const form = createdForm()
+        expect(form.canAddAddress.value).toBe(false)
+
+        // no-op tant que l'adresse n'est pas valide.
+        form.addAddress()
+        expect(form.addresses.value).toHaveLength(1)
+
+        addressAt(form).siteIris = [SITE_86]
+        expect(form.canAddAddress.value).toBe(false) // categorie manquante
+        addressAt(form).categoryIris = [CAT_MAINT]
+        expect(form.canAddAddress.value).toBe(true)
+        form.addAddress()
+        expect(form.addresses.value).toHaveLength(2)
+    })
+
+    it('removeAddress retire le bloc et son erreur de ligne', () => {
+        const form = createdForm()
+        fillValidAddress(form)
+        form.addAddress()
+        form.addressErrors.value = [{}, { city: 'x' }]
+
+        form.removeAddress(1)
+        expect(form.addresses.value).toHaveLength(1)
+        expect(form.addressErrors.value).toHaveLength(1)
+    })
+
+    it('submitAddresses : POST des nouvelles, capture l\'id, finalise l\'onglet', async () => {
+        mockPost.mockResolvedValueOnce({ id: 88 })
+        const form = createdForm()
+        fillValidAddress(form)
+
+        const ok = await form.submitAddresses(vi.fn())
+
+        expect(ok).toBe(true)
+        const [url, body, opts] = mockPost.mock.calls[0] ?? []
+        expect(url).toBe('/providers/7/addresses')
+        expect(body).toMatchObject({ sites: [SITE_86], categories: [CAT_MAINT], city: 'Châtellerault' })
+        expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
+        expect(addressAt(form).id).toBe(88)
+        expect(form.isValidated('address')).toBe(true)
+    })
+
+    it('submitAddresses : PATCH des adresses existantes sur /provider_addresses/{id}', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillValidAddress(form)
+        addressAt(form).id = 88
+
+        await form.submitAddresses(vi.fn())
+
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith('/provider_addresses/88', expect.objectContaining({ sites: [SITE_86] }), { toast: false })
+    })
+
+    it('mappe les erreurs 422 PAR LIGNE et ne finalise pas l\'onglet', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'city', message: 'La ville est obligatoire.' }] },
+            },
+        })
+        const form = createdForm()
+        fillValidAddress(form)
+
+        const ok = await form.submitAddresses(vi.fn())
+
+        expect(ok).toBe(false)
+        expect(form.addressErrors.value[0]?.city).toBe('La ville est obligatoire.')
+        expect(form.isValidated('address')).toBe(false)
+    })
+})
+
+describe('useProviderForm — onglet Comptabilite (ERP-144)', () => {
+    const TVA = '/api/tva_modes/1'
+    const DELAY = '/api/payment_delays/1'
+    const TYPE = '/api/payment_types/3'
+    const BANK = '/api/banks/2'
+
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        permState.accountingView = true
+        permState.accountingManage = true
+    })
+
+    /** Prestataire cree, onglet Comptabilite editable (view + manage). */
+    function createdForm() {
+        const form = useProviderForm()
+        form.providerId.value = 7
+        return form
+    }
+
+    /** Remplit les scalaires comptables communs. */
+    function fillScalars(form: ProviderForm): void {
+        form.accounting.siren = '123456789'
+        form.accounting.accountNumber = '4010'
+        form.accounting.tvaModeIri = TVA
+        form.accounting.nTva = 'FR123'
+        form.accounting.paymentDelayIri = DELAY
+        form.accounting.paymentTypeIri = TYPE
+    }
+
+    it('lecture seule sans accounting.manage (Compta consultation / autres roles)', () => {
+        permState.accountingManage = false
+        const form = createdForm()
+        expect(form.accountingReadonly.value).toBe(true)
+
+        permState.accountingManage = true
+        const form2 = createdForm()
+        expect(form2.accountingReadonly.value).toBe(false)
+    })
+
+    it('RG-3.07 : setPaymentType(VIREMENT) garde la banque ; un autre type la vide', () => {
+        const form = createdForm()
+        form.accounting.bankIri = BANK
+
+        // Type VIREMENT -> banque requise, conservee.
+        form.setPaymentType(TYPE, true, false)
+        expect(form.accounting.bankIri).toBe(BANK)
+
+        // Type non-VIREMENT -> banque videe (sans objet).
+        form.setPaymentType(TYPE, false, false)
+        expect(form.accounting.bankIri).toBeNull()
+    })
+
+    it('RG-3.08 : setPaymentType(LCR) garantit au moins un bloc RIB', () => {
+        const form = createdForm()
+        expect(form.ribs.value).toHaveLength(0)
+
+        form.setPaymentType(TYPE, false, true)
+        expect(form.ribs.value).toHaveLength(1)
+    })
+
+    it('« + RIB » desactive tant que le dernier RIB est incomplet (RG-3.08)', () => {
+        const form = createdForm()
+        form.setPaymentType(TYPE, false, true)
+        expect(form.canAddRib.value).toBe(false)
+
+        const rib = form.ribs.value[0]
+        if (rib) {
+            rib.label = 'Compte'
+            rib.bic = 'BNPAFRPP'
+            rib.iban = 'FR76...'
+        }
+        expect(form.canAddRib.value).toBe(true)
+    })
+
+    it('VIREMENT : PATCH des scalaires avec banque, aucun appel RIB', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillScalars(form)
+        form.accounting.bankIri = BANK
+
+        const ok = await form.submitAccounting(true, false, vi.fn())
+
+        expect(ok).toBe(true)
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/providers/7',
+            expect.objectContaining({ paymentType: TYPE, bank: BANK, siren: '123456789' }),
+            { toast: false },
+        )
+        expect(form.isValidated('accounting')).toBe(true)
+    })
+
+    it('hors VIREMENT : la banque part a null dans le payload (RG-3.07)', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillScalars(form)
+        form.accounting.bankIri = BANK // residu : doit etre ignore (isBankRequired=false)
+
+        await form.submitAccounting(false, false, vi.fn())
+
+        const body = mockPatch.mock.calls[0]?.[1] as Record<string, unknown>
+        expect(body.bank).toBeNull()
+    })
+
+    it('LCR : POST des RIB AVANT le PATCH des scalaires (ordre RG-3.08)', async () => {
+        mockPost.mockResolvedValueOnce({ id: 50 })
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillScalars(form)
+        form.setPaymentType(TYPE, false, true)
+        const rib = form.ribs.value[0]
+        if (rib) {
+            rib.label = 'Compte'
+            rib.bic = 'BNPAFRPP'
+            rib.iban = 'FR76...'
+        }
+
+        const ok = await form.submitAccounting(false, true, vi.fn())
+
+        expect(ok).toBe(true)
+        expect(mockPost).toHaveBeenCalledWith(
+            '/providers/7/ribs',
+            expect.objectContaining({ label: 'Compte', bic: 'BNPAFRPP', iban: 'FR76...' }),
+            { headers: { Accept: 'application/ld+json' }, toast: false },
+        )
+        expect(form.ribs.value[0]?.id).toBe(50)
+        // Le PATCH des scalaires intervient APRES la creation du RIB.
+        expect(mockPatch).toHaveBeenCalledWith('/providers/7', expect.any(Object), { toast: false })
+    })
+
+    it('422 sur les scalaires (bank) : mapping inline, onglet non finalise', async () => {
+        mockPatch.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'bank', message: 'La banque est obligatoire pour un virement.' }] },
+            },
+        })
+        const form = createdForm()
+        fillScalars(form)
+
+        const ok = await form.submitAccounting(true, false, vi.fn())
+
+        expect(ok).toBe(false)
+        expect(form.accountingErrors.errors.bank).toBe('La banque est obligatoire pour un virement.')
+        expect(form.isValidated('accounting')).toBe(false)
+    })
+
+    it('LCR : 422 RIB par ligne -> pas de PATCH des scalaires', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'iban', message: 'L\'IBAN est obligatoire.' }] },
+            },
+        })
+        const form = createdForm()
+        fillScalars(form)
+        form.setPaymentType(TYPE, false, true)
+        const rib = form.ribs.value[0]
+        if (rib) {
+            rib.label = 'Compte'
+            rib.bic = 'BNPAFRPP'
+        }
+
+        const ok = await form.submitAccounting(false, true, vi.fn())
+
+        expect(ok).toBe(false)
+        expect(form.ribErrors.value[0]?.iban).toBe('L\'IBAN est obligatoire.')
+        expect(mockPatch).not.toHaveBeenCalled()
+    })
+})
+
+describe('useProviderForm — modification (ERP-145)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        permState.accountingView = false
+        permState.accountingManage = false
+    })
+
+    it('editMode : completeTab ne verrouille pas et ne bascule pas d\'onglet', () => {
+        const form = useProviderForm()
+        form.editMode.value = true
+        form.activeTab.value = 'contact'
+
+        expect(form.completeTab('contact')).toBe(false)
+        expect(form.isValidated('contact')).toBe(false)
+        expect(form.activeTab.value).toBe('contact')
+    })
+
+    it('updateMain : PATCH /providers/{id} sur le groupe principal (pas de POST)', async () => {
+        mockPatch.mockResolvedValueOnce({ id: 7, companyName: 'MAINTENANCE PRO' })
+        const form = useProviderForm()
+        form.providerId.value = 7
+        form.main.companyName = 'Maintenance Pro'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const ok = await form.updateMain()
+
+        expect(ok).toBe(true)
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/providers/7',
+            { companyName: 'Maintenance Pro', categories: [CAT_MAINT], sites: [SITE_86] },
+            { toast: false },
+        )
+        // Reaffiche le nom normalise renvoye par le serveur.
+        expect(form.main.companyName).toBe('MAINTENANCE PRO')
+    })
+
+    it('updateMain : RG-3.03 front -> bloque le PATCH sans site', async () => {
+        const form = useProviderForm()
+        form.providerId.value = 7
+        form.main.companyName = 'X'
+        form.main.categoryIris = [CAT_MAINT]
+
+        const ok = await form.updateMain()
+
+        expect(ok).toBe(false)
+        expect(mockPatch).not.toHaveBeenCalled()
+        expect(form.mainErrors.errors.sites).toBe('technique.providers.form.errors.siteRequired')
+    })
+
+    it('updateMain : 409 doublon -> erreur inline sur companyName', async () => {
+        mockPatch.mockRejectedValueOnce({ response: { status: 409 } })
+        const form = useProviderForm()
+        form.providerId.value = 7
+        form.main.companyName = 'Doublon'
+        form.main.categoryIris = [CAT_MAINT]
+        form.main.siteIris = [SITE_86]
+
+        const ok = await form.updateMain()
+
+        expect(ok).toBe(false)
+        expect(form.mainErrors.errors.companyName).toBe('technique.providers.form.duplicateCompany')
+    })
+})

frontend/modules/technique/composables/__tests__/useProvidersRepository.test.ts

@@ -0,0 +1,78 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { useProvidersRepository, type Provider } from '../useProvidersRepository'
+
+const mockApiGet = vi.hoisted(() => vi.fn())
+vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
+
+/**
+ * Tests du repertoire prestataires (ERP-140).
+ *
+ * `useProvidersRepository` est une fine enveloppe de `usePaginatedList<Provider>`
+ * sur `/providers`. 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 `/providers`
+ *  - 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 `archivedOnly` est bien transmis une fois applique.
+ */
+describe('useProvidersRepository', () => {
+    beforeEach(() => {
+        mockApiGet.mockReset()
+    })
+
+    /** Une page de prestataires Hydra, avec categories[] et sites[] embarques. */
+    const PAGE: Provider[] = [
+        {
+            id: 1,
+            companyName: 'ACME MAINTENANCE',
+            categories: [{ code: 'MAINTENANCE_INDUSTRIELLE', name: 'Maintenance industrielle' }],
+            sites: [{ id: 4, name: 'Chatellerault', color: '#056CF2' }],
+            updatedAt: '2026-06-15T08:12:01+02:00',
+            isArchived: false,
+        },
+    ]
+
+    it('cible /providers, consomme l\'enveloppe Hydra et envoie l\'Accept ld+json', async () => {
+        mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
+        const repo = useProvidersRepository()
+
+        await repo.fetch()
+
+        expect(mockApiGet).toHaveBeenCalledTimes(1)
+        const [url, query, opts] = mockApiGet.mock.calls[0]
+        expect(url).toBe('/providers')
+        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 = useProvidersRepository()
+
+        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 = useProvidersRepository()
+        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)
+    })
+})

frontend/modules/technique/composables/useProvider.ts

@@ -0,0 +1,70 @@
+import { ref } from 'vue'
+import type { ProviderDetail } from '~/modules/technique/utils/forms/providerDetail'
+
+/**
+ * Chargement et actions d'archivage d'un prestataire unique (ecrans Consultation /
+ * Modification, ERP-145). Miroir de `useSupplier` (M2). Lit le detail embarque via
+ * `GET /api/providers/{id}` (contacts / adresses + leurs sous-collections / ribs
+ * sous `provider:item:read` / `provider:read:accounting`) — une SEULE requete
+ * peuple les deux ecrans (embed borne, pas de N+1).
+ *
+ * L'en-tete `Accept: application/ld+json` est impose pour obtenir le payload Hydra
+ * complet (avec les `@id` des relations embarquees, indispensables au pre-remplissage).
+ *
+ * Etat 100 % local a l'instance (refs). Les erreurs d'archivage / restauration
+ * (notamment le 409 d'homonyme actif a la restauration) sont PROPAGEES a l'appelant,
+ * qui decide du toast a afficher.
+ */
+export function useProvider(id: number | string) {
+    const api = useApi()
+
+    const provider = ref<ProviderDetail | null>(null)
+    const loading = ref(false)
+    const error = ref(false)
+
+    /** Recupere le detail complet (embed contacts/adresses/ribs + comptabilite). */
+    function fetchDetail(): Promise<ProviderDetail> {
+        return api.get<ProviderDetail>(
+            `/providers/${id}`,
+            {},
+            { headers: { Accept: 'application/ld+json' }, toast: false },
+        )
+    }
+
+    /** Charge le detail du prestataire. En cas d'echec : `error = true`, `provider = null`. */
+    async function load(): Promise<void> {
+        loading.value = true
+        error.value = false
+        try {
+            provider.value = await fetchDetail()
+        }
+        catch {
+            error.value = true
+            provider.value = null
+        }
+        finally {
+            loading.value = false
+        }
+    }
+
+    /**
+     * Bascule l'archivage (PATCH `isArchived` SEUL — groupe provider:write:archive ;
+     * tout autre champ => 422), puis RECHARGE le detail complet : la reponse du PATCH
+     * ne porte que `provider:read` (ni l'embed des sous-collections ni les libelles
+     * comptables), un simple merge laisserait l'affichage incoherent. Toute erreur est
+     * propagee a l'appelant AVANT le rechargement.
+     */
+    async function setArchived(isArchived: boolean): Promise<void> {
+        await api.patch(`/providers/${id}`, { isArchived }, { toast: false })
+        provider.value = await fetchDetail()
+    }
+
+    return {
+        provider,
+        loading,
+        error,
+        load,
+        archive: () => setArchived(true),
+        restore: () => setArchived(false),
+    }
+}

frontend/modules/technique/composables/useProviderForm.ts

@@ -0,0 +1,645 @@
+import { computed, reactive, ref, type Ref } from 'vue'
+import { useFormErrors } from '~/shared/composables/useFormErrors'
+import { extractApiErrorMessage, mapViolationsToRecord } from '~/shared/utils/api'
+import { removeCollectionRow } from '~/shared/utils/collectionRow'
+import {
+    emptyProviderAccounting,
+    emptyProviderAddress,
+    emptyProviderContact,
+    emptyProviderMain,
+    emptyProviderRib,
+    type ProviderAccountingDraft,
+    type ProviderAddressFormDraft,
+    type ProviderAddressResponse,
+    type ProviderContactFormDraft,
+    type ProviderContactResponse,
+    type ProviderMainDraft,
+    type ProviderMainResponse,
+    type ProviderRibFormDraft,
+    type ProviderRibResponse,
+} from '~/modules/technique/types/providerForm'
+import {
+    buildProviderContactPayload,
+    isProviderContactBlank,
+    isProviderContactNamed,
+} from '~/modules/technique/utils/forms/providerContact'
+import {
+    buildProviderAddressPayload,
+    isProviderAddressValid,
+} from '~/modules/technique/utils/forms/providerAddress'
+import {
+    buildProviderAccountingPayload,
+    buildProviderRibPayload,
+    isRibBlank,
+    isRibComplete,
+} from '~/modules/technique/utils/forms/providerAccounting'
+
+/**
+ * Workflow de l'ecran « Ajouter un prestataire » (M3 Technique, ERP-141) —
+ * miroir conceptuel de la logique de creation fournisseur (M2), extraite ici en
+ * composable.
+ *
+ * Particularites M3 (cf. spec-front § « Ecran Ajouter ») :
+ *  - PAS d'onglet « Information » : le formulaire principal est minimal (Nom +
+ *    Categorie + Site).
+ *  - Selecteur de site SUR le formulaire principal (RG-3.03, relation directe
+ *    `provider.sites`).
+ *  - Creation incrementale par onglets (Contact · Adresse · Comptabilite) :
+ *    POST principal puis PATCH partiels par groupe de serialisation
+ *    (`provider:write:*`, mode strict — spec-back § 2.10). Le contenu des onglets
+ *    arrive aux tickets ERP-142 → 144 ; ce composable pose le POST principal et
+ *    l'orchestration des onglets.
+ *
+ * Etat 100 % local a l'instance (refs/reactive) — aucune persistance URL.
+ */
+
+/**
+ * Cles des onglets du FLUX DE CREATION. Pas d'onglet « Information » au M3 ;
+ * « Rapports » / « Echanges » n'apparaissent qu'en consultation/modification.
+ * L'onglet « Comptabilite » n'est present que pour les roles qui peuvent le voir
+ * (`technique.providers.accounting.view` — Admin, Compta).
+ */
+export function buildProviderCreateTabKeys(canAccountingView: boolean): string[] {
+    return canAccountingView
+        ? ['contact', 'address', 'accounting']
+        : ['contact', 'address']
+}
+
+export function useProviderForm() {
+    const api = useApi()
+    const { t } = useI18n()
+    const toast = useToast()
+    const { can } = usePermissions()
+
+    // Erreurs de validation par champ (ERP-101) du formulaire principal.
+    const mainErrors = useFormErrors()
+
+    // ERP-172 : remontee d'erreur 409/422 lors d'une suppression immediate de
+    // sous-ressource (message back affiche en toast dedie — pas de mapping inline,
+    // le bloc est en cours de retrait). Ex. dernier RIB d'une LCR -> 409.
+    function notifyRemovalError(error: unknown): void {
+        toast.error({
+            title: t('technique.providers.toast.error'),
+            message: extractApiErrorMessage((error as { data?: unknown })?.data) || t('technique.providers.toast.error'),
+        })
+    }
+
+    // ── Etat du prestataire cree ────────────────────────────────────────────
+    const providerId = ref<number | null>(null)
+    const mainLocked = ref(false)
+    const mainSubmitting = ref(false)
+    const tabSubmitting = ref(false)
+
+    // ── Formulaire principal ──────────────────────────────────────────────────
+    const main = reactive<ProviderMainDraft>(emptyProviderMain())
+
+    // ── Onglets : ordre + gating progressif ───────────────────────────────────
+    const canAccountingView = computed(() => can('technique.providers.accounting.view'))
+    const canAccountingManage = computed(() => can('technique.providers.accounting.manage'))
+    const tabKeys = computed(() => buildProviderCreateTabKeys(canAccountingView.value))
+
+    // Index du dernier onglet deverrouille (-1 tant que le prestataire n'est pas cree).
+    const unlockedIndex = ref(-1)
+    const activeTab = ref<string>('contact')
+    // Onglets valides (passent en lecture seule).
+    const validated = reactive<Record<string, boolean>>({})
+    // Mode MODIFICATION (ERP-145) : navigation libre, pas de verrouillage ni de
+    // bascule automatique d'onglet a 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 : RG-3.03 (>= 1 site) et RG-3.09
+     * (>= 1 categorie). Pose les erreurs inline et retourne false si invalide.
+     * Le back reste la couche autoritaire (ERP-101) ; ce pre-check evite un
+     * aller-retour inutile et porte la garantie RG-3.03 cote front.
+     */
+    function validateMainFront(): boolean {
+        let valid = true
+        if (!main.companyName?.trim()) {
+            mainErrors.setError('companyName', t('technique.providers.form.errors.nameRequired'))
+            valid = false
+        }
+        if (main.siteIris.length === 0) {
+            mainErrors.setError('sites', t('technique.providers.form.errors.siteRequired'))
+            valid = false
+        }
+        if (main.categoryIris.length === 0) {
+            mainErrors.setError('categories', t('technique.providers.form.errors.categoryRequired'))
+            valid = false
+        }
+        return valid
+    }
+
+    /**
+     * Payload du POST principal (groupe `provider:write:main`). `companyName` est
+     * omis s'il est vide afin que la 422 porte la violation NotBlank (RG-3.11) sur
+     * le champ plutot qu'une erreur de type. Les relations M2M partent en IRI.
+     */
+    function buildMainPayload(): Record<string, unknown> {
+        const payload: Record<string, unknown> = {
+            categories: [...main.categoryIris],
+            sites: [...main.siteIris],
+        }
+        if (main.companyName?.trim()) {
+            payload.companyName = main.companyName
+        }
+        return payload
+    }
+
+    /**
+     * POST /providers (groupe `provider:write:main`). Pre-check front RG-3.03/3.09,
+     * puis creation. Au succes : verrouille le bloc principal, deverrouille le 1er
+     * onglet et bascule sur « Contact ». Retourne true si cree, 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<ProviderMainResponse>('/providers', buildMainPayload(), {
+                headers: { Accept: 'application/ld+json' },
+                toast: false,
+            })
+
+            providerId.value = created.id
+            // Reaffiche la valeur normalisee renvoyee par le serveur (UPPERCASE, RG-3.11).
+            main.companyName = created.companyName ?? main.companyName
+
+            mainLocked.value = true
+            unlockedIndex.value = 0
+            activeTab.value = tabKeys.value[0] ?? 'contact'
+            toast.success({ title: t('technique.providers.toast.createSuccess') })
+            return true
+        }
+        catch (error) {
+            // 409 = doublon de nom (RG-3.10) → erreur inline dediee + 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('technique.providers.form.duplicateCompany')
+                mainErrors.setError('companyName', message)
+                toast.error({ title: t('technique.providers.toast.error'), message })
+            }
+            else {
+                mainErrors.handleApiError(error, { fallbackMessage: t('technique.providers.toast.error') })
+            }
+            return false
+        }
+        finally {
+            mainSubmitting.value = false
+        }
+    }
+
+    /**
+     * PATCH partiel du prestataire (mode strict : un seul groupe de serialisation
+     * par appel — spec-back § 2.10). Sert l'onglet Comptabilite a champs scalaires
+     * (ERP-144) ; les onglets Contact/Adresse passent par leurs sous-ressources
+     * (POST/PATCH par ligne, ERP-142/143). No-op tant que le prestataire n'existe pas.
+     */
+    async function patchProvider(payload: Record<string, unknown>): Promise<void> {
+        if (providerId.value === null) return
+        await api.patch(`/providers/${providerId.value}`, payload, { toast: false })
+    }
+
+    /**
+     * MODIFICATION du bloc principal (ERP-145) : PATCH /providers/{id} sur le groupe
+     * provider:write:main (nom + categories + sites). Pre-check front RG-3.03/3.09,
+     * 409 doublon de nom (RG-3.10) et 422 mappes inline comme a la creation. A la
+     * difference de `submitMain`, ne verrouille rien et ne bascule pas d'onglet (la
+     * navigation est libre en modification). Retourne true si le PATCH a reussi.
+     */
+    async function updateMain(): Promise<boolean> {
+        if (providerId.value === null || mainSubmitting.value) return false
+        mainErrors.clearErrors()
+        if (!validateMainFront()) return false
+
+        mainSubmitting.value = true
+        try {
+            const updated = await api.patch<ProviderMainResponse>(
+                `/providers/${providerId.value}`,
+                buildMainPayload(),
+                { toast: false },
+            )
+            main.companyName = updated.companyName ?? main.companyName
+            return true
+        }
+        catch (error) {
+            const status = (error as { response?: { status?: number } })?.response?.status
+            if (status === 409) {
+                const message = t('technique.providers.form.duplicateCompany')
+                mainErrors.setError('companyName', message)
+                toast.error({ title: t('technique.providers.toast.error'), message })
+            }
+            else {
+                mainErrors.handleApiError(error, { fallbackMessage: t('technique.providers.toast.error') })
+            }
+            return false
+        }
+        finally {
+            mainSubmitting.value = false
+        }
+    }
+
+    /**
+     * Marque un onglet valide (passe en lecture seule), deverrouille et avance a
+     * l'onglet suivant. Retourne true si c'etait le dernier onglet du flux
+     * (creation terminee), false sinon.
+     */
+    function completeTab(key: string): boolean {
+        // En modification : navigation libre, l'onglet reste editable apres 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
+    }
+
+    /**
+     * Soumet TOUS les blocs d'une collection en collectant les erreurs PAR INDEX :
+     * on n'arrete pas au premier bloc en echec (decision ERP-101). Reinitialise la
+     * cible, tente chaque ligne via `saveRow`, mappe les 422 inline ou delegue le
+     * fallback a `onUnmappedError`. `shouldSkip` ignore les amorces vides. Retourne
+     * true si au moins un bloc a echoue. Miroir de `useSupplierFormErrors.submitRows`.
+     */
+    async function submitRows<T>(
+        rows: T[],
+        target: Ref<Record<string, string>[]>,
+        saveRow: (row: T, index: number) => Promise<void>,
+        onUnmappedError: (error: unknown, index: number) => void,
+        shouldSkip?: (row: T, index: number) => boolean,
+    ): Promise<boolean> {
+        target.value = []
+        let hasError = false
+        for (let index = 0; index < rows.length; index++) {
+            const row = rows[index] as T
+            if (shouldSkip?.(row, index)) {
+                continue
+            }
+            try {
+                await saveRow(row, index)
+            }
+            catch (error) {
+                const response = (error as { response?: { status?: number, _data?: unknown } })?.response
+                const mapped = response?.status === 422 ? mapViolationsToRecord(response._data) : {}
+                if (Object.keys(mapped).length > 0) {
+                    target.value[index] = mapped
+                }
+                else {
+                    onUnmappedError(error, index)
+                }
+                hasError = true
+            }
+        }
+        return hasError
+    }
+
+    // ── Onglet Contact (ERP-142) ──────────────────────────────────────────────
+    const contacts = ref<ProviderContactFormDraft[]>([emptyProviderContact()])
+    // Erreurs 422 par ligne (alignees sur l'index du v-for), peuplees par submitRows.
+    const contactErrors = ref<Record<string, string>[]>([])
+
+    // « + Nouveau contact » desactive tant que le dernier bloc n'a pas de nom OU
+    // prenom (RG-3.04, aligne M1/M2 — fonction/tel/email seuls ne suffisent pas).
+    const canAddContact = computed(() => {
+        const last = contacts.value[contacts.value.length - 1]
+        return last !== undefined && isProviderContactNamed(last)
+    })
+
+    function addContact(): void {
+        if (canAddContact.value) {
+            contacts.value.push(emptyProviderContact())
+        }
+    }
+
+    // ERP-172 : DELETE immediat du contact existant (sous-ressource) a la
+    // confirmation de la modale. Bloc jamais persiste (id null) : retrait local.
+    async function removeContact(index: number): Promise<void> {
+        await removeCollectionRow({
+            rows: contacts.value,
+            errors: contactErrors.value,
+            index,
+            endpoint: '/provider_contacts',
+            deleteRow: url => api.delete(url, {}, { toast: false }),
+            makeEmpty: emptyProviderContact,
+            onError: notifyRemovalError,
+        })
+    }
+
+    /**
+     * Valide l'onglet Contact : POST des nouveaux contacts sur
+     * /providers/{id}/contacts, PATCH des existants sur /provider_contacts/{id}
+     * (sous-ressource, groupe provider:write:contacts). RG-3.12 : au moins un bloc
+     * valide. Si l'onglet ne contient QUE des amorces vides, on les soumet pour
+     * declencher la 422 RG-3.04 inline (sur `firstName`) plutot que de finaliser un
+     * onglet vide. Retourne true si l'onglet a ete valide (avance/termine).
+     */
+    async function submitContacts(onError: (error: unknown) => void): Promise<boolean> {
+        if (providerId.value === null || tabSubmitting.value) {
+            return false
+        }
+        tabSubmitting.value = true
+        try {
+            const hasSubmittable = contacts.value.some(c => c.id !== null || !isProviderContactBlank(c))
+            const hasError = await submitRows(
+                contacts.value,
+                contactErrors,
+                async (contact) => {
+                    const body = buildProviderContactPayload(contact)
+                    if (contact.id === null) {
+                        const created = await api.post<ProviderContactResponse>(
+                            `/providers/${providerId.value}/contacts`,
+                            body,
+                            { headers: { Accept: 'application/ld+json' }, toast: false },
+                        )
+                        contact.id = created.id
+                        contact.iri = created['@id'] ?? null
+                    }
+                    else {
+                        await api.patch(`/provider_contacts/${contact.id}`, body, { toast: false })
+                    }
+                },
+                onError,
+                contact => hasSubmittable && contact.id === null && isProviderContactBlank(contact),
+            )
+            if (hasError) {
+                return false
+            }
+            completeTab('contact')
+            return true
+        }
+        finally {
+            tabSubmitting.value = false
+        }
+    }
+
+    // ── Onglet Adresse (ERP-143) ──────────────────────────────────────────────
+    const addresses = ref<ProviderAddressFormDraft[]>([emptyProviderAddress()])
+    // Erreurs 422 par ligne (alignees sur l'index du v-for).
+    const addressErrors = ref<Record<string, string>[]>([])
+
+    // « + Nouvelle adresse » desactive tant que la derniere adresse n'a pas
+    // au moins un site ET une categorie (RG-3.05 / RG-3.09).
+    const canAddAddress = computed(() => {
+        const last = addresses.value[addresses.value.length - 1]
+        return last !== undefined && isProviderAddressValid(last)
+    })
+
+    function addAddress(): void {
+        if (canAddAddress.value) {
+            addresses.value.push(emptyProviderAddress())
+        }
+    }
+
+    // ERP-172 : DELETE immediat de l'adresse existante (sous-ressource).
+    async function removeAddress(index: number): Promise<void> {
+        await removeCollectionRow({
+            rows: addresses.value,
+            errors: addressErrors.value,
+            index,
+            endpoint: '/provider_addresses',
+            deleteRow: url => api.delete(url, {}, { toast: false }),
+            makeEmpty: emptyProviderAddress,
+            onError: notifyRemovalError,
+        })
+    }
+
+    /**
+     * Valide l'onglet Adresse : POST des nouvelles adresses sur
+     * /providers/{id}/addresses, PATCH des existantes sur /provider_addresses/{id}
+     * (sous-ressource, groupe provider:write:addresses). Erreurs 422 collectees par
+     * ligne. Retourne true si l'onglet a ete valide (avance/termine).
+     */
+    async function submitAddresses(onError: (error: unknown) => void): Promise<boolean> {
+        if (providerId.value === null || tabSubmitting.value) {
+            return false
+        }
+        tabSubmitting.value = true
+        try {
+            const hasError = await submitRows(
+                addresses.value,
+                addressErrors,
+                async (address) => {
+                    const body = buildProviderAddressPayload(address)
+                    if (address.id === null) {
+                        const created = await api.post<ProviderAddressResponse>(
+                            `/providers/${providerId.value}/addresses`,
+                            body,
+                            { headers: { Accept: 'application/ld+json' }, toast: false },
+                        )
+                        address.id = created.id
+                    }
+                    else {
+                        await api.patch(`/provider_addresses/${address.id}`, body, { toast: false })
+                    }
+                },
+                onError,
+            )
+            if (hasError) {
+                return false
+            }
+            completeTab('address')
+            return true
+        }
+        finally {
+            tabSubmitting.value = false
+        }
+    }
+
+    // ── Onglet Comptabilite (ERP-144) ─────────────────────────────────────────
+    const accounting = reactive<ProviderAccountingDraft>(emptyProviderAccounting())
+    const ribs = ref<ProviderRibFormDraft[]>([])
+    const accountingErrors = useFormErrors()
+    // Erreurs 422 par ligne de RIB (alignees sur l'index du v-for).
+    const ribErrors = ref<Record<string, string>[]>([])
+
+    // L'onglet est editable seulement avec accounting.manage (sinon lecture seule).
+    const accountingReadonly = computed(() => isValidated('accounting') || !canAccountingManage.value)
+
+    /**
+     * Met a jour le type de reglement (IRI) en propageant ses RG inter-champs :
+     *  - hors VIREMENT (RG-3.07) : on vide la banque (sans objet) ;
+     *  - LCR (RG-3.08) : on garantit au moins un bloc RIB visible ; hors LCR, on
+     *    purge les erreurs de RIB (les blocs sont conserves mais non persistes).
+     * `isBankRequired` / `isRibRequired` sont calcules par l'appelant (page) a
+     * partir du code resolu via les referentiels.
+     */
+    function setPaymentType(iri: string | null, isBankRequired: boolean, isRibRequired: boolean): void {
+        accounting.paymentTypeIri = iri
+        if (!isBankRequired) {
+            accounting.bankIri = null
+        }
+        if (isRibRequired) {
+            if (ribs.value.length === 0) {
+                ribs.value.push(emptyProviderRib())
+            }
+        }
+        else {
+            ribErrors.value = []
+        }
+    }
+
+    // « + RIB » desactive tant que le dernier bloc RIB n'est pas complet (RG-3.08).
+    const canAddRib = computed(() => {
+        const last = ribs.value[ribs.value.length - 1]
+        return last !== undefined && isRibComplete(last)
+    })
+
+    function addRib(): void {
+        if (canAddRib.value) {
+            ribs.value.push(emptyProviderRib())
+        }
+    }
+
+    // ERP-172 : DELETE immediat du RIB existant. Le back peut refuser la suppression
+    // du dernier RIB d'une LCR -> 409 remonte via notifyRemovalError, bloc conserve.
+    async function removeRib(index: number): Promise<void> {
+        await removeCollectionRow({
+            rows: ribs.value,
+            errors: ribErrors.value,
+            index,
+            endpoint: '/provider_ribs',
+            deleteRow: url => api.delete(url, {}, { toast: false }),
+            makeEmpty: emptyProviderRib,
+            onError: notifyRemovalError,
+        })
+    }
+
+    /**
+     * Valide l'onglet Comptabilite : (1) sous LCR, POST/PATCH des RIB d'abord
+     * (le back valide RG-3.08 sur le PATCH scalaires, les RIB doivent donc exister
+     * AVANT) ; (2) PATCH des scalaires comptables (groupe provider:write:accounting,
+     * banque envoyee seulement si VIREMENT — RG-3.07). Erreurs RIB par ligne ;
+     * erreurs scalaires inline (bank/paymentType). Retourne true si l'onglet a ete
+     * valide.
+     */
+    async function submitAccounting(
+        isBankRequired: boolean,
+        isRibRequired: boolean,
+        onRibError: (error: unknown) => void,
+    ): Promise<boolean> {
+        if (providerId.value === null || tabSubmitting.value) {
+            return false
+        }
+        tabSubmitting.value = true
+        accountingErrors.clearErrors()
+        try {
+            // 1) RIB d'abord, uniquement sous LCR. Une amorce vide neuve est sautee
+            // s'il reste un autre RIB soumettable ; sinon (LCR sans aucun RIB rempli)
+            // on la soumet pour declencher la 422 NotBlank inline.
+            if (isRibRequired) {
+                const hasSubmittableRib = ribs.value.some(r => r.id !== null || !isRibBlank(r))
+                const ribHasError = await submitRows(
+                    ribs.value,
+                    ribErrors,
+                    async (rib) => {
+                        const body = buildProviderRibPayload(rib)
+                        if (rib.id === null) {
+                            const created = await api.post<ProviderRibResponse>(
+                                `/providers/${providerId.value}/ribs`,
+                                body,
+                                { headers: { Accept: 'application/ld+json' }, toast: false },
+                            )
+                            rib.id = created.id
+                        }
+                        else {
+                            await api.patch(`/provider_ribs/${rib.id}`, body, { toast: false })
+                        }
+                    },
+                    onRibError,
+                    rib => hasSubmittableRib && rib.id === null && isRibBlank(rib),
+                )
+                if (ribHasError) {
+                    return false
+                }
+            }
+
+            // 2) PATCH des scalaires comptables (erreurs inline sur leurs champs).
+            try {
+                await api.patch(
+                    `/providers/${providerId.value}`,
+                    buildProviderAccountingPayload(accounting, isBankRequired),
+                    { toast: false },
+                )
+            }
+            catch (error) {
+                accountingErrors.handleApiError(error, { fallbackMessage: t('technique.providers.toast.error') })
+                return false
+            }
+
+            completeTab('accounting')
+            return true
+        }
+        finally {
+            tabSubmitting.value = false
+        }
+    }
+
+    return {
+        // etat
+        main,
+        providerId,
+        mainLocked,
+        mainSubmitting,
+        tabSubmitting,
+        mainErrors,
+        // onglets
+        canAccountingView,
+        canAccountingManage,
+        tabKeys,
+        activeTab,
+        unlockedIndex,
+        validated,
+        editMode,
+        isValidated,
+        // contacts
+        contacts,
+        contactErrors,
+        canAddContact,
+        addContact,
+        removeContact,
+        submitContacts,
+        // adresses
+        addresses,
+        addressErrors,
+        canAddAddress,
+        addAddress,
+        removeAddress,
+        submitAddresses,
+        // comptabilite
+        accounting,
+        ribs,
+        accountingErrors,
+        ribErrors,
+        accountingReadonly,
+        setPaymentType,
+        canAddRib,
+        addRib,
+        removeRib,
+        submitAccounting,
+        // actions
+        validateMainFront,
+        buildMainPayload,
+        submitMain,
+        updateMain,
+        patchProvider,
+        completeTab,
+        submitRows,
+    }
+}

frontend/modules/technique/composables/useProviderReferentials.ts

@@ -0,0 +1,136 @@
+import { ref } from 'vue'
+
+/**
+ * Charge les referentiels (listes courtes) alimentant les selects du formulaire
+ * principal de l'ecran « Ajouter un prestataire » (M3 Technique, ERP-141) :
+ * categories (type PRESTATAIRE) et sites (86 / 17 / 82).
+ *
+ * Miroir reduit de `useSupplierReferentials` (M2) : a ce stade (formulaire
+ * principal) seuls categories + sites sont necessaires. Les referentiels
+ * comptables (modes de TVA, delais/types de reglement, banques) seront charges
+ * par l'onglet Comptabilite (ERP-144).
+ *
+ * Toutes les collections sont recuperees en entier via l'echappatoire prevue
+ * `?pagination=false` (referentiels de quelques entrees), avec l'en-tete
+ * `Accept: application/ld+json` impose par API Platform 4 pour obtenir l'enveloppe
+ * Hydra (`member`). La valeur d'option est l'IRI Hydra (`@id`), renvoyee telle
+ * quelle dans le payload POST (relations M2M).
+ *
+ * Chargement RESILIENT (Promise.allSettled) : chaque referentiel est isole ; un
+ * echec (permission manquante, reseau) laisse simplement la liste vide.
+ *
+ * Etat 100 % local a l'instance (refs) — aucune persistance URL.
+ */
+
+/** Option generique au format attendu par MalioSelect / MalioSelectCheckbox. */
+export interface RefOption {
+    value: string
+    label: string
+}
+
+/** Option de type de reglement enrichie de son code stable (RG-3.07 / RG-3.08). */
+export interface PaymentTypeOption extends RefOption {
+    code: string
+}
+
+interface HydraMember {
+    '@id': string
+}
+
+interface ReferentialMember extends HydraMember {
+    code: string
+    label: string
+}
+
+interface CategoryMember extends HydraMember {
+    code: string
+    name: string
+}
+
+interface SiteMember extends HydraMember {
+    name: string
+    postalCode: string
+}
+
+interface CountryMember extends HydraMember {
+    code: string
+    name: string
+}
+
+const LD_JSON_HEADERS = { Accept: 'application/ld+json' }
+
+export function useProviderReferentials() {
+    const api = useApi()
+
+    const categories = ref<RefOption[]>([])
+    const sites = ref<RefOption[]>([])
+    const countries = ref<RefOption[]>([])
+    // Referentiels comptables (charges a la demande via loadAccounting).
+    const tvaModes = ref<RefOption[]>([])
+    const paymentDelays = ref<RefOption[]>([])
+    const paymentTypes = ref<PaymentTypeOption[]>([])
+    const banks = ref<RefOption[]>([])
+
+    /** Recupere une collection complete (pagination desactivee) en Hydra. */
+    async function fetchAll<T extends HydraMember>(
+        url: string,
+        query: Record<string, string | string[]> = {},
+    ): Promise<T[]> {
+        const res = await api.get<{ member?: T[] }>(
+            url,
+            { pagination: 'false', ...query },
+            { headers: LD_JSON_HEADERS, toast: false },
+        )
+        return res.member ?? []
+    }
+
+    /** Charge en parallele les referentiels du formulaire principal (categories + sites). */
+    async function loadMain(): Promise<void> {
+        await Promise.allSettled([
+            // RG-3.09 : un prestataire ne porte que des categories de type
+            // PRESTATAIRE -> filtre cote API. Libelle affiche = `name`.
+            fetchAll<CategoryMember>('/categories', { typeCode: 'PRESTATAIRE' })
+                .then((cats) => { categories.value = cats.map(c => ({ value: c['@id'], label: c.name })) }),
+            // Sites (RG-3.03) : libelle = numero de departement (2 premiers chiffres
+            // du code postal du site), ex: 86100 -> « 86 », 17400 -> « 17 ».
+            fetchAll<SiteMember>('/sites')
+                .then((sitesList) => { sites.value = sitesList.map(s => ({ value: s['@id'], label: (s.postalCode ?? '').slice(0, 2) })) }),
+            // Pays (ERP-116) : la valeur d'option est le NOM du pays (l'adresse stocke
+            // `country` en chaine libre, « France »...). value === label. Aligne sur
+            // les ecrans client/fournisseur. Sert le select Pays de l'onglet Adresse.
+            fetchAll<CountryMember>('/countries')
+                .then((list) => { countries.value = list.map(c => ({ value: c.name, label: c.name })) }),
+        ])
+    }
+
+    /**
+     * Charge les referentiels comptables (onglet Comptabilite, ERP-144). Appele
+     * uniquement quand l'utilisateur peut voir l'onglet (accounting.view). Resilient
+     * (allSettled) : un referentiel en echec reste vide.
+     */
+    async function loadAccounting(): Promise<void> {
+        await Promise.allSettled([
+            fetchAll<ReferentialMember>('/tva_modes')
+                .then((list) => { tvaModes.value = list.map(t => ({ value: t['@id'], label: t.label })) }),
+            fetchAll<ReferentialMember>('/payment_delays')
+                .then((list) => { paymentDelays.value = list.map(d => ({ value: d['@id'], label: d.label })) }),
+            // Le code stable du type sert les RG-3.07 (VIREMENT) / RG-3.08 (LCR).
+            fetchAll<ReferentialMember>('/payment_types')
+                .then((list) => { paymentTypes.value = list.map(p => ({ value: p['@id'], label: p.label, code: p.code })) }),
+            fetchAll<ReferentialMember>('/banks')
+                .then((list) => { banks.value = list.map(b => ({ value: b['@id'], label: b.label })) }),
+        ])
+    }
+
+    return {
+        categories,
+        sites,
+        countries,
+        tvaModes,
+        paymentDelays,
+        paymentTypes,
+        banks,
+        loadMain,
+        loadAccounting,
+    }
+}

frontend/modules/technique/composables/useProvidersRepository.ts

@@ -0,0 +1,63 @@
+import { usePaginatedList } from '~/shared/composables/usePaginatedList'
+
+/**
+ * Site Starseed rattache DIRECTEMENT au prestataire (M2M `provider_site`,
+ * RG-3.03), tel qu'embarque en LISTE (groupe site:read) pour la colonne « Site »
+ * du Repertoire (badges colores).
+ *
+ * Difference M3 vs M2 : au M2 les sites venaient de l'agregat dedoublonne des
+ * adresses (`Supplier::getSites()`) ; ici c'est une relation directe portee par
+ * le formulaire principal (cf. spec-back M3 § 2.12).
+ */
+export interface ProviderSite {
+    id: number
+    name: string
+    color: string
+}
+
+/**
+ * Categorie (type PRESTATAIRE) rattachee au prestataire, embarquee en LISTE
+ * (groupe category:read). La colonne « Catégories » affiche le `name` (cohérence
+ * M1/M2 — libellé = `name`, pas `code`).
+ */
+export interface ProviderCategory {
+    code: string
+    name: string
+}
+
+/**
+ * Vue MINIMALE d'un prestataire pour le Repertoire (datatable). Volontairement
+ * partielle : seuls les champs des colonnes + l'id (navigation) sont types ici.
+ * Le detail complet (onglets) est hors perimetre de cet ecran (ERP-140).
+ */
+export interface Provider {
+    id: number
+    companyName: string
+    categories: ProviderCategory[]
+    sites: ProviderSite[]
+    /** Date ISO de derniere modification (default:read) — colonne « Dernière activité ». */
+    updatedAt: string | null
+    isArchived: boolean
+}
+
+/**
+ * Repertoire prestataires (ERP-140) — simple enveloppe de `usePaginatedList<Provider>`
+ * sur la ressource `/providers` (pagination serveur obligatoire ; jamais de
+ * chargement integral en memoire). Miroir de `useSuppliersRepository` (M2).
+ *
+ * Les filtres (recherche, categories, sites, 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 donc les prestataires
+ * archives (exclusion par defaut, spec-back § 2.11). Cocher « Voir les archivés »
+ * envoie `archivedOnly=true` → seules les archives sont listees (aligne sur Client).
+ *
+ * Le cloisonnement par site est applique AUTOMATIQUEMENT cote back (§ 2.13) en
+ * fonction de l'utilisateur — rien a filtrer cote front.
+ *
+ * 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 useProvidersRepository() {
+    return usePaginatedList<Provider>({ url: '/providers' })
+}

frontend/modules/technique/nuxt.config.ts

@@ -0,0 +1 @@
+export default defineNuxtConfig({})