- Create GAME_FLOW_DIAGRAM.md with detailed visual representations of:
  * Complete match lifecycle state machine (scheduled → bet → ingame → completed)
  * Component interaction diagrams showing system architecture
  * Betting system flow from customer request to receipt generation
  * Timer and automation sequences with priority logic
  * Extraction process flow with redistribution cap logic
  * Error handling and recovery scenarios
  * Performance and scalability visualizations
- Include timing sequences, global betting mode comparisons, and bottleneck analysis

- Create USER_WORKFLOW_DOCUMENTATION.md with extensive coverage of:
  * Complete cashier workflow from login to end-of-day procedures
  * Game flow and match progression with state machine details
  * Extraction algorithm and redistribution cap system
  * Major functionality and configuration options
- Add statistics.html template for admin statistics dashboard
- Update core components for improved functionality

- Remove duplicate start_games function in routes.py that was causing Flask route conflict
- Add Statistics page link to admin submenu in navbar with chart-bar icon

- Add /api/cashier/start-games endpoint to routes.py that sends START_GAME message to message bus
- Complete betting system with win_amount calculation and paid_out tracking
- Update bet resolution logic for UNDER/OVER outcomes
- Add comprehensive result extraction with CAP logic
- Enhance match timer and games thread coordination
- Update verification pages to show proper win amounts and payout status

- Remove automatic PLAY_VIDEO_MATCH sending from MatchTimerComponent
- Add MATCH_START handler to GamesThread with betting calculation logic
- Update Message Builder to include result parameter in PLAY_VIDEO_MATCH messages
- Update Qt Player to use match_video.html template for match videos
- Add new match_video.html overlay template for displaying match results

The new flow: Start Games -> MATCH_START -> betting calculation -> PLAY_VIDEO_MATCH with result -> display match video with result overlay

- Extend help panel visibility from 5 to 10 seconds
- Add 'h' key toggle to reopen minimized help panel on all pages
- Fix 'h' key functionality on bet list pages (bets.html, admin_bets.html)
- Add keyboard help panel to bet verification pages
- Improve user experience with consistent keyboard shortcuts across all pages

- Press 'v' or 'V' from bets list pages to go to verification
- ESC key from verification pages goes back to bets list
- Ensure barcode input focus on verification pages
- Applied to both admin and cashier interfaces

- Enter key prints the ticket directly
- Esc key goes back to bet list
- Applied to both cashier and admin bet details pages
- Simplified bet submission to just Enter (no Ctrl+Enter required)

- ESC key now clears all input amounts in the closed match panel
- TAB navigation maintains input values for continued betting
- ESC acts as proper 'cancel' operation while TAB is navigation-only
- Applied to both cashier and admin new bet pages

- After digits+Enter to select match, scroll to the match panel
- When TAB navigates to outcomes, focus goes directly to input field
- ESC key closes match panel without requiring Enter, allowing selection of another match
- Applied changes to both cashier and admin new bet pages

- Add keyboard navigation to /bets and /bets/new pages (admin and cashier)
- Add keyboard navigation to /cashier/verify-bet page with auto-focus
- Implement conditional QR code and barcode printing based on settings
- Remove fist icon and MBETTER title from printed receipts
- Remove FIXTURE, ITEMS, and STATUS lines from receipts
- Add python-barcode dependency for barcode generation
- Update PyInstaller build script with barcode imports
- Apply receipt changes to all bet list and detail pages

- Correct parameter order in frontend JavaScript API calls
- Add detailed logging for all association operations (create, remove, bulk save)
- Log user context, operation details, and validation errors
- Fix parameter mapping: outcome_name (source) -> extraction_result (target)
- Update logging to correctly show association mappings
- Add logging for association validation and duplicate detection

- Fixed displayAssociations() and createOutcomeColumns() functions to properly group associations by extraction_result instead of outcome_name
- This ensures all extraction associations are correctly displayed in their respective columns in the extraction management interface

- Remove the entire 'Current Associations Summary' card section
- Remove updateAssociationsSummary() JavaScript function
- Update error handling to remove references to associations-summary element
- Clean up the page layout for better focus on the main functionality

- Fix getDropTarget function to properly detect drops on column bodies
- Allow dropping on any element within the column body area
- Ensure drag and drop associations work correctly

- Remove 'Drop outcomes here to create association columns' from Results area
- Change 'Drag bets to UNDER/OVER or Results areas' to 'Drag bets to UNDER/OVER or Results associations area'

- Rename 'Available Outcomes' to 'Available Bets' in admin interface
- Add database tables for available_bets and result_options
- Implement CRUD operations for managing bets and result options
- Update extraction page UI with add/delete functionality
- Implement drag-and-drop associations between bets and results
- Add database persistence for all associations
- Remove X buttons from result association columns for cleaner UI
- Update terminology throughout for clarity

