How nazard2008/ideal-octo-rotary-phone works
LIUMA is a device-management platform comprising an Android agent, a web console, and a Fastify backend. The apparent workflow is an operator using the console to manage devices and request device capabilities; the backend exposes APIs and sockets, while the agent connects and routes commands to feature services. The source index and excerpts support the Android service/socket and backend startup/authentication relationships shown; most console-to-backend and device-feature wiring was not sampled, so those links are marked unverified or omitted.
Main entry points: index.ts HTTP server · device Device views · auth.ts Authentication · MainService.java Main service
Components 24
Operator console
- Web console
frontend/src/App.tsx - Device views
frontend/src/pages/device - API client
frontend/src/services/api.ts - Socket client
frontend/src/services/socket.ts
Backend services
- HTTP server
backend/src/index.ts - Authentication
backend/src/routes/auth.ts - Auth middleware
backend/src/middleware/auth.ts - Device routes
backend/src/routes/device.ts - Management routes
backend/src/routes - Socket service
backend/src/services/socket.ts - Task manager
backend/src/services/tasks.ts - Database access
backend/src/db/index.ts - SQLite data
backend/src/db/schema.ts
Android agent
- Agent startup
LIUMA/app/src/main/java/com/liuma/app/core/LiumaApp.java - Main service
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Command protocol
LIUMA/app/src/main/java/com/liuma/app/core/Protocol.java - Device socket
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
Device capabilities
- Device feature services
LIUMA/app/src/main/java/com/liuma/app/features - Screen capture
LIUMA/app/src/main/java/com/liuma/app/features/screen/ScreenCaptureService.kt - Remote control
LIUMA/app/src/main/java/com/liuma/app/features/screen/RemoteControlService.kt - Virtual display
LIUMA/app/src/main/java/com/liuma/app/features/hvnc/HvncService.kt - Location tracking
LIUMA/app/src/main/java/com/liuma/app/features/gps/LocationService.kt
Other components
- Operator
Connections 24
- Operator → Web console: uses
- Web console → Device views: presents
- Device views → API client: requests data
- Device views → Socket client: sends commands
- API client → HTTP server: HTTP requests
- Socket client → Socket service: socket events
- HTTP server → Authentication: registers
backend/src/index.ts - HTTP server → Device routes: registers
backend/src/index.ts - HTTP server → Management routes: registers
backend/src/index.ts - HTTP server → Socket service: initializes
backend/src/index.ts - HTTP server → Task manager: starts
backend/src/index.ts - Authentication → Auth middleware: gets user
backend/src/routes/auth.ts - Authentication → Database access: reads and writes
backend/src/routes/auth.ts - Auth middleware → Database access: checks session
backend/src/middleware/auth.ts - Database access → SQLite data: persists records
backend/src/db/index.ts - Agent startup → Main service: starts
- Main service → Device socket: uses connection
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Main service → Command router: initializes
LIUMA/app/src/main/java/com/liuma/app/service/MainService.java - Device socket → Command router: initializes
LIUMA/app/src/main/java/com/liuma/app/core/network/SocketClient.java - Device socket → HTTP server: enrolls and connects
- Command router → Device feature services: dispatches commands
- Remote control → Screen capture: uses capture
LIUMA/app/src/main/java/com/liuma/app/features/screen/RemoteControlService.kt - Virtual display → Device feature services: provides capability
LIUMA/app/src/main/java/com/liuma/app/features/hvnc/HvncService.kt - Location tracking → Device feature services: provides capability
LIUMA/app/src/main/java/com/liuma/app/features/gps/LocationService.kt