Registro clienti e onboarding¶

Questo modulo copre tutto ciò che serve per conoscere la controparte e costruire un fascicolo affidabile.

Cosa include¶

Anagrafe
Rapporti
Documenti
Legami
UBO
Onboarding
KYC Verifiche
KYB Verifiche
Spine documentale

Obiettivo di business¶

Creare un fascicolo cliente coerente, aggiornabile, difendibile e riusabile in tutti i processi successivi: screening, CDD, monitoring, SOS, filing e audit.

Flusso tipico¶

sequenceDiagram
    participant Operatore as Team AML
    participant Registry as Registro Anagrafiche
    participant Onboarding as Wizard Onboarding
    participant KYC as KYC/KYB Verifiche
    participant Docs as Documenti

    Operatore->>Registry: crea o aggiorna anagrafica
    Operatore->>Onboarding: avvia caso onboarding
    Onboarding->>Docs: raccoglie documenti e allegati
    Onboarding->>KYC: salva questionari e risposte
    KYC->>Registry: aggiorna profilo e metadati cliente

Funzioni principali¶

Anagrafe¶

Gestisce il master record del soggetto:

persone fisiche;
persone giuridiche;
riferimenti identificativi;
attributi operativi e storico.

Legami e UBO¶

Ricostruiscono:

relazioni tra soggetti;
catene partecipative;
titolare effettivo;
poteri di rappresentanza.

KYC/KYB verifiche¶

Separano la verifica dal semplice dato anagrafico:

una verifica ha stato, esito, cronologia e controlli;
il profilo può essere aggiornato senza perdere la traccia dell’istruttoria.

Documenti e spine¶

Raccolgono e organizzano:

documenti identificativi;
documenti societari;
record di validazione e sostituzione;
spine e dossier navigabili.

UI chiave¶

/anagrafe
/admin/onboarding/cases
/admin/kyc
/admin/kyb
/documenti
/documenti/spine

API chiave¶

GET/POST/PUT /api/anagrafe
POST /api/v1/kyc/verifiche
POST /api/v1/kyb/verifiche
POST /api/v1/documenti/records
POST /api/v1/kyb/verifiche/:cod_verifica/struttura/calcola-ubo