- Add AvailableBetModel with is_active and sort_order fields
- Create Migration_023_AddAvailableBetsTable with default betting options
- Add API endpoints for CRUD operations on available bets
- Update extraction page UI with add/delete functionality
- Update JavaScript to load from available_bets table instead of hardcoded outcomes
- Add modal dialog for adding new bet options
- Add delete buttons to each bet item in the UI

- Release database session before ZIP downloads to prevent locking
- Process all match data first, then download ZIP files separately
- This prevents database locks during potentially slow ZIP downloads
- Allows other database operations to proceed between different ZIP downloads
- Maintains proper error handling and heartbeat updates during downloads

- Set default API access token to gtW82Ejr8LySk2PFVRefn-HEWG5NrowsHaDCht2yPGo
- Change default FastAPI server URL to https://mbetter.nexlab.net/
- Update default request interval to 600 seconds (10 minutes)
- Update settings across config template, routes, and settings.py

- Add new QR code settings section in admin/configurations page
- QR codes disabled by default in database on creation
- Include size, error correction level, and display options
- Add API endpoints for QR code configuration management
- Update barcode settings to be enabled by default
- Add JavaScript handlers for QR code settings with validation
- Create database migration for QR code configuration settings

- Reduce PyInstaller binary libraries to eliminate segfaults:
  * Remove 25+ unnecessary X11/GL libraries from build.py
  * Keep only essential libraries: libxcb.so.1 and libX11.so.6
  * Update mbetter_discovery_linux.spec with minimal libraries
  * Remove qt.conf and platforms directory copying for self-contained binary

- Clean up codebase by removing unused files:
  * Remove qt6_player.py (unused duplicate implementation)
  * Remove temp_js.js and extract_js.py (utility files)
  * Remove hook-pyqt6.py and runtime_hook.py (disabled/unnecessary)

- Enhance build scripts:
  * Update MbetterClient_wrapper.sh with video safety measures
  * Update clean.sh to preserve .exe files while removing artifacts
  * Add comprehensive error handling for virtualized environments

- Restore important assets:
  * Restore dist/MBetterDiscovery.exe from git repository

Result: Self-contained binary with reduced library conflicts, better compatibility across Linux distributions and virtualized environments.

- Detect Mesa software rendering in OverlayWebView.setup_web_view()
- Apply Mesa-specific transparency settings using CSS rgba() instead of Qt alpha
- Update overlay window transparency for Mesa compatibility
- Add Mesa transparency environment variables to wrapper script
- Use composition-based transparency for Mesa instead of native transparency
- Maintain hardware transparency for non-Mesa environments

- Add comprehensive ffmpeg-python hidden imports to build.py and PyInstaller specs
- Include ffmpeg._run, ffmpeg._utils, ffmpeg.nodes, ffmpeg.streams, ffmpeg.filter modules
- Create MbetterClient_wrapper.sh for automatic virtualization detection
- Apply Mesa software rendering with transparency optimizations for VMs
- Fix VMware vmwgfx_dri.so crashes and Chromium shared memory permission errors
- Disable Vulkan extensions that cause VK_KHR_video_decode_queue errors
- Enable hardware acceleration detection for optimal performance on physical hardware

- Add QTWEBENGINE_DISABLE_SANDBOX=1 environment variable to all Qt WebEngine files
- Suppress Chromium sandbox warnings when running as root user
- Applied to: qt6_player.py, player.py, overlay_url_handler.py
- Environment variable set before any Qt imports to ensure effectiveness

- Add UDP broadcast component that sends server info every 30 seconds
- Create Qt6 discovery application for LAN server detection
- Fix Migration 012 column count mismatch by adding missing status column
- Suppress Chromium sandbox warnings when running as root
- Add PyInstaller specs for Linux and Windows executables
- Update requirements.txt with netifaces dependency
- Create comprehensive documentation and setup scripts

Features:
- Automatic server discovery on local network
- Cross-platform support (Linux/Windows)
- System tray integration
- Auto-open browser functionality
- SSL detection and support
- Standalone executable builds

- Created create_icon.py script to generate network/discovery-themed icon
- Generated mbetter_discovery_icon.ico with multiple sizes (16x16 to 256x256)
- Updated Windows PyInstaller spec to use the icon
- Enhanced setup_discovery.py to automatically create icon during build
- Added icon preview PNG file for development reference

The icon features:
- Blue circular background with network theme
- Concentric radar circles representing discovery
- Signal waves for larger icon sizes
- Professional Windows executable appearance