# webosbrew/dev-manager-desktop architecture

> Architecture diagram of the GitHub repository webosbrew/dev-manager-desktop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webosbrew/dev-manager-desktop
- Repository: https://github.com/webosbrew/dev-manager-desktop

## Overview

##### Main Components
a. Desktop Host (Tauri Shell)
- Bundles the Angular UI and Rust backend into a cross-platform desktop app.
- Exposes a JavaScript ↔ Rust bridge (IPC/API) for front-end ↔ back-end communication.
b. Front-end (Angular SPA)
- src/app: UI Components & pages (Add Device, Apps, Files, Terminal, Debug, etc.).
- src/core/services: Angular services that call Tauri.invoke or WebSocket for back-end actions.
c. Back-end (Rust / src-tauri)
- Main process (main.rs) & lib.rs: initializes Tauri and registers commands.
- Plugins (src-tauri/src/plugins): implement Tauri commands (e.g., cmd, file, device, shell, local_file).
- Managers (device_manager, session_manager, shell_manager, spawn_manager): encapsulate stateful operations.
- Conn_pool: handles persistent connections over SSH/SFTP to TV.
- Event_channel: relays asynchronous events/data streams to front end.
d. External Systems / Resources
- Target webOS TV devices (SSH, SFTP, Luna API).
- Local File System (for file transfers).
- Local OS (for spawning CLI tools, e.g., ares-cli compatibility).
- Fastlane (for mobile code signing / packaging tasks, if used).
e. Build & Deployment
- angular.json, tsconfig: front-end build config.
- Cargo.toml, build.rs: Rust build config.
- fastlane folder: scripts for packaging on iOS/Android (if relevant).
- GitHub workflows & release scripts.

