From e60327d2860401fcb959eb25ab14bfff40f46668 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Munsch?= <github@jeremydev.ovh>
Date: Mon, 31 Aug 2026 11:30:41 +0200
Subject: [PATCH] docs(arcadia): add brand queries, HTTP API endpoint, and CLI
 usage in README

---
 documentation/Arcadia/README.md | 62 +++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/documentation/Arcadia/README.md b/documentation/Arcadia/README.md
index 0539e97..0734f93 100644
--- a/documentation/Arcadia/README.md
+++ b/documentation/Arcadia/README.md
@@ -97,3 +97,65 @@ LEFT JOIN METAP.META_UTIL u_cmcl ON i.UTIL_CMCL = u_cmcl.COD_UTIL
 LEFT JOIN METAP.META_UTIL u_mkt ON i.UTIL_MKT = u_mkt.COD_UTIL
 LEFT JOIN METAP.META_UTIL u_qual ON i.UTIL_QUAL = u_qual.COD_UTIL;
 ```
+
+### D. Référentiel des Marques (`REFP.MARQUE`)
+
+#### Requête SQL Oracle de référence
+```sql
+SELECT 
+    m.COD_MARQ          AS id,
+    m.LIB_MARQ          AS name,
+    m.COD_RGPT_MARQ     AS rgpt_code,
+    m.COMMENTAIRE       AS comment,
+    m.TYPE_MARQUE       AS type,
+    m.SOCIETE           AS societe,
+    m.MARQUE_PROPRE     AS is_own_brand,
+    m.GLN_SOC           AS gln
+FROM REFP.MARQUE m
+ORDER BY m.COD_MARQ ASC;
+```
+
+#### Requête HTTP API
+
+```http
+GET /api/v1/brands
+Authorization: Bearer <API_TOKEN>
+Accept: application/json
+```
+
+**Exemple avec cURL :**
+```bash
+curl -X GET "https://api.arcadia.ldc.fr/api/v1/brands" \
+  -H "Authorization: Bearer YOUR_API_TOKEN" \
+  -H "Accept: application/json"
+```
+
+**Exemple de réponse JSON (200 OK) :**
+```json
+{
+  "data": [
+    {
+      "id": "1",
+      "name": "LE GAULOIS"
+    },
+    {
+      "id": "2",
+      "name": "MAITRE COQ"
+    },
+    {
+      "id": "3",
+      "name": "LOUÉ"
+    }
+  ],
+  "links": {
+    "self": "http://localhost/api/v1/brands"
+  }
+}
+```
+
+#### Commande CLI Artisan
+
+```bash
+php artisan arcadia:brand:list
+```
+