Guida Completa
ABC Monitor

1. Primi passi

ABC Monitor raccoglie schede ABC, osservazioni sui comportamenti ed eventi di contesto in un archivio locale. Puoi consultare i dati, produrre report e lavorare con account distinti.

1. Installa il programma e crea il primo amministratore.
2. Salva il codice di ripristino password e configura struttura e reparto.
3. Esporta la chiave di recupero e prepara un backup.
4. Crea un residente e definisci almeno un comportamento.
5. Inserisci una registrazione ABC e controllala nel Registro.
6. Prepara un report; se lavori in équipe, crea gli account degli operatori.

Il programma è uno strumento di raccolta e organizzazione dei dati; non è un dispositivo medico. Le decisioni professionali restano affidate al gruppo di lavoro.

2. Installazione su Windows e Mac

Windows

1. Scarica ABC_Monitor_v2.4.0_windows.exe dalla scheda ufficiale.
2. Apri l’installer e conferma la richiesta di Windows per procedere.
3. Segui la procedura guidata. La cartella standard è C:\Program Files\ABC Monitor.
4. Per iniziare su un solo computer, lascia deselezionate la modalità server e l’opzione di avvio automatico.
5. Completa l’installazione e apri ABC Monitor dal Desktop o dal menu Start.

Se Windows mostra “Windows ha protetto il PC”, dopo aver verificato la provenienza del file scegli Ulteriori informazioni → Esegui comunque. Il programma non richiede un’installazione separata di Python.

Mac Intel

1. Scarica ABC_Monitor_v2.4.0_mac_x86_64.dmg. Richiede macOS 11 Big Sur o successivo.
2. Apri il DMG e trascina ABC Monitor.app in Applicazioni.
3. Avvia l’app dalla cartella Applicazioni.
4. Se macOS blocca il primo avvio, sui sistemi fino a macOS 14 fai clic destro sull’app → Apri. Sui sistemi recenti cerca Apri comunque nelle impostazioni di Privacy e sicurezza.

Per riconoscere il processore usa menu Apple → Informazioni su questo Mac. La build indicata è per Intel; la versione Apple Silicon è in preparazione.

3. Primo amministratore e configurazione del reparto

Protezione iniziale

1. Inserisci nome e cognome del primo amministratore.
2. Scegli uno Username amministratore: da 3 a 40 caratteri, usando lettere, numeri, punto, trattino o underscore.
3. Inserisci e conferma una password di almeno 10 caratteri con maiuscola, minuscola, numero e simbolo.
4. Premi Crea amministratore.
5. Salva il Codice di ripristino mostrato, conferma L’ho salvato in un posto sicuro e premi Continua.

Il codice viene mostrato una sola volta e serve a reimpostare la password. Conservalo fuori dal computer.

Configurazione del reparto

Compila almeno Nome della struttura e Nome del reparto. Puoi indicare città, provincia, responsabile, posti disponibili, anno di riferimento e un logo PNG/JPG fino a 5 MB. Premi Completa configurazione.

Prima di inserire un archivio reale, vai in Sicurezza e backup e prepara la protezione descritta nel capitolo sui backup.

4. Accesso, navigazione e Dashboard

Apri ABC Monitor dall’icona del programma. Il browser mostra le schermate; non devi visitare il sito pubblico per usare il tuo archivio.

Accedi con il tuo username e la tua password. Se hai attivato la verifica in due passaggi, inserisci anche il codice richiesto. Gli account creati con password temporanea devono cambiarla al primo accesso.

La voce selezionata è evidenziata nella barra laterale. Su schermi piccoli può essere necessario aprire il pannello laterale tramite il comando del browser dell’app.

Gli amministratori trovano nella Dashboard anche il Centro di Controllo, le attività recenti, lo stato tecnico e il pannello Server di rete locale. L’avviso di manutenzione si configura da Gestione modalità manutenzione; è un messaggio per gli operatori.

5. Demo e attivazione della licenza

Senza una licenza valida il programma parte in modalità Demo: fino a 2 residenti attivi, senza scadenza, e report PDF con filigrana. Non occorre reinstallare per passare alla versione completa.

