Indice
1. Introduzione 2. Preparazione File 3. Come Usare il Sistema 4. Interpretazione Risultati 5. Validazione Dati Reali 6. Checklist Qualità 7. Risoluzione Problemi 8. Esempi Pratici

Manuale Test e Validazione

Guida completa per data tester - Versione 2.0.0

1. Introduzione

Cosa fa il sistema:

  • Analizza le pratiche NPL che gli fornisci
  • Calcola per ogni pratica:
    • Probabilità di recupero (in %)
    • Tempo stimato per il recupero (in giorni)
  • Crea una classifica ordinata dalla pratica migliore alla peggiore
  • Fornisce spiegazioni dettagliate per ogni pratica

Obiettivo del Test:

Verificare che il sistema sia accurato, cioè che le pratiche in cima alla classifica siano effettivamente quelle che verranno recuperate.

TARGET: Le prime 100 pratiche devono avere almeno 99% di successo (99 su 100 recuperate)

2. Preparazione File di Test

Formati File Accettati

Excel

.xlsx, .xls

CSV

.csv

JSON

.json

Colonne Necessarie

Colonna Obbligatoria Esempio Valori
STATO Sì "LAVORAZIONE", "CHIUSA"
REGIONE Sì "CAMPANIA", "LOMBARDIA", "LAZIO"
COD. INTERNO No "NPL001", "12345"
FASCIA OP. No "VISURA CATASTALE POSITIVA"
ESITO No* "POSITIVA", "A STRALCIO"

* ESITO è usato solo per validazione (vedi sezione 5)

Esempio File CSV

cod_interno,regione,stato,fascia_op NPL001,CAMPANIA,LAVORAZIONE,VISURA CATASTALE POSITIVA NPL002,LOMBARDIA,LAVORAZIONE, NPL003,LAZIO,CHIUSA,VISURA CATASTALE POSITIVA NPL004,SICILIA,LAVORAZIONE, NPL005,PIEMONTE,CHIUSA,

Controlli Pre-Upload:

  • Colonne STATO e REGIONE presenti
  • Almeno 10 pratiche nel file
  • Nessuna riga completamente vuota
  • Formato file corretto (.csv, .xlsx, .json)

3. Come Usare il Sistema

Passo 1: Accesso

URL Pubblica: https://npl-analyzer.nplfy.com
URL Locale: http://localhost:8676

Apri il browser e vai su uno degli indirizzi sopra.

Dovresti vedere la homepage con il titolo "NPL Recovery Prediction System"

Passo 2: Carica il File

Metodo 1: Drag & Drop
  1. Trascina il file nella zona grigia tratteggiata
  2. Quando diventa verde, rilascia
  3. Vedrai il nome del file
Metodo 2: Click
  1. Clicca "Seleziona File"
  2. Scegli il file dal computer
  3. Clicca "Apri"

Passo 3: Analizza

Clicca il bottone Analizza Pratiche

Vedrai un'animazione di caricamento. Attendi qualche secondo.

Tempi attesi: 10 pratiche = 1-2 secondi | 1000 pratiche = 5-10 secondi

Passo 4: Risultati

La pagina mostrerà 4 parti principali:

Dashboard
Statistiche globali
Grafici
Top 10 e distribuzione
Tabella
Classifica completa
Spiegazioni
Dettagli per pratica

4. Interpretazione Risultati

Capire la Classifica (Rank)

Posizione Significato Priorità
#1 - #10 Pratiche ECCELLENTI MASSIMA
#11 - #50 Pratiche OTTIME ALTA
#51 - #100 Pratiche BUONE MEDIA-ALTA
#100+ Pratiche MEDIE/BASSE BASSA

Capire la Probabilità

95-100% ECCELLENTE 80-95% ALTA 60-80% BUONA 40-60% MEDIA 0-40% BASSA
Regola pratica: Pratiche con probabilità > 80% sono sicure | < 40% sono rischiose

Capire il Tempo Stimato

0-30 giorni VELOCE - Recupero rapido
31-60 giorni NORMALE - Recupero standard
61-90 giorni LENTO - Richiede tempo
>90 giorni MOLTO LENTO - Richiede molto tempo

Icone nella Spiegazione

🏆 = Pratica in TOP 10 (le migliori 10)

⭐ = Pratica in TOP 50 (tra le migliori 50)

✓ = Pratica in TOP 100 (tra le migliori 100)

💎 = PRATICA IDEALE (alta probabilità + veloce)

⚠️ = Attenzione (qualcosa da notare)

5. Validazione con Dati Reali

Cos'è la Validazione?

