feat(docs): update API reference with new endpoints and extended parameter details

documentation/content/docs/api-reference.mdx

@@ -82,6 +82,11 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
     Récupère les informations détaillées de l'utilisateur connecté. Requiert l'authentification.
   </Accordion>
 
+  <Accordion title="GET /users/public/:username">
+    Récupère le profil public d'un utilisateur par son nom d'utilisateur.
+    **Réponse :** `id`, `username`, `displayName`, `avatarUrl`, `createdAt`.
+  </Accordion>
+
   <Accordion title="GET /users/me/export">
     Extrait l'intégralité des données de l'utilisateur au format JSON (Conformité RGPD).
     Contient le profil, les contenus et les favoris.
@@ -89,7 +94,22 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
 
   <Accordion title="PATCH /users/me">
     Met à jour les informations du profil.
+    **Corps :**
     - `displayName` (string)
+    - `bio` (string)
+  </Accordion>
+
+  <Accordion title="POST /users/me/avatar">
+    Met à jour l'avatar de l'utilisateur.
+    **Type :** `multipart/form-data`
+    **Champ :** `file` (Image)
+  </Accordion>
+
+  <Accordion title="PATCH /users/me/consent">
+    Met à jour les consentements légaux de l'utilisateur.
+    **Corps :**
+    - `termsVersion` (string)
+    - `privacyVersion` (string)
   </Accordion>
 
   <Accordion title="DELETE /users/me">
@@ -105,9 +125,9 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
     - `POST /users/me/2fa/disable` : Désactive avec jeton.
   </Accordion>
 
-  <Accordion title="Administration (GET /users/admin)">
+  <Accordion title="Administration (Admin uniquement)">
-    Liste tous les utilisateurs. Réservé aux administrateurs.
+    - `GET /users/admin` : Liste tous les utilisateurs (avec pagination `limit`, `offset`).
-    **Params :** `limit`, `offset`.
+    - `DELETE /users/:uuid` : Supprime définitivement un utilisateur par son UUID.
   </Accordion>
 </Accordions>
 
@@ -118,12 +138,15 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
     Recherche et filtre les contenus. Ces endpoints sont mis en cache (Redis + Navigateur).
     
     **Query Params :**
+    - `limit` (number) : Défaut 10.
+    - `offset` (number) : Défaut 0.
     - `sort` : `trend` | `recent` (uniquement sur `/explore`)
-    - `tag` (string)
+    - `tag` (string) : Filtrer par tag.
-    - `category` (slug ou id)
+    - `category` (slug ou id) : Filtrer par catégorie.
-    - `author` (username)
+    - `author` (username) : Filtrer par auteur.
-    - `query` (titre)
+    - `query` (titre) : Recherche textuelle.
-    - `favoritesOnly` (bool)
+    - `favoritesOnly` (bool) : Ne montrer que les favoris de l'utilisateur connecté.
+    - `userId` (uuid) : Filtrer les contenus d'un utilisateur spécifique.
   </Accordion>
 
   <Accordion title="GET /contents/:idOrSlug">
@@ -133,8 +156,13 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
     Si l'User-Agent correspond à un robot d'indexation (Googlebot, Twitterbot, etc.), l'API retourne un rendu HTML minimal contenant les méta-tags **OpenGraph** et **Twitter Cards** pour un partage optimal. Pour les autres clients, les données sont retournées en JSON.
   </Accordion>
 
+  <Accordion title="POST /contents">
+    Crée une entrée de contenu (sans upload de fichier direct). Utile pour référencer des URLs externes.
+    **Corps :** `title`, `description`, `url`, `type`, `categoryId`, `tags`.
+  </Accordion>
+
   <Accordion title="POST /contents/upload">
-    Upload un fichier avec traitement automatique.
+    Upload un fichier avec traitement automatique par le serveur.
     **Type :** `multipart/form-data`
 
     **Champs :**
@@ -145,6 +173,11 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
     - `tags`? : string[]
   </Accordion>
 
+  <Accordion title="POST /contents/upload-url">
+    Génère une URL présignée pour un upload direct vers S3.
+    **Query Param :** `fileName` (string).
+  </Accordion>
+
   <Accordion title="POST /contents/:id/view | /use">
     Incrémente les statistiques de vue ou d'utilisation.
   </Accordion>
@@ -152,6 +185,10 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
   <Accordion title="DELETE /contents/:id">
     Supprime un contenu (Soft Delete). Doit être l'auteur.
   </Accordion>
+
+  <Accordion title="DELETE /contents/:id/admin">
+    Supprime définitivement un contenu. **Réservé aux administrateurs.**
+  </Accordion>
 </Accordions>
 
 ### 📂 Catégories, ⭐ Favoris, 🚩 Signalements
@@ -159,19 +196,23 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
 <Accordions>
   <Accordion title="Catégories (/categories)">
     - `GET /categories` : Liste toutes les catégories.
+    - `GET /categories/:id` : Détails d'une catégorie.
     - `POST /categories` : Création (Admin uniquement).
+    - `PATCH /categories/:id` : Mise à jour (Admin uniquement).
+    - `DELETE /categories/:id` : Suppression (Admin uniquement).
   </Accordion>
 
   <Accordion title="Favoris (/favorites)">
-    - `GET /favorites` : Liste les favoris de l'utilisateur.
+    Requiert l'authentification.
+    - `GET /favorites` : Liste les favoris de l'utilisateur (avec pagination `limit`, `offset`).
     - `POST /favorites/:contentId` : Ajoute un favori.
     - `DELETE /favorites/:contentId` : Retire un favori.
   </Accordion>
 
   <Accordion title="Signalements (/reports)">
     - `POST /reports` : Signale un contenu ou un tag.
-    - `GET /reports` : Liste (Modérateurs).
+    - `GET /reports` : Liste des signalements (Pagination `limit`, `offset`). **Admin/Modérateurs**.
-    - `PATCH /reports/:id/status` : Gère le workflow.
+    - `PATCH /reports/:id/status` : Change le statut (`pending`, `resolved`, `dismissed`). **Admin/Modérateurs**.
   </Accordion>
 </Accordions>
 
@@ -185,7 +226,23 @@ Cette page documente tous les points de terminaison disponibles sur l'API Memego
   </Accordion>
 
   <Accordion title="Tags (/tags)">
-    - `GET /tags` : Recherche de tags populaires ou récents.
+    - `GET /tags` : Recherche de tags.
-    **Params :** `query`, `sort`, `limit`.
+    - **Params :** `query` (recherche), `sort` (`popular` | `recent`), `limit`, `offset`.
+  </Accordion>
+</Accordions>
+
+### 🛠️ Système & Médias
+
+<Accordions>
+  <Accordion title="Santé (/health)">
+    - `GET /health` : Vérifie l'état de l'API et de la connexion à la base de données.
+  </Accordion>
+
+  <Accordion title="Médias (/media)">
+    - `GET /media/*key` : Accès direct aux fichiers stockés sur S3. Supporte la mise en cache agressive.
+  </Accordion>
+
+  <Accordion title="Administration (/admin)">
+    - `GET /admin/stats` : Récupère les statistiques globales de la plateforme. **Admin uniquement**.
   </Accordion>
 </Accordions>