HandyCafe Docs
owner

Journaux

La page Journaux fournit une piste d'audit complète de tous les événements système dans HandyCafe. Chaque action importante (du démarrage de la session à la connexion au caissier) est enregistrée ici aux fins de responsabilité, de dépannage et de conformité.

Onglets

La page est divisée en onglets. Chacun couvre un ensemble d'enregistrements différent.

Onglet Contenu
Journaux système Le journal d'événements général décrit sur cette page
Transactions Mouvements d'argent enregistrés sur les postes des caissiers
Corbeille Enregistrements supprimés depuis d'autres pages, conservés pour récupération
Audit Enregistrements inaltérables des modifications sensibles
Journaux IP Enregistrements d'accès conservés dans des fichiers quotidiens pour la rétention légale. Voir Journaux IP et enregistrements d'accès
Événements d'altération Détections anti-triche signalées par les clients
Liste noire HWID Identifiants matériels empêchés d'ouvrir une session
Steam VAC Contrôles de bannissement Steam sur les comptes des membres

Les onglets peuvent être désactivés individuellement dans Paramètres, puis Affichage. Lorsque tous les onglets sont désactivés, l'entrée Journaux disparaît du menu de navigation. Voir Paramètres d'affichage.

L'onglet Audit

L'onglet Audit enregistre les modifications qui comptent pour la traçabilité : changements de permissions et de rôles, ajustements financiers, modifications de produits, modifications de paramètres, suppressions de données et opérations sur les consoles.

Les enregistrements d'audit ne peuvent pas être modifiés. Chacun est protégé par une signature d'intégrité chaînée à l'enregistrement précédent. L'onglet affiche un résultat de vérification en haut. Si un enregistrement a été altéré, le panneau désigne le premier enregistrement où la chaîne se rompt.

Les enregistrements d'audit peuvent être filtrés par catégorie ou par action. La recherche en texte libre porte sur l'auteur et la cible.

Performance

La visionneuse de journaux utilise le rendu de liste virtuelle pour maintenir des performances fluides même lors de l'affichage de milliers d'entrées. Cela signifie que seules les lignes visibles sont affichées dans le DOM à tout moment, permettant au système de gérer plus de 1 000 enregistrements de journaux sans dégradation de l'interface.

Champs d'entrée du journal

Chaque entrée de journal contient les champs suivants :

Champ Descriptif
Horodatage Date et heure de l'événement
Source Le composant système qui a généré l'événement
Catégorie Classement de l'événement (voir catégories ci-dessous)
Action Type d'action spécifique (voir les actions courantes ci-dessous)
PC Le PC client ou la console impliquée, le cas échéant
IP Adresse IP associée à l'événement
Membre Le membre concerné, le cas échéant
Caissier Le caissier qui a déclenché ou était en service pour l'événement
Message Description lisible par un humain de ce qui s'est passé

Catégories de journaux

Les événements sont classés en 8 catégories :

  1. Serveur : démarrage, arrêt du serveur, modifications de configuration et événements au niveau du système.
  2. Client : connexions, déconnexions et changements d'état du client.
  3. Caissier : connexion, déconnexion et actions administratives du caissier.
  4. Membre : inscription des membres, mises à jour de profil et modifications de compte.
  5. Session : événements du cycle de vie de la session (démarrage, arrêt, pause, reprise).
  6. Console : événements liés à la console (ajouts, suppressions, affectations de session).
  7. Commande : événements de création, de modification et de clôture de commande.
  8. Paiement : traitement des paiements, remboursements et événements de transaction financière.

Actions courantes enregistrées

Les actions suivantes apparaissent fréquemment dans le journal :

  • startSession : Une nouvelle session a été démarrée sur un client ou une console.
  • stopSession : Une session active a été terminée.
  • pauseSession : Une session en cours a été mise en pause.
  • resumeSession : Une session en pause a repris.
  • consoleAdded : Une nouvelle console de jeu a été enregistrée dans le système.
  • newMemberAdded : Un nouveau compte membre a été créé.
  • orderCreated : Une nouvelle commande de produit a été passée.
  • orderClosed : Une commande a été finalisée et clôturée.
  • cashierLogin : Un caissier s'est connecté au système.
  • cashierLogout : Un caissier s'est déconnecté.
  • serverStarted : L'application HandyCafe Server a été lancée.
  • clientConnected : Un PC client a établi une connexion avec le serveur.
  • clientDisconnected : Un PC client s'est déconnecté du serveur.

Filtrage et recherche

Filtre de catégorie

Sélectionnez une ou plusieurs catégories pour affiner l'affichage du journal. Par exemple, affichez uniquement les événements de session et de paiement pour auditer l'activité financière.

Filtre d'actions

Filtrez par types d'action spécifiques pour trouver rapidement des événements particuliers.

Filtre de plage de dates

Restreignez l'affichage du journal à une période spécifique. Combiné avec d'autres filtres, cela facilite l'enquête sur les incidents survenus au cours d'une fenêtre temporelle connue.

Options de tri

Triez les entrées du journal par n'importe quel champ par ordre croissant ou décroissant. Le tri par horodatage (le plus récent en premier) est la valeur par défaut.

Recherche de texte

Une zone de recherche en texte libre correspond à tous les champs, vous permettant de rechercher un nom d'hôte, une adresse IP, un nom de membre ou tout autre mot-clé spécifique dans les messages du journal.

Autorisations

L'accès à la page Journaux est contrôlé par les autorisations suivantes :

Autorisation Descriptif
LOG_VIEW Obligatoire pour accéder à la page Journaux
LOG_DISPLAY_FULL Permet d'afficher l'historique complet des journaux
LOG_DISPLAY_TODAY Restreint l'affichage aux entrées d'aujourd'hui uniquement
LOG_DELETE Permet de supprimer les entrées du journal

Un caissier avec LOG_VIEW et LOG_DISPLAY_TODAY peut consulter les événements du jour mais ne peut pas accéder aux données historiques. Seuls les utilisateurs disposant de LOG_DISPLAY_FULL peuvent parcourir l'intégralité des archives de journaux.

Mises à jour en temps réel

Les nouveaux événements de journal apparaissent automatiquement dans la visionneuse au fur et à mesure qu'ils se produisent. Le système écoute les événements du journal via la connexion d'événements TCP, il n'est donc pas nécessaire d'actualiser manuellement la page. Un cache de journaux améliore les performances en réduisant les requêtes répétées de base de données lors du défilement des entrées récentes.