Validare significa verificare se il sistema funziona bene usando pratiche già chiuse (di cui conosci l'esito) e controllando se il sistema le aveva messe in alto nella classifica.

Procedura Step-by-Step

STEP 1: Prepara file con pratiche chiuse

Esempio file originale con colonna ESITO:

COD | REGIONE | STATO | ESITO NPL001 | CAMPANIA | CHIUSA | POSITIVA NPL002 | LAZIO | CHIUSA | POSITIVA NPL003 | SICILIA | CHIUSA | (vuoto)
STEP 2: Rimuovi colonna ESITO

Crea una copia e elimina la colonna ESITO:

COD | REGIONE | STATO NPL001 | CAMPANIA | CHIUSA NPL002 | LAZIO | CHIUSA NPL003 | SICILIA | CHIUSA
Il sistema NON deve conoscere l'esito durante il test!
STEP 3-4: Carica e Analizza
  1. Carica il file senza ESITO nel sistema
  2. Ottieni la classifica
  3. Clicca "Esporta CSV"
STEP 5: Confronta con Esiti Reali
  1. Apri il CSV esportato
  2. Affianca la colonna ESITO del file originale
  3. Filtra per Rank da 1 a 100
  4. Conta quante pratiche hanno ESITO positivo
STEP 6: Calcola Accuratezza

Formula: Accuracy = (Pratiche Positive in Top-100) / 100

≥99%
OTTIMO
95-98%
BUONO
85-94%
ACCETTABILE
<85%
PROBLEMA

6. Checklist Controllo Qualità

Prima dell'Upload
  • File formato corretto (.csv/.xlsx/.json)
  • Colonne STATO e REGIONE presenti
  • Almeno 10 pratiche nel file
  • Encoding UTF-8 (per CSV)
  • Nessuna riga vuota
Durante Elaborazione
  • Upload completato senza errori
  • Spinner visualizzato
  • Tempo elaborazione < 30 secondi
Dopo Elaborazione
  • Dashboard con 4 riquadri visibili
  • Numero pratiche = atteso
  • Due grafici caricati
  • Tabella risultati completa
  • Bottone "Spiegazione" presente
Export Risultati
  • Bottone "Esporta CSV" funziona
  • File CSV scaricato
  • CSV apribile in Excel
  • Tutte le colonne presenti

7. Risoluzione Problemi

Soluzioni:
  1. Verifica estensione file (.csv, .xlsx, .json)
  2. Apri il file in Excel per controllare
  3. Prova a salvare in formato diverso
  4. Se file >50MB, riduci pratiche

Cosa fare:
  1. Apri file in Excel
  2. Verifica prima riga contiene "STATO" e "REGIONE"
  3. Se nomi diversi, rinominali
  4. Salva e riprova

Soluzioni:
  1. Ricarica la pagina (F5)
  2. Riduci numero pratiche (prova con 100)
  3. Se persiste, contatta supporto tecnico

Verifiche:
  1. Controlla dati nel file sono corretti
  2. Verifica nessuna cella vuota nelle colonne obbligatorie
  3. Prova con file esempio (esempio_pratiche.csv)
  4. Se persiste, contatta supporto

8. Esempi Pratici

Esempio 1: Test Rapido (5 Pratiche)

Scenario: Vuoi fare un test veloce

cod_interno,regione,stato P001,CAMPANIA,LAVORAZIONE P002,LOMBARDIA,LAVORAZIONE P003,LAZIO,CHIUSA P004,SICILIA,LAVORAZIONE P005,PIEMONTE,CHIUSA

Risultato atteso: 5 pratiche analizzate, classifica #1-#5, spiegazioni complete

Esempio 2: Interpretazione Risultati (300 Pratiche)

Dashboard mostra:

  • Totale: 300 pratiche
  • Probabilità media: 52%
  • Giorni medi: 45
  • Score top: 0.625

Top-3:

Rank Codice Regione Prob Tempo Valutazione
#1 NPL_12345 CAMPANIA 97% 28gg ECCELLENTE - Lavorare SUBITO
#2 NPL_67890 LAZIO 93% 35gg OTTIMA - Alta priorità
#3 NPL_11111 LOMBARDIA 89% 42gg BUONA - Priorità media-alta
Azione consigliata:
  1. Inizia dalle prime 50 pratiche (priorità massima)
  2. Continua con 51-100 (priorità alta)
  3. Valuta 101-200 in base a risorse

NPL Recovery Prediction System - Versione 2.0.0

URL Pubblica: https://npl-analyzer.nplfy.com

Ultimo aggiornamento: 18 Novembre 2025