feat(api): métriques Qlik + gamme serveur à jour, et doc de connexion dans Paramètres

L'instantané grid_rows fige la ligne au moment du calcul, mais deux données
évoluent indépendamment et doivent refléter l'état courant :

- Métriques réseau Qlik : qlik_network_metrics est alimentée par les syncs et
  les recherches réseau, hors du calcul de grille. Relues à chaque appel et
  exposées dans `network` (null quand le produit n'en a pas). Les colonnes
  caReseau/qteReseau/... de la ligne sont réalignées dessus.
- Gamme serveur : codeGamme peut être surchargée par un snapshot de session.
  L'API expose `codeGammeServeur`, la gamme NON modifiée telle qu'elle est en
  base PostgreSQL, relue à chaque appel. codeGammeInit est gardé aligné.

Ajout de pgGetGammesByCodeins() : variante sans jointure artfou1, nécessaire
car la recherche de l'API est transversale (pas de fournisseur connu).

Ce n'est pas un recalcul : deux lectures indexées bornées à la page courante
(500 lignes max). Mesuré à ~20 ms, soit le même coût que sans enrichissement.
Paramètre enrich=0 pour servir l'instantané brut.

Paramètres → nouvelle section « API CollectFlow — Connexion » : URL de base
déduite de l'origine, en-têtes d'authentification, liste des endpoints et des
paramètres, exemples curl copiables, lien vers openapi.json.

Vérifié sur PostgreSQL local avec un instantané volontairement périmé :
gamme snapshot A → serveur C, caReseau 111 → 990000, produit sans données
réseau → network null, produit sans gamme → codeGammeServeur null, enrich=0
redonnant bien les valeurs figées, et toujours zéro recalcul.

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

src/lib/api-schemas.ts

@@ -8,7 +8,6 @@
 
 import { z } from "zod";
 import { GRID_SORT_KEYS, type GridSortKey } from "@/lib/grid-store";
-import type { ProductRow } from "@/types/grid";
 
 const SORT_KEYS = GRID_SORT_KEYS as readonly string[];
 
@@ -27,6 +26,11 @@ const sortShape = {
     order: z.enum(["asc", "desc"]).default("desc"),
     /** Liste de champs de ProductRow à conserver, séparés par des virgules. */
     fields: z.string().optional(),
+    /**
+     * `1` (défaut) : relit les métriques réseau Qlik et la gamme serveur au moment
+     * de l'appel. `0` : sert l'instantané brut, un peu plus rapide.
+     */
+    enrich: z.enum(["0", "1"]).default("1"),
 };
 
 /** `/api/v1/grid` — le fournisseur est obligatoire (recherche transversale : /products/search). */
@@ -67,7 +71,7 @@ export const productDetailSchema = z.object({
  * et les ventilations par magasin, ce qui est volumineux sur plusieurs centaines de
  * lignes. `codein` est toujours conservé pour que la ligne reste identifiable.
  */
-export function pickFields(row: ProductRow, fields?: string): Partial<ProductRow> {
+export function pickFields<T extends object>(row: T, fields?: string): Partial<T> {
     if (!fields) return row;
     const wanted = new Set(
         fields.split(",").map((f) => f.trim()).filter(Boolean),
@@ -78,7 +82,7 @@ export function pickFields(row: ProductRow, fields?: string): Partial<ProductRow
     for (const key of wanted) {
         if (key in row) out[key] = (row as unknown as Record<string, unknown>)[key];
     }
-    return out as Partial<ProductRow>;
+    return out as Partial<T>;
 }
 
 /** Normalise le tri validé vers la clé attendue par grid-store. */