# 0dimidrol0/devicemonitor architecture

> Architecture diagram of the GitHub repository 0dimidrol0/devicemonitor, 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/0dimidrol0/devicemonitor
- Repository: https://github.com/0dimidrol0/devicemonitor

## Overview

DeviceMonitor is an Android telemetry and workload-protection toolkit. An app configures and starts the monitor; it collects device and optional frame telemetry, emits snapshots and warning events, derives adaptive workload recommendations, and tracks workload sessions through report export. Compose dashboard/card and the development overlay present monitor data. The README documents these capabilities; edges beyond the indexed caller references are omitted where implementation detail was not shown.

Main entry points: [`device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt) (Telemetry collector), [`device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt`](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt) (Monitor API), [`device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt`](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt) (Overlay content), [`device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt`](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt) (Adaptive guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Telemetry core"]
  node_api["Monitor API<br/>[DeviceMonitor.kt]"]
  node_config["Configuration"]
  node_collector["Telemetry collector"]
  node_snapshot["Device snapshots<br/>[DeviceSnapshot.kt]"]
  node_warnings["Warning events"]
  node_frame["Frame metrics"]
  node_sensors["Sensor providers<br/>[SensorProviders.kt]"]
end

subgraph group_decisions["Risk and sessions"]
  node_policy["Recommendation policy"]
  node_recommend["Adaptive guard"]
  node_recommendation["Workload recommendations"]
  node_session["Workload sessions<br/>[WorkloadSession.kt]"]
  node_sessionreport["Session reports"]
  node_export["Report exporter"]
end

subgraph group_ui["Compose UI"]
  node_dashboard["Dashboard"]
  node_compact["Compact card"]
  node_dashboardcontent["Dashboard content"]
  node_metrics["Metrics cards<br/>[MetricsCard.kt]"]
  node_sessioncard["Session card<br/>[SessionCard.kt]"]
end

subgraph group_overlay["Debug overlay"]
  node_overlayapi["Overlay controller"]
  node_overlaycontent["Overlay content"]
  node_overlaypanel["Expanded panel"]
  node_bubble["Overlay bubble"]
  node_clipboard["Clipboard export"]
end

node_app(("Android app"))

node_app -->|"configures and starts"| node_api
node_api -->|"delegates to"| node_collector
node_collector -->|"emits"| node_snapshot
node_collector -->|"emits"| node_warnings
node_collector -->|"reads telemetry"| node_sensors
node_collector -->|"uses metrics"| node_frame
node_api -->|"accepts config"| node_config
node_collector -->|"updates guard"| node_recommend
node_recommend -->|"evaluates risk"| node_policy
node_recommend -->|"produces"| node_recommendation
node_collector -->|"updates session"| node_session
node_collector -->|"completes session"| node_sessionreport
node_api -->|"exports report"| node_export
node_export -->|"serializes"| node_sessionreport
node_app -->|"displays"| node_dashboard
node_app -->|"displays"| node_compact
node_dashboard -.->|"renders"| node_dashboardcontent
node_dashboardcontent -.->|"renders"| node_metrics
node_dashboardcontent -.->|"renders"| node_sessioncard
node_app -->|"shows overlay"| node_overlayapi
node_overlayapi -->|"reads monitor"| node_api
node_overlayapi -->|"displays"| node_overlaycontent
node_overlaycontent -->|"renders"| node_overlaypanel
node_overlaycontent -->|"renders"| node_bubble
node_overlaycontent -->|"exports via"| node_clipboard

click node_api "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt"
click node_config "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitorConfig.kt"
click node_collector "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt"
click node_snapshot "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceSnapshot.kt"
click node_warnings "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceWarningEvent.kt"
click node_frame "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/FrameMetricsTracker.kt"
click node_sensors "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/SensorProviders.kt"
click node_policy "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt"
click node_recommend "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt"
click node_recommendation "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadRecommendation.kt"
click node_session "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSession.kt"
click node_sessionreport "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSessionReport.kt"
click node_export "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt"
click node_dashboard "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt"
click node_compact "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorCompactCard.kt"
click node_dashboardcontent "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt"
click node_metrics "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/MetricsCard.kt"
click node_sessioncard "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/SessionCard.kt"
click node_overlayapi "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt"
click node_overlaycontent "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt"
click node_overlaypanel "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayExpandedPanel.kt"
click node_bubble "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayBubbleView.kt"
click node_clipboard "https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DebugOverlayClipboard.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_api,node_config,node_collector,node_snapshot,node_warnings,node_frame,node_sensors toneBlue
class node_policy,node_recommend,node_recommendation,node_session,node_sessionreport,node_export toneAmber
class node_dashboard,node_compact,node_dashboardcontent,node_metrics,node_sessioncard toneMint
class node_overlayapi,node_overlaycontent,node_overlaypanel,node_bubble,node_clipboard toneRose
class node_app toneIndigo
```

## Components

### Telemetry core

- [Monitor API](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt): `device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt`
- [Configuration](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitorConfig.kt): `device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitorConfig.kt`
- [Telemetry collector](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt): `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`
- [Device snapshots](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceSnapshot.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceSnapshot.kt`
- [Warning events](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceWarningEvent.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceWarningEvent.kt`
- [Frame metrics](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/FrameMetricsTracker.kt): `device-monitor-core/src/main/java/io/github/dimidrol/impl/FrameMetricsTracker.kt`
- [Sensor providers](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/SensorProviders.kt): `device-monitor-core/src/main/java/io/github/dimidrol/impl/SensorProviders.kt`

### Risk and sessions

- [Recommendation policy](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt): `device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt`
- [Adaptive guard](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt): `device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt`
- [Workload recommendations](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadRecommendation.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadRecommendation.kt`
- [Workload sessions](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSession.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSession.kt`
- [Session reports](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSessionReport.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSessionReport.kt`
- [Report exporter](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt): `device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt`

### Compose UI

- [Dashboard](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt): `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt`
- [Compact card](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorCompactCard.kt): `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorCompactCard.kt`
- [Dashboard content](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt): `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt`
- [Metrics cards](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/MetricsCard.kt): `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/MetricsCard.kt`
- [Session card](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/SessionCard.kt): `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/SessionCard.kt`

### Debug overlay

- [Overlay controller](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt): `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt`
- [Overlay content](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt): `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt`
- [Expanded panel](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayExpandedPanel.kt): `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayExpandedPanel.kt`
- [Overlay bubble](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayBubbleView.kt): `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayBubbleView.kt`
- [Clipboard export](https://github.com/0dimidrol0/devicemonitor/blob/master/device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DebugOverlayClipboard.kt): `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DebugOverlayClipboard.kt`

### Other components

- **Android app**

## Connections

- Android app → Monitor API: configures and starts
- Monitor API → Telemetry collector: delegates to (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt`)
- Telemetry collector → Device snapshots: emits (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Telemetry collector → Warning events: emits (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Telemetry collector → Sensor providers: reads telemetry (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Telemetry collector → Frame metrics: uses metrics (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Monitor API → Configuration: accepts config (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt`)
- Telemetry collector → Adaptive guard: updates guard (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Adaptive guard → Recommendation policy: evaluates risk (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt`)
- Adaptive guard → Workload recommendations: produces (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Telemetry collector → Workload sessions: updates session (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Telemetry collector → Session reports: completes session (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt`)
- Monitor API → Report exporter: exports report (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt`)
- Report exporter → Session reports: serializes (evidence: `device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt`)
- Android app → Dashboard: displays
- Android app → Compact card: displays
- Dashboard → Dashboard content: renders (evidence: `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt`)
- Dashboard content → Metrics cards: renders (evidence: `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt`)
- Dashboard content → Session card: renders (evidence: `device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt`)
- Android app → Overlay controller: shows overlay
- Overlay controller → Monitor API: reads monitor (evidence: `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt`)
- Overlay controller → Overlay content: displays (evidence: `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt`)
- Overlay content → Expanded panel: renders (evidence: `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt`)
- Overlay content → Overlay bubble: renders (evidence: `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt`)
- Overlay content → Clipboard export: exports via (evidence: `device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt`)
