Remove ranking, AI analysis (routes + ai-copilot module), and score-engine from the grid. Add Qlik Sense network metrics (CA, Qte, nb magasins per product) joined by code centrale (articles.artcentrale). - qlik-client.ts: NTLM + ticket SSO auth, QIX hypercube extraction (master items) - qlik-network-cache.ts + qlik_network_metrics table (db-init): cache layer - POST /api/qlik/sync?fournisseur=: per-supplier sync into cache - SyncQlikButton: per-supplier sync, grid reload, last-update date display - get-product-rows Phase 8: enrich rows with cached network metrics - heatmap-grid: CA reseau / Qte reseau / Magasins (/270) / % presence columns - discovery: app 9872ee6e, master items CA N / Quantite N / Magasin Ventes Nb N - deps: httpntlm, ws Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4.8 KiB
Intégration Qlik Sense — données réseau (~270 magasins)
Remplace les heuristiques (ranking / IA / score) par les vraies données réseau La Foir'Fouille : CA réseau, Qté vendue réseau, Nb magasins par produit.
Architecture livrée
| Élément | Fichier |
|---|---|
| Connecteur Qlik (NTLM + QIX websocket) | src/lib/qlik-client.ts |
| Cache lecture/upsert | src/lib/qlik-network-cache.ts |
| Table cache | qlik_network_metrics (src/db/schema.ts, créée par scripts/db-init.js) |
| Route de sync (admin) | POST /api/qlik/sync (src/app/api/qlik/sync/route.ts) |
| Bouton UI | src/features/grid/components/sync-qlik-button.tsx |
| Jointure grille | enrichWithNetworkMetrics() dans src/features/grid/api/get-product-rows.ts (Phase 8) |
| Colonnes grille | CA réseau / Qté réseau / Magasins (/270) / % présence (heatmap-grid.tsx) |
Retirés : ranking (champs/query/colonnes), analyse IA (routes /api/ai/*, bulk-ai-analyzer,
dossier ai-copilot), score (score-engine.ts, colonne score).
Auth — NTLM + ticket SSO (✅ TESTÉ, marche)
Flux implémenté dans qlik-client.ts / scripts/qlik-discover.mjs :
GET /hub/(non authentifié) → 302, on extrait letargetId.- NTLM (login
FFSCH, domaine vide, pasFOIRFOUILLE) sur/internal_windows_authentication/?targetId=…→ 302 vers/hub/?qlikTicket=XXX. GET /hub/?qlikTicket=XXX→ Qlik pose le cookieX-Qlik-Session.- Cookie + Xrfkey → QRS REST (✅) et Engine websocket.
⚠️ Domaine NTLM vide (comme requests_ntlm("FFSCH", pwd)). Forcer FOIRFOUILLE → 401.
Testé depuis l'extérieur : auth + QRS OK, 147 apps côté admin (2 visibles pour FFSCH).
Discovery (✅ FAITE)
App réseau article-niveau = "Magasins Vision Consolidée" (stream Magasin Big Data) :
QLIK_APP_NETWORK = 9872ee6e-d64a-4b43-984a-076bf1f7f647- dim
QLIK_DIM_CODE_ARTICLE_ID = fcd239e5-288b-4830-a047-0e3d7665d971(Article Code) - CA
QLIK_MEAS_CA_ID = 43a76088-86fa-402e-a80e-0efd7701b3e1(CA N) - Qté
QLIK_MEAS_QTE_ID = 7b40caf1-be4b-4811-8d45-50acde33e715(Quantité N) - nb mag
QLIK_MEAS_NBMAG_ID = 8b63fae5-db2f-4e4c-8618-f3e9d60b6b3b(Magasin Ventes Nb N)
Ces GUID sont déjà les défauts dans qlik-client.ts (hypercube par qLibraryId).
(App "CA Foirfouille" stream Réseau = 65b3ad21-… : pas de dimension article → écartée.)
⚠️ À confirmer par un échantillon de hypercube (5 lignes) : que Article Code = code
centrale 10000XXXXXX, et que Magasin Ventes Nb N = nb magasins vendeurs. L'agent hermes
(Playwright) peut le faire.
Limite extraction depuis l'extérieur
Le websocket Engine renvoie 403 depuis un environnement externe (le proxy Qlik refuse
l'upgrade ws hors contexte navigateur ; l'extraction hermes qui marche réutilise une session
Playwright). Sur le réseau corporate (où tournera CollectFlow / où /hub/ renvoie 401
NTLM direct), le ws raw devrait passer. À valider en déployant POST /api/qlik/sync sur leur
infra interne.
Variables d'environnement (.env.local)
QLIK_HOST=reporting-magasins.lafoirfouille.fr
QLIK_USER=FFSCH
QLIK_PWD=<mot de passe courant>
QLIK_DOMAIN= # VIDE (ne pas mettre FOIRFOUILLE — NTLM sans domaine)
QLIK_TLS_INSECURE=true
# Défauts déjà en dur dans qlik-client.ts (discovery 2026-06-20) :
QLIK_APP_NETWORK=9872ee6e-d64a-4b43-984a-076bf1f7f647
QLIK_DIM_CODE_ARTICLE_ID=fcd239e5-288b-4830-a047-0e3d7665d971
QLIK_MEAS_CA_ID=43a76088-86fa-402e-a80e-0efd7701b3e1
QLIK_MEAS_QTE_ID=7b40caf1-be4b-4811-8d45-50acde33e715
QLIK_MEAS_NBMAG_ID=8b63fae5-db2f-4e4c-8618-f3e9d60b6b3b
RESTE À FAIRE
-
Confirmer la sémantique des champs (échantillon hypercube, via l'agent hermes/Playwright ou en déployant
/api/qlik/syncen interne) :Article Code= code centrale10000XXXXXX?Magasin Ventes Nb N= nb magasins vendeurs ? App bien réseau (270 magasins) ? -
Exécuter le sync depuis le réseau interne : le websocket Engine renvoie 403 depuis l'extérieur. Déployer
POST /api/qlik/syncsur l'infra interne FF pour valider l'extraction. -
Code centrale =
articles.artcentrale✅ RÉSOLU. Confirmé via l'API FFGET /api/articles/{no_id}→ champartcentrale(ex"10000167303"=10000+6 chiffres). Ajouté au SELECT depgGetArticlesByFournisseur(a.artcentrale AS "codeCentrale") → propagé dansProductRow.codeCentrale→ jointureenrichWithNetworkMetrics. ⚠️ Vide pour la plupart des articles (seuls les référencés centralement en ont un). À valider que la valeur Qlik "Article Code" est bien au même format sur le premier vrai sync.
Tant que le sync interne n'est pas exécuté, la grille fonctionne en dégradation propre : colonnes réseau vides, aucune erreur.