Gestion des Entrées

Section En-tête

• Icône de Page: Icône de connexion dans cercle teinté cyan
• Titre: "Entrées" avec sous-titre "Historique des Entrées"
• Barre de Recherche: Recherche plein texte avec placeholder "Rechercher Entrée"
• Boutons d'Action: Exporter (basé sur permission), Actualiser, Filtres (basé sur permission)
• Bordure Inférieure: Diviseur de 1px sur mobile/tablette pour séparation visuelle

Mobile (≤768px): Empilement vertical avec ligne icône+titre, puis ligne recherche+boutons
Bureau/Tablette (>768px): Ligne horizontale avec actions alignées à droite

Panneau de Filtres (Barre Latérale Droite)

• Largeur: Largeur fixe de 320px avec défilement vertical
• Animation: Glissement fluide de 300ms depuis la droite (Curves.easeInOut)
• Position: Superpose le contenu depuis le côté droit, bas: 64px (au-dessus de la barre de pagination)
• Sections: Clients, Utilisateurs, Entreprises, Appareils, Étiquettes, Zones, Plage de Dates, Type, Montant Transaction, Statut Paiement
• Actions: Réinitialiser (bouton contour) et Appliquer (bouton principal) en bas
• Permission: Nécessite permission canFilterEntries()

Liste Entrées & Pagination

• Vue Mobile/Tablette: Disposition carte (largeur ≤1200px)
• Vue Bureau: Tableau de données (largeur >1200px)
• Barre de Pagination: Hauteur fixe de 64px en bas avec compteur, sélecteur de lignes et navigation
• État de Chargement: Indicateur de progression pendant la récupération des données

Fonctionnalité de Recherche

• Champs Recherchables: IDs d'entrée, noms de clients, noms d'utilisateurs, noms d'appareils, plaques d'immatriculation, détails de transaction
• Résultats en Temps Réel: Se met à jour automatiquement pendant que vous tapez
• Insensible à la Casse: Les recherches fonctionnent quelle que soit la capitalisation
• Correspondance Partielle: Trouvez des entrées avec termes de recherche incomplets
• Réinitialisation de Page: Retourne à la page 1 lorsqu'une nouvelle recherche est effectuée

Exemples: "ABC-123" pour plaque, "Jean Dupont" pour client, "Barrière 1" pour appareil

Boutons d'Action

• Exporter: Télécharger les entrées filtrées vers Excel (nécessite permission canExportReports)
• Actualiser: Recharger les données d'entrée pour voir les derniers enregistrements
• Filtres: Ouvrir le panneau de filtres avancés (nécessite permission canFilterEntries)

Bureau (>1024px): Boutons texte avec icônes
Mobile/Tablette (≤1024px): Boutons circulaires avec icônes uniquement

Filtres Autocomplétion AJAX

Ces filtres fournissent une recherche intelligente avec requêtes différées pour des performances optimales:

• Clients: Rechercher clients enregistrés par nom (minimum 2 caractères)
• Utilisateurs: Rechercher utilisateurs système par nom (minimum 2 caractères)
• Entreprises: Rechercher entreprises/organisations par nom (minimum 2 caractères)

Comment Fonctionne l'Autocomplétion:

1. Tapez au moins 2 caractères dans le champ de recherche
2. Le système attend 300ms que vous finissiez de taper (délai de rebond)
3. Un spinner de chargement apparaît dans le champ pendant la recherche
4. Les résultats se remplissent automatiquement (maximum 25 éléments par recherche)
5. Sélectionnez un ou plusieurs éléments dans le menu déroulant
6. Les éléments sélectionnés apparaissent comme puces amovibles au-dessus du champ

Filtres Déroulants Multi-Sélection

• Appareils: Sélectionnez parmi tous les appareils d'entrée disponibles (pré-chargé, max 1000 appareils)
• Étiquettes: Sélectionnez des étiquettes personnalisées avec indicateurs de couleur pour organisation visuelle
• Zones: Sélectionnez des zones de stationnement avec indicateurs de couleur

Tous les filtres déroulants prennent en charge les sélections multiples et affichent les éléments sélectionnés comme puces amovibles. Les appareils, étiquettes et zones sont pré-chargés à l'initialisation de la page pour sélection instantanée.

