How antnygamer/roadconquest-beta works
Road Conquest is an Android exploration game that records drives, matches them to roads, reveals a fog-covered map, and awards progression for roads and places. The main workflow runs from location tracking through local history and map rendering; foreground place resolution and achievement scoring extend it. Optional accounts and a separate backend support leaderboard visibility and verified competition. The graph follows the README and SOURCE INDEX references; unsampled subsystems are included where documented, but uncertain implementation links are omitted.
Main entry points: TrackingService.kt Tracking service · MainActivity.kt Map screen · application.mjs Account service · TrackingRepository.kt Tracking repository
Components 28
Android app
- Map screen
app/src/main/java/com/roadconquest/app/MainActivity.kt - Settings
app/src/main/java/com/roadconquest/app/SettingsActivity.kt
Driving and exploration
- Tracking service
app/src/main/java/com/roadconquest/app/TrackingService.kt - Location providers
app/src/main/java/com/roadconquest/app/util/LocationProviders.kt - OSRM matching
app/src/main/java/com/roadconquest/app/matching/OsrmMatcher.kt - Tracking repository
app/src/main/java/com/roadconquest/app/data/TrackingRepository.kt - Local database
app/src/main/java/com/roadconquest/app/data/AppDatabase.kt - Road grouping
app/src/main/java/com/roadconquest/app/data/RoadGrouping.kt - Map renderer
app/src/main/java/com/roadconquest/app/map/MapRenderer.kt - Fog rendering
app/src/main/java/com/roadconquest/app/map/FogBitmapRenderer.kt
Progression and exports
- Progression manager
app/src/main/java/com/roadconquest/app/progression/ProgressionManager.kt - Progression repository
app/src/main/java/com/roadconquest/app/data/ProgressionRepository.kt - Achievements
app/src/main/java/com/roadconquest/app/achievements/Achievements.kt - Garage and shop
app/src/main/java/com/roadconquest/app/ShopActivity.kt - Data export
app/src/main/java/com/roadconquest/app/export/DataExporter.kt
Accounts and competition
- Account screens
app/src/main/java/com/roadconquest/app/AccountActivity.kt - Account client
app/src/main/java/com/roadconquest/app/account/AccountClient.kt - Account store
app/src/main/java/com/roadconquest/app/account/AccountStore.kt - Leaderboard screen
app/src/main/java/com/roadconquest/app/LeaderboardActivity.kt - Account service
server/src/application.mjs - Auth security
server/src/security.mjs - Competition service
server/src/competition.mjs - Drive integrity
server/src/integrity.mjs - Competitive scoring
server/src/scoring.mjs - PostgreSQL
Other components
- Driver
- OSRM matcher
- Android geocoder
Connections 30
- Driver → Map screen: opens
- Map screen → Tracking service: starts
app/src/main/java/com/roadconquest/app/MainActivity.kt - Tracking service → Location providers: requests fixes
app/src/main/java/com/roadconquest/app/TrackingService.kt - Tracking service → Tracking repository: records drives
app/src/main/java/com/roadconquest/app/TrackingService.kt - Tracking repository → Local database: persists history
app/src/main/java/com/roadconquest/app/data/TrackingRepository.kt - Tracking service → OSRM matching: matches pending
app/src/main/java/com/roadconquest/app/TrackingService.kt - OSRM matching → OSRM matcher: requests matches
- OSRM matching → Road grouping: groups roads
app/src/main/java/com/roadconquest/app/matching/OsrmMatcher.kt - Map screen → Map renderer: renders map
app/src/main/java/com/roadconquest/app/MainActivity.kt - Map renderer → Fog rendering: renders fog
app/src/main/java/com/roadconquest/app/map/MapRenderer.kt - Map screen → Tracking repository: loads exploration
app/src/main/java/com/roadconquest/app/MainActivity.kt - Tracking service → Progression repository: records candidates
app/src/main/java/com/roadconquest/app/TrackingService.kt - Progression repository → Local database: stores progression
app/src/main/java/com/roadconquest/app/data/ProgressionRepository.kt - Progression manager → Android geocoder: resolves places
- Progression manager → Progression repository: updates awards
app/src/main/java/com/roadconquest/app/progression/ProgressionManager.kt - Progression manager → Achievements: checks milestones
app/src/main/java/com/roadconquest/app/progression/ProgressionManager.kt - Garage and shop → Progression repository: buys cosmetics
app/src/main/java/com/roadconquest/app/ShopActivity.kt - Settings → Data export: exports history
app/src/main/java/com/roadconquest/app/SettingsActivity.kt - Data export → Tracking repository: reads driving data
app/src/main/java/com/roadconquest/app/export/DataExporter.kt - Driver → Settings: configures app
- Account screens → Account client: sends account requests
app/src/main/java/com/roadconquest/app/AccountActivity.kt - Account screens → Account store: stores session
app/src/main/java/com/roadconquest/app/AccountActivity.kt - Account client → Account service: calls HTTPS API
- Leaderboard screen → Account client: requests rankings
- Account service → Auth security: checks credentials
server/src/application.mjs - Account service → Competition service: creates competition
server/src/application.mjs - Account service → PostgreSQL: queries database
server/src/application.mjs - Competition service → Drive integrity: verifies drives
server/src/competition.mjs - Competition service → Competitive scoring: scores results
server/src/competition.mjs - Drive integrity → Competitive scoring: validates scoring
server/src/integrity.mjs