How quadrified/runique works
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: OfflineFirstRunRepository.kt Offline-first repository · MainActivity.kt Phone app · SyncRunWorkerScheduler.kt Sync scheduler · RunPendingSyncDao.kt Pending sync records
Components 20
App navigation
- Phone app
app/src/main/java/com/quadrified/runique/MainActivity.kt - Navigation root
app/src/main/java/com/quadrified/runique/NavigationRoot.kt
Accounts
- Sign-in screens
auth/presentation/src/main/java/com/quadrified/auth/presentation/login/LoginScreen.kt - Auth repository
auth/data/src/main/java/com/quadrified/auth/data/AuthRepositoryImpl.kt - Session storage
core/data/src/main/java/com/quadrified/core/data/auth/EncryptedSessionStorage.kt
Run tracking
- Active run tracker
run/presentation/src/main/java/com/quadrified/run/presentation/active_run/service/ActiveRunService.kt - Run screens
run/presentation/src/main/java/com/quadrified/run/presentation/active_run/ActiveRunScreen.kt - Location observer
run/location/src/main/java/com/quadrified/run/location/AndroidLocationObserver.kt
Persistence and sync
- Offline-first repository
core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt - Local run source
core/database/src/main/java/com/quadrified/core/database/RoomLocalRunDataSource.kt - Run database
core/database/src/main/java/com/quadrified/core/database/RunDatabase.kt - Pending sync records
core/database/src/main/java/com/quadrified/core/database/dao/RunPendingSyncDao.kt - Remote run source
run/network/src/main/java/com/quadrified/run/network/KtorRemoteRunDataSource.kt - Sync scheduler
run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt - Sync workers
run/data/src/main/java/com/quadrified/run/data/CreateRunWorker.kt
Analytics and Wear
- Analytics dashboard
analytics/presentation/src/main/java/com/quadrified/analytics/presentation/AnalyticsDashboardScreen.kt - Analytics repository
analytics/data/src/main/java/com/quadrified/analytics/data/RoomAnalyticsRepository.kt - Watch tracker
wear/run/data/src/main/java/com/quadrified/wear/run/data/HealthServicesExerciseTracker.kt - Phone-watch connector
run/data/src/main/java/com/quadrified/run/connectivity/PhoneToWatchConnector.kt
Other components
- Runner
Connections 18
- Runner → Phone app: opens
- Phone app → Navigation root: uses
app/src/main/java/com/quadrified/runique/MainActivity.kt - Phone app → Analytics dashboard: launches
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
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
core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt - Offline-first repository → Pending sync records: checks pending
core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt - Offline-first repository → Sync scheduler: schedules retry
core/data/src/main/java/com/quadrified/core/data/run/OfflineFirstRunRepository.kt - Sync scheduler → Pending sync records: records queued work
run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt - Sync scheduler → Sync workers: enqueues
run/data/src/main/java/com/quadrified/run/data/SyncRunWorkerScheduler.kt - Run database → Pending sync records: provides DAO
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