# kanoqwq/ufi-tools architecture

> Architecture diagram of the GitHub repository kanoqwq/ufi-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kanoqwq/ufi-tools
- Repository: https://github.com/kanoqwq/ufi-tools

## Overview

UFI-TOOLS is an Android device-management app with a browser-based remote console. The main user flow is to start the app or its background service, reach the embedded web server from a browser, and use its API/UI to manage device functions. The README also describes monitoring, networking, SMS forwarding, scheduled tasks, OTA, themes, and plugins; these are represented as feature subsystems where the tree supports them. Several feature implementations were not sampled, so connections beyond indexed references or README statements are omitted or marked unverified.

Main entry points: [`app/src/main/java/com/minikano/f50_sms/modules`](https://github.com/kanoqwq/ufi-tools/tree/http-server-version/app/src/main/java/com/minikano/f50_sms/modules) (API modules), [`app/src/main/java/com/minikano/f50_sms/MainActivity.kt`](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/MainActivity.kt) (Android app), [`app/src/main/java/com/minikano/f50_sms/WebService.kt`](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/WebService.kt) (Web service), [`app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt`](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt) (Ktor web server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App lifecycle"]
  node_activity["Android app<br/>[MainActivity.kt]"]
  node_webservice["Web service<br/>[WebService.kt]"]
  node_adbservice["ADB service<br/>[ADBService.kt]"]
end

subgraph group_web["Web control"]
  node_webserver["Ktor web server<br/>[KanoWebServer.kt]"]
  node_api["API modules"]
  node_auth["API authentication<br/>[KanoAuth.kt]"]
  node_frontend["Web console<br/>[main.js]"]
end

subgraph group_device["Device management"]
  node_deviceinfo["Device status"]
  node_advanced["Advanced controls"]
  node_at["AT commands<br/>[atModule.kt]"]
  node_ota["OTA updates<br/>[otaModule.kt]"]
  node_plugins["Plugin system<br/>[pluginsModule.kt]"]
  node_network["Network controls"]
end

subgraph group_comms["Communications"]
  node_sms["SMS forwarding<br/>[smsModule.kt]"]
  node_poll["SMS polling<br/>[SmsPoll.kt]"]
  node_scheduler["Scheduled tasks"]
end

subgraph group_runtime["Runtime support"]
  node_shell["Shell execution<br/>[ShellKano.kt]"]
  node_root["Root shell socket<br/>[RootShell.kt]"]
  node_identity["Device identity"]
  node_metadata["App configuration<br/>[AppMeta.kt]"]
  node_prefs[("Persistent preferences")]
end

node_user(("Device user"))
node_browser(("Browser user"))
node_external["SMS delivery services"]

node_user -->|"opens"| node_activity
node_activity -->|"starts service"| node_webservice
node_activity -->|"starts service"| node_adbservice
node_webservice -->|"starts server"| node_webserver
node_webserver -->|"installs routes"| node_api
node_browser -->|"opens console"| node_webserver
node_browser -->|"uses"| node_frontend
node_frontend -.->|"sends requests"| node_api
node_api -->|"checks requests"| node_auth
node_api -->|"exposes status"| node_deviceinfo
node_api -->|"exposes controls"| node_advanced
node_api -->|"exposes commands"| node_at
node_api -->|"exposes updates"| node_ota
node_api -->|"exposes plugins"| node_plugins
node_api -->|"exposes network tools"| node_network
node_api -->|"exposes SMS controls"| node_sms
node_sms -->|"uses polling"| node_poll
node_poll -->|"forwards messages"| node_external
node_api -->|"exposes scheduling"| node_scheduler
node_advanced -->|"runs commands"| node_shell
node_shell -->|"uses socket"| node_root
node_activity -->|"initializes identity"| node_identity
node_webservice -->|"initializes identity"| node_identity
node_webservice -->|"initializes settings"| node_metadata
node_identity -->|"reads and writes"| node_prefs
node_metadata -->|"persists settings"| node_prefs

click node_activity "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/MainActivity.kt"
click node_webservice "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/WebService.kt"
click node_adbservice "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/ADBService.kt"
click node_webserver "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt"
click node_api "https://github.com/kanoqwq/ufi-tools/tree/http-server-version/app/src/main/java/com/minikano/f50_sms/modules"
click node_auth "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/auth/KanoAuth.kt"
click node_frontend "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/frontEnd/public/script/main.js"
click node_deviceinfo "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/deviceInfo/baseDeviceInfoModule.kt"
click node_advanced "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/advanced/advancedToolsModule.kt"
click node_at "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/at/atModule.kt"
click node_ota "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/ota/otaModule.kt"
click node_plugins "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/plugins/pluginsModule.kt"
click node_network "https://github.com/kanoqwq/ufi-tools/tree/http-server-version/app/src/main/java/com/minikano/f50_sms/modules"
click node_sms "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/smsForward/smsModule.kt"
click node_poll "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/SmsPoll.kt"
click node_scheduler "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/scheduledTask/scheduledTaskModule.kt"
click node_shell "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/ShellKano.kt"
click node_root "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/RootShell.kt"
click node_identity "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/UniqueDeviceIDManager.kt"
click node_metadata "https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/configs/AppMeta.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_webservice,node_adbservice,node_user,node_browser toneBlue
class node_webserver,node_api,node_auth,node_frontend toneAmber
class node_deviceinfo,node_advanced,node_at,node_ota,node_plugins,node_network toneMint
class node_sms,node_poll,node_scheduler toneRose
class node_shell,node_root,node_identity,node_metadata,node_prefs,node_external toneIndigo
```

## Components

### App lifecycle

- [Android app](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/MainActivity.kt): `app/src/main/java/com/minikano/f50_sms/MainActivity.kt`
- [Web service](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/WebService.kt): `app/src/main/java/com/minikano/f50_sms/WebService.kt`
- [ADB service](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/ADBService.kt): `app/src/main/java/com/minikano/f50_sms/ADBService.kt`

### Web control

- [Ktor web server](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt): `app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt`
- [API modules](https://github.com/kanoqwq/ufi-tools/tree/http-server-version/app/src/main/java/com/minikano/f50_sms/modules): `app/src/main/java/com/minikano/f50_sms/modules`
- [API authentication](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/auth/KanoAuth.kt): `app/src/main/java/com/minikano/f50_sms/modules/auth/KanoAuth.kt`
- [Web console](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/frontEnd/public/script/main.js): `app/frontEnd/public/script/main.js`

### Device management

- [Device status](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/deviceInfo/baseDeviceInfoModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/deviceInfo/baseDeviceInfoModule.kt`
- [Advanced controls](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/advanced/advancedToolsModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/advanced/advancedToolsModule.kt`
- [AT commands](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/at/atModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/at/atModule.kt`
- [OTA updates](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/ota/otaModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/ota/otaModule.kt`
- [Plugin system](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/plugins/pluginsModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/plugins/pluginsModule.kt`
- [Network controls](https://github.com/kanoqwq/ufi-tools/tree/http-server-version/app/src/main/java/com/minikano/f50_sms/modules): `app/src/main/java/com/minikano/f50_sms/modules`

### Communications

- [SMS forwarding](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/smsForward/smsModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/smsForward/smsModule.kt`
- [SMS polling](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/SmsPoll.kt): `app/src/main/java/com/minikano/f50_sms/utils/SmsPoll.kt`
- [Scheduled tasks](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/modules/scheduledTask/scheduledTaskModule.kt): `app/src/main/java/com/minikano/f50_sms/modules/scheduledTask/scheduledTaskModule.kt`

### Runtime support

- [Shell execution](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/ShellKano.kt): `app/src/main/java/com/minikano/f50_sms/utils/ShellKano.kt`
- [Root shell socket](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/RootShell.kt): `app/src/main/java/com/minikano/f50_sms/utils/RootShell.kt`
- [Device identity](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/utils/UniqueDeviceIDManager.kt): `app/src/main/java/com/minikano/f50_sms/utils/UniqueDeviceIDManager.kt`
- [App configuration](https://github.com/kanoqwq/ufi-tools/blob/http-server-version/app/src/main/java/com/minikano/f50_sms/configs/AppMeta.kt): `app/src/main/java/com/minikano/f50_sms/configs/AppMeta.kt`
- **Persistent preferences**

### Other components

- **Device user**
- **Browser user**
- **SMS delivery services**

## Connections

- Device user → Android app: opens (evidence: `README.md`)
- Android app → Web service: starts service (evidence: `app/src/main/java/com/minikano/f50_sms/MainActivity.kt`)
- Android app → ADB service: starts service (evidence: `app/src/main/java/com/minikano/f50_sms/MainActivity.kt`)
- Web service → Ktor web server: starts server (evidence: `app/src/main/java/com/minikano/f50_sms/WebService.kt`)
- Ktor web server → API modules: installs routes (evidence: `app/src/main/java/com/minikano/f50_sms/KanoWebServer.kt`)
- Browser user → Ktor web server: opens console (evidence: `README.md`)
- Browser user → Web console: uses (evidence: `README.md`)
- Web console → API modules: sends requests
- API modules → API authentication: checks requests (evidence: `app/src/main/java/com/minikano/f50_sms/modules/auth/authRoute.kt`)
- API modules → Device status: exposes status (evidence: `README.md`)
- API modules → Advanced controls: exposes controls (evidence: `README.md`)
- API modules → AT commands: exposes commands (evidence: `README.md`)
- API modules → OTA updates: exposes updates (evidence: `README.md`)
- API modules → Plugin system: exposes plugins (evidence: `README.md`)
- API modules → Network controls: exposes network tools (evidence: `README.md`)
- API modules → SMS forwarding: exposes SMS controls (evidence: `README.md`)
- SMS forwarding → SMS polling: uses polling (evidence: `app/src/main/java/com/minikano/f50_sms/modules/smsForward/smsModule.kt`)
- SMS polling → SMS delivery services: forwards messages (evidence: `app/src/main/java/com/minikano/f50_sms/utils/SmsPoll.kt`)
- API modules → Scheduled tasks: exposes scheduling (evidence: `README.md`)
- Advanced controls → Shell execution: runs commands (evidence: `app/src/main/java/com/minikano/f50_sms/modules/advanced/advancedToolsModule.kt`)
- Shell execution → Root shell socket: uses socket (evidence: `app/src/main/java/com/minikano/f50_sms/utils/ShellKano.kt`)
- Android app → Device identity: initializes identity (evidence: `app/src/main/java/com/minikano/f50_sms/MainActivity.kt`)
- Web service → Device identity: initializes identity (evidence: `app/src/main/java/com/minikano/f50_sms/WebService.kt`)
- Web service → App configuration: initializes settings (evidence: `app/src/main/java/com/minikano/f50_sms/WebService.kt`)
- Device identity → Persistent preferences: reads and writes (evidence: `app/src/main/java/com/minikano/f50_sms/utils/UniqueDeviceIDManager.kt`)
- App configuration → Persistent preferences: persists settings (evidence: `app/src/main/java/com/minikano/f50_sms/configs/AppMeta.kt`)
