# ge0rg/aprsdroid architecture

> Architecture diagram of the GitHub repository ge0rg/aprsdroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ge0rg/aprsdroid
- Repository: https://github.com/ge0rg/aprsdroid

## Overview

##### Main Components

a. Core Application Layer:
- Main activities (HubActivity, MainListActivity, MapAct, etc.)
- Preferences and settings management system (PrefsAct, PrefsWrapper)

b. Data Management Layer:
- StorageDatabase component for local data persistence
- Message handling system (MessageService, MessageActivity)
- Station management (StationActivity, StationHelper)

c. APRS Protocol Layer:
- Different TNC protocols (tncproto package)
- APRS packet handling (AprsPacket, AprsService)
- Protocol implementations (AprsIsProto, KenwoodProto, KissProto, Tnc2Proto)

d. Backend Systems:
- Multiple backend implementations (AfskUploader, HttpPostUploader, TcpUploader, UdpUploader)
- Bluetooth and USB connectivity (BluetoothTnc, UsbTnc)
- Audio processing system (AudioBufferProcessor)

e. Location Services:
- Location management system (LocationSource, PeriodicGPS, SmartBeaconing)
- Tracking and reporting (FixedPosition)

f. External Integrations:
- Google Maps integration
- APRS network connectivity
- Bluetooth/USB device connections

##### Relationship Flows

- Data flow between components
- Dependencies between layers
- Communication with external services
- User interaction flows

##### Specific Implementation Details

Specialized components:
- Multiple language support (show res/values structure)
- Backend configurations (res/xml/backend*.xml)
- Protocol configurations (res/xml/proto*.xml)

##### Architecture Patterns to Highlight

- Model-View-Presenter pattern for UI components
- Service-oriented architecture for background operations
- Plugin-based backend system
- Event-driven location updates

**┌─────────────────────────────────────────┐**
- UI Layer                   │
- (Activities, Fragments, Adapters)       │
- ┤
- Business Logic Layer          │
- (Services, Helpers, Protocol Handlers)  │
- ┤
- Data Access Layer             │
- (StorageDatabase, Backend Handlers)     │
- ┤
- Communication Layer             │
- (APRS Network, Bluetooth, USB)          │
- ┘

Important Considerations:

##### How different protocols interact with the backend systems

Remember to:
- Version information
- Document key dependencies (Scala, Android SDK, Google Maps)
- Build system integration (Gradle)

