Centro Assistenza

Procedura di accesso dettagliata:

1. Vai alla pagina di login (auth.php)
2. Inserisci le tue credenziali:
   • Username: Il tuo nome utente amministratore
   • Password: La tua password (viene crittografata con SHA256)
3. Clicca "Accedi"
4. Se le credenziali sono corrette, verrai reindirizzato alla dashboard
5. Se sbagli username o password, apparirà un messaggio di errore

⚠️ Nota importante: Le credenziali vengono fornite direttamente dal nostro team dopo l'acquisto o al termine dell'installazione.

📧 Per problemi di accesso, contattaci: postmaster@egiapronto.it

Quando sei loggato come amministratore nella pagina di selezione lingua:

• Messaggio di conferma del tuo status di amministratore
• Pulsante "Vai alla Dashboard" per accesso rapido
• Tutte le lingue disponibili (anche quelle non installate)
• Le lingue non installate sono in grigio e linkano al negozio per l'acquisto
• Accesso completo a tutte le funzionalità di gestione

Gestione credenziali:

• Username e password sono fissi e vengono forniti dal nostro team
• Non è possibile recuperare o resettare le credenziali autonomamente
• Non condividere le credenziali di accesso
• Fai logout quando hai finito di lavorare
• Monitora gli accessi per rilevare attività sospette
• Fai backup periodici delle impostazioni e del database

⚠️ Importante: Se perdi le credenziali, contatta il supporto tecnico per assistenza.

Controllo automatico del setup:

• Se il database non è accessibile o non configurato, verrai automaticamente reindirizzato alla pagina di setup
• Il controllo viene effettuato su tutte le pagine principali del sistema
• La configurazione iniziale deve essere completata prima di poter utilizzare il sistema
• Il sistema protegge l'integrità dei dati verificando sempre la connessione

La pagina iniziale (index.php) permette di:

Per clienti non autenticati:
• Vedono solo le lingue installate e disponibili
• Possono selezionare una lingua per accedere al menu

Per amministratori autenticati:
• Vedono tutte le lingue (installate in colore normale, non installate in grigio)
• Possono acquistare lingue aggiuntive cliccando su quelle grigie
• Hanno accesso rapido alla dashboard

Processo di selezione: Cliccando su una lingua installata si accede al menu in quella lingua con un loader animato durante la traduzione.

Procedura di acquisto:

1. Come amministratore autenticato, puoi vedere le lingue non ancora installate (visualizzate in grigio)
2. Cliccando su una lingua non installata verrai reindirizzato automaticamente al negozio
3. Link diretto: www.egiapronto.it/shop
4. Nel negozio puoi acquistare lingue, texture e font aggiuntivi

💡 Nota: L'espansione delle lingue permette di raggiungere una clientela più ampia e internazionale.

Processo di traduzione:

Quando si seleziona una lingua:
1. Appare un loader animato con messaggi in diverse lingue
2. Il sistema traduce automaticamente tutto il contenuto del menu
3. La traduzione include: nomi piatti, descrizioni, allergeni, ingredienti, categorie
4. Il caricamento completo può richiedere alcuni secondi per lingue complesse

🔄 Aggiornamento automatico: Quando modifichi i contenuti, le traduzioni vengono aggiornate automaticamente in tutte le lingue installate.

Procedura completa passo-passo:

1. Vai nella sezione "Aggiungi piatti al menù"
2. Compila i campi principali:
   • Nome del piatto: Inserisci il nome (verrà verificato che non ci siano duplicati)
   • Costo: Inserisci il prezzo in euro (step 0.01)
   • Menù del giorno: Spunta per includere nell'offerta speciale

3. Descrizione (max 4000 caratteri):
   • Scrivi manualmente la descrizione
   • O usa il pulsante "Genera descrizione" per suggerimenti AI

4. Allergeni e Ingredienti:
   • Sistema di tag intelligente con lista predefinita
   • Massimo 10 tag per campo
   • Solo elementi dalla whitelist sono accettati

5. Categoria: Selezione obbligatoria dal menu a tendina
6. Immagine: Carica un'immagine (auto-ottimizzata e convertita in WebP)
7. Clicca "Salva" per confermare l'inserimento

Procedura di modifica:

1. Nella tabella dei piatti, clicca l'icona matita (✏️) accanto al piatto da modificare
2. Si aprirà una finestra modale con tutti i campi precompilati
3. Modifica i campi necessari:
   • Puoi cambiare nome, prezzo, descrizione, allergeni, ingredienti, categoria
   • Puoi aggiornare l'immagine caricandone una nuova
   • Puoi nascondere il piatto spuntando "Nascondi piatto"
   • Puoi includerlo/escluderlo dal menu del giorno
4. Clicca "Salva" per confermare le modifiche