1. Accedi come amministratore.
2. Apri Informazioni e licenza.
3. Compila Email usata per l’acquisto e Chiave di licenza.
4. Premi Attiva licenza e attendi il messaggio di conferma.

La licenza sblocca le funzioni mantenendo l’archivio già creato nella demo. Per aggiornare lo stato usa Ricontrolla ora.

Se devi spostare la licenza su un altro computer, usa Disattiva la licenza su questo PC (per spostarla altrove), conferma come amministratore e poi attivala sul nuovo computer. L’attivazione richiede Internet.

La licenza prevede un computer; in modalità server gli altri dispositivi accedono all’archivio di quel computer tramite il browser. Il programma comunica con il servizio di licenze per attivazione e verifica.

6. Creare e gestire i residenti

Barra laterale → Residenti

1. Inserisci Nome, Cognome e Sesso.
2. Se utile, aggiungi Codice interno facoltativo, foto PNG/JPG fino a 5 MB e note generali.
3. Seleziona i Comportamenti più manifestabili. Con Altro comportamento, scrivi un nome per riga.
4. Premi Salva residente e verifica la conferma.

Se esiste lo stesso nome e cognome, il programma chiede di confermare che si tratta di un omonimo. Non confermare per inserire due volte la stessa persona.

Modificare o rimuovere

Nell’elenco alfabetico usa il comando di modifica della scheda e poi Salva modifiche. Puoi aggiornare i dati e sostituire la foto.

La rimozione definitiva è riservata all’amministratore, richiede la sua password e cancella la persona con i dati collegati. Prima dell’operazione il programma crea un backup cifrato preventivo.

7. Definire i comportamenti da osservare

Barra laterale → Comportamenti

1. Scegli il Residente.
2. Seleziona la Categoria.
3. Scrivi il Nome specifico del comportamento.
4. Aggiungi una Definizione operativa: descrivi ciò che un osservatore può riconoscere, evitando etichette generiche.
5. Premi Aggiungi comportamento.

Il comando Rimuovi archivia il comportamento dalle nuove registrazioni e conserva lo storico. È disponibile se non ci sono manifestazioni registrate negli ultimi 3 mesi; un comportamento mai registrato può essere rimosso subito.

Nell’elenco Comportamenti rimossi, usa Ripristina per renderlo nuovamente disponibile.

8. Compilare una registrazione ABC

Barra laterale → Registrazione

Prima devono essere presenti un residente e almeno un comportamento attivo. Una scheda può contenere più comportamenti osservati nello stesso contesto.

1. Seleziona la persona e controlla Data e Ora.
2. Compila il Contesto / attività.
3. Descrivi l’Antecedente: ciò che è successo prima.
4. Descrivi la Conseguenza: ciò che è successo dopo.
5. Apri il riquadro del comportamento osservato e seleziona Registrato.
6. Inserisci numero di episodi, frequenza, durata totale in minuti, intensità e le eventuali note.
7. Premi Salva registrazione. Deve essere selezionato almeno un comportamento.
8. Controlla il risultato nel Registro.

Antecedente, conseguenza e contesto sono facoltativi nel programma, ma la loro compilazione rende l’osservazione più utile. Il conteggio degli episodi e l’etichetta di frequenza sono campi distinti.

9. Inserire gli eventi nel Diario clinico

Barra laterale → Diario clinico

1. Seleziona il residente.
2. Imposta la Data e il Tipo di evento.
3. Inserisci un Titolo breve, obbligatorio, e i Dettagli.
4. Premi Salva evento e controlla l’elenco sottostante.

Tra le categorie disponibili: riduzione o modifica della terapia, introduzione di un farmaco, stato febbrile, ciclo mestruale, crisi epilettica, ricovero/accesso sanitario e altro evento.

Usa il diario per documentare informazioni conosciute e di tua competenza. La presenza di un evento vicino a un comportamento nella timeline non dimostra un rapporto causale.

10. Consultare il Registro e cercare nell’archivio

Registro delle osservazioni

1. Apri Registro e scegli il residente.
2. Imposta le date Dal e Al.
3. Controlla le osservazioni nella tabella.
4. Per lavorare sui dati fuori dal programma, premi Scarica CSV.

