# libxzr/perfmon-plus architecture

> Architecture diagram of the GitHub repository libxzr/perfmon-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/libxzr/perfmon-plus
- Repository: https://github.com/libxzr/perfmon-plus

## Overview

##### Project type and purpose
- This is a native-enhanced Android application (“PerfMon+”) whose purpose is to monitor various hardware and system performance metrics (CPU/GPU frequency and load, memory usage, etc.) in real time and present them on the device screen.

##### File structure
- Top level
- build.gradle, settings.gradle, gradle-wrapper → standard Android/Gradle build setup
- app/ → Android application module
- screenshots/ → sample UI captures
- app/src/main/java/xzr/perfmon
- MainActivity.java → primary UI entry point
- FloatingWindow.java → overlay UI component
- JniTools.java → Java wrapper for native C code
- RefreshingDateThread.java → background thread to refresh UI data
- Settings.java, SharedPreferencesUtil.java → settings persistence
- Tools.java, Support.java → helper/business-logic classes
- app/src/main/jni
- Android.mk → native build script
- functions.c, interfaces.c, perfmon.h, xzr_perfmon_JniTools.h → C code that reads system data via sysfs or other kernel interfaces

##### Supplement from README
- No back-end services or external APIs. All data comes from local system files or kernel interfaces via native code.

## Diagram (Mermaid)

```mermaid
graph TD
    %% UI Layer
    subgraph "UI Layer"
        MA["MainActivity"]:::ui
        FW["FloatingWindow"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic"
        TS["Tools & Support"]:::logic
        RDT["RefreshingDateThread"]:::logic
        SP["Settings & SharedPreferencesUtil"]:::logic
    end

    %% Native Layer
    subgraph "Native Layer"
        JT["JniTools"]:::native
        subgraph "C Modules"
            FC["functions.c"]:::native
            IC["interfaces.c"]:::native
            PH["perfmon.h"]:::native
            JH["xzr_perfmon_JniTools.h"]:::native
        end
        MK["Android.mk"]:::native
    end

    %% System / Kernel
    SK["Linux Kernel (/sys)"]:::system

    %% Connections
    MA -->|"initialize"| FW
    MA -->|"invoke logic"| TS
    FW -->|"invoke logic"| TS
    MA -->|"load settings"| SP
    TS -->|"save/read"| SP
    TS -->|"call JNI"| JT
    RDT -->|"trigger fetch"| JT
    JT -->|"invoke native"| FC
    JT -->|"invoke native"| IC
    FC -->|"read sysfs"| SK
    IC -->|"read sysfs"| SK
    SK -->|"metrics data"| FC
    SK -->|"metrics data"| IC
    FC -->|"return metrics"| JT
    IC -->|"return metrics"| JT
    JT -->|"JNI return data"| TS
    TS -->|"update UI"| MA
    RDT -->|"periodic update"| MA

    %% Click Events
    click MA "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/MainActivity.java"
    click FW "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/FloatingWindow.java"
    click TS "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/Tools.java"
    click TS "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/Support.java"
    click RDT "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/RefreshingDateThread.java"
    click SP "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/Settings.java"
    click SP "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/SharedPreferencesUtil.java"
    click JT "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/java/xzr/perfmon/JniTools.java"
    click FC "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/jni/functions.c"
    click IC "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/jni/interfaces.c"
    click PH "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/jni/perfmon.h"
    click JH "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/jni/xzr_perfmon_JniTools.h"
    click MK "https://github.com/libxzr/perfmon-plus/blob/master/app/src/main/jni/Android.mk"

    %% Styles
    classDef ui fill:#D0E6FF,stroke:#0366d6,color:#000
    classDef logic fill:#DFFFD0,stroke:#228B22,color:#000
    classDef native fill:#FFE4B5,stroke:#FF8C00,color:#000
    classDef system fill:#E0E0E0,stroke:#696969,color:#000
```