Filtre 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 de date
• Plage: De 2020 à la date actuelle
• Format d'Affichage: JJ/MM/AAAA
• Par Défaut: Affiche "Non Défini" quand aucune date n'est sélectionnée

Cas d'Usage: Rapports quotidiens (aujourd'hui seulement), analyse hebdomadaire (plage de 7 jours), facturation mensuelle (1er au dernier jour du mois), périodes personnalisées pour événements spéciaux

Filtre Type d'Entité

Filtrez les entrées par type d'entité (personne/compte) entrant dans l'installation:

• ● Client: Clients enregistrés avec comptes, abonnements ou passes de stationnement
• ● Utilisateur: Utilisateurs système incluant personnel, administrateurs et opérateurs
• ● Invité: Visiteurs non enregistrés, utilisateurs ponctuels ou entrées anonymes

Multi-Sélection: Choisissez un ou plusieurs types d'entité pour analyser différents segments d'utilisateurs simultanément.

Plage Montant Transaction

• Montant Minimum: Filtrer les entrées avec transactions supérieures ou égales à cette valeur
• Montant Maximum: Filtrer les entrées avec transactions inférieures ou égales à cette valeur
• Type de Saisie: Les champs numériques acceptent les valeurs décimales (ex., 5.50, 10.00)
• Devise: Utilise la devise par défaut du système
• Optionnel: Laissez vide pour ignorer le filtrage par montant

Exemples: Min: 0, Max: 10 (petites transactions), Min: 50 (entrées haute valeur), Min: 0, Max: 0 (entrées gratuites)

Filtre Statut Paiement

• ● Tous: Afficher toutes les entrées quel que soit le statut de paiement
• ● Payé: Seulement les entrées avec transactions de paiement complétées
• ● Impayé: Seulement les entrées avec paiements en attente ou échoués

Sélection Simple: Choisissez une option de statut de paiement dans le menu déroulant.

Scénarios de Filtrage Communs

• Entrées Impayées + Client: Identifier les clients avec paiements en attente
• Payé + Plage Montant: Analyser les revenus par taille de transaction
• Impayé + Plage Date: Trouver les créances vieillissantes
• Montant = 0 + Statut Tous: Examiner l'utilisation d'entrée gratuite (passes, personnel, etc.)
• Montant Élevé + Payé: Suivre le stationnement premium ou les revenus d'événements spéciaux

Vue Tableau Bureau (largeur > 1200px)

Tableau de données complet avec colonnes pour informations complètes d'entrée:

Vue Carte Mobile/Tablette (largeur ≤ 1200px)

Entrées affichées comme cartes extensibles pour interaction tactile conviviale:

• En-tête Carte: Date/heure d'entrée avec icône de connexion
• Badge Entité: Badge coloré pour Client/Utilisateur/Invité
• Info Principale: Nom d'entité et plaque d'immatriculation (si disponible)
• Appareil: Nom de l'appareil d'entrée avec icône d'appareil
• Zone: Puce de zone codée par couleur
• Info Paiement: Montant de transaction et statut de paiement (Payé/Impayé)
• Étiquettes: Puces d'étiquettes codées par couleur
• Appuyer pour Étendre: Accéder aux détails complets et actions disponibles

États Chargement & Vide

• État de Chargement: Indicateur de progression circulaire avec message "Chargement des entrées..."
• État Vide: Message utile lorsqu'aucune entrée ne correspond aux filtres actuels
• État d'Erreur: Message d'erreur clair avec option de réessayer si le chargement des données échoue
• Zéro Résultat: Suggestions pour ajuster les filtres ou termes de recherche

Processus d'Exportation

1. Appliquer les filtres souhaités pour affiner l'ensemble d'entrées (optionnel)
2. Cliquer 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 barre de progression de téléchargement
5. Choisir l'emplacement d'enregistrement et confirmer le téléchargement

Format de Fichier: .xlsx (Excel 2007+)
Nommage: entries_export_[horodatage].xlsx
Permission: Nécessite permission canExportReports()

Colonnes de Données Exportées

• ID d'Entrée
• Date & Heure
• Type d'Entité (Client/Utilisateur/Invité)
• Nom d'Entité
• ID Client (si applicable)
• ID Utilisateur (si applicable)
• Nom & ID d'Appareil
• Numéro de Plaque d'Immatriculation
• Nom & ID de Zone
• Étiquettes (séparées par virgules)
• Nom & ID d'Entreprise/Société
• Montant de Transaction
• Devise
• Statut de Paiement (Payé/Impayé)
• Détails d'Entrée Supplémentaires

