4NK_IA_front/docs/TESTS.md

title
Stratégie de tests (shell)

Objectif

Fournir des tests shell simples, paramétrables par variables d’environnement, pour valider les fonctionnalités clés sans dépendre d’outils lourds.

Pré-requis

• Backend accessible sur http://localhost:3001
• PM2 (optionnel) pour relancer le backend

Tests disponibles

1. Upload volumineux (50 Mo): tests/upload_100mb.test.sh

   • Valide l’absence d’erreur 413 côté proxy et Multer

2. OCR CNI (paramétrable): tests/ocr_cni_pipeline.test.sh

   • Variables requises:
     • SAMPLE_CNI (chemin vers une image CNI)
     • FOLDER_HASH (hash du dossier cible)
   • Skips si variables non définies

3. Enrichissement Adresse (paramétrable): tests/enrich_address_pipeline.test.sh

   • Variables requises:
     • FOLDER_HASH, FILE_HASH (doit référencer un document déjà extrait avec au moins une adresse)
   • Skips si variables non définies

Exécution

chmod +x tests/*.sh
./tests/upload_100mb.test.sh
SAMPLE_CNI=/chemin/cni.jpg FOLDER_HASH=default ./tests/ocr_cni_pipeline.test.sh
FOLDER_HASH=xxxx FILE_HASH=yyyy ./tests/enrich_address_pipeline.test.sh

Interprétation

• OK: test validé
• SKIP: conditions non remplies (variables/env ou données manquantes)
• ERR: action attendue non réalisée