Événements

Section d'En-tête

• Titre de la Page : "Événements" avec icône de note d'événement
• Description : Sous-titre "Historique des Événements"
• Barre de Recherche : Recherche rapide à travers tous les champs d'événements
• Boutons d'Action : Exporter (basé sur permissions), Actualiser, et basculer Filtres (basé sur permissions)

Mobile : Les éléments s'empilent verticalement
Bureau/Tablette : Rangée horizontale avec actions alignées à droite

Panneau de Filtre (Barre Latérale Droite)

• Animation : Glissement fluide de 300ms depuis le côté droit
• Largeur : Largeur fixe de 340px avec défilement vertical
• Sections : Type d'Événement, Type d'Entité, Période, Utilisateurs, Clients, Appareils, Cartes d'Accès, Entreprises, Étiquettes, Zones
• Actions : Boutons Réinitialiser et Appliquer en bas
• Permission : Requiert la permission canFilterEvents()

Liste d'Événements et Pagination

• Vue Bureau : Tableau de données (largeur > 1024px)
• Vue Mobile/Tablette : Disposition en cartes (largeur ≤ 1024px)
• Barre de Pagination : Barre inférieure avec compteur, sélecteur de lignes par page et navigation de page
• Pages Max : Supporte jusqu'à 99 999 999 pages

Fonctionnalité de la Barre de Recherche

• Champs Consultables : Descriptions d'événements, noms d'appareils, noms de clients, noms d'utilisateurs, messages d'événements
• Recherche en Temps Réel : Les résultats se mettent à jour automatiquement pendant que vous tapez
• Insensible à la Casse : La recherche fonctionne indépendamment de la casse des lettres
• Correspondance Partielle : Trouvez des événements avec des informations incomplètes

Exemples : "entrée" pour les entrées, "paiement échoué" pour les erreurs, "Terminal 2" pour les événements d'appareil

Boutons d'Action

• Exporter : Télécharger les résultats filtrés vers Excel (requiert permission canExportReports)
• Actualiser : Recharger les données d'événements pour voir les dernières activités
• Filtres : Basculer le panneau de filtre avancé (requiert permission canFilterEvents)

Bureau : Boutons texte avec icônes | Mobile/Tablette : Boutons icône uniquement

Types d'Événements Disponibles

• ● Information : Événements informatifs (mises à jour système, opérations routinières)
• ● Entrée : Véhicule ou personne entrant dans l'installation
• ● Sortie : Véhicule ou personne sortant de l'installation
• ● Payé : Transactions de paiement complétées
• ● Erreur : Erreurs système et défaillances
• ● Avertissement : Conditions d'avertissement nécessitant attention

Multi-Sélection : Sélectionnez plusieurs types d'événements simultanément pour voir les résultats combinés.

Cas d'Usage par Type d'Événement

• Entrée + Sortie : Suivez le flux de trafic de l'installation et les modèles d'occupation
• Payé : Surveillez l'activité de paiement et la génération de revenus
• Erreur + Avertissement : Identifiez et dépannez les problèmes système
• Information : Examinez les opérations système routinières et les mises à jour

Catégories de Type d'Entité

• ● Client : Clients enregistrés avec comptes et abonnements
• ● Utilisateur : Utilisateurs système (personnel, administrateurs, opérateurs)
• ● Invité : Visiteurs non enregistrés ou utilisateurs anonymes

Filtre de Plage de Dates

• Date de Début : Début de la plage de dates (inclusif)
• Date de Fin : Fin de la plage de dates (inclusif)
• Sélecteur de Date : Interface calendrier pour sélection facile
• Plage : De 2020 à la date actuelle
• Format d'Affichage : JJ/MM/AAAA

Scénarios de Filtrage Courants

• Client + Entrée : Suivez les arrivées des clients enregistrés
• Invité + Payé : Surveillez les transactions de paiement des invités
• Utilisateur + Erreur : Examinez les problèmes système liés au personnel
• Tous Types + Plage de Dates : Générez des rapports d'activité quotidiens/hebdomadaires/mensuels

