How flaviomelian/monitoring-resources works
DockStream is a cluster-monitoring and container-orchestration product with a Next.js operations panel and a Spring backend. The main workflow is an operator viewing mesh and telemetry state, then requesting cluster scaling or managing files; backend controllers delegate these actions to services, which inspect Docker, collect metrics, or persist and replicate files. The README also describes an older React/Vite CRUD replica, but the sampled evidence does not establish it as part of the current panel workflow. Edges are limited to relationships visible in excerpts or explicitly documented; unsampled controllers and frontend pages are represented only where their capability is documented.
Main entry points: page.tsx Operations pages · MonitoringService.java Telemetry collector · FileService.java File service · ResourceMetricRepository.java Metric repository
Components 24
Operations panel
- Operations pages
frontend/src/app/services/page.tsx - Mesh app grid
frontend/src/app/component/MeshAppsGrid.tsx - Stack topology
frontend/src/app/component/StackTopolgyGrid.tsx - Navigation header
frontend/src/app/component/Header.tsx - File workspace
frontend/src/app/files/page.tsx - Client documentation
frontend/src/app/frontend-doc/page.tsx
Backend API
- Cluster endpoints
backend/src/main/java/com/flavio/backend/controller/ClusterController.java - Metrics endpoints
backend/src/main/java/com/flavio/backend/controller/MetricsController.java - File endpoints
backend/src/main/java/com/flavio/backend/controller/FileController.java
Cluster and telemetry
- Cluster orchestrator
backend/src/main/java/com/flavio/backend/service/ClusterOrchestratorService.java - Telemetry collector
backend/src/main/java/com/flavio/backend/service/MonitoringService.java - Metric repository
backend/src/main/java/com/flavio/backend/repository/ResourceMetricRepository.java - Resource metrics
backend/src/main/java/com/flavio/backend/model/ResourceMetric.java - Server nodes
backend/src/main/java/com/flavio/backend/model/ServerNode.java
File management
- File service
backend/src/main/java/com/flavio/backend/service/FileService.java - File records
backend/src/main/java/com/flavio/backend/model/File.java - File repository
backend/src/main/java/com/flavio/backend/repository/FileRepository.java
Identity and access
- Authentication service
backend/src/main/java/com/flavio/backend/service/AuthService.java - User records
backend/src/main/java/com/flavio/backend/model/User.java - User repository
backend/src/main/java/com/flavio/backend/repository/UserRepository.java
Other components
- Operator
- Docker runtime
- Replica nodes
- Relational store
Connections 21
- Operator → Operations pages: uses
frontend/src/app/services/page.tsx - Operations pages → Mesh app grid: renders
frontend/src/app/services/page.tsx - Operations pages → Stack topology: renders
frontend/src/app/services/page.tsx - Operator → File workspace: manages files
- Navigation header → Client documentation: links to
frontend/src/app/component/Header.tsx - Cluster endpoints → Cluster orchestrator: delegates to
backend/src/main/java/com/flavio/backend/controller/ClusterController.java - Cluster orchestrator → Docker runtime: runs CLI
backend/src/main/java/com/flavio/backend/service/ClusterOrchestratorService.java - Metrics endpoints → Telemetry collector: delegates to
backend/src/main/java/com/flavio/backend/controller/MetricsController.java - Telemetry collector → Metric repository: queries and saves
backend/src/main/java/com/flavio/backend/service/MonitoringService.java - Metric repository → Resource metrics: stores
backend/src/main/java/com/flavio/backend/repository/ResourceMetricRepository.java - Resource metrics → Server nodes: belongs to node
backend/src/main/java/com/flavio/backend/model/ResourceMetric.java - Telemetry collector → Replica nodes: sends telemetry
backend/src/main/java/com/flavio/backend/service/MonitoringService.java - File endpoints → File service: delegates to
backend/src/main/java/com/flavio/backend/controller/FileController.java - File service → File repository: reads and writes
backend/src/main/java/com/flavio/backend/service/FileService.java - File repository → File records: stores
backend/src/main/java/com/flavio/backend/service/FileService.java - File service → Replica nodes: propagates uploads
backend/src/main/java/com/flavio/backend/service/FileService.java - Authentication service → User repository: reads and saves
backend/src/main/java/com/flavio/backend/service/AuthService.java - Authentication service → User records: creates
backend/src/main/java/com/flavio/backend/service/AuthService.java - User repository → User records: stores
backend/src/main/java/com/flavio/backend/service/AuthService.java - Operator → Cluster endpoints: requests scaling
- Relational store → Metric repository: persists