# sabnish776/cyberops architecture

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

- Interactive diagram: https://gitdiagram.com/sabnish776/cyberops
- Repository: https://github.com/sabnish776/cyberops

## Overview

CyberOps is a browser-based remote-operations workspace. Users authenticate, manage SSH server profiles, connect to targets, and then use terminals or focused workflows for service discovery/control, monitoring, database queries, SFTP, tunnels, remote desktop, and multi-server command broadcast. The graph emphasizes documented capabilities and sampled call paths; unsampled integrations are shown only when the README documents them.

Main entry points: [`frontend/src/App.tsx`](https://github.com/sabnish776/cyberops/blob/main/frontend/src/App.tsx) (Workspace shell), [`frontend/src/api/client.ts`](https://github.com/sabnish776/cyberops/blob/main/frontend/src/api/client.ts) (REST client), [`backend/src/main/java/com/cyberops/service/SshClientService.java`](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SshClientService.java) (SSH client), [`backend/src/main/java/com/cyberops/controller/ServerController.java`](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/controller/ServerController.java) (Server & sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Workspace UI"]
  node_workspace["Workspace shell<br/>[App.tsx]"]
  node_authui["Sign-in UI<br/>[AuthModal.tsx]"]
  node_api_client["REST client<br/>[client.ts]"]
  node_server_ui["Server dashboard<br/>[ServerCard.tsx]"]
  node_terminal_ui["Terminal workspace"]
  node_service_ui["Service manager"]
  node_monitor_ui["Monitoring"]
  node_database_ui["Database console"]
  node_sftp_ui["SFTP browser"]
  node_tunnel_ui["Tunnel manager"]
  node_broadcast_ui["Fleet broadcast"]
  node_desktop_ui["Remote desktop"]
end

subgraph group_api["Backend API"]
  node_backend_api["REST controllers"]
  node_server_control["Server &amp; sessions"]
end

subgraph group_remote["Remote Operations"]
  node_ssh["SSH client"]
  node_session_manager["SSH sessions"]
  node_service_discovery["Service discovery"]
  node_monitor_service["Telemetry"]
  node_database_service["Remote queries"]
  node_sftp_service["File transfer<br/>[SftpService.java]"]
  node_tunnel_service["Port forwarding<br/>[TunnelService.java]"]
  node_broadcast_service["Parallel execution"]
  node_desktop_socket["Desktop stream"]
  node_terminal_socket["Terminal stream"]
end

subgraph group_state["Identity &amp; State"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_server_profiles[("Server profiles<br/>[ServerProfile.java]")]
  node_session_records[("Session records<br/>[SessionRecord.java]")]
  node_audit["Audit logging<br/>[AuditService.java]"]
  node_sqlite[("Embedded SQLite")]
end

node_operator(("Operator"))
node_ssh_targets(("SSH targets"))

node_operator -->|"uses"| node_workspace
node_workspace -->|"opens"| node_authui
node_authui -->|"authenticates"| node_api_client
node_workspace -->|"renders"| node_server_ui
node_workspace -->|"renders"| node_terminal_ui
node_workspace -->|"renders"| node_service_ui
node_workspace -->|"renders"| node_monitor_ui
node_workspace -->|"renders"| node_database_ui
node_workspace -->|"renders"| node_sftp_ui
node_workspace -->|"renders"| node_tunnel_ui
node_workspace -->|"renders"| node_broadcast_ui
node_workspace -->|"renders"| node_desktop_ui
node_server_ui -->|"requests"| node_api_client
node_terminal_ui -.->|"requests"| node_api_client
node_service_ui -->|"requests"| node_api_client
node_monitor_ui -.->|"requests"| node_api_client
node_database_ui -->|"requests"| node_api_client
node_sftp_ui -->|"requests"| node_api_client
node_tunnel_ui -->|"requests"| node_api_client
node_broadcast_ui -.->|"requests"| node_api_client
node_api_client -->|"HTTP requests"| node_backend_api
node_backend_api -.->|"delegates"| node_auth_service
node_backend_api -.->|"routes server calls"| node_server_control
node_server_control -->|"reads/writes"| node_server_profiles
node_server_control -->|"tests connection"| node_ssh
node_server_control -->|"manages sessions"| node_session_manager
node_session_manager -.->|"persists sessions"| node_session_records
node_service_discovery -->|"executes probes"| node_ssh
node_monitor_service -->|"reads telemetry"| node_ssh
node_tunnel_service -->|"opens forwarding"| node_ssh
node_broadcast_service -->|"executes remotely"| node_ssh
node_sftp_service -.->|"transfers files"| node_ssh
node_desktop_socket -->|"uses session"| node_session_manager
node_terminal_socket -.->|"uses session"| node_session_manager
node_ssh -->|"connects"| node_ssh_targets
node_server_control -->|"records events"| node_audit
node_broadcast_service -->|"audits runs"| node_audit
node_tunnel_service -->|"audits changes"| node_audit
node_audit -->|"stores logs"| node_sqlite
node_server_profiles -.->|"stored in"| node_sqlite

click node_workspace "https://github.com/sabnish776/cyberops/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/auth/AuthModal.tsx"
click node_api_client "https://github.com/sabnish776/cyberops/blob/main/frontend/src/api/client.ts"
click node_server_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/dashboard/ServerCard.tsx"
click node_terminal_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/terminal/TerminalWorkspace.tsx"
click node_service_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/services/ServiceManagerModal.tsx"
click node_monitor_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/monitoring/MonitoringModal.tsx"
click node_database_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/database/DatabaseConsoleModal.tsx"
click node_sftp_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/sftp/FileManagerModal.tsx"
click node_tunnel_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/tunnels/TunnelManagerModal.tsx"
click node_broadcast_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/broadcast/BroadcastWorkspace.tsx"
click node_desktop_ui "https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/desktop/RemoteDesktopModal.tsx"
click node_backend_api "https://github.com/sabnish776/cyberops/tree/main/backend/src/main/java/com/cyberops/controller"
click node_auth_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/AuthService.java"
click node_server_control "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/controller/ServerController.java"
click node_ssh "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SshClientService.java"
click node_session_manager "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SshSessionManager.java"
click node_service_discovery "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/ServiceManagerService.java"
click node_monitor_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/MonitoringService.java"
click node_database_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/DatabaseService.java"
click node_sftp_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SftpService.java"
click node_tunnel_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/TunnelService.java"
click node_broadcast_service "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/BroadcastService.java"
click node_desktop_socket "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/websocket/RemoteDesktopWebSocketHandler.java"
click node_terminal_socket "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/websocket/TerminalWebSocketHandler.java"
click node_server_profiles "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/model/ServerProfile.java"
click node_session_records "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/model/SessionRecord.java"
click node_audit "https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/AuditService.java"

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_workspace,node_authui,node_api_client,node_server_ui,node_terminal_ui,node_service_ui,node_monitor_ui,node_database_ui,node_sftp_ui,node_tunnel_ui,node_broadcast_ui,node_desktop_ui toneBlue
class node_backend_api,node_server_control toneAmber
class node_ssh,node_session_manager,node_service_discovery,node_monitor_service,node_database_service,node_sftp_service,node_tunnel_service,node_broadcast_service,node_desktop_socket,node_terminal_socket toneMint
class node_auth_service,node_server_profiles,node_session_records,node_audit,node_sqlite toneRose
class node_operator,node_ssh_targets toneIndigo
```

## Components

### Workspace UI

- [Workspace shell](https://github.com/sabnish776/cyberops/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Sign-in UI](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/auth/AuthModal.tsx): `frontend/src/components/auth/AuthModal.tsx`
- [REST client](https://github.com/sabnish776/cyberops/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Server dashboard](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/dashboard/ServerCard.tsx): `frontend/src/components/dashboard/ServerCard.tsx`
- [Terminal workspace](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/terminal/TerminalWorkspace.tsx): `frontend/src/components/terminal/TerminalWorkspace.tsx`
- [Service manager](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/services/ServiceManagerModal.tsx): `frontend/src/components/services/ServiceManagerModal.tsx`
- [Monitoring](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/monitoring/MonitoringModal.tsx): `frontend/src/components/monitoring/MonitoringModal.tsx`
- [Database console](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/database/DatabaseConsoleModal.tsx): `frontend/src/components/database/DatabaseConsoleModal.tsx`
- [SFTP browser](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/sftp/FileManagerModal.tsx): `frontend/src/components/sftp/FileManagerModal.tsx`
- [Tunnel manager](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/tunnels/TunnelManagerModal.tsx): `frontend/src/components/tunnels/TunnelManagerModal.tsx`
- [Fleet broadcast](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/broadcast/BroadcastWorkspace.tsx): `frontend/src/components/broadcast/BroadcastWorkspace.tsx`
- [Remote desktop](https://github.com/sabnish776/cyberops/blob/main/frontend/src/components/desktop/RemoteDesktopModal.tsx): `frontend/src/components/desktop/RemoteDesktopModal.tsx`

### Backend API

- [REST controllers](https://github.com/sabnish776/cyberops/tree/main/backend/src/main/java/com/cyberops/controller): `backend/src/main/java/com/cyberops/controller`
- [Server & sessions](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/controller/ServerController.java): `backend/src/main/java/com/cyberops/controller/ServerController.java`

### Remote Operations

- [SSH client](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SshClientService.java): `backend/src/main/java/com/cyberops/service/SshClientService.java`
- [SSH sessions](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SshSessionManager.java): `backend/src/main/java/com/cyberops/service/SshSessionManager.java`
- [Service discovery](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/ServiceManagerService.java): `backend/src/main/java/com/cyberops/service/ServiceManagerService.java`
- [Telemetry](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/MonitoringService.java): `backend/src/main/java/com/cyberops/service/MonitoringService.java`
- [Remote queries](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/DatabaseService.java): `backend/src/main/java/com/cyberops/service/DatabaseService.java`
- [File transfer](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/SftpService.java): `backend/src/main/java/com/cyberops/service/SftpService.java`
- [Port forwarding](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/TunnelService.java): `backend/src/main/java/com/cyberops/service/TunnelService.java`
- [Parallel execution](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/BroadcastService.java): `backend/src/main/java/com/cyberops/service/BroadcastService.java`
- [Desktop stream](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/websocket/RemoteDesktopWebSocketHandler.java): `backend/src/main/java/com/cyberops/websocket/RemoteDesktopWebSocketHandler.java`
- [Terminal stream](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/websocket/TerminalWebSocketHandler.java): `backend/src/main/java/com/cyberops/websocket/TerminalWebSocketHandler.java`

### Identity & State

- [Authentication](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/AuthService.java): `backend/src/main/java/com/cyberops/service/AuthService.java`
- [Server profiles](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/model/ServerProfile.java): `backend/src/main/java/com/cyberops/model/ServerProfile.java`
- [Session records](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/model/SessionRecord.java): `backend/src/main/java/com/cyberops/model/SessionRecord.java`
- [Audit logging](https://github.com/sabnish776/cyberops/blob/main/backend/src/main/java/com/cyberops/service/AuditService.java): `backend/src/main/java/com/cyberops/service/AuditService.java`
- **Embedded SQLite**

### Other components

- **Operator**
- **SSH targets**

## Connections

- Operator → Workspace shell: uses (evidence: `README.md`)
- Workspace shell → Sign-in UI: opens (evidence: `frontend/src/App.tsx`)
- Sign-in UI → REST client: authenticates (evidence: `frontend/src/components/auth/AuthModal.tsx`)
- Workspace shell → Server dashboard: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Terminal workspace: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Service manager: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Monitoring: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Database console: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → SFTP browser: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Tunnel manager: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Fleet broadcast: renders (evidence: `frontend/src/App.tsx`)
- Workspace shell → Remote desktop: renders (evidence: `frontend/src/App.tsx`)
- Server dashboard → REST client: requests (evidence: `frontend/src/App.tsx`)
- Terminal workspace → REST client: requests
- Service manager → REST client: requests (evidence: `frontend/src/components/services/ServiceManagerModal.tsx`)
- Monitoring → REST client: requests
- Database console → REST client: requests (evidence: `frontend/src/components/database/DatabaseConsoleModal.tsx`)
- SFTP browser → REST client: requests (evidence: `frontend/src/components/sftp/FileManagerModal.tsx`)
- Tunnel manager → REST client: requests (evidence: `frontend/src/components/tunnels/TunnelManagerModal.tsx`)
- Fleet broadcast → REST client: requests (evidence: `frontend/src/components/broadcast/BroadcastWorkspace.tsx`)
- REST client → REST controllers: HTTP requests (evidence: `frontend/src/api/client.ts`)
- REST controllers → Authentication: delegates
- REST controllers → Server & sessions: routes server calls
- Server & sessions → Server profiles: reads/writes (evidence: `backend/src/main/java/com/cyberops/controller/ServerController.java`)
- Server & sessions → SSH client: tests connection (evidence: `backend/src/main/java/com/cyberops/controller/ServerController.java`)
- Server & sessions → SSH sessions: manages sessions (evidence: `backend/src/main/java/com/cyberops/controller/ServerController.java`)
- SSH sessions → Session records: persists sessions (evidence: `backend/src/main/java/com/cyberops/service/SshSessionManager.java`)
- Service discovery → SSH client: executes probes (evidence: `backend/src/main/java/com/cyberops/service/ServiceManagerService.java`)
- Telemetry → SSH client: reads telemetry (evidence: `backend/src/main/java/com/cyberops/service/MonitoringService.java`)
- Port forwarding → SSH client: opens forwarding (evidence: `backend/src/main/java/com/cyberops/service/TunnelService.java`)
- Parallel execution → SSH client: executes remotely (evidence: `backend/src/main/java/com/cyberops/service/BroadcastService.java`)
- File transfer → SSH client: transfers files
- Desktop stream → SSH sessions: uses session (evidence: `backend/src/main/java/com/cyberops/websocket/RemoteDesktopWebSocketHandler.java`)
- Terminal stream → SSH sessions: uses session
- SSH client → SSH targets: connects (evidence: `backend/src/main/java/com/cyberops/service/SshClientService.java`)
- Server & sessions → Audit logging: records events (evidence: `backend/src/main/java/com/cyberops/controller/ServerController.java`)
- Parallel execution → Audit logging: audits runs (evidence: `backend/src/main/java/com/cyberops/service/BroadcastService.java`)
- Port forwarding → Audit logging: audits changes (evidence: `backend/src/main/java/com/cyberops/service/TunnelService.java`)
- Audit logging → Embedded SQLite: stores logs (evidence: `backend/src/main/java/com/cyberops/service/AuditService.java`)
- Server profiles → Embedded SQLite: stored in
