# fahimahamed1/fasonrat architecture

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

- Interactive diagram: https://gitdiagram.com/fahimahamed1/fasonrat
- Repository: https://github.com/fahimahamed1/fasonrat

## Overview

FasonRat is a self-hosted Android remote-management platform: operators use a web dashboard to manage connected devices, while an Android agent reports device data and handles remote commands. The README documents device access, screen control, resilience, APK customization, and administration; the source index identifies the corresponding backend, frontend, and agent modules. Some cross-process wiring and unsampled route implementations are not shown, so those links are omitted or marked unverified rather than inferred as direct calls.

Main entry points: [`fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java`](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java) (Command router), [`frontend/src/pages`](https://github.com/fahimahamed1/fasonrat/tree/main/frontend/src/pages) (Management pages), [`fason/app/src/main/java/com/fason/app/service/MainService.java`](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/service/MainService.java) (Foreground service), [`backend/src/index.ts`](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/index.ts) (Server entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web dashboard"]
  node_webapp["Dashboard app<br/>[App.tsx]"]
  node_webpages["Management pages"]
  node_webapi["API client<br/>[api.ts]"]
  node_websocket["Socket client<br/>[socket.ts]"]
end

subgraph group_server["Backend services"]
  node_backend["Server entry<br/>[index.ts]"]
  node_auth["Authentication<br/>[index.ts]"]
  node_routes["API routes"]
  node_realtime["Device sockets<br/>[socket.ts]"]
  node_tasks["Background tasks<br/>[tasks.ts]"]
  node_database[("Application data<br/>[schema.ts]")]
  node_builder["APK builder<br/>[builder.ts]"]
end

subgraph group_agent["Android agent"]
  node_android["Android agent<br/>[FasonApp.java]"]
  node_service["Foreground service<br/>[MainService.java]"]
  node_socketclient["Agent connection<br/>[SocketClient.java]"]
  node_router["Command router"]
  node_protocol["Command protocol<br/>[Protocol.java]"]
  node_resilience["Background resilience"]
end

subgraph group_device["Device capabilities"]
  node_deviceaccess["Device data access"]
  node_files["File transfer"]
  node_hvnc["Screen control<br/>[HVncManager.java]"]
  node_accessibility["Accessibility features"]
end

node_operator(("Operator"))
node_http(("HTTP interface"))

node_operator -->|"uses"| node_webapp
node_webapp -->|"presents"| node_webpages
node_webpages -.->|"requests data"| node_webapi
node_webpages -.->|"receives updates"| node_websocket
node_webapi -.->|"sends requests"| node_http
node_http -.->|"serves"| node_backend
node_backend -->|"registers"| node_auth
node_backend -->|"registers"| node_routes
node_routes -.->|"reads and writes"| node_database
node_routes -.->|"uses sockets"| node_realtime
node_tasks -->|"uses"| node_database
node_android -->|"starts"| node_service
node_service -->|"connects through"| node_socketclient
node_service -->|"dispatches commands"| node_router
node_router -.->|"uses messages"| node_protocol
node_socketclient -.->|"exchanges events"| node_realtime
node_router -.->|"invokes features"| node_deviceaccess
node_router -.->|"handles transfers"| node_files
node_router -.->|"controls screen"| node_hvnc
node_accessibility -->|"forwards events"| node_hvnc
node_service -->|"uses watchdog"| node_resilience
node_webpages -.->|"configures builds"| node_builder

click node_webapp "https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/App.tsx"
click node_webpages "https://github.com/fahimahamed1/fasonrat/tree/main/frontend/src/pages"
click node_webapi "https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/services/api.ts"
click node_websocket "https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/services/socket.ts"
click node_backend "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/index.ts"
click node_auth "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/auth/index.ts"
click node_routes "https://github.com/fahimahamed1/fasonrat/tree/main/backend/src/routes"
click node_realtime "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/services/socket.ts"
click node_tasks "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/services/tasks.ts"
click node_database "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/db/schema.ts"
click node_android "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/FasonApp.java"
click node_service "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/service/MainService.java"
click node_socketclient "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/SocketClient.java"
click node_router "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java"
click node_protocol "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/Protocol.java"
click node_deviceaccess "https://github.com/fahimahamed1/fasonrat/tree/main/fason/app/src/main/java/com/fason/app/features"
click node_files "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/TransferHelper.java"
click node_hvnc "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java"
click node_accessibility "https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java"
click node_resilience "https://github.com/fahimahamed1/fasonrat/tree/main/fason/app/src/main/java/com/fason/app/receiver"
click node_builder "https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/routes/builder.ts"

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_webapp,node_webpages,node_webapi,node_websocket toneBlue
class node_backend,node_auth,node_routes,node_realtime,node_tasks,node_database,node_builder toneAmber
class node_android,node_service,node_socketclient,node_router,node_protocol,node_resilience toneMint
class node_deviceaccess,node_files,node_hvnc,node_accessibility toneRose
class node_operator,node_http toneIndigo
```

## Components

### Web dashboard

- [Dashboard app](https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Management pages](https://github.com/fahimahamed1/fasonrat/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Socket client](https://github.com/fahimahamed1/fasonrat/blob/main/frontend/src/services/socket.ts): `frontend/src/services/socket.ts`

### Backend services

- [Server entry](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Authentication](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/auth/index.ts): `backend/src/auth/index.ts`
- [API routes](https://github.com/fahimahamed1/fasonrat/tree/main/backend/src/routes): `backend/src/routes`
- [Device sockets](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/services/socket.ts): `backend/src/services/socket.ts`
- [Background tasks](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/services/tasks.ts): `backend/src/services/tasks.ts`
- [Application data](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/db/schema.ts): `backend/src/db/schema.ts`
- [APK builder](https://github.com/fahimahamed1/fasonrat/blob/main/backend/src/routes/builder.ts): `backend/src/routes/builder.ts`

### Android agent

- [Android agent](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/FasonApp.java): `fason/app/src/main/java/com/fason/app/core/FasonApp.java`
- [Foreground service](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/service/MainService.java): `fason/app/src/main/java/com/fason/app/service/MainService.java`
- [Agent connection](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/SocketClient.java): `fason/app/src/main/java/com/fason/app/core/network/SocketClient.java`
- [Command router](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java): `fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java`
- [Command protocol](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/Protocol.java): `fason/app/src/main/java/com/fason/app/core/Protocol.java`
- [Background resilience](https://github.com/fahimahamed1/fasonrat/tree/main/fason/app/src/main/java/com/fason/app/receiver): `fason/app/src/main/java/com/fason/app/receiver`

### Device capabilities

- [Device data access](https://github.com/fahimahamed1/fasonrat/tree/main/fason/app/src/main/java/com/fason/app/features): `fason/app/src/main/java/com/fason/app/features`
- [File transfer](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/network/TransferHelper.java): `fason/app/src/main/java/com/fason/app/core/network/TransferHelper.java`
- [Screen control](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java): `fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java`
- [Accessibility features](https://github.com/fahimahamed1/fasonrat/blob/main/fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java): `fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java`

### Other components

- **Operator**
- **HTTP interface**

## Connections

- Operator → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Management pages: presents (evidence: `README.md`)
- Management pages → API client: requests data
- Management pages → Socket client: receives updates
- API client → HTTP interface: sends requests
- HTTP interface → Server entry: serves
- Server entry → Authentication: registers (evidence: `backend/src/index.ts`)
- Server entry → API routes: registers (evidence: `backend/src/index.ts`)
- API routes → Application data: reads and writes (evidence: `backend/src/routes/auth.ts`)
- API routes → Device sockets: uses sockets
- Background tasks → Application data: uses (evidence: `backend/src/services/tasks.ts`)
- Android agent → Foreground service: starts (evidence: `fason/app/src/main/java/com/fason/app/core/FasonApp.java`)
- Foreground service → Agent connection: connects through (evidence: `fason/app/src/main/java/com/fason/app/service/MainService.java`)
- Foreground service → Command router: dispatches commands (evidence: `fason/app/src/main/java/com/fason/app/service/MainService.java`)
- Command router → Command protocol: uses messages
- Agent connection → Device sockets: exchanges events (evidence: `README.md`)
- Command router → Device data access: invokes features (evidence: `fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java`)
- Command router → File transfer: handles transfers
- Command router → Screen control: controls screen (evidence: `fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java`)
- Accessibility features → Screen control: forwards events (evidence: `fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java`)
- Foreground service → Background resilience: uses watchdog (evidence: `fason/app/src/main/java/com/fason/app/service/MainService.java`)
- Management pages → APK builder: configures builds
