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 responsabilità, risoluzione problemi e conformità.

Schede

La pagina è divisa in schede. Ciascuna copre un insieme di record diverso.

Scheda	Contenuto
Log di sistema	Il registro eventi generale descritto in questa pagina
Transazioni	Movimenti di denaro registrati sui turni dei cassieri
Cestino	Record eliminati da altre pagine, conservati per il ripristino
Audit	Record a prova di manomissione delle modifiche sensibili
Log IP	Registri di accesso conservati in file giornalieri per la conservazione legale. Vedi Log IP e registri di accesso
Eventi di manomissione	Rilevamenti anti-cheat segnalati dai client
Lista nera HWID	ID hardware a cui è impedito aprire una sessione
VAC di Steam	Controlli dei ban Steam sugli account dei membri

Le schede possono essere disattivate singolarmente in Impostazioni, poi Visualizza. Quando tutte le schede sono disattivate, la voce Log scompare dal menu di navigazione. Vedi Impostazioni di visualizzazione.

La Scheda Audit

La scheda Audit registra le modifiche che contano per la tracciabilità: modifiche di permessi e ruoli, rettifiche finanziarie, modifiche ai prodotti, modifiche alle impostazioni, eliminazioni di dati e operazioni sulle console.

I record di audit non possono essere modificati. Ciascuno è protetto da una firma di integrità che si concatena al record precedente. La scheda mostra il risultato della verifica in alto. Se un record è stato alterato, il pannello indica il primo record in cui la catena si interrompe.

I record di audit possono essere filtrati per categoria o azione. La ricerca a testo libero copre autore e destinatario.

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 è 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 è 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 è stata avviata su un client o console.
stopSession: una sessione attiva è stata terminata.
pauseSession: una sessione in corso è stata messa in pausa.
resumeSession: una sessione in pausa è stata ripresa.
consoleAdded: una nuova console da gioco è stata registrata nel sistema.
newMemberAdded: un nuovo account membro è stato creato.
orderCreated: un nuovo ordine prodotti è stato effettuato.
orderClosed: un ordine è 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 è stata avviata.
clientConnected: un PC client ha stabilito una connessione con il server.
clientDisconnected: un PC client si è disconnesso dal server.

Filtri e Ricerca

Filtro per Categoria

Seleziona una o più categorie per restringere la visualizzazione del log. Ad esempio, mostra solo eventi Sessione e Pagamento per controllare l'attività 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 (più recenti per primi) è 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 è 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 può consultare gli eventi di oggi ma non può 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'è 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.