# quadrified/runique architecture

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

- Interactive diagram: https://gitdiagram.com/quadrified/runique
- Repository: https://github.com/quadrified/runique

## Overview

Runique is a phone-and-Wear OS running tracker. The main user journey is to start and track a run, save it locally, view run history, and synchronize changes with the server; accounts and analytics are additional capabilities. The graph includes the app navigation, auth, run tracking and storage/sync, analytics, and watch subsystems. Several UI and feature modules are represented from the file tree, but their internal calls were not sampled, so those relationships are shown only as unverified dashed links or omitted.

Main entry points: [`core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt`](https://github.com/quadrified/runique/blob/main/core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt) (Offline-first repository), [`app/src/main/java/com/quadrified/runique/MainActivity.kt`](https://github.com/quadrified/runique/blob/main/app/src/main/java/com/quadrified/runique/MainActivity.kt) (Phone app), [`run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt`](https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt) (Sync scheduler), [`core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt`](https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt) (Pending sync records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_main["Phone app<br/>[MainActivity.kt]"]
  node_navigation["Navigation root<br/>[NavigationRoot.kt]"]
end

subgraph group_auth["Accounts"]
  node_authui["Sign-in screens<br/>[LoginScreen.kt]"]
  node_authrepo["Auth repository"]
  node_session["Session storage"]
end

subgraph group_run["Run tracking"]
  node_active["Active run tracker"]
  node_runui["Run screens<br/>[ActiveRunScreen.kt]"]
  node_location["Location observer"]
end

subgraph group_data["Persistence and sync"]
  node_runrepo["Offline-first repository"]
  node_localruns["Local run source"]
  node_database[("Run database<br/>[RunDatabase.kt]")]
  node_pending[("Pending sync records")]
  node_remote["Remote run source"]
  node_scheduler["Sync scheduler"]
  node_workers["Sync workers<br/>[CreateRunWorker.kt]"]
end

subgraph group_extras["Analytics and Wear"]
  node_analytics["Analytics dashboard"]
  node_analyticsrepo["Analytics repository"]
  node_watch["Watch tracker"]
  node_phonewatch["Phone-watch connector"]
end

node_runner(("Runner"))

node_runner -.->|"opens"| node_main
node_main -->|"uses"| node_navigation
node_main -->|"launches"| node_analytics
node_navigation -.->|"routes to"| node_authui
node_authui -.->|"submits credentials"| node_authrepo
node_authrepo -->|"stores login"| node_session
node_runui -.->|"controls"| node_active
node_active -.->|"observes"| node_location
node_runrepo -.->|"reads and writes"| node_localruns
node_runrepo -->|"fetches and posts"| node_remote
node_runrepo -->|"checks pending"| node_pending
node_runrepo -->|"schedules retry"| node_scheduler
node_scheduler -->|"records queued work"| node_pending
node_scheduler -->|"enqueues"| node_workers
node_database -->|"provides DAO"| node_pending
node_analytics -.->|"loads metrics"| node_analyticsrepo
node_analyticsrepo -.->|"queries runs"| node_database
node_watch -.->|"shares run data"| node_phonewatch

click node_main "https://github.com/quadrified/runique/blob/main/app/src/main/java/com/quadrified/runique/MainActivity.kt"
click node_navigation "https://github.com/quadrified/runique/blob/main/app/src/main/java/com/quadrified/runique/NavigationRoot.kt"
click node_authui "https://github.com/quadrified/runique/blob/main/auth/presentation/src/main/java/com/quadrified/auth/presentation/login/LoginScreen.kt"
click node_authrepo "https://github.com/quadrified/runique/blob/main/auth/data/src/main/java/com/quadrified/auth/data/AuthRepositoryImpl.kt"
click node_session "https://github.com/quadrified/runique/blob/main/core/data/src/main/java/com/quadrified/core/data/auth/EncryptedSessionStorage.kt"
click node_active "https://github.com/quadrified/runique/blob/main/run/presentation/src/main/java/com/quadrified/run/presentation/active_run/service/ActiveRunService.kt"
click node_runui "https://github.com/quadrified/runique/blob/main/run/presentation/src/main/java/com/quadrified/run/presentation/active_run/ActiveRunScreen.kt"
click node_location "https://github.com/quadrified/runique/blob/main/run/location/src/main/java/com/quadrified/run/location/AndroidLocationObserver.kt"
click node_runrepo "https://github.com/quadrified/runique/blob/main/core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt"
click node_localruns "https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/RoomLocalRunDataSource.kt"
click node_database "https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/RunDatabase.kt"
click node_pending "https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt"
click node_remote "https://github.com/quadrified/runique/blob/main/run/network/src/main/java/com/quadrified/run/network/KtorRemoteRunDataSource.kt"
click node_scheduler "https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt"
click node_workers "https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/data/CreateRunWorker.kt"
click node_analytics "https://github.com/quadrified/runique/blob/main/analytics/presentation/src/main/java/com/quadrified/analytics/presentation/AnalyticsDashboardScreen.kt"
click node_analyticsrepo "https://github.com/quadrified/runique/blob/main/analytics/data/src/main/java/com/quadrified/analytics/data/RoomAnalyticsRepository.kt"
click node_watch "https://github.com/quadrified/runique/blob/main/wear/run/data/src/main/java/com/quadrified/wear/run/data/HealthServicesExerciseTracker.kt"
click node_phonewatch "https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/connectivity/PhoneToWatchConnector.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_navigation toneBlue
class node_authui,node_authrepo,node_session toneAmber
class node_active,node_runui,node_location toneMint
class node_runrepo,node_localruns,node_database,node_pending,node_remote,node_scheduler,node_workers toneRose
class node_analytics,node_analyticsrepo,node_watch,node_phonewatch,node_runner toneIndigo
```

## Components

### App navigation

- [Phone app](https://github.com/quadrified/runique/blob/main/app/src/main/java/com/quadrified/runique/MainActivity.kt): `app/src/main/java/com/quadrified/runique/MainActivity.kt`
- [Navigation root](https://github.com/quadrified/runique/blob/main/app/src/main/java/com/quadrified/runique/NavigationRoot.kt): `app/src/main/java/com/quadrified/runique/NavigationRoot.kt`

### Accounts

- [Sign-in screens](https://github.com/quadrified/runique/blob/main/auth/presentation/src/main/java/com/quadrified/auth/presentation/login/LoginScreen.kt): `auth/presentation/src/main/java/com/quadrified/auth/presentation/login/LoginScreen.kt`
- [Auth repository](https://github.com/quadrified/runique/blob/main/auth/data/src/main/java/com/quadrified/auth/data/AuthRepositoryImpl.kt): `auth/data/src/main/java/com/quadrified/auth/data/AuthRepositoryImpl.kt`
- [Session storage](https://github.com/quadrified/runique/blob/main/core/data/src/main/java/com/quadrified/core/data/auth/EncryptedSessionStorage.kt): `core/data/src/main/java/com/quadrified/core/data/auth/EncryptedSessionStorage.kt`

### Run tracking

- [Active run tracker](https://github.com/quadrified/runique/blob/main/run/presentation/src/main/java/com/quadrified/run/presentation/active_run/service/ActiveRunService.kt): `run/presentation/src/main/java/com/quadrified/run/presentation/active_run/service/ActiveRunService.kt`
- [Run screens](https://github.com/quadrified/runique/blob/main/run/presentation/src/main/java/com/quadrified/run/presentation/active_run/ActiveRunScreen.kt): `run/presentation/src/main/java/com/quadrified/run/presentation/active_run/ActiveRunScreen.kt`
- [Location observer](https://github.com/quadrified/runique/blob/main/run/location/src/main/java/com/quadrified/run/location/AndroidLocationObserver.kt): `run/location/src/main/java/com/quadrified/run/location/AndroidLocationObserver.kt`

### Persistence and sync

- [Offline-first repository](https://github.com/quadrified/runique/blob/main/core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt): `core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt`
- [Local run source](https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/RoomLocalRunDataSource.kt): `core/database/src/main/java/com/quadrified/core/database/RoomLocalRunDataSource.kt`
- [Run database](https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/RunDatabase.kt): `core/database/src/main/java/com/quadrified/core/database/RunDatabase.kt`
- [Pending sync records](https://github.com/quadrified/runique/blob/main/core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt): `core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt`
- [Remote run source](https://github.com/quadrified/runique/blob/main/run/network/src/main/java/com/quadrified/run/network/KtorRemoteRunDataSource.kt): `run/network/src/main/java/com/quadrified/run/network/KtorRemoteRunDataSource.kt`
- [Sync scheduler](https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt): `run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt`
- [Sync workers](https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/data/CreateRunWorker.kt): `run/data/src/main/java/com/quadrified/run/data/CreateRunWorker.kt`

### Analytics and Wear

- [Analytics dashboard](https://github.com/quadrified/runique/blob/main/analytics/presentation/src/main/java/com/quadrified/analytics/presentation/AnalyticsDashboardScreen.kt): `analytics/presentation/src/main/java/com/quadrified/analytics/presentation/AnalyticsDashboardScreen.kt`
- [Analytics repository](https://github.com/quadrified/runique/blob/main/analytics/data/src/main/java/com/quadrified/analytics/data/RoomAnalyticsRepository.kt): `analytics/data/src/main/java/com/quadrified/analytics/data/RoomAnalyticsRepository.kt`
- [Watch tracker](https://github.com/quadrified/runique/blob/main/wear/run/data/src/main/java/com/quadrified/wear/run/data/HealthServicesExerciseTracker.kt): `wear/run/data/src/main/java/com/quadrified/wear/run/data/HealthServicesExerciseTracker.kt`
- [Phone-watch connector](https://github.com/quadrified/runique/blob/main/run/data/src/main/java/com/quadrified/run/connectivity/PhoneToWatchConnector.kt): `run/data/src/main/java/com/quadrified/run/connectivity/PhoneToWatchConnector.kt`

### Other components

- **Runner**

## Connections

- Runner → Phone app: opens
- Phone app → Navigation root: uses (evidence: `app/src/main/java/com/quadrified/runique/MainActivity.kt`)
- Phone app → Analytics dashboard: launches (evidence: `app/src/main/java/com/quadrified/runique/MainActivity.kt`)
- Navigation root → Sign-in screens: routes to
- Sign-in screens → Auth repository: submits credentials
- Auth repository → Session storage: stores login (evidence: `auth/data/src/main/java/com/quadrified/auth/data/AuthRepositoryImpl.kt`)
- Run screens → Active run tracker: controls
- Active run tracker → Location observer: observes
- Offline-first repository → Local run source: reads and writes
- Offline-first repository → Remote run source: fetches and posts (evidence: `core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt`)
- Offline-first repository → Pending sync records: checks pending (evidence: `core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt`)
- Offline-first repository → Sync scheduler: schedules retry (evidence: `core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt`)
- Sync scheduler → Pending sync records: records queued work (evidence: `run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt`)
- Sync scheduler → Sync workers: enqueues (evidence: `run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt`)
- Run database → Pending sync records: provides DAO (evidence: `core/database/src/main/java/com/quadrified/core/database/RunDatabase.kt`)
- Analytics dashboard → Analytics repository: loads metrics
- Analytics repository → Run database: queries runs
- Watch tracker → Phone-watch connector: shares run data