Se non trovi una registrazione, verifica persona e intervallo di date. La tabella del Registro serve alla consultazione e all’esportazione: non è un foglio di modifica diretta degli eventi.

Ricerca globale

Usa Ricerca globale per cercare nei residenti, comportamenti, registrazioni, eventi del diario e documenti. Applica i filtri disponibili e apri il risultato desiderato. Le informazioni amministrative sono escluse dalla ricerca degli operatori.

11. Report, statistiche, timeline e archivio

Barra laterale → Reportistica Premium

Preparare i documenti

1. Seleziona il residente e apri Crea report.
2. Scegli il modello: Report mensile standard, Report équipe, Report sintetico o Report completo.
3. Imposta il periodo Dal / Al.
4. Seleziona le parti desiderate: Dettaglio ABC, Eventi clinici, Timeline e Firma operatore.
5. Premi Prepara i documenti.
6. Scarica il formato necessario.

La voce Firma operatore riguarda il contenuto del report; non equivale a una firma digitale qualificata. I file scaricati devono essere conservati e condivisi con le regole del proprio servizio.

Le altre schede

• Statistiche: comportamenti più frequenti, andamento nel tempo, fasce orarie, giorni della settimana, antecedenti e conseguenze ricorrenti.
• Timeline: eventi in ordine cronologico, per confrontare osservazioni e contesto.
• Archivio: seleziona un documento e premi Scarica documento archiviato.
• Impostazioni: l’amministratore può aggiornare il nome della struttura e il logo dei report.

12. Creare e gestire gli utenti

Barra laterale → Gestione utenti

1. Apri Nuovo utente e inserisci nome, cognome e username.
2. Scegli il ruolo Operatore o Amministratore.
3. Per gli operatori, decidi se abilitare Può utilizzare le funzioni AI.
4. Imposta una password temporanea conforme ai requisiti oppure usa Genera password sicura.
5. Conferma la password e premi Crea utente.
6. Consegna le credenziali in modo riservato. L’utente cambia la password al primo accesso.

Gli operatori svolgono le attività dell’archivio. Gli amministratori hanno anche accesso a utenti, sicurezza, backup, licenza, chiusura del programma e funzioni AI.

Da Gestisci account puoi disattivare o riattivare l’accesso, reimpostare la password e azzerare la 2FA quando una persona perde telefono e codici. Le operazioni critiche richiedono la conferma dell’amministratore. Non puoi disattivare l’account attualmente in uso.

Usa un account personale per ciascun operatore: condividere credenziali rende meno chiaro chi abbia effettuato un’operazione.

13. Password, verifica in due passaggi e recupero

Il mio account

Apri Il mio account per cambiare la password e configurare la verifica in due passaggi. Con la 2FA, oltre alla password viene richiesto un codice dell’app di autenticazione. Segui il codice QR e la conferma mostrati dal programma; conserva anche i codici di recupero.

L’amministratore può rendere la 2FA obbligatoria per tutti gli amministratori. La sessione di accesso e il processo in background sono elementi diversi: uscire dall’account non chiude il programma.

Password dimenticata

1. Dalla schermata di login premi Password dimenticata?.
2. Inserisci username, codice di ripristino e nuova password secondo le istruzioni.
3. Salva il nuovo codice di ripristino: il precedente non è più valido.

Un amministratore può generare un nuovo codice da Il mio account → Codice di ripristino password. Se perdi anche il codice, chiedi a un altro amministratore o contatta l’assistenza. Su Windows è disponibile anche lo strumento di emergenza di reimpostazione amministratore previsto dal pacchetto.

Dopo 5 tentativi errati l’account viene bloccato per 10 minuti. Attendi il termine del blocco invece di riprovare continuamente. La sessione è configurata con una scadenza di 15 minuti di inattività.

14. Backup, chiave di recupero e ripristino

Barra laterale → Sicurezza e backup

Creare un backup manuale

1. Premi Prepara nuovo backup cifrato.
2. Attendi che sia disponibile Scarica backup cifrato.
3. Scarica il file .abcbackup e conservalo anche su un supporto diverso dal computer.

