Log

La pagina Log fornisce una traccia di controllo completa di tutti gli eventi di sistema in HandyCafe. Ogni azione significativa -- dall'avvio delle sessioni agli accessi dei cassieri -- viene registrata qui per responsabilita, risoluzione problemi e conformita.

Prestazioni

Il visualizzatore di log utilizza il rendering con lista virtuale per mantenere prestazioni fluide anche visualizzando migliaia di voci. Questo significa che solo le righe visibili vengono renderizzate nel DOM in qualsiasi momento, permettendo al sistema di gestire oltre 1.000 record di log senza degradazione dell'interfaccia.

Campi della Voce di Log

Ogni voce di log contiene i seguenti campi:

Campo	Descrizione
Timestamp	Data e ora in cui l'evento si e verificato
Origine	Il componente di sistema che ha generato l'evento
Categoria	Classificazione dell'evento (vedi categorie sotto)
Azione	Tipo di azione specifico (vedi azioni comuni sotto)
PC	Il PC client o la console coinvolti, se applicabile
IP	Indirizzo IP associato all'evento
Membro	Il membro coinvolto, se applicabile
Cassiere	Il cassiere che ha attivato o era in servizio per l'evento
Messaggio	Descrizione leggibile di cosa e successo

Categorie di Log

Gli eventi sono classificati in 8 categorie:

Server -- Avvio del server, spegnimento, modifiche alla configurazione e eventi a livello di sistema.
Client -- Connessioni dei client, disconnessioni e cambi di stato.
Cassiere -- Accesso del cassiere, logout e azioni amministrative.
Membro -- Registrazione dei membri, aggiornamenti del profilo e modifiche all'account.
Sessione -- Eventi del ciclo di vita delle sessioni (avvio, termine, pausa, ripresa).
Console -- Eventi relativi alle console (aggiunte, rimozioni, assegnazioni sessioni).
Ordine -- Creazione, modifica e chiusura degli ordini.
Pagamento -- Elaborazione pagamenti, rimborsi e transazioni finanziarie.

Azioni Comuni Registrate

Le seguenti azioni appaiono frequentemente nel log:

startSession -- Una nuova sessione e stata avviata su un client o console.
stopSession -- Una sessione attiva e stata terminata.
pauseSession -- Una sessione in corso e stata messa in pausa.
resumeSession -- Una sessione in pausa e stata ripresa.
consoleAdded -- Una nuova console da gioco e stata registrata nel sistema.
newMemberAdded -- Un nuovo account membro e stato creato.
orderCreated -- Un nuovo ordine prodotti e stato effettuato.
orderClosed -- Un ordine e stato completato e chiuso.
cashierLogin -- Un cassiere ha effettuato l'accesso al sistema.
cashierLogout -- Un cassiere ha effettuato il logout.
serverStarted -- L'applicazione HandyCafe Server e stata avviata.
clientConnected -- Un PC client ha stabilito una connessione con il server.
clientDisconnected -- Un PC client si e disconnesso dal server.

Filtri e Ricerca

Filtro per Categoria

Seleziona una o piu categorie per restringere la visualizzazione del log. Ad esempio, mostra solo eventi Sessione e Pagamento per controllare l'attivita finanziaria.

Filtro per Azione

Filtra per tipi di azione specifici per trovare rapidamente particolari eventi.

Filtro per Intervallo di Date

Limita la visualizzazione del log a un periodo specifico. Combinato con altri filtri, rende semplice indagare incidenti verificatisi in una finestra temporale nota.

Opzioni di Ordinamento

Ordina le voci di log per qualsiasi campo in ordine crescente o decrescente. L'ordinamento per timestamp (piu recenti per primi) e quello predefinito.

Ricerca Testuale

Una casella di ricerca full-text confronta tutti i campi, permettendoti di cercare un nome host specifico, indirizzo IP, nome membro o qualsiasi parola chiave nei messaggi del log.

Permessi

L'accesso alla pagina Log e controllato dai seguenti permessi:

Permesso	Descrizione
`LOG_VIEW`	Necessario per accedere alla pagina Log
`LOG_DISPLAY_FULL`	Permette di visualizzare lo storico completo dei log
`LOG_DISPLAY_TODAY`	Limita la visualizzazione alle sole voci di oggi
`LOG_DELETE`	Permette di eliminare le voci di log

Un cassiere con LOG_VIEW e LOG_DISPLAY_TODAY puo consultare gli eventi di oggi ma non puo accedere ai dati storici. Solo gli utenti con LOG_DISPLAY_FULL possono sfogliare l'intero archivio dei log.

Aggiornamenti in Tempo Reale

I nuovi eventi di log appaiono automaticamente nel visualizzatore man mano che si verificano. Il sistema ascolta gli eventi di log tramite la connessione di eventi TCP quindi non c'e bisogno di aggiornare manualmente la pagina. Una cache dei log migliora le prestazioni riducendo le query ripetute al database durante lo scorrimento delle voci recenti.