💡 Tip: Nascondere un piatto è utile quando è temporaneamente non disponibile senza doverlo eliminare.

Procedura di eliminazione:

1. Clicca l'icona cestino (🗑️) accanto al piatto da eliminare
2. Conferma l'eliminazione nella finestra di dialogo
3. Il piatto verrà rimosso definitivamente dal sistema

⚠️ ATTENZIONE: L'eliminazione è irreversibile. Se vuoi rimuovere temporaneamente un piatto, usa la funzione "Nascondi piatto" invece di eliminarlo.

Sistema AI per descrizioni:

1. Inserisci almeno il nome del piatto
2. Clicca su "Genera descrizione"
3. Il sistema userà l'intelligenza artificiale per creare una descrizione automatica basata sul nome del piatto
4. Se esiste già una descrizione, ti verrà chiesto se vuoi sovrascriverla

💡 Vantaggi:
• Risparmio di tempo nella creazione di contenuti
• Descrizioni professionali e accattivanti
• Coerenza stilistica in tutto il menu

Legenda icone:

• 👁️ (Verde): Piatto visibile ai clienti
• 👁️⃣ (Rosso): Piatto nascosto ai clienti
• 🍴 (Verde): Piatto incluso nel menu del giorno
• ✏️: Modifica piatto
• 🗑️: Elimina piatto

Come ordinare i piatti:
Usa i controlli di ordinamento:
• Ordina per: Nome, Costo, o Categoria
• Direzione: Crescente o Decrescente
• Raggruppa per: Nessun gruppo o Per Categoria

Gestione menu speciale:

1. Nella sezione "Menù del giorno", usa l'interruttore per abilitare/disabilitare
2. Quando disabilitato, il menu del giorno non sarà visibile ai clienti
3. Quando abilitato, appariranno i controlli per la gestione del prezzo

💡 Utilità: Puoi preparare il menu del giorno in anticipo e attivarlo quando necessario.

Configurazione prezzo speciale:

1. Assicurati di aver aggiunto dei piatti al menu del giorno (spuntando la casella durante l'aggiunta/modifica)
2. Il sistema calcolerà automaticamente il prezzo totale senza sconto
3. Inserisci il prezzo scontato nel campo dedicato (deve essere minore del totale)
4. Clicca "Salva" per applicare il prezzo

⚠️ Importante: Il prezzo scontato deve essere inferiore al totale calcolato automaticamente. Se modifichi i piatti inclusi, dovrai aggiornare anche il prezzo.

Visualizzazione recap dettagliato:

1. Clicca il pulsante "Recap" accanto al prezzo del menu del giorno
2. Si aprirà una finestra che mostra:
   • Lista completa di tutti i piatti inclusi con i loro prezzi originali
   • Totale senza sconto
   • Totale con sconto applicato
   • Risparmio effettivo per il cliente

💡 Utilità: Perfetto per verificare la convenienza dell'offerta e per presentarla ai clienti.

Aggiornamento informazioni base:

1. Clicca l'icona informazioni (ℹ️) nei controlli in basso
2. Modifica i campi disponibili:
   • Logo: Carica un nuovo file immagine
   • Indirizzo: Inserisci l'indirizzo completo
   • Telefono: Numero di contatto principale
   • Sito Web: URL completo del sito web
   • Descrizione: Nome o slogan del locale
3. Clicca "Salva modifiche"

💡 Nota: Queste informazioni appariranno nell'header del menu clienti.

Personalizzazione aspetto visivo:

1. Clicca l'icona tavolozza (🎨) nei controlli
2. Scegli il tipo di sfondo:
   • Colore: Seleziona dalla palette o inserisci codice hex personalizzato
   • Texture: Scegli una delle texture disponibili nella galleria
3. Regola l'opacità con il cursore (0-100%)
4. Clicca "Salva modifiche"

🎨 Palette colori disponibile: Include scala di grigi, rossi, viola, blu, ciano, verdi, gialli con oltre 20 colori predefiniti.

Personalizzazione tipografica completa:

1. Clicca l'icona font (🔤) nei controlli
2. Scegli l'elemento da modificare:
   • NOME LOCALE: Font e colore del titolo principale
   • INFO LOCALE: Font e colore per indirizzo, telefono, sito
   • CAT. PIATTO: Font e colore per i nomi delle categorie
   • NOME PIATTO: Font e colore per i nomi dei piatti
   • PREZZO: Font e colore per i prezzi
   • DESCRIZIONE: Font e colore per le descrizioni

3. Per ogni elemento puoi scegliere:
   • Font da lista predefinita (Roboto, Open Sans, Lato, Montserrat, Poppins, Ubuntu)
   • Colore dalla palette o inserendo un codice hex
4. Visualizza l'anteprima in tempo reale
5. Clicca "Salva" per applicare

Gestione liste predefinite:

Gli allergeni e ingredienti devono essere gestiti dalla sezione dedicata (Gestione Allergeni/Ingredienti):

• Il sistema impedisce l'inserimento di allergeni/ingredienti non riconosciuti
• Appare un avviso per aggiungere nuovi elementi dalla sezione specifica
• Questa protezione garantisce coerenza e accuratezza delle informazioni

💡 Perché questo controllo? Per evitare errori di battitura e garantire informazioni accurate sui potenziali allergeni.

Sistema intelligente di tagging:

• Durante l'inserimento, inizia a digitare e apparirà un menu a discesa
• Puoi selezionare solo elementi dalla lista predefinita
• Il sistema supporta ricerca fuzzy (cerca anche con piccoli errori di battitura)
• Massimo 10 tag per campo
• Dropdown intelligente con suggerimenti automatici
• Validazione in tempo reale per evitare errori

🔍 Funzionalità avanzate: Ricerca case-insensitive e tollerante agli errori per facilità d'uso.

Sistema di traduzione manuale:

1. Seleziona il tipo di contenuto: Piatti o Categorie
2. Scegli la lingua: Dal menu a tendina delle lingue disponibili
3. Compila le traduzioni:
   • Testo originale in italiano mostrato a sinistra
   • Campi di traduzione da compilare a destra
   • Per i piatti: nome e descrizione
   • Per le categorie: solo nome
4. Clicca "Salva Traduzione" per ogni elemento

💡 Nota importante: Anche l'intelligenza artificiale può sbagliare! Verifica sempre le traduzioni automatiche prima di salvarle.

Lingue disponibili per traduzione:

Il sistema mostra solo le lingue installate nel tuo account, che possono includere:
• Italiano, Inglese (UK/US), Francese, Spagnolo, Tedesco
• Russo, Cinese (Semplificato/Tradizionale), Giapponese, Coreano
• Portoghese (Portogallo/Brasile), Arabo, Olandese, Turco
• Hindi, Polacco, Svedese, Norvegese, Ucraino
• Ceco, Ungherese, Swahili, Afrikaans, Greco

📧 Per lingue aggiuntive: Contatta postmaster@egiapronto.it o visita il negozio.

Aggiornamento traduzioni esistenti:

• Il sistema rileva automaticamente se esiste già una traduzione
• Se presente, aggiorna la traduzione esistente
• Se non presente, crea una nuova traduzione
• I campi mostrano le traduzioni attuali (se disponibili)
• Puoi modificare e salvare le traduzioni quante volte necessario

🔄 Automatismo: Non devi preoccuparti di duplicati - il sistema gestisce tutto automaticamente.

Procedura di stampa etichette:

1. Il sistema rileva automaticamente l'URL del tuo menu
2. Scegli il formato di stampa:
   • 1 etichetta (molto grande) per tavoli principali
   • 2 etichette (1×2) formato medio
   • 3 etichette (1×3) formato compatto
   • 4 etichette (2×2) formato piccolo
3. Clicca "Stampa etichette"
4. Si aprirà l'anteprima di stampa del browser

🎨 Design professionale: Include logo del menu, bandierine delle lingue disponibili e scritta "SCAN ME" accattivante.

Contenuto del QR code:

• URL base del menu: Rilevato automaticamente dal sistema
• Accesso diretto alla pagina di selezione lingua
• Logo personalizzato integrato nel QR code
• Correzione errori alta per garantire scansioni affidabili
• Bandierine delle lingue mostrate visivamente sull'etichetta

📱 Compatibilità: Funziona con qualsiasi smartphone o tablet con fotocamera.

Best practices per stampa professionale:

• Usa stampante laser o inkjet di buona qualità
• Carta bianca non lucida per migliore scansione
• Dimensioni ottimizzate per formato A4
• Separazione adeguata tra etichette multiple
• Fallback automatico se il logo non si carica

💡 Suggerimento: Testa sempre la scansione di un'etichetta stampata prima di stampare tutte le copie necessarie.

Procedura di backup automatica:

1. Vai nella sezione "Gestione Database"
2. Clicca "Crea Nuovo Backup"
3. Il sistema genera automaticamente un file SQL con:
   • Struttura completa di tutte le tabelle
   • Tutti i dati (piatti, categorie, traduzioni, ecc.)
   • Timestamp nel nome file per identificazione
4. Protezione anti-refresh: Evita duplicazioni accidentali

💾 File generato: menu_backup_YYYY-MM-DD_HH-mm-ss.sql nella cartella backup.

Procedura di ripristino:

1. Visualizza la lista backup disponibili (ordinati dal più recente)
2. Individua il backup da cui vuoi ripristinare
3. Clicca "Ripristina" accanto al backup scelto
4. Conferma l'operazione nell'avviso di sicurezza
5. Il sistema sostituisce tutti i dati attuali con quelli del backup

⚠️ ATTENZIONE CRITICA: Il ripristino è irreversibile e sostituisce TUTTI i dati esistenti. Crea sempre un backup prima di ripristinare!

Gestione automatica dei backup:

• Massimo 5 backup vengono conservati nel sistema
• Eliminazione automatica dei backup più vecchi
• Ordinamento per data dal più recente al più vecchio
• Informazioni complete: Nome file, data di creazione, azioni disponibili
• Protezione doppia contro refresh accidentali

💡 Strategia consigliata: Crea backup regolari prima di modifiche importanti e tieni sempre almeno un backup recente.

Sistema di validazione intelligente:

1. Compila il form con nome e descrizione dell'ingrediente
2. Clicca "Aggiungi Ingrediente"
3. Il sistema verifica con AI (Puter.ai) se l'ingrediente è valido per uso culinario
4. Prima volta: Ti verrà chiesto di autorizzare Puter.ai (clicca "Continue")
5. Se valido: L'ingrediente viene aggiunto automaticamente
6. Se non valido: Ricevi un messaggio di errore esplicativo

🤖 Validazione AI: Verifica che l'ingrediente sia realmente usato in cucina (frutta, verdura, spezie, condimenti, ecc.).

Doppia modalità di gestione:

Modalità RICERCA (default):
• Ricerca dinamica per nome ingrediente
• Risultati istantanei con nome e descrizione
• Eliminazione diretta dai risultati

Modalità LISTA:
• Tabella completa di tutti gli ingredienti
• Paginazione intelligente (25 per pagina)
• Navigazione a blocchi per grandi quantità
• Ancoraggio automatico alla tabella quando usi paginazione

🔄 Switch facilità: Interruttore per passare rapidamente tra le due modalità.

Gestione errori e fallback:

• Messaggio di errore chiaro se Puter.ai non risponde
• Log dettagliati in console per debugging
• Riprovare l'operazione dopo alcuni secondi
• Verifica connessione internet e autorizzazioni browser

🔧 Risoluzione problemi:
• Ricarica la pagina e riprova
• Assicurati di aver autorizzato Puter.ai
• Contatta supporto se il problema persiste

💡 Modello "User Pays": Servizio gratuito con autorizzazione una tantum - nessun costo nascosto.

Requisiti e ottimizzazioni automatiche:

• Formati supportati: JPEG, PNG, GIF
• Dimensione massima: Auto-ridimensionata a max 800px di larghezza
• Conversione automatica: Tutte le immagini vengono convertite in formato WebP
• Ottimizzazione qualità: Compressione automatica al 80% per bilanciare qualità e velocità
• Peso file: Ridotto automaticamente per caricamenti rapidi

💡 Best practice: Usa immagini ben illuminate, di buona qualità e che rappresentino chiaramente il piatto.

Condizioni per l'abilitazione:

Il campo prezzo si abilita automaticamente quando:
• Hai aggiunto almeno un piatto al menu del giorno
• I piatti sono correttamente contrassegnati durante l'aggiunta/modifica

✅ Soluzione:
1. Verifica di aver spuntato "Inserisci nel menù del giorno" durante l'aggiunta piatti
2. Controlla nella tabella che i piatti mostrino l'icona 🍴 verde
3. Il campo si abiliterà automaticamente quando detecta piatti nel menu speciale

Valori predefiniti del sistema:

• Per i colori: Seleziona i colori di default dalla palette
• Per i font: Seleziona "Roboto" e colore "#000000"
• Per lo sfondo: Seleziona colore "#121212" e opacità 100%
• Per le texture: Disabilita e torna al colore solido

🔄 Procedura: Non esiste un pulsante "reset", ma puoi facilmente tornare ai valori originali selezionando manualmente le impostazioni di default.

Troubleshooting font:

• Assicurati di cliccare "Salva" dopo ogni modifica
• Il sistema fa automaticamente refresh della pagina dopo il salvataggio
• I font vengono caricati da Google Fonts, verifica la connessione internet
• Svuota la cache del browser se i cambiamenti non sono visibili
• Testa su diversi dispositivi per verificare la coerenza

⚠️ Nota: Alcuni font potrebbero richiedere qualche secondo per caricarsi completamente.

Gestione multilingua:

• Solo le lingue installate sono funzionali per i clienti
• Gli amministratori possono vedere tutte le lingue disponibili
• Per installare nuove lingue, acquistale dal negozio ufficiale
• Il loader di traduzione può richiedere tempo per lingue complesse

🔧 Se il loader non scompare:
• Ricarica manualmente la pagina
• Verifica la connessione internet
• Prova una lingua diversa