Overview
The Events page provides a comprehensive log of all activities across your parking facility. Track entries, exits, payments, errors, warnings, and informational events in real-time. With powerful filtering and search capabilities, you can quickly find specific events, analyze patterns, and generate detailed reports for operations, compliance, and troubleshooting.
Key Features:
- Complete Event Log: Track all facility activities including entries, exits, payments, and system events
- Full-Text Search: Search across event descriptions, device names, customer names, and more
- Advanced Filtering: 10+ filter criteria including event type, entity type, dates, devices, users, customers, businesses, access cards, tags, and zones
- AJAX Autocomplete: Smart search for users, customers, businesses, and access cards with debounced queries
- Event Categorization: Filter by event type (Information, Entry, Exit, Paid, Error, Warning)
- Export Capabilities: Download filtered event data to Excel for analysis (permission-based)
- Responsive Design: Card view on mobile/tablet, table view on desktop
- Pagination Control: Customize rows per page (10, 25, 50, 100) with preference persistence
- Date Caching: Optimized performance with pre-parsed event dates
Interface Layout
The Events page is organized for efficient event tracking and analysis.
Header Section
- Page Title: "Events" with event note icon
- Description: "Event History" subtitle
- Search Bar: Quick search across all event fields
- Action Buttons: Export (permission-based), Refresh, and Filters toggle (permission-based)
Mobile: Elements stack vertically
Desktop/Tablet: Horizontal row with right-aligned actions
Filter Panel (Right Sidebar)
- Animation: Smooth 300ms slide-in from right side
- Width: 340px fixed width with vertical scroll
- Sections: Event Type, Entity Type, Period, Users, Customers, Devices, Access Cards, Businesses, Tags, Zones
- Actions: Reset and Apply buttons at bottom
- Permission: Requires canFilterEvents() permission
Event List & Pagination
- Desktop View: Data table (width > 1024px)
- Mobile/Tablet View: Card layout (width ≤ 1024px)
- Pagination Bar: Bottom bar with counter, rows per page selector, and page navigation
- Max Pages: Supports up to 99,999,999 pages
Search & Quick Filters
Quickly locate events using the search bar or open the filter panel for advanced filtering.
Search Bar Functionality
- Searchable Fields: Event descriptions, device names, customer names, user names, event messages
- Real-Time Search: Results update automatically as you type
- Case Insensitive: Search works regardless of letter casing
- Partial Matching: Find events with incomplete information
Examples: "entry" for entries, "payment failed" for errors, "Terminal 2" for device events
Action Buttons
- Export: Download filtered results to Excel (requires canExportReports permission)
- Refresh: Reload event data to see latest activities
- Filters: Toggle advanced filter panel (requires canFilterEvents permission)
Desktop: Text buttons with icons | Mobile/Tablet: Icon-only buttons
Event Type Filters
Filter events by their type to focus on specific activity categories.
Available Event Types
- ● Information: Informational events (system updates, routine operations)
- ● Entry: Vehicle or person entering facility
- ● Exit: Vehicle or person exiting facility
- ● Paid: Payment transactions completed
- ● Error: System errors and failures
- ● Warning: Warning conditions requiring attention
Multi-Select: Select multiple event types simultaneously to view combined results.
Use Cases by Event Type
- Entry + Exit: Track facility traffic flow and occupancy patterns
- Paid: Monitor payment activity and revenue generation
- Error + Warning: Identify and troubleshoot system issues
- Information: Review routine system operations and updates
Entity Type Filters
Filter events by the type of entity (person/account) involved in the event.
Entity Type Categories
- ● Customer: Registered customers with accounts and subscriptions
- ● User: System users (staff, administrators, operators)
- ● Guest: Unregistered visitors or anonymous users
Date Range Filter
- Start Date: Beginning of date range (inclusive)
- End Date: End of date range (inclusive)
- Date Picker: Calendar interface for easy selection
- Range: From 2020 to current date
- Display Format: DD/MM/YYYY
Common Filtering Scenarios
- Customer + Entry: Track registered customer arrivals
- Guest + Paid: Monitor guest payment transactions
- User + Error: Review staff-related system issues
- All Types + Date Range: Generate daily/weekly/monthly activity reports
Advanced Filters
Use advanced filters to narrow down events by users, customers, devices, businesses, access cards, tags, and zones.
AJAX Autocomplete Filters
These filters use intelligent search with debounced queries (300ms delay) for optimal performance:
- Users: Search system users by name (minimum 2 characters)
- Customers: Search registered customers by name (minimum 2 characters)
- Access Cards: Search access cards by username (minimum 2 characters)
- Businesses: Search companies/organizations by name (minimum 2 characters)
How It Works:
- Type at least 2 characters in the search field
- System waits 300ms for you to finish typing
- Loading indicator appears during search
- Results populate automatically (max 25 items)
- Select one or multiple items
- Selected items appear as chips with remove option
Multi-Select Dropdown Filters
- Devices: Select from all available devices (pre-loaded, max 1000)
- Tags: Select custom tags with color indicators
- Zones: Select parking zones with color indicators
All dropdown filters support multi-selection and display selected items as removable chips.
Filter Combinations
Combine multiple filters for precise event analysis:
- Device + Error Type: Troubleshoot specific device issues
- Customer + Entry/Exit: Track individual customer activity
- Zone + Date Range: Analyze zone-specific traffic patterns
- Business + Paid Events: Generate company billing reports
- Access Card + Entry: Audit access card usage
- Tag + Any Event Type: Track events by custom categories
Event List Views
Events display differently based on screen size for optimal viewing experience.
Desktop Table View (width > 1024px)
Full data table with columns for comprehensive event information:
| Column | Description |
|---|---|
| Date/Time | Event timestamp |
| Event Type | Category (Entry, Exit, Paid, Error, etc.) |
| Entity Type | Customer, User, or Guest |
| Entity Name | Customer/User name or "Guest" |
| Device | Device that generated the event |
| Description | Event message and details |
| Zone/Tags | Associated zone and tags |
| Actions | View details, related records |
Mobile/Tablet Card View (width ≤ 1024px)
Events displayed as cards for touch-friendly navigation:
- Card Header: Event type icon with color coding and timestamp
- Entity Info: Entity type badge and name
- Device Badge: Device name with icon
- Description: Event message text
- Zone/Tags: Color-coded chips for zones and tags
- Tap to Expand: View full details and available actions
Loading & Empty States
- Loading State: Progress indicator with "Loading events..." message
- Empty State: Helpful message when no events match filters
- Error State: Clear error message with retry option
- Date Cache: Pre-parsed dates improve filter performance on large datasets
Export Data to Excel
Export filtered event data to Excel for external analysis, reporting, and record-keeping.
Export Process
- Apply desired filters to narrow down event set (optional)
- Click the "Export" button in the header area
- System generates Excel file with all current filters applied
- Excel save dialog appears with download progress
- Choose location and save file to your computer
File Format: .xlsx (Excel 2007+)
Naming: events_export_[timestamp].xlsx
Permission: Requires canExportReports() permission
Exported Data Columns
- Event ID
- Date & Time
- Event Type (Entry, Exit, Paid, Error, Warning, Information)
- Entity Type (Customer, User, Guest)
- Entity Name
- Customer ID (if applicable)
- User ID (if applicable)
- Device Name
- Device ID
- Access Card Username
- Access Card ID
- Business/Company Name
- Zone Name
- Tags (comma-separated)
- Event Description
- Additional Details
Export Best Practices
- Filter Before Export: Apply filters to get exactly the data you need
- Date Range Limits: Use reasonable date ranges to manage file size
- Event Type Focus: Export specific event types for targeted analysis
- Regular Backups: Export daily/weekly event logs for compliance
- Device Reports: Export device-specific events for maintenance logs
- Customer Reports: Export customer events for billing and support
Pagination Controls
Navigate through large event sets efficiently with pagination controls at the bottom of the page.
Rows Per Page
- Options: 10, 25, 50, or 100 events per page
- Persistence: Selection saved to preferences automatically
- Performance: Larger page sizes may load slower on older devices
Page Navigation
- First Page: Jump to page 1 (|◄)
- Previous: Go back one page (◄)
- Page Numbers: Click specific page to jump directly
- Next: Advance one page (►)
- Last Page: Jump to final page (►|)
- Max Pages: Supports up to 99,999,999 pages
Event Counter
Format: "Showing X-Y of Z events"
- X: First event number on current page
- Y: Last event number on current page
- Z: Total events matching current filters
Best Practices & Tips
Daily Event Monitoring
- Review error and warning events each morning
- Check entry/exit ratios to ensure proper gate operation
- Monitor payment events for transaction failures
- Use date filter set to "Today" for current day activity
- Export daily event logs for compliance records
Troubleshooting with Events
- Filter by device + error type to isolate hardware issues
- Use customer filter to investigate specific complaints
- Check warning events before they escalate to errors
- Compare entry/exit events to identify gate malfunctions
- Review access card events for security auditing
Analytics and Reporting
- Export entry events by zone to analyze traffic patterns
- Filter by customer + paid events for billing reconciliation
- Use business filter to generate company-specific reports
- Combine zone + date range for occupancy analysis
- Track user events for staff activity monitoring
Search Optimization
- Use specific search terms for faster autocomplete results
- Apply filters before searching to narrow result sets
- Remember autocomplete requires minimum 2 characters
- Wait for debounce delay (300ms) to complete typing
- Use device dropdown instead of search for faster selection
Performance Tips
- Always use date range filters for large datasets
- System caches parsed dates for faster filtering
- Limit autocomplete searches to 2-5 characters for best results
- Export large datasets rather than paginating through many pages
- Close filter panel when not in use for better screen space
- Refresh page periodically to see latest events