This structure will provide a clear understanding of how APRSdroid's components interact while maintaining the appropriate level of detail for a principal software engineer to understand the system architecture.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Define styles
    classDef ui fill:#f9f,stroke:#333,stroke-width:2px
    classDef service fill:#9cf,stroke:#333,stroke-width:2px
    classDef data fill:#fc9,stroke:#333,stroke-width:2px
    classDef protocol fill:#9f9,stroke:#333,stroke-width:2px
    classDef backend fill:#ff9,stroke:#333,stroke-width:2px
    classDef location fill:#f99,stroke:#333,stroke-width:2px

    subgraph UI_Layer
        APRSApp["APRSdroid Application"]:::ui
        HubAct["Hub Activity"]:::ui
        MapAct["Map Activity"]:::ui
        PrefsAct["Preferences Activity"]:::ui
        MsgAct["Message Activity"]:::ui
        StationAct["Station Activity"]:::ui
        GMapsAct["Google Maps Activity"]:::ui
    end

    subgraph Business_Logic
        PrefsWrap["Preferences Wrapper"]:::service
        StationHelper["Station Helper"]:::service
        AprsService["APRS Service"]:::service
        MsgService["Message Service"]:::service
    end

    subgraph Data_Layer
        StorageDB[(Storage Database)]:::data
        AprsPacket["APRS Packet Handler"]:::data
    end

    subgraph Protocol_Layer
        TNCProto{{"TNC Protocols"}}:::protocol
        AprsIsProto["APRS-IS Protocol"]:::protocol
        KenwoodProto["Kenwood Protocol"]:::protocol
        KissProto["KISS Protocol"]:::protocol
        Tnc2Proto["TNC2 Protocol"]:::protocol
    end

    subgraph Backend_Layer
        AfskUp["AFSK Uploader"]:::backend
        HttpUp["HTTP Uploader"]:::backend
        TcpUp["TCP Uploader"]:::backend
        UdpUp["UDP Uploader"]:::backend
        BluetoothTnc["Bluetooth TNC"]:::backend
        UsbTnc["USB TNC"]:::backend
        AudioProc["Audio Processor"]:::backend
    end

    subgraph Location_Services
        LocSource["Location Source"]:::location
        FixedPos["Fixed Position"]:::location
        PeriodicGPS["Periodic GPS"]:::location
        SmartBeacon["Smart Beaconing"]:::location
    end

    %% Relationships
    APRSApp --> HubAct
    HubAct --> |Navigation| MapAct
    HubAct --> |Navigation| PrefsAct
    HubAct --> |Navigation| MsgAct
    HubAct --> |Navigation| StationAct
    MapAct --> GMapsAct

    PrefsAct --> PrefsWrap
    StationAct --> StationHelper
    MsgAct --> MsgService
    
    MsgService --> StorageDB
    StationHelper --> StorageDB
    
    AprsService --> AprsPacket
    AprsPacket --> TNCProto
    
    TNCProto --> AprsIsProto
    TNCProto --> KenwoodProto
    TNCProto --> KissProto
    TNCProto --> Tnc2Proto
    
    AprsIsProto --> |Upload| HttpUp
    KenwoodProto --> |Upload| TcpUp
    KissProto --> |Upload| UdpUp
    Tnc2Proto --> |Upload| AfskUp
    
    BluetoothTnc --> AudioProc
    UsbTnc --> AudioProc
    
    LocSource --> FixedPos
    LocSource --> PeriodicGPS
    LocSource --> SmartBeacon
    
    %% Click events
    click APRSApp "https://github.com/ge0rg/aprsdroid/blob/master/src/APRSdroidApplication.scala"
    click HubAct "https://github.com/ge0rg/aprsdroid/blob/master/src/HubActivity.scala"
    click PrefsAct "https://github.com/ge0rg/aprsdroid/blob/master/src/PrefsAct.scala"
    click PrefsWrap "https://github.com/ge0rg/aprsdroid/blob/master/src/PrefsWrapper.scala"
    click StorageDB "https://github.com/ge0rg/aprsdroid/blob/master/src/StorageDatabase.scala"
    click MsgService "https://github.com/ge0rg/aprsdroid/blob/master/src/MessageService.scala"
    click MsgAct "https://github.com/ge0rg/aprsdroid/blob/master/src/MessageActivity.scala"
    click StationAct "https://github.com/ge0rg/aprsdroid/blob/master/src/StationActivity.scala"
    click StationHelper "https://github.com/ge0rg/aprsdroid/blob/master/src/StationHelper.scala"
    click AprsPacket "https://github.com/ge0rg/aprsdroid/blob/master/src/AprsPacket.scala"
    click AprsService "https://github.com/ge0rg/aprsdroid/blob/master/src/AprsService.scala"
    click TNCProto "https://github.com/ge0rg/aprsdroid/tree/master/src/tncproto/"
    click AfskUp "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/AfskUploader.scala"
    click HttpUp "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/HttpPostUploader.scala"
    click TcpUp "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/TcpUploader.scala"
    click UdpUp "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/UdpUploader.scala"
    click BluetoothTnc "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/BluetoothTnc.scala"
    click UsbTnc "https://github.com/ge0rg/aprsdroid/blob/master/src/backend/UsbTnc.scala"
    click AudioProc "https://github.com/ge0rg/aprsdroid/blob/master/src/AudioBufferProcessor.java"
    click LocSource "https://github.com/ge0rg/aprsdroid/blob/master/src/location/LocationSource.scala"
    click FixedPos "https://github.com/ge0rg/aprsdroid/blob/master/src/location/FixedPosition.scala"
    click PeriodicGPS "https://github.com/ge0rg/aprsdroid/blob/master/src/location/PeriodicGPS.scala"
    click SmartBeacon "https://github.com/ge0rg/aprsdroid/blob/master/src/location/SmartBeaconing.scala"
    click MapAct "https://github.com/ge0rg/aprsdroid/blob/master/src/MapAct.scala"
    click GMapsAct "https://github.com/ge0rg/aprsdroid/blob/master/src/GoogleMapAct.scala"
```