Filtres d'Autocomplétion AJAX

Ces filtres utilisent une recherche intelligente avec requêtes différées (délai de 300ms) pour une performance optimale :

• Utilisateurs : Recherchez les utilisateurs système par nom (minimum 2 caractères)
• Clients : Recherchez les clients enregistrés par nom (minimum 2 caractères)
• Cartes d'Accès : Recherchez les cartes d'accès par nom d'utilisateur (minimum 2 caractères)
• Entreprises : Recherchez les entreprises/organisations par nom (minimum 2 caractères)

Comment Ça Marche :

1. Tapez au moins 2 caractères dans le champ de recherche
2. Le système attend 300ms que vous finissiez de taper
3. Un indicateur de chargement apparaît pendant la recherche
4. Les résultats se remplissent automatiquement (max 25 éléments)
5. Sélectionnez un ou plusieurs éléments
6. Les éléments sélectionnés apparaissent comme puces avec option de suppression

Filtres Déroulants Multi-Sélection

• Appareils : Sélectionnez parmi tous les appareils disponibles (pré-chargés, max 1000)
• Étiquettes : Sélectionnez les étiquettes personnalisées avec indicateurs de couleur
• Zones : Sélectionnez les zones de stationnement avec indicateurs de couleur

Tous les filtres déroulants supportent la multi-sélection et affichent les éléments sélectionnés comme puces supprimables.

Combinaisons de Filtres

Combinez plusieurs filtres pour une analyse précise des événements :

• Appareil + Type d'Erreur : Dépannez les problèmes d'appareil spécifiques
• Client + Entrée/Sortie : Suivez l'activité individuelle des clients
• Zone + Plage de Dates : Analysez les modèles de trafic spécifiques à la zone
• Entreprise + Événements Payés : Générez des rapports de facturation d'entreprise
• Carte d'Accès + Entrée : Auditez l'utilisation des cartes d'accès
• Étiquette + N'importe quel Type d'Événement : Suivez les événements par catégories personnalisées

Vue Tableau de Bureau (largeur > 1024px)

Tableau de données complet avec colonnes pour des informations d'événement complètes :

Vue Carte Mobile/Tablette (largeur ≤ 1024px)

Événements affichés comme cartes pour une navigation tactile conviviale :

• En-tête de Carte : Icône de type d'événement avec codage couleur et horodatage
• Info Entité : Badge de type d'entité et nom
• Badge Appareil : Nom d'appareil avec icône
• Description : Texte du message d'événement
• Zone/Étiquettes : Puces codées par couleur pour zones et étiquettes
• Appuyer pour Développer : Voir les détails complets et actions disponibles

États de Chargement et Vides

• État de Chargement : Indicateur de progression avec message "Chargement des événements..."
• État Vide : Message utile lorsqu'aucun événement ne correspond aux filtres
• État d'Erreur : Message d'erreur clair avec option de réessai
• Cache de Date : Les dates pré-analysées améliorent la performance du filtre sur les grands ensembles de données

Processus d'Exportation

1. Appliquez les filtres souhaités pour affiner l'ensemble d'événements (optionnel)
2. Cliquez sur le bouton "Exporter" dans la zone d'en-tête
3. Le système génère un fichier Excel avec tous les filtres actuels appliqués
4. La boîte de dialogue d'enregistrement Excel apparaît avec progression du téléchargement
5. Choisissez l'emplacement et enregistrez le fichier sur votre ordinateur

Format de Fichier : .xlsx (Excel 2007+)
Nommage : events_export_[horodatage].xlsx
Permission : Requiert la permission canExportReports()

Colonnes de Données Exportées

• ID d'Événement
• Date et Heure
• Type d'Événement (Entrée, Sortie, Payé, Erreur, Avertissement, Information)
• Type d'Entité (Client, Utilisateur, Invité)
• Nom de l'Entité
• ID Client (si applicable)
• ID Utilisateur (si applicable)
• Nom de l'Appareil
• ID de l'Appareil
• Nom d'utilisateur de la Carte d'Accès
• ID de la Carte d'Accès
• Nom de l'Entreprise/Société
• Nom de la Zone
• Étiquettes (séparées par virgules)
• Description de l'Événement
• Détails Supplémentaires