Meilleures Pratiques d'Exportation

• Filtrer Avant Export: Appliquez des filtres spécifiques pour obtenir exactement les données dont vous avez besoin
• Plages de Dates: Utilisez des plages de dates raisonnables pour gérer la taille du fichier
• Statut Paiement: Exportez les entrées impayées séparément pour suivi de facturation
• Rapports Client: Filtrez par client pour relevés de compte individuels
• Analyse Zone: Exportez par zone pour rapports d'occupation et d'utilisation
• Sauvegardes Régulières: Exportez les journaux d'entrée quotidiens/hebdomadaires pour conformité et récupération après sinistre
• Vérification Facturation: Exportez les entrées payées par plage de dates pour vérifier les revenus

Lignes Par Page

• Options: 10, 25, 50 ou 100 entrées par page
• Persistance: La sélection est automatiquement enregistrée dans les préférences utilisateur
• Clé de Préférence: EntriesRowsPerPage stocké via PreferencesHelper
• Performance: Des tailles de page plus grandes peuvent charger plus lentement sur les anciens appareils ou réseaux lents

Navigation de Page

• Première Page: Aller à la page 1 (double flèche gauche)
• Précédent: Reculer d'une page (flèche gauche simple)
• Numéros de Page: Cliquer sur un numéro de page spécifique pour aller directement
• Suivant: Avancer d'une page (flèche droite simple)
• Dernière Page: Aller à la dernière page (double flèche droite)
• Réinitialisation de Page: Retourne à la page 1 lorsque les filtres ou la recherche changent

Compteur d'Entrées

Format: "Affichage X-Y de Z entrées"

• X: Premier numéro d'entrée sur la page actuelle (ex., 1, 11, 26)
• Y: Dernier numéro d'entrée sur la page actuelle (ex., 10, 25, 50)
• Z: Total d'entrées correspondant aux filtres et recherche actuels

Opérations Quotidiennes

• Surveillez les entrées impayées chaque matin pour le suivi de facturation
• Examinez les entrées d'invités pour identifier les nouveaux clients potentiels
• Vérifiez les entrées d'aujourd'hui par zone pour surveiller les performances des barrières
• Comparez les comptes d'entrée aux comptes de sortie pour les écarts
• Exportez les journaux d'entrée quotidiens pour les rapports d'opérations

Gestion Facturation & Revenus

• Filtrez les entrées impayées par client pour rappels de paiement
• Utilisez plage de dates + statut payé pour vérifier les revenus quotidiens
• Exportez les entrées client pour relevés de compte
• Suivez les entrées de haute valeur (filtre montant transaction) pour services premium
• Surveillez les entrées à montant zéro pour auditer l'utilisation des passes

Analyse & Rapports

• Exportez les entrées par zone et date pour analyse d'occupation
• Filtrez par entreprise pour générer des rapports clients corporatifs
• Utilisez le filtre type d'entité pour séparer le trafic client vs invité
• Combinez les filtres appareil + date pour rapports d'utilisation de barrière
• Suivez les entrées étiquetées pour l'efficacité des promotions

Optimisation Recherche & Filtrage

• Utilisez des termes de recherche spécifiques (plaque, nom client) pour résultats les plus rapides
• Commencez avec des filtres larges (plage dates, zone) puis affinez
• Rappelez-vous que l'autocomplétion nécessite minimum 2 caractères
• Attendez que le délai de rebond de 300ms se termine avant de taper davantage
• Utilisez le menu déroulant appareil au lieu de la recherche pour sélection plus rapide
• Appliquez le filtre statut paiement avant la plage de montant pour meilleures performances

Conseils de Performance

• Utilisez toujours des filtres de plage de dates pour grands ensembles de données
• Limitez les recherches d'autocomplétion à 2-5 caractères pour meilleures performances
• Exportez les grands ensembles de données plutôt que de parcourir de nombreuses pages
• Fermez le panneau de filtres lorsqu'il n'est pas utilisé pour un meilleur espace d'écran
• Utilisez 10-25 lignes par page pour chargements initiaux plus rapides
• Actualisez périodiquement pour voir les dernières entrées