# palachzzz/wheellogandroid architecture

> Architecture diagram of the GitHub repository palachzzz/wheellogandroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/palachzzz/wheellogandroid
- Repository: https://github.com/palachzzz/wheellogandroid

## Overview

##### Main Components
- Mobile Frontend (Android UI)
- This includes Activity classes (e.g., MainActivity, ScanActivity), fragments (e.g., MainPreferencesFragment), and view components (in the “views” and “presentation” packages).
- Resource files for layouts, drawables, strings, and other UI assets are located under app/src/main/res.
- Core Services and Utilities
- Services such as BluetoothLeService, LoggingService, and other utility classes (Constants, FileUtil, MathsUtil) form the application’s core functionality.
- These handle data acquisition from sensors, logging, and processing.
- External Integration Modules
- Specific integrations for different platforms: GarminConnectIQ, PebbleService, GearService, and specific adapters for Gotway, InMotion, Kingsong, Ninebot (and NinebotZ).
- These modules enable connectivity with external accessories and watches.
- Data/Library Components
- The app/libs folder includes JAR files like accessory-v2.5.1.jar, connectiq.jar, and sdk-v1.0.0.jar which provide external SDKs or libraries necessary for interfacing with the hardware or third-party services.
- Build and Configuration Components
- Gradle files, .gitignore, and GitHub Actions workflows (.github/workflows) are used for build automation and continuous integration.

##### Out the Relationships and Interactions
- The Android UI layer interacts with the service layer to trigger data collection (e.g., initiating Bluetooth scans or logging operations).
- The BluetoothLeService and other background services provide data from external sensors. The processed data is then fed into the LoggingService which may save data locally or forward it for further processing.
- The connectivity modules (GarminConnectIQ, PebbleService, GearService) are separate integration points that allow the mobile app to communicate with various wearable devices.
- The adapters (GotwayAdapter, InMotionAdapter, KingsongAdapter, NinebotAdapter, NinebotZAdapter) abstract details specific to different hardware types and allow the LoggingService or related components to handle various device protocols.
- A configuration or settings layer (files like preferences.xml, Preferences fragments) enables the user to customize which service or adapter to use and to set parameters.

##### Architectural Patterns
- MVC/MVP or a clear separation between UI (Activities, Fragments) and the Service/Business logic (Bluetooth services, logging services, and external integrations).
- Modularity through distinct packages that separate core functionality (services, utilities) from presentation or integration-specific code.
- Dependency on third-party libraries (via the libs folder) that extend functionality to external devices.
- Use of Gradle for building and continuous integration workflows as seen in the .github folder and gradle wrapper files.

##### Technologies and Frameworks
- Android SDK – leveraging components such as Activities, Services, Broadcast Receivers.
- Gradle – for build automation and dependency management.
- External SDKs from the JAR files (accessory, connectiq, sdk) for integrations with wearables and accessories.
- Native Android resource management (res folders for layouts, values, etc.) indicating strong adherence to Android app development conventions.

##### Specific Elements
- Use clear labels for each component:

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Mobile Frontend (Android UI)
    subgraph "Mobile Frontend (Android UI)"
        A["MainActivity"]:::ui
        B["ScanActivity"]:::ui
        C["MainPreferencesFragment"]:::ui
        D["Custom UI Components"]:::ui
        E["Presentation Layer"]:::ui
        E2["Presentation Preferences"]:::ui
        F["UI Resources"]:::ui
    end

    %% Core Services and Utilities
    subgraph "Core Services & Utilities"
        G["BluetoothLeService"]:::service
        H["LoggingService"]:::service
        I["GoogleDriveService"]:::service
        J["Utilities"]:::service
    end

    %% External Integration Modules
    subgraph "External Integration Modules"
        K["GarminConnectIQ"]:::integration
        L["PebbleService"]:::integration
        L1["PebbleBroadcastReceiver"]:::integration
        M["GearService"]:::integration
        M1["GearSAPServiceProviderConnection"]:::integration
        subgraph "Adapter Modules"
            N1["GotwayAdapter"]:::adapter
            N2["InMotionAdapter"]:::adapter
            N3["KingsongAdapter"]:::adapter
            N4["NinebotAdapter"]:::adapter
            N5["NinebotZAdapter"]:::adapter
        end
    end

    %% External Libraries / SDKs
    O["External SDK Libraries"]:::library

    %% Build and Configuration Components
    P["Build & Config"]:::build

    %% Relationships
    %% UI interactions with Core Services
    A -->|"triggers"| G
    B -->|"triggers"| G
    C -->|"updates"| H
    D -->|"updates"| H
    E -->|"updates"| H
    E2 -->|"updates"| H
    F -->|"renders"| A

    %% Core Services interactions
    G -->|"provides data"| H
    I -->|"syncs data"| H
    J -->|"supports"| H

    %% Core Services to External Integration
    H -->|"sync"| K
    H -->|"notify"| L
    H -->|"notify"| M
    H -->|"routes"| N1
    H -->|"routes"| N2
    H -->|"routes"| N3
    H -->|"routes"| N4
    H -->|"routes"| N5

    %% External Libraries dependency
    O -->|"dependency"| K
    O -->|"dependency"| L
    O -->|"dependency"| M
    O -->|"dependency"| N1
    O -->|"dependency"| N2
    O -->|"dependency"| N3
    O -->|"dependency"| N4
    O -->|"dependency"| N5

    %% Build process affecting all layers
    P -->|"builds"| A
    P -->|"builds"| B
    P -->|"builds"| C
    P -->|"builds"| G
    P -->|"builds"| H
    P -->|"builds"| K

    %% Click Events for Mobile Frontend
    click A "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/MainActivity.java"
    click B "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/ScanActivity.java"
    click C "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/MainPreferencesFragment.java"
    click D "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/java/com/cooper/wheellog/views"
    click E "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/java/com/cooper/wheellog/presentation"
    click E2 "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/java/com/cooper/wheellog/presentation/preferences"
    click F "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/res"

    %% Click Events for Core Services and Utilities
    click G "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/BluetoothLeService.java"
    click H "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/LoggingService.java"
    click I "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/GoogleDriveService.java"
    click J "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/java/com/cooper/wheellog/utils"

    %% Click Events for External Integration Modules
    click K "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/GarminConnectIQ.java"
    click L "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/PebbleService.java"
    click L1 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/PebbleBroadcastReceiver.java"
    click M "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/GearService.java"
    click M1 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/GearSAPServiceProviderConnection.java"
    click N1 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/utils/GotwayAdapter.java"
    click N2 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/utils/InMotionAdapter.java"
    click N3 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/utils/KingsongAdapter.java"
    click N4 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/utils/NinebotAdapter.java"
    click N5 "https://github.com/palachzzz/wheellogandroid/blob/master/app/src/main/java/com/cooper/wheellog/utils/NinebotZAdapter.java"

    %% Click Event for External Libraries
    click O "https://github.com/palachzzz/wheellogandroid/tree/master/app/src/main/libs"

    %% Click Event for Build and Configuration
    click P "https://github.com/palachzzz/wheellogandroid/blob/master/app/build.gradle"

    %% Styles
    classDef ui fill:#FFCC00,stroke:#333,stroke-width:2px;
    classDef service fill:#66CCFF,stroke:#333,stroke-width:2px;
    classDef integration fill:#CC99FF,stroke:#333,stroke-width:2px;
    classDef adapter fill:#CC66FF,stroke:#333,stroke-width:2px;
    classDef library fill:#99FF99,stroke:#333,stroke-width:2px;
    classDef build fill:#FF9999,stroke:#333,stroke-width:2px;
```
