4NK_IA_front/docs/interconnexions/bodacc.md

Bodacc – Gel des avoirs (Personnes)

Objectif: vérifier l’existence de mentions de gel des avoirs pour une identité (NOM/PRÉNOM), consigner les hits (références, lien source) et produire un PDF de synthèse.

Entrées minimales:

• lastName (obligatoire, uppercase recommandé)
• firstName (optionnel)
• métadonnées utiles: date de naissance, pays

Accès:

• Sans clé (temporaire): scraping léger avec politesse (User-Agent dédié, 1 req/s, backoff).
• Avec API (si disponible): clé API, endpoint de recherche nom/prénom.

Sortie (dans le cache JSON):

extraction.entities.persons[i].enrichment.bodacc = {
  state: 'idle'|'running'|'done'|'error',
  startedAt, finishedAt,
  hits: [{ name, date, sourceUrl, matchScore }],
  pdfPath
}

PDF: une page de synthèse (identité + hits) + annexes si autorisé.

Limites: homonymies; respecter le cadre légal (RGPD) et citer les sources.