Entries Management

Header Section

• Page Icon: Login icon in cyan-tinted circle
• Title: "Entries" with subtitle "Entries History"
• Search Bar: Full-text search with placeholder "Search Entry"
• Action Buttons: Export (permission-based), Refresh, Filters (permission-based)
• Bottom Border: 1px divider on mobile/tablet for visual separation

Mobile (≤768px): Vertical stack with icon+title row, then search+buttons row
Desktop/Tablet (>768px): Horizontal row with right-aligned actions

Filter Panel (Right Sidebar)

• Width: 320px fixed width with vertical scroll
• Animation: Smooth 300ms slide-in from right (Curves.easeInOut)
• Position: Overlays content from right side, bottom: 64px (above pagination bar)
• Sections: Customers, Users, Businesses, Devices, Tags, Zones, Date Range, Type, Transaction Amount, Payment Status
• Actions: Reset (outlined button) and Apply (primary button) at bottom
• Permission: Requires canFilterEntries() permission

Entry List & Pagination

• Mobile/Tablet View: Card layout (width ≤1200px)
• Desktop View: Data table (width >1200px)
• Pagination Bar: Fixed 64px height at bottom with counter, rows selector, and navigation
• Loading State: Progress indicator during data fetch

Search Functionality

• Searchable Fields: Entry IDs, customer names, user names, device names, license plates, transaction details
• Real-Time Results: Updates automatically as you type
• Case Insensitive: Searches work regardless of capitalization
• Partial Matching: Find entries with incomplete search terms
• Page Reset: Returns to page 1 when new search is performed

Examples: "ABC-123" for license plate, "John Doe" for customer, "Gate 1" for device

Action Buttons

• Export: Download filtered entries to Excel (requires canExportReports permission)
• Refresh: Reload entry data to see latest records
• Filters: Open advanced filter panel (requires canFilterEntries permission)

Desktop (>1024px): Text buttons with icons
Mobile/Tablet (≤1024px): Icon-only circular buttons

AJAX Autocomplete Filters

These filters provide intelligent search with debounced queries for optimal performance:

• Customers: Search registered customers by name (minimum 2 characters)
• Users: Search system users by name (minimum 2 characters)
• Businesses: Search companies/organizations by name (minimum 2 characters)

How Autocomplete Works:

1. Type at least 2 characters in the search field
2. System waits 300ms for you to finish typing (debounce delay)
3. Loading spinner appears in field during search
4. Results populate automatically (maximum 25 items per search)
5. Select one or multiple items from dropdown
6. Selected items appear as removable chips above field

Multi-Select Dropdown Filters

• Devices: Select from all available entry devices (pre-loaded, max 1000 devices)
• Tags: Select custom tags with color indicators for visual organization
• Zones: Select parking zones with color indicators

All dropdown filters support multiple selections and display selected items as removable chips. Devices, tags, and zones are pre-loaded on page initialization for instant selection.

Date Range Filter

• Start Date: Beginning of date range (inclusive)
• End Date: End of date range (inclusive)
• Date Picker: Calendar interface for easy date selection
• Range: From 2020 to current date
• Display Format: DD/MM/YYYY
• Default: Shows "Not Set" when no date selected

Use Cases: Daily reports (today only), weekly analysis (7-day range), monthly billing (1st to last day of month), custom periods for special events

Entity Type Filter

Filter entries by the type of entity (person/account) entering the facility:

• ● Customer: Registered customers with accounts, subscriptions, or parking passes
• ● User: System users including staff, administrators, and operators
• ● Guest: Unregistered visitors, one-time users, or anonymous entries

Multi-Select: Choose one or more entity types to analyze different user segments simultaneously.

Transaction Amount Range

• Minimum Amount: Filter entries with transactions greater than or equal to this value
• Maximum Amount: Filter entries with transactions less than or equal to this value
• Input Type: Numeric fields accept decimal values (e.g., 5.50, 10.00)
• Currency: Uses system default currency
• Optional: Leave blank to ignore amount filtering

Examples: Min: 0, Max: 10 (small transactions), Min: 50 (high-value entries), Min: 0, Max: 0 (free entries)

Payment Status Filter

• ● All: Show all entries regardless of payment status
• ● Paid: Only entries with completed payment transactions
• ● Unpaid: Only entries with pending or failed payments

Single Select: Choose one payment status option from the dropdown.

Common Filtering Scenarios

