# dreamhax444/controller-app architecture

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

- Interactive diagram: https://gitdiagram.com/dreamhax444/controller-app
- Repository: https://github.com/dreamhax444/controller-app

## Overview

Trace Controller is an Android fleet-control console: an operator authenticates, views assigned trackers and live telemetry, then issues commands or opens remote media and management tools. Its main runtime spans Compose navigation, authentication and authorization, Supabase-backed fleet monitoring, tracker sessions and recovery, and feature-specific workflows such as maps, alerts, files, diagnostics, and updates. The README documents several integrations and capabilities whose implementation was not sampled; those branches are shown at the documented subsystem level, with source-level details limited to the excerpts and index.

Main entry points: [`app/src/main/java/com/livetracker/controller/main/MainShellScreen.kt`](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/main/MainShellScreen.kt) (Console shell), [`core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt`](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt) (Fleet manager), [`app/src/main/java/com/livetracker/controller/MainActivity.kt`](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/MainActivity.kt) (App entry), [`core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt`](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt) (Tracker sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_auth_ui["Sign-in UI<br/>[LoginScreen.kt]"]
  node_google["Google sign-in"]
  node_auth_repo["Authentication"]
  node_authorization["Access policy"]
  node_shell["Console shell<br/>[MainShellScreen.kt]"]
end

subgraph group_fleet["Fleet operations"]
  node_fleet_manager["Fleet manager"]
  node_tracker_sessions["Tracker sessions"]
  node_recovery["Connection recovery"]
  node_map["Live map<br/>[MapScreen.kt]"]
  node_alerts["Alerts<br/>[AlertsScreen.kt]"]
  node_siren["Siren engine"]
  node_offline["Offline maps"]
end

subgraph group_remote["Remote features"]
  node_commands["Command gateway"]
  node_camera["Camera viewer<br/>[CameraScreen.kt]"]
  node_audio["Audio viewer<br/>[AudioScreen.kt]"]
  node_screen["Screen sharing"]
  node_files["File transfers<br/>[FilesViewModel.kt]"]
  node_diagnostics["Diagnostics"]
end

subgraph group_updates["Self updates"]
  node_updates["Update engine"]
end

subgraph group_backend["Cloud services"]
  node_realtime["Supabase Realtime"]
  node_supabase_auth["Supabase GoTrue"]
  node_update_storage["Update storage"]
end

node_operator(("Operator"))
node_tracker_device(("Tracker device"))

node_operator -->|"uses"| node_activity
node_activity -->|"shows"| node_auth_ui
node_auth_ui -->|"starts sign-in"| node_google
node_google -.->|"submits identity"| node_auth_repo
node_auth_repo -->|"verifies token"| node_supabase_auth
node_activity -->|"shows console"| node_shell
node_shell -->|"monitors fleet"| node_fleet_manager
node_fleet_manager -->|"exchanges telemetry"| node_realtime
node_fleet_manager -->|"delegates commands"| node_commands
node_fleet_manager -.->|"tracks connections"| node_tracker_sessions
node_tracker_sessions -->|"triggers recovery"| node_recovery
node_tracker_sessions -.->|"connects"| node_tracker_device
node_fleet_manager -.->|"supplies telemetry"| node_map
node_shell -.->|"opens alerts"| node_alerts
node_alerts -.->|"displays alarms"| node_siren
node_shell -.->|"opens viewer"| node_camera
node_shell -.->|"opens viewer"| node_audio
node_shell -.->|"opens sharing"| node_screen
node_shell -.->|"opens transfers"| node_files
node_shell -.->|"opens diagnostics"| node_diagnostics
node_commands -.->|"dispatches commands"| node_tracker_device
node_shell -->|"manages map areas"| node_offline
node_shell -.->|"manages updates"| node_updates
node_updates -->|"downloads releases"| node_update_storage
node_tracker_device -->|"signals sessions"| node_realtime
node_camera -->|"views camera stream"| node_tracker_device
node_audio -->|"streams audio"| node_tracker_device
node_screen -->|"views screen stream"| node_tracker_device
node_authorization -.->|"checks access policy"| node_auth_repo

click node_activity "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/MainActivity.kt"
click node_auth_ui "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/auth/LoginScreen.kt"
click node_google "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/auth/GoogleSignInManager.kt"
click node_auth_repo "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/auth/data/SupabaseAuthenticationRepository.kt"
click node_authorization "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/auth/domain/AuthorizationEngine.kt"
click node_shell "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/main/MainShellScreen.kt"
click node_fleet_manager "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt"
click node_tracker_sessions "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt"
click node_recovery "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/recovery/TrackerRecoveryManager.kt"
click node_map "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/map/MapScreen.kt"
click node_alerts "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/alerts/AlertsScreen.kt"
click node_siren "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/alert/SirenAlertEngine.kt"
click node_commands "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/command/DefaultCommandGateway.kt"
click node_camera "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/camera/CameraScreen.kt"
click node_audio "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/audio/AudioScreen.kt"
click node_screen "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/screen/ScreenCaptureScreen.kt"
click node_files "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/files/FilesViewModel.kt"
click node_diagnostics "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/diagnostics/DiagnosticsScreen.kt"
click node_updates "https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/update/domain/DefaultUpdateRepository.kt"
click node_offline "https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/map/offline/OfflineMapManager.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_activity,node_auth_ui,node_google,node_auth_repo,node_authorization,node_shell toneBlue
class node_fleet_manager,node_tracker_sessions,node_recovery,node_map,node_alerts,node_siren,node_offline toneAmber
class node_commands,node_camera,node_audio,node_screen,node_files,node_diagnostics toneMint
class node_updates toneRose
class node_realtime,node_supabase_auth,node_update_storage,node_operator,node_tracker_device toneIndigo
```

## Components

### App and access

- [App entry](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/MainActivity.kt): `app/src/main/java/com/livetracker/controller/MainActivity.kt`
- [Sign-in UI](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/auth/LoginScreen.kt): `app/src/main/java/com/livetracker/controller/auth/LoginScreen.kt`
- [Google sign-in](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/auth/GoogleSignInManager.kt): `app/src/main/java/com/livetracker/controller/auth/GoogleSignInManager.kt`
- [Authentication](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/auth/data/SupabaseAuthenticationRepository.kt): `core/src/main/java/com/livetracker/controller/core/auth/data/SupabaseAuthenticationRepository.kt`
- [Access policy](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/auth/domain/AuthorizationEngine.kt): `core/src/main/java/com/livetracker/controller/core/auth/domain/AuthorizationEngine.kt`
- [Console shell](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/main/MainShellScreen.kt): `app/src/main/java/com/livetracker/controller/main/MainShellScreen.kt`

### Fleet operations

- [Fleet manager](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt): `core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt`
- [Tracker sessions](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt): `core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt`
- [Connection recovery](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/recovery/TrackerRecoveryManager.kt): `core/src/main/java/com/livetracker/controller/core/tracker/recovery/TrackerRecoveryManager.kt`
- [Live map](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/map/MapScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/map/MapScreen.kt`
- [Alerts](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/alerts/AlertsScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/alerts/AlertsScreen.kt`
- [Siren engine](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/alert/SirenAlertEngine.kt): `app/src/main/java/com/livetracker/controller/alert/SirenAlertEngine.kt`
- [Offline maps](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/map/offline/OfflineMapManager.kt): `app/src/main/java/com/livetracker/controller/ui/screens/map/offline/OfflineMapManager.kt`

### Remote features

- [Command gateway](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/tracker/command/DefaultCommandGateway.kt): `core/src/main/java/com/livetracker/controller/core/tracker/command/DefaultCommandGateway.kt`
- [Camera viewer](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/camera/CameraScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/camera/CameraScreen.kt`
- [Audio viewer](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/audio/AudioScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/audio/AudioScreen.kt`
- [Screen sharing](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/screen/ScreenCaptureScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/screen/ScreenCaptureScreen.kt`
- [File transfers](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/files/FilesViewModel.kt): `app/src/main/java/com/livetracker/controller/ui/screens/files/FilesViewModel.kt`
- [Diagnostics](https://github.com/dreamhax444/controller-app/blob/main/app/src/main/java/com/livetracker/controller/ui/screens/diagnostics/DiagnosticsScreen.kt): `app/src/main/java/com/livetracker/controller/ui/screens/diagnostics/DiagnosticsScreen.kt`

### Self updates

- [Update engine](https://github.com/dreamhax444/controller-app/blob/main/core/src/main/java/com/livetracker/controller/core/update/domain/DefaultUpdateRepository.kt): `core/src/main/java/com/livetracker/controller/core/update/domain/DefaultUpdateRepository.kt`

### Cloud services

- **Supabase Realtime**
- **Supabase GoTrue**
- **Update storage**

### Other components

- **Operator**
- **Tracker device**

## Connections

- Operator → App entry: uses (evidence: `README.md`)
- App entry → Sign-in UI: shows (evidence: `app/src/main/java/com/livetracker/controller/MainActivity.kt`)
- Sign-in UI → Google sign-in: starts sign-in (evidence: `app/src/main/java/com/livetracker/controller/MainActivity.kt`)
- Google sign-in → Authentication: submits identity
- Authentication → Supabase GoTrue: verifies token (evidence: `README.md`)
- App entry → Console shell: shows console (evidence: `app/src/main/java/com/livetracker/controller/MainActivity.kt`)
- Console shell → Fleet manager: monitors fleet (evidence: `README.md`)
- Fleet manager → Supabase Realtime: exchanges telemetry (evidence: `README.md`)
- Fleet manager → Command gateway: delegates commands (evidence: `core/src/main/java/com/livetracker/controller/core/tracker/supabase/SupabaseFleetManager.kt`)
- Fleet manager → Tracker sessions: tracks connections
- Tracker sessions → Connection recovery: triggers recovery (evidence: `core/src/main/java/com/livetracker/controller/core/tracker/session/DefaultTrackerSessionManager.kt`)
- Tracker sessions → Tracker device: connects
- Fleet manager → Live map: supplies telemetry
- Console shell → Alerts: opens alerts
- Alerts → Siren engine: displays alarms
- Console shell → Camera viewer: opens viewer
- Console shell → Audio viewer: opens viewer
- Console shell → Screen sharing: opens sharing
- Console shell → File transfers: opens transfers
- Console shell → Diagnostics: opens diagnostics
- Command gateway → Tracker device: dispatches commands
- Console shell → Offline maps: manages map areas (evidence: `app/src/main/java/com/livetracker/controller/ui/screens/map/offline/OfflineMapManager.kt`)
- Console shell → Update engine: manages updates
- Update engine → Update storage: downloads releases (evidence: `README.md`)
- Tracker device → Supabase Realtime: signals sessions (evidence: `README.md`)
- Camera viewer → Tracker device: views camera stream (evidence: `README.md`)
- Audio viewer → Tracker device: streams audio (evidence: `README.md`)
- Screen sharing → Tracker device: views screen stream (evidence: `README.md`)
- Access policy → Authentication: checks access policy
