4NK_IA_front/docs/qualite_reupload_conf_adresse.md

Gestion de la qualité: remplacement d'image, confirmation d'adresse et révision IA

Backend

• Suggestions ajoutées dans status.suggestions des résultats:
  • needsReupload (bool), reasons (array)
  • needsAddressConfirmation (bool), detectedAddress (objet)
• Endpoint confirmation d'adresse:
  • POST /api/folders/:folderHash/files/:fileHash/confirm-address
  • Body { confirmed: true, address: { street, city, postalCode, country } }

Enrichissement Adresse

• Endpoint: POST /api/folders/:folderHash/files/:fileHash/enrich/address
• Sources consultées:
  • Base Adresse Nationale (géocodage)
  • GéoRisque (risques majeurs)
  • Cadastre (parcelles)
• Cache statut: cache/<folder>/<file>.enrich.address.json avec state: running|done|error
• PDF: cache/<folder>/<file>.enrich.address.pdf (sections Géocodage, Risques, Cadastre, Sources)

Frontend (UploadView)

• Si needsReupload: chip “Qualité faible: remplacer” → ouvre un file picker, supprime l’original et réuploade.
• Si needsAddressConfirmation: chip “Adresse à confirmer” → dialogue pré-rempli; POST de confirmation; rafraîchissement.
• Révision IA: bouton “Révision IA” pour lancer une révision manuelle; affichage d’un chip “IA: x.xx” (tooltip = avis) et d’un chip “Corrections: N” ouvrant un dialogue listant les corrections si disponibles.

Extraction (onglet)

• Bouton “Collecter” sur l’entité Adresse: déclenche /enrich/address
• Affiche le statut (en cours / OK / erreur) et un lien “Voir PDF” si disponible
• Affiche score BAN (%), coordonnées, et résumé des risques et parcelles

Tests manuels

1. Télécharger une image de faible qualité → vérifier l'apparition du chip “Qualité faible: remplacer”.
2. Confirmer l'adresse détectée → vérifier que le chip disparaît après POST.

Notes

• Annuaire de noms (FR/EN) intégré: rehausse la confiance si prénom/nom reconnus dans les listes unifiées.