Preparare il backup non significa averlo già scaricato. Completa entrambi i passaggi.

Backup automatico

Attiva Backup cifrato automatico (una volta al giorno, all’accesso). Imposta, se disponibile, una cartella per la copia aggiuntiva su disco esterno o rete e premi Salva impostazioni backup. Usa Esegui ora un backup automatico per controllare il funzionamento. Il programma conserva gli ultimi 14 backup automatici.

Esportare la chiave

1. Nella sezione Chiave di recupero, scegli una passphrase di almeno 12 caratteri e ripetila.
2. Autorizza l’esportazione con la conferma amministratore richiesta.
3. Premi Scarica file chiave (.abckey).
4. Conserva il file fuori dal computer e la passphrase in un luogo separato.

Cosa comprende il backup

Nella versione 2.4.0 il file .abcbackup contiene una copia cifrata del database. Non è una copia completa di tutte le cartelle: conserva separatamente foto, file PDF archiviati e configurazione se devi trasferire l’intero ambiente.

Ripristinare nello stesso archivio

1. Salva il lavoro e concorda una pausa con gli operatori collegati.
2. In Ripristino backup scegli il file .abcbackup.
3. Controlla data e identificativo del database mostrati.
4. Autorizza il ripristino. Il programma prepara prima una copia di sicurezza dell’archivio corrente.
5. Controlla residenti e registrazioni dopo l’operazione.

Il ripristino sostituisce il database corrente con quello del backup. Sono accettati backup dello stesso database e con la chiave corretta. Se compare “Questo backup appartiene a un database diverso”, non insistere creando nuovi archivi.

Per recuperare su un altro computer servono anche chiave e identificativo originali. La schermata di questa versione non offre una procedura completa di importazione della chiave: contatta l’assistenza prima di una migrazione o dopo un guasto.

Integrità e registro attività

La stessa pagina mostra l’integrità del database e la verifica del registro attività. Se segnala un’anomalia, conserva una copia dell’ambiente e contatta l’assistenza prima di modificare o cancellare file.

15. Modalità locale e server di rete

Dashboard → Centro di Controllo → Server di rete locale → Modalità di funzionamento

Queste impostazioni si trovano nella Dashboard dell’amministratore. In modalità locale ABC Monitor risponde solo al computer sul quale è avviato.

Usare altri dispositivi nella stessa rete

1. Dal computer che ospita ABC Monitor, scegli Server per altri dispositivi (Server).
2. Seleziona Cifra la connessione con HTTPS per proteggere il traffico di rete.
3. Premi Applica la nuova modalità e completa la conferma amministratore.
4. Conferma anche la finestra di Windows sul computer server.
5. Premi Riavvia ora ABC Monitor.
6. Nel pannello di rete usa l’indirizzo o il QR code per aprire il programma dagli altri dispositivi collegati alla stessa rete.

Gli altri dispositivi usano il browser e le credenziali personali. Il computer server deve restare acceso e connesso. L’accesso locale con 127.0.0.1 funziona solo sul computer server, non sugli altri dispositivi.

HTTPS usa un certificato locale autofirmato: può comparire un avviso del browser. Verifica che l’indirizzo sia quello mostrato dal tuo server e segui le indicazioni del servizio che gestisce la rete.

Non aprire porte sul router per esporre il programma a Internet. L’uso descritto è per una rete locale affidabile.

Tornare alla modalità locale

Scegli Solo su questo PC (Locale), applica la modifica e riavvia il programma. Su Windows puoi anche attivare o disattivare Avvia ABC Monitor automaticamente quando accedo a Windows.

Su Mac la schermata non offre il cambio automatico della modalità: per configurare un Mac come server chiedi assistenza. Il controllo automatico della sospensione descritto dalla modalità server è implementato su Windows; sugli altri sistemi verifica le impostazioni di risparmio energetico.

16. Chiudere il programma e capire il background

Chiudere il browser non arresta subito ABC Monitor. Il browser visualizza le schermate, mentre il programma continua a funzionare separatamente.

