📖 Guida Elencus

Impara a usare Elencus per gestire i tuoi contatti offline

← Torna all'app

📑 Indice Contenuti

  1. Introduzione - Cos'è Elencus?
  2. Aggiungere un Nuovo Contatto
  3. Rimuovere un Contatto
  4. Ricerca Base
  5. Ricerca Filtrata per Organizzazione
  6. Ricerca con Suggerimenti Intelligenti
  7. Ricerca Combinata (AND)
  8. Importazione Dati (Multi-formato)
  9. Ricerca e Fusione Duplicati
  10. Esportazione Dati (CSV, JSON, PDF)
  11. Sistema di Backup (LocalStorage & IndexedDB)
  12. Librerie e Tecnologie Utilizzate
  13. Suggerimenti Importanti sulla Sicurezza

🎯 1. Introduzione - Cos'è Elencus?

Elencus è un'applicazione web moderna per gestire contatti e organizzazioni in modo semplice, veloce e soprattutto completamente offline.

Perché Offline?

Elencus funziona 100% offline perché:

Come Funziona?

Tutti i tuoi dati vengono salvati nel browser tramite:

💡 Consiglio: Inizia aggiungendo alcuni contatti. Elencus salva automaticamente tutto!

➕ 2. Aggiungere un Nuovo Contatto

Aggiungere un contatto è semplissimo!

🔧 Come Fare:

  1. Clicca il pulsante Aggiungi Contatto in alto
  2. Compila i campi (solo Nominativo è obbligatorio)
  3. Clicca Salva
  4. ✅ Il contatto è aggiunto e salvato automaticamente

Campi Disponibili

💡 Suggerimento: Compila almeno Nominativo e Organizzazione per poter usare al meglio i filtri.

🗑️ 3. Rimuovere un Contatto

Puoi rimuovere contatti in due modi: nel cestino temporaneo o eliminazione permanente.

Metodo 1: Rimozione Temporanea (Cestino)

🔧 Come Fare:

  1. Individua il contatto nella lista
  2. Clicca il pulsante Elimina (🗑️) a destra
  3. Conferma l'eliminazione
  4. ✅ Contatto spostato nel cestino

Metodo 2: Recupero dal Cestino

🔧 Come Fare:

  1. Clicca Cestino nel footer
  2. Vedi i contatti eliminati
  3. Clicca Ripristina per recuperare
  4. Oppure Elimina Definitivamente per rimuovere per sempre

💡 Vantaggio: Il cestino ti permette di recuperare errori. Puoi sempre ripristinare contatti eliminati per sbaglio!

🔍 4. Ricerca Base

La ricerca base è il modo più semplice per trovare contatti.

🔧 Come Fare:

  1. Clicca la barra di ricerca in alto ("Cerca contatti...")
  2. Inizia a digitare qualcosa (nome, organizzazione, email, telefono, ecc.)
  3. ✅ I risultati si aggiornano in tempo reale
  4. Clicca × per pulire la ricerca

Come Funziona?

La ricerca base:

💬 Esempio: Digita "mrta" e vedrai "Marta", digita "lz" e vedrai "Lazio"

🎯 5. Ricerca Filtrata per Organizzazione

Filtra i contatti per una specifica organizzazione.

🔧 Come Fare:

  1. Nella barra di ricerca, digita il nome di un'organizzazione
  2. Vedrai suggerimenti di organizzazioni simili
  3. Clicca su uno dei suggerimenti
  4. ✅ Vedi solo i contatti di quell'organizzazione

Come Funzionano i Suggerimenti?

Elencus è "intelligente" e suggerisce:

💬 Esempio: Digita "ASL Lazio" e vedrai suggerimenti di: ASL Napoli, ASL Campania, Regione Lazio, etc.

⭐ 6. Ricerca con Suggerimenti Intelligenti

Elencus offre suggerimenti intelligenti mentre digiti nella ricerca.

🔧 Come Fare:

  1. Digita nella barra di ricerca
  2. Sotto vedrai fino a 12 suggerimenti di organizzazioni
  3. Clicca su uno qualsiasi per filtrare
  4. Oppure continua a digitare per altri risultati

Tipi di Suggerimenti

I suggerimenti includono:

🎯 Fuzzy Matching

Trova risultati anche con errori di battitura

⚡ Veloce

Suggerimenti aggiornati in tempo reale

🤖 Intelligente

Suggerisce risultati simili e correlati

🔗 7. Ricerca Combinata (AND)

Cerca contatti che appartengono a MULTIPLE organizzazioni contemporaneamente (operatore AND).

🔧 Come Fare:

  1. Clicca il pulsante Ricerca Combinata accanto alla barra di ricerca
  2. Si apre un modal con una lista di organizzazioni
  3. Seleziona 2 o più organizzazioni con i checkbox
  4. Clicca Applica Filtro
  5. ✅ Vedi i contatti da TUTTE le organizzazioni selezionate

Esempi di Uso

La ricerca combinata è utile quando:

💬 Esempio: Seleziona "ASL Napoli 2" + "Regione Lazio" → Vedrai tutti i contatti di entrambe le organizzazioni

📥 8. Importazione Dati (Multi-formato)

Elencus supporta l'importazione da molti formati diversi per massima flessibilità.

🔧 Come Fare:

  1. Clicca il pulsante Importa in alto
  2. Seleziona il file dal tuo computer
  3. Elencus leggerà il file automaticamente
  4. ✅ Contatti importati e aggiunti (con notifica toast)

Formati Supportati

📄 CSV

Comma-Separated Values. Formato universale per spreadsheet. Prima riga = intestazione.

📋 JSON

Formato strutturato. Supporta anche file corrotti con riparazione automatica.

📝 TXT

File di testo semplice. Contatti delimitati da virgole, tab o uno per riga.

📇 VCF / VCARD

Formato standard per contatti. Supporta vCard 2.1 e 3.0.

📄 PDF

File PDF testuali semplici. Per PDF complessi, esporta come TXT/CSV.

📊 Excel (XLSX, XLS)

Fogli di calcolo Excel. Supporta file semplici e compressi.

🔷 XML

File XML strutturati. Supporta Android Contacts, formati generici e tabelle.

🌐 HTML

File HTML con tabelle o liste strutturate. Estrae automaticamente i contatti.

Dettagli per Formato

📄 CSV (Comma-Separated Values)

Formato comune per spreadsheet. Usa la prima riga come intestazione:

nominativo,organizzazione,telefono,email,note

Elencus riconosce automaticamente i campi anche con nomi diversi (nome, name, contatto, etc.).

📋 JSON

Formato standard strutturato. Elencus accetta:

📇 VCF / VCARD

Formato standard per contatti. Supporta:

📄 PDF

Elencus può importare file PDF testuali semplici:

Se il PDF è troppo complesso, Elencus ti suggerirà di esportarlo come TXT o CSV.

📊 Excel (XLSX, XLS)

Supporto per fogli di calcolo Excel:

🔷 XML

Supporta vari formati XML:

🌐 HTML

Estrae contatti da file HTML:

💡 Consiglio: Se un formato non funziona, prova a esportare i dati come CSV (formato universale) e importali qui. CSV è sempre supportato al 100%.

Gestione Errori e Riparazione

Elencus gestisce intelligentemente gli errori:

🔍 8.5. Ricerca e Fusione Duplicati

Elencus può trovare automaticamente contatti duplicati e permetterti di unirli in un unico contatto completo.

🔧 Come Fare:

  1. Clicca il pulsante Duplicati in alto (accanto a "Importa")
  2. Elencus analizza tutti i contatti e trova duplicati
  3. Si apre un modal con i gruppi di duplicati trovati
  4. Per ogni gruppo, vedi il contatto "base" e quelli da unire
  5. Clicca Unisci su un gruppo per unire quei contatti
  6. Oppure clicca Unisci tutti per unire tutti i duplicati in una volta
  7. ✅ I contatti vengono fusi mantenendo tutte le informazioni

Come Funziona la Ricerca Duplicati?

Elencus identifica duplicati basandosi su:

Come Funziona la Fusione?

Quando unisci duplicati:

💡 Suggerimento: Controlla i duplicati dopo ogni importazione di massa per mantenere la rubrica pulita e organizzata.

💬 Esempio: Se hai "Mario Rossi" con telefono e "Mario Rossi" con email, unendoli otterrai "Mario Rossi" con telefono E email.

📤 9. Esportazione Dati (CSV, JSON, PDF)

Esporta i tuoi contatti in vari formati.

Esportazione Contatti Selezionati

🔧 Come Fare:

  1. Seleziona i contatti che vuoi esportare (checkbox a sinistra)
  2. Clicca Esporta Selezionati
  3. Scegli il formato (CSV, JSON, TXT, PDF)
  4. ✅ File scaricato

Esportazione di Tutti i Dati

🔧 Come Fare:

  1. Clicca Esporta in alto a destra
  2. Scegli il formato desiderato
  3. ✅ File scaricato con tutti i contatti

Esportazione dal Backup Panel

🔧 Come Fare:

  1. Footer → Backup
  2. TAB "Spazio" → Esporta Tutto
  3. ✅ File JSON scaricato con contatti + cestino
  4. Salva in cloud personale per massima protezione

Formati di Esportazione

📊 CSV

Formato universale, compatibile con Excel, Google Sheets, etc.

📋 JSON

Formato strutturato con tutti i dati e metadati (migliore per backup).

📄 PDF

Documento stampabile e leggibile, perfetto per stampa o condivisione.

📝 TXT

Testo semplice, facile da leggere ma con meno struttura.

💡 Consiglio: Usa JSON per backup, CSV per Excel/Sheets, PDF per stampa.

💾 10. Sistema di Backup (LocalStorage & IndexedDB)

Elencus offre un sistema di backup automatico multi-livello per proteggere i tuoi dati.

Tre Livelli di Protezione