##### Relationships and Data Flows
- UI → Tauri.invoke(“device_add”, params) → Rust plugin (device.rs) → Conn_pool → SSH to TV.
- UI → Tauri.invoke(“file_list”, path) → Rust plugin (remote_files) → SFTP to TV → returns file list → UI.
- UI → Tauri.invoke(“spawn_shell”, cmd) → spawn_manager → child process / pty → streams back to UI via event_channel.
- UI listens on event_channel for streaming logs, file-transfer progress, terminal data.
- Rust managers coordinate sessions, token handling, and permission grants (via permissions/*.toml).

##### Architectural Patterns & Principles
- Separation of Concerns: UI layer (Angular) vs. Native layer (Rust).
- Modular Plugins: each capability (device, file, shell) is isolated as a Tauri plugin.
- Connection Pooling & Session Management: reuse SSH/SFTP sessions across UI requests.
- Reactive Event Handling: event_channel provides streaming/evented updates to the UI.

##### Technologies & Frameworks to Annotate
- Angular (TypeScript, Components, Services, RxJS).
- Tauri (Rust + WebView2 / WebKit).
- Rust (tokio, ssh2, sftp, serde, toml).
- SSH/SFTP (libssh2 via ssh2 crate).
- Fastlane (Ruby scripts for code signing).
- GitHub Actions (CI/CD workflows).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        AddDevice["Add Device Module"]:::ui
        Apps["Apps Module"]:::ui
        Files["Files Module"]:::ui
        Terminal["Terminal Module"]:::ui
        Debug["Debug Module"]:::ui
        BackendClient["BackendClient Service"]:::ui
        EventChannelUI["EventChannel (UI)"]:::ui
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        TauriHost["Tauri Host (WebView + Rust)"]:::ipc
    end

    %% Domain & Infrastructure Layer
    subgraph "Domain/Infrastructure Layer"
        direction TB
        subgraph Plugins
            direction TB
            DevicePlugin["device.rs"]:::domain
            FilePlugin["file.rs"]:::domain
            ShellPlugin["shell.rs"]:::domain
            LocalFilePlugin["local_file.rs"]:::domain
            CmdPlugin["cmd.rs"]:::domain
            DevModePlugin["devmode.rs"]:::domain
        end
        subgraph Managers
            direction TB
            DeviceManager["DeviceManager"]:::domain
            SessionManager["SessionManager"]:::domain
            ShellManager["ShellManager"]:::domain
            SpawnManager["SpawnManager"]:::domain
        end
        subgraph ConnPool
            direction TB
            ConnPoolMod["conn_pool modulo"]:::domain
            ConnPoolPool["pool.rs"]:::domain
            ConnPoolConn["connection.rs"]:::domain
            ConnPoolCmd["cmd.rs"]:::domain
        end
        subgraph EventChannel
            direction TB
            EventChannelMod["event_channel modulo"]:::domain
            EventChannelChan["channel.rs"]:::domain
        end
    end

    %% External Systems
    subgraph "External Systems"
        direction TB
        TVDevices["webOS TV (SSH/SFTP/Luna API)"]:::external
        LocalFS["Local File System"]:::external
        CLITools["CLI Tools (ares-cli)"]:::external
    end

    %% Connections: UI to Backend
    AddDevice -->|uses| BackendClient
    Apps -->|uses| BackendClient
    Files -->|uses| BackendClient
    Terminal -->|uses| BackendClient
    Debug -->|uses| BackendClient

    BackendClient -->|IPC invoke| TauriHost
    EventChannelUI -->|listens| TauriHost

    %% Tauri to Plugins
    TauriHost -->|registers commands| DevicePlugin
    TauriHost -->|registers commands| FilePlugin
    TauriHost -->|registers commands| ShellPlugin
    TauriHost -->|registers commands| LocalFilePlugin
    TauriHost -->|registers commands| CmdPlugin
    TauriHost -->|registers commands| DevModePlugin

    %% Plugins to Managers
    DevicePlugin -->|calls| DeviceManager
    FilePlugin -->|calls| SessionManager
    FilePlugin -->|calls| ConnPoolMod
    ShellPlugin -->|calls| ShellManager
    CmdPlugin -->|calls| SpawnManager
    DevModePlugin -->|calls| DeviceManager

    %% Managers to Resources
    DeviceManager -->|SSH| ConnPoolMod
    SessionManager -->|manages sessions| ConnPoolMod
    ShellManager -->|executes shell| ConnPoolMod
    SpawnManager -->|spawns| CLITools

    %% Connection Pool to TV and FS
    ConnPoolPool -->|connection| TVDevices
    ConnPoolConn -->|connection| TVDevices
    ConnPoolCmd -->|executes| TVDevices
    FilePlugin -->|SFTP| LocalFS

    %% Event Channel back to UI
    DeviceManager -->|events| EventChannelMod
    SessionManager -->|events| EventChannelMod
    ShellManager -->|events| EventChannelMod
    SpawnManager -->|events| EventChannelMod
    EventChannelChan -->|stream| EventChannelUI

    %% Click Events
    click TauriHost "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/main.rs"
    click TauriHost "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/lib.rs"
    click TauriHost "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/tauri.conf.json"
    click AddDevice "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/add-device/add-device.module.ts"
    click AddDevice "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/add-device/wizard/wizard.component.ts"
    click Apps "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/apps/apps.module.ts"
    click Apps "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/apps/apps.component.ts"
    click Files "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/files/files.module.ts"
    click Files "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/files/files.component.ts"
    click Terminal "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/terminal/terminal.module.ts"
    click Terminal "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/terminal/terminal.component.ts"
    click Debug "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/debug/debug.module.ts"
    click Debug "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/debug/debug.component.ts"
    click BackendClient "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/services/backend-client.ts"
    click BackendClient "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/services/device-manager.service.ts"
    click BackendClient "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/services/remote-file.service.ts"
    click BackendClient "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/services/remote-shell.service.ts"
    click BackendClient "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/services/remote-command.service.ts"
    click EventChannelUI "https://github.com/webosbrew/dev-manager-desktop/blob/main/src/app/core/event-channel.ts"
    click DevicePlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/device.rs"
    click FilePlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/file.rs"
    click ShellPlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/shell.rs"
    click LocalFilePlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/local_file.rs"
    click CmdPlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/cmd.rs"
    click DevModePlugin "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/plugins/devmode.rs"
    click DeviceManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/device_manager/manager.rs"
    click DeviceManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/device_manager/device.rs"
    click SessionManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/session_manager/manager.rs"
    click ShellManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/shell_manager/manager.rs"
    click ShellManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/shell_manager/shell.rs"
    click SpawnManager "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/spawn_manager/manager.rs"
    click ConnPoolMod "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/conn_pool/mod.rs"
    click ConnPoolPool "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/conn_pool/pool.rs"
    click ConnPoolConn "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/conn_pool/connection.rs"
    click ConnPoolCmd "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/conn_pool/cmd.rs"
    click EventChannelMod "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/event_channel/mod.rs"
    click EventChannelChan "https://github.com/webosbrew/dev-manager-desktop/blob/main/src-tauri/src/event_channel/channel.rs"

    %% Styling
    classDef ui fill:#D0E6FF,stroke:#0366D6,color:#000
    classDef ipc fill:#D0FFD6,stroke:#028A0F,color:#000
    classDef domain fill:#FFE5B4,stroke:#E57C00,color:#000
    classDef external fill:#E0E0E0,stroke:#888,color:#000
```
