Project Overview

Project Overview

Version: v2.0-beta.1 - Production Ready

StreamSpace is a multi-platform container streaming platform that delivers GUI applications to web browsers. v2.0-beta.1 introduces a Control Plane + Agent architecture supporting Kubernetes and Docker, with multi-tenancy, observability, and enterprise security.

v2.0 Architecture

StreamSpace v2.0 uses a Control Plane + Agent model:

• Control Plane (api/): Centralized Go API with WebSocket Hub, VNC Proxy, and multi-tenancy
• K8s Agent (agents/k8s-agent/): Kubernetes agent with session lifecycle, VNC tunneling (~80% coverage)
• Docker Agent (agents/docker-agent/): Docker agent with HA backends (~60% coverage)
• Web UI (ui/): React + TypeScript with Material-UI (98% test passing)

Core Modules

• Control Plane API: Go REST + WebSocket backend with Agent Hub, Command Dispatcher, VNC Proxy
• Platform Agents: K8s and Docker agents that connect via WebSocket for bidirectional communication
• Web UI: React + Vite application with real-time agent monitoring and admin dashboard
• Deployment Assets: Helm chart, Kubernetes manifests, Grafana dashboards, Prometheus alerts

Feature Highlights (v2.0-beta.1)

• Multi-Tenancy: Org-scoped access control with JWT claims, cross-tenant prevention
• Observability: 3 Grafana dashboards (Control Plane, Sessions, Agents), 12 Prometheus alerts
• Security: 0 Critical/High CVEs, security headers (HSTS, CSP), rate limiting
• API Documentation: OpenAPI 3.0 spec with Swagger UI at /api/docs
• Performance: API latency ~200ms (p99), session startup ~6s, VNC latency <100ms

Test Coverage

Component	Coverage	Status
API Backend	100%	All 9 handler packages
UI Components	98%	189/191 tests passing
K8s Agent	~80%	Session lifecycle, VNC
Docker Agent	~60%	Platform support

For details see README.md, FEATURES.md, and CHANGELOG.md in the main repo. Architecture specifics on Architecture and catalogs on Plugins-Catalog / Templates-Catalog.