🔄 LocalStorage

Automatico - Ogni azione. È il salvataggio principale veloce e affidabile.

📦 IndexedDB

Automatico - Ogni ~10 salvataggi. Backup offline con storico completo.

📄 Export JSON

Manuale - Su richiesta. Salva in cloud personale.

Accesso al Backup Panel

🔧 Come Accedere:

  1. Clicca Backup nel footer
  2. Accedi ai 3 tab:
  3. Spazio - Visualizza utilizzo memory + crea backup
  4. Backup - Gestisci backup salvati
  5. Importa - Carica da file JSON

Gestione Backup Manuale

TAB "Spazio":

TAB "Backup":

TAB "Importa":

💡 Best Practice: Fai un export JSON almeno 1 volta al mese e salvalo in cloud personale (Google Drive, OneDrive, etc.)

🔧 11. Librerie e Tecnologie Utilizzate

Elencus utilizza alcune librerie open source per supportare formati avanzati come PDF e Excel. Tutte le librerie sono scaricate localmente per garantire privacy e sicurezza.

Librerie Utilizzate

📄 PDF.js (Mozilla)

Versione: 3.11.174
Licenza: Apache License 2.0
Uso: Lettura ed estrazione testo da file PDF
Fonte: mozilla.github.io/pdf.js

📊 SheetJS (xlsx)

Versione: 0.18.5
Licenza: Apache License 2.0
Uso: Lettura file Excel (XLSX, XLS)
Fonte: sheetjs.com

Perché Versioni Locali?

Elencus scarica e utilizza le librerie localmente invece di caricarle da CDN esterni per:

Licenze e Open Source

Tutte le librerie utilizzate sono:

🔒 Importante: Le librerie sono incluse nel pacchetto dell'app. Non vengono mai caricate da internet durante l'uso. I tuoi dati non vengono mai inviati a server esterni.

Dove Si Trovano?

Le librerie sono salvate nella cartella js/libs/ del progetto:

Puoi verificare la presenza di queste librerie aprendo la cartella del progetto. Non sono necessarie connessioni internet per utilizzarle.

🔐 12. Suggerimenti Importanti sulla Sicurezza

Poiché Elencus salva i dati localmente, la sicurezza dipende da te. Ecco i suggerimenti più importanti:

✅ Cosa Fare

🔐 Protezione del Dispositivo

  • ✅ Usa una password forte per il tuo PC/Smartphone
  • ✅ Mantieni il sistema operativo aggiornato
  • ✅ Usa un antivirus affidabile
  • ✅ Attiva il firewall del sistema

💾 Backup Regolari

  • ✅ Crea backup LocalStorage automatico (Elencus fa tutto)
  • ✅ Crea backup IndexedDB manualmente ogni settimana
  • ✅ Esporta JSON almeno 1 volta al mese
  • ✅ Salva export in cloud personale (Google Drive, OneDrive, Dropbox)

🛡️ Browser Security

  • ✅ Mantieni il browser aggiornato
  • ✅ Non installare estensioni non verificate
  • ✅ Usa browser ufficiali (Chrome, Firefox, Safari, Edge)
  • ✅ Attiva protezione tracking se disponibile

⚠️ Cosa NON Fare

❌ Rischi da Evitare

  • ❌ NON svuotare cache/dati browser senza backup
  • ❌ NON condividere il tuo dispositivo con persone non fidate
  • ❌ NON installare software sospetto
  • ❌ NON visitare siti infetti o poco sicuri
  • ❌ NON usare reti WiFi pubbliche senza VPN per aggiornamenti
  • ❌ NON fidarsi di email phishing

🔒 Se Accade il Peggio

📋 Checklist di Recupero:

  1. Controlla se hai backup IndexedDB → Ripristina
  2. Controlla se hai export JSON in cloud → Importa
  3. Se non hai backup: reinserisci manualmente i contatti
  4. Per il futuro: implementa backup regolari!

🎯 Piano di Sicurezza Consigliato

Frequenza Azione Metodo
Automatico Save LocalStorage Elencus lo fa automaticamente
~10 salvataggi Backup IndexedDB Automatico (10% probabilità)
Settimanale Backup Manuale Footer → Backup → Crea Manuale
Mensile Export JSON Footer → Backup → Esporta Tutto

🎯 Obiettivo Finale: Avere SEMPRE almeno 1 backup recente offline sul dispositivo + 1 backup in cloud personale.

📞 Domande Frequenti sulla Sicurezza

D: Elencus usa il mio cloud?
R: No! Elencus NON usa nessun cloud di terze parti. Tu scegli se esportare e dove salvare.

D: Se cambio browser, perdo i dati?
R: Sì, perché IndexedDB è browser-specifico. Usa sempre export JSON per backup cross-browser.

D: Se reinstallo il browser?
R: Perdi dati LocalStorage e IndexedDB. Importa da backup JSON precedente.

D: Elencus traccia i miei dati?
R: Assolutamente no! Nessun tracking, analytics o server remoti.