Meilleures Pratiques d'Exportation

• Filtrer Avant d'Exporter : Appliquez des filtres pour obtenir exactement les données dont vous avez besoin
• Limites de Plage de Dates : Utilisez des plages de dates raisonnables pour gérer la taille du fichier
• Focus sur Type d'Événement : Exportez des types d'événements spécifiques pour une analyse ciblée
• Sauvegardes Régulières : Exportez les journaux d'événements quotidiens/hebdomadaires pour la conformité
• Rapports d'Appareil : Exportez les événements spécifiques à l'appareil pour les journaux de maintenance
• Rapports Client : Exportez les événements clients pour la facturation et le support

Lignes Par Page

• Options : 10, 25, 50 ou 100 événements par page
• Persistance : Sélection enregistrée automatiquement dans les préférences
• Performance : Les tailles de page plus grandes peuvent se charger plus lentement sur les appareils plus anciens

Navigation de Page

• Première Page : Aller à la page 1 (|◄)
• Précédent : Reculer d'une page (◄)
• Numéros de Page : Cliquer sur une page spécifique pour y aller directement
• Suivant : Avancer d'une page (►)
• Dernière Page : Aller à la dernière page (►|)
• Pages Max : Supporte jusqu'à 99 999 999 pages

Compteur d'Événements

Format : "Affichage X-Y de Z événements"

• X : Numéro du premier événement sur la page actuelle
• Y : Numéro du dernier événement sur la page actuelle
• Z : Total des événements correspondant aux filtres actuels

Surveillance Quotidienne des Événements

• Examinez les événements d'erreur et d'avertissement chaque matin
• Vérifiez les ratios entrée/sortie pour assurer le bon fonctionnement des portes
• Surveillez les événements de paiement pour les échecs de transaction
• Utilisez le filtre de date défini sur "Aujourd'hui" pour l'activité du jour actuel
• Exportez les journaux d'événements quotidiens pour les dossiers de conformité

Dépannage avec les Événements

• Filtrez par appareil + type d'erreur pour isoler les problèmes matériels
• Utilisez le filtre client pour enquêter sur des plaintes spécifiques
• Vérifiez les événements d'avertissement avant qu'ils ne s'aggravent en erreurs
• Comparez les événements d'entrée/sortie pour identifier les dysfonctionnements de porte
• Examinez les événements de carte d'accès pour l'audit de sécurité

Analytique et Rapports

• Exportez les événements d'entrée par zone pour analyser les modèles de trafic
• Filtrez par client + événements payés pour la réconciliation de facturation
• Utilisez le filtre entreprise pour générer des rapports spécifiques à l'entreprise
• Combinez zone + plage de dates pour l'analyse d'occupation
• Suivez les événements utilisateur pour la surveillance de l'activité du personnel

Optimisation de la Recherche

• Utilisez des termes de recherche spécifiques pour des résultats d'autocomplétion plus rapides
• Appliquez des filtres avant de rechercher pour affiner les ensembles de résultats
• Rappelez-vous que l'autocomplétion nécessite minimum 2 caractères
• Attendez le délai de différé (300ms) pour terminer la saisie
• Utilisez le menu déroulant d'appareil au lieu de la recherche pour une sélection plus rapide

Conseils de Performance

• Utilisez toujours des filtres de plage de dates pour les grands ensembles de données
• Le système met en cache les dates analysées pour un filtrage plus rapide
• Limitez les recherches d'autocomplétion à 2-5 caractères pour de meilleurs résultats
• Exportez les grands ensembles de données plutôt que de paginer à travers de nombreuses pages
• Fermez le panneau de filtre lorsqu'il n'est pas utilisé pour un meilleur espace d'écran
• Actualisez la page périodiquement pour voir les derniers événements