SibaqSync - Race Management App

A modern Flutter application for race management and timing with QR code scanning capabilities. Built following the MVP development roadmap with clean architecture and modern design principles.

🏃‍♂️ Features

✅ Implemented Features

🔐 Authentication & User Management

• Firebase email/password authentication
• Role-based access control (Organizer/Participant)
• User profile management
• Password reset functionality
• Secure user data storage
• Session management and auto-logout

🏁 Event Management

• Create and manage racing events
• Edit event details and schedules
• Event status tracking (Draft, Scheduled, Ongoing, Completed)
• Support for different event types (races, marathons, etc.)
• Event discovery and browsing
• Event lifecycle management

👥 Participant Management

• Individual participant registration
• Team registration and group management
• Participant status tracking (Registered, Running, Finished, DNF)
• Bib number assignment and management
• Bulk registration from CSV/Excel
• Advanced participant filtering and sorting
• Participant data validation and deduplication

🎖️ Dossard (Bib Number) Generation System

Fully Featured:

• Template Editor: Create custom dossard designs with visual editor
• Customizable Elements:
  • QR Codes (auto-generated per participant)
  • Bib Numbers (large, prominent display)
  • Participant Names
  • Organization Names
  • Categories/Age Groups
  • Custom Text
  • Custom Images and logos
• Template Management: Save, edit, and reuse templates
• Dynamic Generation:
  • Generate dossards for individual participants
  • Generate dossards by bib number range
  • Automatic QR code generation and embedding
  • Batch generation for all participants
• Multiple Export Formats:
  • Individual PNG files (separate files per dossard)
  • ZIP Archive (all dossards compressed)
  • PDF Document (2 dossards per page, print-ready)
• Customization Options:
  • Background image upload
  • Element positioning and sizing
  • Font selection and sizing
  • Color customization
  • Frame and border options

📱 QR Code System

• Dynamic QR code generation for each participant
• Real-time QR code scanning with camera integration
• Mobile scanner with barcode detection
• Secure QR code storage and retrieval
• Offline QR code reference support
• QR code display widgets
• QR code sharing capabilities

🚀 Real-time Features

• Live race results and rankings
• Real-time leaderboards with position updates
• Race progress tracking and notifications
• Manual participant finish entry
• QR scan-based finish detection
• Time tracking and performance metrics
• Finish time recording and validation

🏢 Organization Management

• Team creation and management
• Organization-level participant coordination
• Multi-event organization support
• Team-based registration and tracking
• Organization dashboard and analytics

📊 Data Export & Reporting

• CSV Export:
  • Customizable column selection
  • Participant data export
  • Race results export
  • Compatible with spreadsheet applications
• PDF Export:
  • Professional formatted reports
  • Race results with rankings
  • Participant information sheets
  • Print-ready formatting
  • Custom header and footer
• Excel Export: Direct Excel file generation
• ZIP Archive: Batch file packaging
• Results sharing functionality

🌐 Connectivity & Performance

• Offline capability with local caching
• Real-time Firebase synchronization
• Connectivity status monitoring (online/offline detection)
• Cached network image support
• Optimized data loading
• Data sync queue management

🎨 User Interface & Experience

• Material Design 3 implementation
• Custom theming system (Blue primary #2563EB, Emerald secondary #059669)
• Responsive design for all screen sizes
• Loading animations and progress indicators
• Toast notifications for user feedback
• Audio notifications support
• Google Fonts for modern typography
• Smooth navigation and transitions
• Empty state designs
• Error handling UI

🔊 Notifications & Feedback

• Toast notifications for actions and confirmations
• Audio notifications for race events
• User preference management
• Snackbar feedback
• Dialog confirmations

📱 Platform Support

• ✅ iOS (iOS 12.0+)
• ✅ Android (API 21+)
• ✅ Web (Chrome, Safari, Firefox)
• ✅ macOS (macOS 10.14+)
• ⚠️ Windows/Linux (Limited support)

---

🔄 In Progress/Future Features

📜 Digital Certificate Generator (Planned)

• Features Coming Soon:
  • Certificate template designer
  • Customizable certificate layouts
  • Participant achievement recognition
  • Digital signature support
  • Certificate generation on race completion
  • Multi-format export (PDF, PNG, etc.)
  • Email delivery integration
  • Print-ready certificate generation

📡 Live Stream Integration (Planned)

• Live race monitoring
• Real-time viewer engagement
• Race highlights and replays

🔔 Push Notifications (Planned)

• Participant alerts
• Race start/finish notifications
• Leaderboard updates
• Important announcements

🗺️ Route Tracking (Planned)

• GPS route mapping
• Course visualization
• Participant location tracking
• Route analytics