4NK_IA_front/docs/qualite_reupload_conf_adresse.md

36 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 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 loriginal 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 dun chip “IA: x.xx” (tooltip = avis) et dun chip “Corrections: N” ouvrant un dialogue listant les corrections si disponibles.
#### Extraction (onglet)
- Bouton “Collecter” sur lentité 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.