fix(api): nomenclatures dérivées du préfixe de code3, pas de code1/code2

Les codes de nomenclature FF font 6 chiffres et sont hiérarchiques par préfixe
(31xxxx à 40xxxx) : « 32 » univers, « 3202 » famille, « 320211 » sous-famille.

L'endpoint groupait sur les colonnes code1/code2, qui ne sont renseignées que
si pgGetNomenclatureByFournisseur a su remonter la hiérarchie — ce qui dépend
d'une détection heuristique de la colonne parent de la table `nomenclature`.
Quand elle échoue, seul code3 est rempli et l'endpoint aurait renvoyé une liste
vide aux niveaux 1 et 2, sans rien signaler.

Les niveaux sont désormais dérivés de left(code3, 2|4|6), toujours disponible.

En conséquence, /grid gagne un filtre `nomenclature` par préfixe, qui fonctionne
aux trois niveaux et ne dépend pas non plus de code1/code2 : c'est lui que
meta.filtreGrid désigne. Les filtres code1..code3 exacts restent inchangés.

Les libellés viennent toujours du payload et peuvent être null aux niveaux 1 et
2 pour la même raison ; codes et compteurs, eux, sont exacts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y26nRZxTR57K7h8yqsF675

src/app/api/v1/grid/route.ts

@@ -83,6 +83,7 @@ export async function GET(req: NextRequest) {
         code1: q.code1,
         code2: q.code2,
         code3: q.code3,
+        nomenclature: q.nomenclature,
         search: q.search,
         sort: toSortKey(q.sort),
         order: q.order,

src/app/api/v1/nomenclatures/route.ts

@@ -16,10 +16,11 @@ export const dynamic = "force-dynamic";
  * C'est la porte d'entrée pour traiter un gros fournisseur : certains dépassent
  * 130 000 articles, et tout récupérer d'un coup n'a de sens ni pour une IA ni
  * pour une application. On liste d'abord les postes — quelques dizaines de
- * lignes — puis on interroge `/grid?fournisseur=…&code1=…` poste par poste.
+ * lignes — puis on interroge `/grid?fournisseur=…&nomenclature=…` poste par poste.
  *
- * `niveau=2` accepte `parent` (un code1) et `niveau=3` un `parent` (un code2),
- * pour descendre l'arborescence sans tout charger.
+ * Les codes sont hiérarchiques par préfixe (6 chiffres, de 31xxxx à 40xxxx) :
+ * niveau 1 = « 32 », niveau 2 = « 3202 », niveau 3 = « 320211 ». `parent` accepte
+ * un préfixe pour descendre l'arborescence sans tout charger.
  */
 export async function GET(req: NextRequest) {
     const authCtx = await requireApiAuth(req);
@@ -54,8 +55,11 @@ export async function GET(req: NextRequest) {
             nbArticles,
             snapshotRowCount: freshness.rowCount,
             snapshotComputedAt: freshness.computedAt,
-            /** Le paramètre de /grid à utiliser pour filtrer sur un poste de ce niveau. */
-            filtreGrid: `code${niveau}`,
+            /**
+             * Le paramètre de /grid à utiliser avec les `code` renvoyés ci-dessus.
+             * `nomenclature` filtre par préfixe et fonctionne aux trois niveaux.
+             */
+            filtreGrid: "nomenclature",
         },
     });
 }

src/app/api/v1/openapi.json/route.ts

@@ -220,7 +220,7 @@ export async function GET(req: NextRequest) {
                     parameters: [
                         { name: "fournisseur", in: "query", required: true, schema: { type: "string" } },
                         { name: "niveau", in: "query", schema: { type: "integer", enum: [1, 2, 3], default: 1 }, description: "1 = univers, 2 = famille, 3 = sous-famille." },
-                        { name: "parent", in: "query", schema: { type: "string" }, description: "Restreint à un poste parent : un code1 si niveau=2, un code2 si niveau=3." },
+                        { name: "parent", in: "query", schema: { type: "string" }, description: "Préfixe du poste parent, ex. « 32 » pour lister ses familles." },
                     ],
                     responses: {
                         "200": {
@@ -269,7 +269,8 @@ export async function GET(req: NextRequest) {
                         { name: "gamme", in: "query", schema: { type: "string" }, description: "Filtre sur la gamme (A, B, C, D, Z)." },
                         { name: "code1", in: "query", schema: { type: "string" }, description: "Filtre nomenclature niveau 1." },
                         { name: "code2", in: "query", schema: { type: "string" }, description: "Filtre nomenclature niveau 2." },
-                        { name: "code3", in: "query", schema: { type: "string" }, description: "Filtre nomenclature niveau 3." },
+                        { name: "code3", in: "query", schema: { type: "string" }, description: "Filtre nomenclature niveau 3 (code exact)." },
+                        { name: "nomenclature", in: "query", schema: { type: "string" }, description: "Préfixe de nomenclature renvoyé par listerNomenclaturesFournisseur : 32, 3202 ou 320211. À préférer à code1/code2, qui peuvent être vides." },
                         { name: "search", in: "query", schema: { type: "string" }, description: "Filtre texte : libellé, codein, GTIN, référence ou code centrale." },
                         {
                             name: "compute",