From cbfaee2dfbe5b0cf24a8a43cfcd4d59ebe93bad4 Mon Sep 17 00:00:00 2001
From: Michael SCHAL <michaelschal@gmail.com>
Date: Thu, 19 Mar 2026 11:03:28 +0100
Subject: [PATCH] fix: mvtart sync ON CONFLICT DO NOTHING + doc ranking API

- Add ON CONFLICT DO NOTHING to mvtart insert to work with unique index
- Document ranking endpoints in API_DOCUMENTATION.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 API_DOCUMENTATION.md      | 103 ++++++++++++++++++++++++++++++++++++++
 sync/tables/mouvements.js |   2 +-
 2 files changed, 104 insertions(+), 1 deletion(-)

diff --git a/API_DOCUMENTATION.md b/API_DOCUMENTATION.md
index 42875f7..c1eb80f 100644
--- a/API_DOCUMENTATION.md
+++ b/API_DOCUMENTATION.md
@@ -860,6 +860,108 @@ GET /api/performance/ca/gamme?dateDebut=&dateFin=&site=
 
 ---
 
+## Ranking (classement réseau)
+
+### Recherche ranking
+```
+GET /api/ranking?gencod=&codein=&site=&foucentrale=&limit=
+```
+
+Retourne les classements réseau et magasin des articles. Les données proviennent des fichiers d'import centrale (TURBOCAR, AUXENCE, etc.).
+
+| Paramètre     | Type   | Description                        | Défaut |
+|---------------|--------|------------------------------------|--------|
+| `gencod`      | string | Code EAN exact                     | —      |
+| `codein`      | string | Code interne article               | —      |
+| `site`        | string | Filtrer par site (partiel)         | tous   |
+| `foucentrale` | string | Filtrer par fournisseur (partiel)  | tous   |
+| `limit`       | int    | Nombre max (max 500)               | 50     |
+
+**Réponse** :
+```json
+{
+  "count": 3,
+  "ranking": [
+    {
+      "gencod": "3700536100805",
+      "site": "292",
+      "libelle": "ETUI 10 CARTES FIDELITE COUSU FANTASIA",
+      "foucentrale": "FFTURBOC",
+      "nomfoucentrale": "TURBOCAR",
+      "ranking_ca": 90,
+      "ranking_qte": 39,
+      "ranking_mag_ca": 0,
+      "ranking_mag_qte": 0,
+      "ranking_mag_marge": 0,
+      "pv_calcule": 3.89,
+      "pv_mag": 0,
+      "pv_cen": null,
+      "codefamille": "350402",
+      "libellefamille": "EQUIPEMENT INTERIEUR ET EXTERIEUR",
+      "date_maj": "2024-05-06T00:00:00.000Z",
+      "date_calcul_mag": "1901-01-01T00:00:00.000Z",
+      "art_no_id": "2920000106042",
+      "codein": "129632"
+    }
+  ]
+}
+```
+
+**Clés ranking** :
+| Champ | Description |
+|-------|-------------|
+| `ranking_ca` | Classement réseau par chiffre d'affaires (1 = meilleur) |
+| `ranking_qte` | Classement réseau par quantité vendue |
+| `ranking_mag_ca` | Classement magasin par CA |
+| `ranking_mag_qte` | Classement magasin par quantité |
+| `ranking_mag_marge` | Classement magasin par marge |
+| `pv_calcule` | Prix de vente calculé par la centrale |
+| `pv_mag` | Prix de vente magasin |
+| `pv_cen` | Prix de vente centrale |
+
+> Le ranking est lié aux articles via le **GENCOD** (EAN). La jointure avec `art_gtin` permet de retrouver le `no_id` et le `codein`.
+
+---
+
+### Ranking d'un article
+```
+GET /api/ranking/article/:id
+```
+
+**Paramètre** : `id` = `no_id` de l'article
+
+Retourne le ranking pour tous les sites où l'article est référencé.
+
+```json
+{
+  "artNoId": "2920000106042",
+  "ranking": [
+    {
+      "gencod": "3700536100805",
+      "site": "292",
+      "ranking_ca": 90,
+      "ranking_qte": 39,
+      "ranking_mag_ca": 0,
+      "ranking_mag_qte": 0,
+      "ranking_mag_marge": 0,
+      "foucentrale": "FFTURBOC",
+      "nomfoucentrale": "TURBOCAR",
+      "pv_calcule": 3.89,
+      "pv_mag": 0,
+      "pv_cen": null,
+      "codefamille": "350402",
+      "libellefamille": "EQUIPEMENT INTERIEUR ET EXTERIEUR",
+      "date_maj": "2024-05-06T00:00:00.000Z",
+      "date_calcul_mag": "1901-01-01T00:00:00.000Z"
+    }
+  ]
+}
+```
+
+> Le ranking est aussi inclus dans la fiche référentiel : `GET /api/articles/:id/referentiel` → champ `ranking`.
+
+---
+
 ## Synchronisation
 
 ### État de la sync
@@ -902,6 +1004,7 @@ GET /api/sync/status
 | `cdefou_vivant` | Refresh complet | Nuit |
 | `cdefou_reception` | Delta | Nuit |
 | `cdefou_receplig` | Delta | Nuit |
+| `ranking` | Refresh complet | Nuit |
 
 ---
 
diff --git a/sync/tables/mouvements.js b/sync/tables/mouvements.js
index 4440030..306018d 100644
--- a/sync/tables/mouvements.js
+++ b/sync/tables/mouvements.js
@@ -25,7 +25,7 @@ async function insertChunk(pg, table, rows, cols) {
     return `(${ph.join(', ')})`;
   });
   await pg.query(
-    `INSERT INTO ${table} (${cols.join(', ')}) VALUES ${placeholders.join(', ')}`,
+    `INSERT INTO ${table} (${cols.join(', ')}) VALUES ${placeholders.join(', ')} ON CONFLICT DO NOTHING`,
     values
   );
 }