Opracować aplikację React Native na Androida dla lokalnego serwera systemu grupowych treningów

1. General Description

• Application Type: Cross-platform mobile application (Android) for tablets, developed in React Native.
• Purpose:  Management of group training systems in fitness studios (cycling, rowing, functional training, crossfit, martial arts, pilates) at the local level.
• Main Features:
  • Display of data from exercise machines (speed, power, cadence, heart rate) in real-time, obtained via ANT+ receiver.
  • Display of leaderboards, graphs, and other visual information for training participants, obtained from the central server.
  • Control of LED lighting (WLED API): on/off, brightness, color, effects, synchronization with music
  • Playback of music and video (from local server or YouTube or Vimeo).
  • Launching training scenarios obtained from the central server.
• Target Audience:  Fitness studio trainers.

2. Technical Requirements

• Platform:  Android 7.0 (API 24) and above
• Compatibility:  The application must be compatible with tablets from various manufacturers with a screen resolution of at least 1280x800 pixels.
• Development:
  • Programming Language: JavaScript (ES6+)
  • Framework: React Native
  • Libraries:
    • For working with the ANT+ protocol (e.g., react-native-antplus).
    • For interacting with the WLED API (e.g., axios).
    • For playing music and video (e.g., react-native-video, react-native-youtube-iframe).
    • State management: Redux, MobX, Zustand or Context API
    • Navigation: React Navigation
• Security:
  • Protection of the application from unauthorized access and modification.
  • Encryption of data stored on the device.
• Integration:
  • Interaction with the central server via REST API using HTTPS and JWT for authentication.
  • Broadcasting data to a projector via Wi-Fi Direct.

3. Functional Requirements

• Authorization:
  • Login to the application using a username and password obtained from the central server.
• Main Screen:
  • Display of a list of available trainings (synchronized with the central server).
  • Display of the training schedule.
  • Button for configuring the trainer's profile.
• Training Screen:
  • Display of data from exercise machines in real-time (speed, power, cadence, heart rate), obtained via ANT+ receiver.
  • Display of data in various formats, depending on the type of training (leaderboard, graphs, individual metrics).
  • Control of lighting (WLED): on/off, brightness, color, effects, synchronization with music.
  • Music control: selection of tracks from the local server or YouTube, play, pause, stop.
  • Video control: selection of videos from the video library (synchronized with the central server), play, pause, stop.
• Settings Screen:
  • Configuration of the trainer's profile.
  • Configuration of the connection with the ANT+ receiver.
  • Configuration of the connection with the WLED controller.
• Customization
  • The application must provide the ability to customize the training screen for each studio.
  • Customization Options:
    • Logo.
    • Color scheme.
    • Fonts.
    • (Optional) Placement of interface elements.

• Technical Implementation:

  • Storage of customization settings can be implemented locally on the device or on the central server (depending on your requirements).
  • For changing colors and fonts, themes can be used in React Native.
  • For configuring the placement of elements, flexible layouts (flexbox) can be used.

4. Non-Functional Requirements

• Performance:  The application must work quickly and smoothly, without delays and "freezes".
• Reliability:  The application must be stable and not "crash" during operation.
• Usability:  The application interface must be intuitive and convenient for the trainer.
• Design:  Modern and attractive interface design.

5. Additional Requirements

• Offline Mode:  The application must have the ability to work in offline mode when there is no internet connection, storing training data locally and providing limited functionality (see section 6).
• Data Synchronization:  When the internet connection is restored, the application must synchronize locally stored data with the central server.
• Broadcasting to Projector:  The application must have the ability to broadcast training data and video to a projector via Wi-Fi Direct.

6. Offline Mode

• The application must have the ability to work in offline mode (e.g., 24 hours, without connecting to the central server).
• In offline mode, the following functions must be available:
  • Launching training with a pre-loaded scenario.
  • Collecting data from exercise machines via ANT+.
  • Displaying training data on the tablet screen.
  • Controlling lighting (WLED).
  • Playing pre-loaded music and video.
• When the internet connection is restored, the application must synchronize locally stored data with the central server.