• Unpaid Entries + Customer: Identify customers with outstanding payments
• Paid + Amount Range: Analyze revenue by transaction size
• Unpaid + Date Range: Find aging receivables
• Amount = 0 + Status All: Review free entry usage (passes, staff, etc.)
• High Amount + Paid: Track premium parking or special event revenue

Desktop Table View (width > 1200px)

Full data table with columns for comprehensive entry information:

Mobile/Tablet Card View (width ≤ 1200px)

Entries displayed as expandable cards for touch-friendly interaction:

• Card Header: Entry date/time with login icon
• Entity Badge: Colored badge for Customer/User/Guest
• Main Info: Entity name and license plate (if available)
• Device: Entry device name with device icon
• Zone: Color-coded zone chip
• Payment Info: Transaction amount and payment status (Paid/Unpaid)
• Tags: Color-coded tag chips
• Tap to Expand: Access full details and available actions

Loading & Empty States

• Loading State: Circular progress indicator with "Loading entries..." message
• Empty State: Helpful message when no entries match current filters
• Error State: Clear error message with retry option if data fails to load
• Zero Results: Suggestions to adjust filters or search terms

Export Process

1. Apply desired filters to narrow down entry set (optional)
2. Click the "Export" button in the header area
3. System generates Excel file with all current filters applied
4. Excel save dialog appears with download progress bar
5. Choose save location and confirm download

File Format: .xlsx (Excel 2007+)
Naming: entries_export_[timestamp].xlsx
Permission: Requires canExportReports() permission

Exported Data Columns

• Entry ID
• Date & Time
• Entity Type (Customer/User/Guest)
• Entity Name
• Customer ID (if applicable)
• User ID (if applicable)
• Device Name & ID
• License Plate Number
• Zone Name & ID
• Tags (comma-separated)
• Business/Company Name & ID
• Transaction Amount
• Currency
• Payment Status (Paid/Unpaid)
• Additional Entry Details

Export Best Practices

• Filter Before Export: Apply specific filters to get exactly the data you need
• Date Ranges: Use reasonable date ranges to manage file size
• Payment Status: Export unpaid entries separately for billing follow-up
• Customer Reports: Filter by customer for individual account statements
• Zone Analysis: Export by zone for occupancy and utilization reports
• Regular Backups: Export daily/weekly entry logs for compliance and disaster recovery
• Billing Verification: Export paid entries by date range to verify revenue

Rows Per Page

• Options: 10, 25, 50, or 100 entries per page
• Persistence: Selection automatically saved to user preferences
• Preference Key: EntriesRowsPerPage stored via PreferencesHelper
• Performance: Larger page sizes may load slower on older devices or slow networks

Page Navigation

• First Page: Jump to page 1 (double arrow left)
• Previous: Go back one page (single arrow left)
• Page Numbers: Click specific page number to jump directly
• Next: Advance one page (single arrow right)
• Last Page: Jump to final page (double arrow right)
• Page Reset: Returns to page 1 when filters or search changes

Entry Counter

Format: "Showing X-Y of Z entries"

• X: First entry number on current page (e.g., 1, 11, 26)
• Y: Last entry number on current page (e.g., 10, 25, 50)
• Z: Total entries matching current filters and search

Daily Operations

• Monitor unpaid entries each morning for billing follow-up
• Review guest entries to identify potential new customers
• Check today's entries by zone to monitor gate performance
• Compare entry counts to exit counts for discrepancies
• Export daily entry logs for operations reports

Billing & Revenue Management

• Filter unpaid entries by customer for payment reminders
• Use date range + paid status to verify daily revenue
• Export customer entries for account statements
• Track high-value entries (transaction amount filter) for premium services
• Monitor zero-amount entries to audit pass usage

Analytics & Reporting

• Export entries by zone and date for occupancy analysis
• Filter by business to generate corporate client reports
• Use entity type filter to separate customer vs guest traffic
• Combine device + date filters for gate utilization reports
• Track tagged entries for promotion effectiveness

Search & Filter Optimization

• Use specific search terms (license plate, customer name) for fastest results
• Start with broad filters (date range, zone) then narrow down
• Remember autocomplete requires minimum 2 characters
• Wait for 300ms debounce to complete before typing more
• Use device dropdown instead of search for quicker selection
• Apply payment status filter before amount range for better performance

Performance Tips

• Always use date range filters for large datasets
• Limit autocomplete searches to 2-5 characters for best performance
• Export large datasets rather than browsing many pages
• Close filter panel when not in use for better screen real estate
• Use 10-25 rows per page for faster initial loads
• Refresh periodically to see latest entries