4NK_IA_front/GUIDE_TEST_APERCU_CORRIGE.md
root 6ae698de76 feat: Implémentation de l'aperçu PDF fonctionnel
- Ajout du composant FilePreview avec iframe et viewer PDF intégré
- Correction du mapping des données API (document_id -> id)
- Ajout de previewUrl avec URL.createObjectURL pour l'aperçu
- Interface modale avec navigation et zoom
- Support des fichiers PDF avec affichage réel du contenu
- Correction de l'affichage de la taille des fichiers
- Ajout des dépendances react-pdf-js pour l'aperçu PDF
- Scripts de démarrage et fichiers de test
- Documentation complète de la fonctionnalité d'aperçu
2025-09-10 23:25:55 +02:00

3.3 KiB

🎯 Guide de Test - Aperçu PDF Corrigé

Problème résolu

Le problème était que l'API backend retournait un format différent de ce que le frontend attendait :

  • API backend : {message, document_id, status}
  • Frontend attendu : {id, name, type, size, uploadDate, status, previewUrl}

Solution : Mappage correct des données de l'API vers le format Document.

📋 Instructions de test

1. Accéder à l'application

2. Tester l'aperçu PDF

  1. Aller dans l'onglet "TÉLÉVERSEMENT" (premier onglet)
  2. Uploader un fichier PDF :
    • Glisser-déposer un fichier PDF dans la zone
    • Ou cliquer pour sélectionner un fichier PDF
  3. Attendre que le statut soit "completed" (cercle vert)
  4. Cliquer sur "APERÇU" (bouton avec icône 👁️)
  5. Vérifier que le PDF s'affiche dans une fenêtre modale

🔍 Ce qui devrait se passer maintenant

Upload réussi

  • Statut : "completed" (cercle vert)
  • Nom du fichier : Affiché correctement
  • Taille : Affichée correctement (plus de "NaN MB")
  • Bouton "APERÇU" : Cliquable et fonctionnel

Aperçu PDF

  • Fenêtre modale s'ouvre
  • Titre : Nom du fichier PDF
  • Contenu : PDF réel affiché via iframe
  • Contrôles : Navigation et zoom fonctionnels
  • Boutons : Fermer et Télécharger opérationnels

🧪 Test avec le fichier existant

Si vous avez déjà un document uploadé :

  1. Cliquer sur "APERÇU" sur le document existant
  2. Vérifier que l'aperçu s'ouvre
  3. Tester les contrôles (navigation, zoom)

🐛 Dépannage

Si l'aperçu ne s'ouvre toujours pas

  1. Ouvrir la console (F12)
  2. Chercher les erreurs JavaScript
  3. Vérifier que le document a bien un previewUrl

Si la taille affiche "NaN MB"

  1. Recharger la page (F5)
  2. Uploader un nouveau fichier
  3. Vérifier que la taille s'affiche correctement

🔧 Vérifications techniques

Console (F12)

  • Pas d'erreurs JavaScript
  • Messages de succès pour l'upload
  • Données correctes dans les logs

Network (F12)

  • Requête POST vers /api/notary/upload
  • Réponse 200 avec {message, document_id, status}
  • Pas d'erreurs de réseau

📊 Résultats attendus

Succès

  • Upload du PDF fonctionne
  • Taille affichée correctement
  • Bouton "APERÇU" cliquable
  • Fenêtre modale s'ouvre
  • PDF affiché correctement
  • Contrôles fonctionnels

Échec

  • Upload échoue
  • Taille "NaN MB"
  • Bouton "APERÇU" non fonctionnel
  • Erreurs dans la console
  • Aperçu ne s'ouvre pas

🎉 Avantages de la correction

Données correctes

  • Mapping de l'API vers le format Document
  • Taille affichée correctement
  • ID du document correct
  • previewUrl générée correctement

Fonctionnalité

  • Aperçu fonctionne avec de vrais fichiers
  • Interface professionnelle
  • Contrôles opérationnels
  • Téléchargement fonctionnel

📞 Support

Si le test échoue encore :

  1. Noter l'erreur exacte de la console
  2. Vérifier le format de la réponse API
  3. Tester avec un nouveau fichier
  4. Recharger la page si nécessaire

L'aperçu PDF devrait maintenant fonctionner correctement ! 🎉