Una scheda ancora aperta può mantenere il programma attivo anche se non la stai usando. La permanenza temporanea in Gestione attività, in modalità locale, è normale.

Chiusura immediata

1. Salva ciò che stai compilando.
2. Accedi come amministratore.
3. Nella barra laterale premi ⏻ Chiudi ABC Monitor.
4. Conferma con Sì, chiudi.
5. Quando compare il messaggio di chiusura, chiudi anche la scheda del browser.

In modalità server, prima avvisa gli operatori: la chiusura interrompe anche il loro accesso. Il pulsante Esci termina soltanto la sessione del tuo account.

17. AI e analisi comportamentale

Barra laterale → AI e analisi comportamentale

La sezione compare per gli amministratori e per gli operatori autorizzati. Le schede sono Analisi, Assistente, Prompt, Cronologia e, per l’amministratore, Impostazioni.

Analisi locale

Seleziona residente e periodo e premi Esegui analisi descrittiva locale. Questa elaborazione non richiede l’invio dei dati a un provider esterno.

Provider AI

L’amministratore può configurare provider, modello, URL API e chiave nelle Impostazioni, salvare e usare Test connessione. Il servizio deve essere attivato prima di generare testi o usare l’assistente.

Prima di un invio esterno, controlla i dati selezionati e le note libere. L’anonimizzazione automatica non garantisce la rimozione di riferimenti a familiari, luoghi o altri dettagli riconoscibili. Completa le conferme richieste per l’elaborazione.

L’uso delle API può avere costi e crediti separati dagli abbonamenti alle app dei provider. Le risposte AI sono bozze da verificare prima di inserirle in una relazione; non dimostrano da sole la funzione di un comportamento.

Puoi salvare prompt riutilizzabili, consultare la cronologia e scaricare il testo generato. Il pulsante di invio è un’azione distinta: aprire questa pagina non avvia da solo un’elaborazione esterna.

18. Aggiornare e usare l’installazione pulita

Aggiornamento con conservazione dei dati su Windows

1. Scarica la nuova build dal sito ufficiale.
2. Prepara un backup e conserva la chiave fuori dal computer.
3. Chiudi ABC Monitor con il comando interno.
4. Avvia il nuovo installer e lascia deselezionata Installazione pulita.
5. Al termine controlla account, residenti e licenza.

I file del programma e i dati sono separati. La cartella dati standard su Windows è C:\ProgramData\ABC Monitor; su Mac è ~/Library/Application Support/ABC Monitor. Non cancellarle per risolvere un problema di avvio.

Installazione pulita su Windows

Usala soltanto quando vuoi ripartire da zero. Elimina la cartella dati standard: archivio, configurazione, chiavi, backup locali e file contenuti nella cartella. Il programma non deve ricaricare il precedente archivio da quella cartella e richiede la configurazione iniziale.

Nel nuovo installer l’opzione richiede una conferma separata, con risposta predefinita No, e non viene mantenuta selezionata nel successivo aggiornamento. È bloccata nelle installazioni silenziose.

Per aggiornare l’app su Mac, chiudila prima di sostituirla in Applicazioni e conserva una copia dei dati. La casella “Installazione pulita” descritta qui appartiene all’installer Windows.

19. Problemi frequenti

20. Chiedere assistenza

Barra laterale → Centro Assistenza

Scegli la categoria, scrivi oggetto e descrizione e completa i campi e le conferme richiesti. Il programma prepara il messaggio per la tua applicazione di posta: controllalo e premi Invia nella posta per consegnarlo.

Se non hai un’app di posta configurata, puoi salvare una copia del messaggio e inviarla tramite il tuo servizio email a pas.destefano@gmail.com.

• Indica versione del programma, Windows/macOS e modello del computer se rilevante.
• Descrivi i passaggi che precedono il problema, ciò che ti aspettavi e ciò che è successo.
• Riporta il messaggio di errore completo.
• Usa screenshot privi di dati identificativi e chiavi di licenza.

In Sicurezza e backup l’amministratore può scaricare il log tecnico per l’assistenza. Controlla ogni allegato prima dell’invio; non allegare automaticamente il database o l’archivio delle persone seguite.