Files
Starseed/docs/specs/M4-transporteurs/prompts/WT5-qualimat.md
T
Matthieu d9313dbec8 feat(transport) : schéma + entités Carrier + contrat lecture (ERP-155/157)
Schéma BDD du répertoire transporteurs (M4) + entités + contrat de lecture
(liste + détail), socle du front.

- Migration Version20260615150000 : tables carrier / carrier_address /
  carrier_contact / carrier_price (FK cross-module, CHECK enum, index partiel
  uq_carrier_name_active, COMMENT ON COLUMN). uploaded_document et
  qualimat_carrier réutilisées (non recréées).
- Entités Carrier* (#[Auditable], Timestampable/Blamable) + ApiResource
  LECTURE seule (GetCollection + Get via CarrierProvider, anti-N+1, exclusion
  archivés + ?includeArchived). Écriture (POST/PATCH + Processor) reportée WT4+.
- QualimatCarrier : mapping ORM lecture seule sur la table référentielle
  existante (sortie du schema_filter, mapping aligné DDL ERP-39, schema:update
  no-op) + endpoint de recherche read-only (§ 4.7).
- Relations cross-module des prix (Client/Supplier/adresses) via contrats
  Shared (ClientInterface, SupplierInterface, ClientAddressInterface,
  SupplierAddressInterface) + resolve_target_entities — sans import inter-module
  (règle n°1). Ajout du groupe supplier_address:read aux champs de
  SupplierAddress pour l'embed.
- Garde-fous : ColumnCommentsCatalog (carrier* + qualimat_carrier), makefile
  test-db-setup (index partiel carrier), i18n audit (transport_carrier*),
  EntitiesAreTimestampableBlamableTest (QualimatCarrier whitelisté).
- CarrierSerializationContractTest : contrat JSON liste + détail vérifié
  (embeds objet, booléens, enveloppe Hydra) ; JSON réel capturé dans
  spec-back § 4.0.bis.

make db-reset OK, make test vert (731), make nuxt-test vert (480),
php-cs-fixer OK.
2026-06-15 19:15:12 +02:00

2.4 KiB

WT5 — Endpoint QualimatCarrier lecture seule (ticket 1.4 / ERP-156)

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 :

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.