How xiang20041021/liumarat works
LIUMA is an Android device-management agent paired with a web dashboard and Fastify backend. The main flow starts when the Android app launches its persistent service, connects to the backend, and receives commands; users operate the dashboard through the backend’s APIs and device socket channel. The repository also includes authentication, device enrollment and records, logs, settings, and a broad set of device capabilities. The README is empty, and many feature and route implementations were not excerpted, so those subsystems are represented at directory level and unsupported links are omitted.
Main entry points: MainService.java Persistent service · SocketClient.java Device socket client · socket.ts Device socket service · index.ts Database access
Components 24
Web console
- Dashboard pages
frontend/src/pages - Web socket client
frontend/src/services/socket.ts - Web API client
frontend/src/services/api.ts
Backend service
- HTTP server
backend/src/index.ts - Authentication routes
backend/src/routes/auth.ts - Product routes
backend/src/routes - Auth middleware
backend/src/middleware/auth.ts - Device socket service
backend/src/services/socket.ts - Task service
backend/src/services/tasks.ts - Database access
backend/src/db/index.ts - Persistent records
backend/src/db/schema.ts - User and device data
backend/src/db/schema.ts
Android agent
- Android startup
LIUMA/app/src/main/java/com/liuma/app/core/LiumaApp.java - Persistent service
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Device socket client
LIUMA/app/src/main/java/com/liuma/app/core/network/SocketClient.java - Command router
LIUMA/app/src/main/java/com/liuma/app/core/network/SocketCommandRouter.java - Wire protocol
LIUMA/app/src/main/java/com/liuma/app/core/Protocol.java - Permission manager
LIUMA/app/src/main/java/com/liuma/app/core/permissions/PermissionManager.java
Device capabilities
- Device feature handlers
LIUMA/app/src/main/java/com/liuma/app/features - Location tracking
LIUMA/app/src/main/java/com/liuma/app/features/gps - Screen and remote control
LIUMA/app/src/main/java/com/liuma/app/features/screen - Remote display service
LIUMA/app/src/main/java/com/liuma/app/features/hvnc - Files and transfers
LIUMA/app/src/main/java/com/liuma/app/features/storage
Other components
- Dashboard user
Connections 22
- Dashboard user → Dashboard pages: uses
- Android startup → Persistent service: starts
LIUMA/app/src/main/java/com/liuma/app/core/LiumaApp.java - Persistent service → Command router: initializes
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Persistent service → Device feature handlers: starts clipboard and GPS
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Device socket client → Command router: initializes
LIUMA/app/src/main/java/com/liuma/app/core/network/SocketClient.java - Device socket client → Wire protocol: uses constants
LIUMA/app/src/main/java/com/liuma/app/core/network/SocketClient.java - Persistent service → Device socket client: uses socket
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Persistent service → Wire protocol: uses constants
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Device feature handlers → Permission manager: checks access
LIUMA/app/src/main/java/com/liuma/app/features/gps/GpsManager.java - HTTP server → Authentication routes: registers
backend/src/index.ts - HTTP server → Product routes: registers
backend/src/index.ts - HTTP server → Device socket service: registers
backend/src/index.ts - Authentication routes → Database access: reads and writes
backend/src/routes/auth.ts - Authentication routes → Auth middleware: uses session helpers
backend/src/routes/auth.ts - Auth middleware → Database access: checks sessions
backend/src/middleware/auth.ts - Device socket service → Database access: reads and writes
backend/src/services/socket.ts - Task service → Device socket service: uses socket service
backend/src/services/tasks.ts - Database access → Persistent records: queries records
backend/src/db/index.ts - Dashboard pages → Web API client: calls API
- Dashboard pages → Web socket client: uses device channel
- Device socket client → Device socket service: exchanges device events
- Device socket client → Device feature handlers: dispatches commands
LIUMA/app/src/main/java/com/liuma/app/features/proxy/ProxyService.java