==============================================================================
   DIZIONARIO LATINO CLONE - GUIDA ALLA DISTRIBUZIONE E INSTALLAZIONE
==============================================================================

Questo documento contiene tutte le istruzioni operative per:
  A) Chi distribuisce il pacchetto (docenti, tecnici, colleghi)
  B) Chi riceve e installa l'applicazione sul proprio PC (studenti, utenti)

==============================================================================
PARTE A: GUIDA PER IL DISTRIBUTORE
==============================================================================

1. CHE COSA CONTIENE IL PACCHETTO "dizionario-latino-clone.zip":
   - Un'applicazione web locale autonoma, portabile e pronta all'uso.
   - Oltre 10.250 lemmi latini con quantità vocaliche, paradigmi e categorie.
   - Oltre 699.000 forme flesse indicizzate (coniugazioni e declinazioni).
   - Oltre 64.000 voci per la ricerca inversa Italiano -> Latino.
   - Declinatore e Coniugatore dinamico bicolore (radice/desinenza).
   - Motore ibrido: funziona al 100% OFFLINE (senza internet); se connesso,
     recupera in automatico esempi d'autore storici da dizionario-latino.com.

2. COME DISTRIBUIRE IL FILE:
   - Il file "dizionario-latino-clone.zip" pesa solo circa 17 MB.
   - Può essere condiviso tramite:
     * Chiavetta USB
     * Google Drive / Microsoft OneDrive / Dropbox
     * Microsoft Teams / Google Classroom
     * Allegato email (dove consentito fino a 20 MB)
     * Cartella condivisa di rete (LAN d'istituto o aziendale)

3. COSA COMUNICARE AI DESTINATARI:
   - È sufficiente inviare il file zip e allegare o inoltrare il testo della
     "PARTE B" riportata qui sotto.


==============================================================================
PARTE B: ISTRUZIONI PER IL DESTINATARIO (PC DI ARRIVO)
==============================================================================

SISTEMI OPERATIVI SUPPORTATI: Windows 10 e Windows 11 (64-bit / 32-bit).

------------------------------------------------------------------------------
REQUISITO PRELIMINARE: INTERPRETE PYTHON 3
------------------------------------------------------------------------------
Sul computer deve essere presente Python (versione 3.8 o superiore).

1. Se non è già installato, scaricalo gratuitamente dal sito ufficiale:
   https://www.python.org/downloads/

2. FONDAMENTALE DURANTE L'INSTALLAZIONE:
   Nella PRIMISSIMA schermata di installazione di Python, prima di premere
   qualsiasi tasto, SPUNTA OBBLIGATORIAMENTE la casella in basso:
   
   [x] "Add python.exe to PATH"  (oppure "Aggiungi Python alle variabili d'ambiente")
   
   Quindi clicca su "Install Now".


------------------------------------------------------------------------------
PASSO 1: ESTRAZIONE DELLO ZIP
------------------------------------------------------------------------------
1. Fai clic con il tasto destro sul file "dizionario-latino-clone.zip".
2. Seleziona "Estrai tutto..." (Extract all).
3. Scegli una cartella a tua scelta (ad esempio C:\DizionarioLatino, 
   oppure nella cartella Documenti o sul Desktop).


------------------------------------------------------------------------------
PASSO 2: CONFIGURAZIONE AUTOMATICA (1 SOLO CLIC)
------------------------------------------------------------------------------
Apri la cartella estratta "dizionario-latino-clone":

  METODO 1 (Consigliato):
  - Fai doppio clic sul collegamento:
    "Configura e Installa.lnk"

  METODO 2 (Alternativo):
  - Fai clic con il TASTO DESTRO del mouse sul file "installa.ps1"
  - Seleziona "Esegui con PowerShell" (Run with PowerShell).

Cosa fa lo script in automatico:
  - Trova i percorsi esatti di Python sul tuo computer.
  - Verifica la libreria necessaria (beautifulsoup4).
  - Crea sul tuo Desktop il collegamento nativo "Dizionario Latino.lnk".
  - Crea nella cartella il collegamento "Avvia Dizionario Latino.lnk".


------------------------------------------------------------------------------
PASSO 3: AVVIO E UTILIZZO
------------------------------------------------------------------------------
D'ora in poi, per avviare il dizionario:

1. Fai doppio clic sul collegamento "Dizionario Latino" comparso sul tuo Desktop.
2. L'applicazione si avvia in background in modo pulito e silenzioso
   (senza finestre nere di prompt dei comandi).
3. Il browser predefinito si aprirà automaticamente all'indirizzo:
   http://127.0.0.1:8080


==============================================================================
RISOLUZIONE DEI PROBLEMI PIÙ FREQUENTI
==============================================================================

• PROBLEMA: Viene mostrato "Python non risulta installato o non si trova nel PATH".
  SOLUZIONE: Riapri l'installer di Python scaricato, scegli "Modify" e assicurati
  di spuntare la casella "Add python.exe to PATH", quindi ripeti l'installazione.

• PROBLEMA: Windows impedisce l'esecuzione degli script PowerShell.
  SOLUZIONE: Fai doppio clic su "Configura e Installa.lnk", che aggira
  automaticamente le restrizioni di policy locali senza modificare la sicurezza
  di sistema.

• DISINSTALLAZIONE:
  Per rimuovere l'applicazione, è sufficiente cancellare il collegamento dal
  Desktop e eliminare la cartella estratta. Nessuna chiave di registro invasiva
  viene aggiunta a Windows.
==============================================================================
