docs: add migration documentation, finalization scripts, and update Swagger paths

src/swagger/articles.yaml

@@ -1,5 +1,5 @@
 paths:
-  /api/v2/articles:
+  /api/cms/articles:
     get:
       summary: Récupère la liste paginée des articles
       description: Retourne une liste paginée de tous les articles. L'authentification est optionnelle.
@@ -96,7 +96,7 @@ paths:
         '422':
           description: Erreur de validation des données
 
-  /api/v2/articles/feed:
+  /api/cms/articles/feed:
     get:
       summary: Récupère le fil d'actualité des articles
       description: Retourne les articles des utilisateurs suivis par l'utilisateur authentifié
@@ -136,7 +136,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v2/articles/{slug}:
+  /api/cms/articles/{slug}:
     get:
       summary: Récupère un article par son slug
       description: Retourne les détails complets d'un article spécifique
@@ -245,7 +245,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v2/articles/{slug}/favorite:
+  /api/cms/articles/{slug}/favorite:
     post:
       summary: Ajoute un article aux favoris
       description: Ajoute un article à la liste des favoris de l'utilisateur authentifié

src/swagger/clans.yaml

@@ -1,5 +1,5 @@
 paths:
-  /api/v3/clans:
+  /api/herowars/clans:
     get:
       summary: Récupère la liste de tous les clans
       description: Retourne une liste de tous les clans. L'authentification est optionnelle.
@@ -90,7 +90,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v3/clans/{clanId}:
+  /api/herowars/clans/{clanId}:
     get:
       summary: Récupère les détails d'un clan
       description: Retourne les détails complets d'un clan spécifique. Authentification requise.

src/swagger/members.yaml

@@ -1,5 +1,5 @@
 paths:
-  /api/v3/members:
+  /api/herowars/members:
     get:
       summary: Récupère la liste de tous les membres
       description: Retourne une liste paginée de tous les membres. Authentification requise.
@@ -106,7 +106,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v3/members/{memberId}:
+  /api/herowars/members/{memberId}:
     get:
       summary: Récupère les détails d'un membre
       description: Retourne les détails complets d'un membre spécifique. Authentification requise.

src/swagger/users.yaml

@@ -1,5 +1,5 @@
 paths:
-  /api/v1/user:
+  /api/skydive/user:
     get:
       summary: Récupère le profil de l'utilisateur connecté
       description: Retourne les informations du profil de l'utilisateur authentifié
@@ -76,7 +76,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v1/users/login:
+  /api/skydive/users/login:
     post:
       summary: Authentifie un utilisateur
       description: Authentifie un utilisateur avec email et mot de passe, retourne un JWT
@@ -117,7 +117,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v1/authenticate:
+  /api/skydive/authenticate:
     get:
       summary: Authentification par clé API
       description: Authentifie un utilisateur/application avec une clé API dans les headers
@@ -142,7 +142,7 @@ paths:
         '500':
           description: Erreur serveur
 
-  /api/v1/users:
+  /api/skydive/users:
     post:
       summary: Crée un nouvel utilisateur
       description: Crée un nouvel utilisateur avec les données fournies