How aleisistan/clustercontrol works
ClusterControl lets administrators manage clusters, users and cameras, while authenticated users monitor device telemetry on a dashboard. Devices publish through MQTT; the backend ingests and stores telemetry and serves dashboard data, with camera relay, alerts, weather and industrial-test status as separate capabilities. The README documents the major integrations and user flows; source excerpts are incomplete, so unsampled subsystem links are shown only where the README supports them.
Main entry points: main.ts NestJS API · app.routes.ts Angular application · dashboard.component.ts Telemetry dashboard · users.service.ts User management
Components 22
Web interface
- Angular application
frontend/src/app/app.routes.ts - Login and session
frontend/src/app/services/auth.service.ts - Telemetry dashboard
frontend/src/app/dashboard/dashboard.component.ts - Admin pages
frontend/src/app/pages/admin-clusters-page.component.ts
Identity and administration
- NestJS API
backend/src/main.ts - Authentication
backend/src/auth/auth.service.ts - User management
backend/src/users/users.service.ts - Cluster management
backend/src/cluster/cluster.service.ts
Devices and telemetry
- MQTT ingestion
backend/src/telemetry/mqtt.service.ts - Telemetry service
backend/src/telemetry/telemetry.service.ts - Industrial test status
backend/src/industrial-tests/industrial-test-status.service.ts
Operational services
- Camera management and relay
backend/src/camera/camera.controller.ts - Alerts and email
backend/src/alerts/alerts.service.ts - Weather panel
backend/src/weather/weather.service.ts
Runtime integrations
- PostgreSQL
- MQTT device
firmware/esp32-mqtt-base/src/main.cpp - Telemetry simulator
simulator/simulator.js - MQTT broker
- Industrial test runners
tests-industriales/runner/endurance.py
Other components
- User
- OpenWeather
- IP cameras
Connections 25
- User → Angular application: uses
- Angular application → Login and session: routes to
frontend/src/app/app.routes.ts - Login and session → NestJS API: requests login
- NestJS API → Authentication: routes authentication
- Authentication → User management: looks up user
backend/src/auth/auth.service.ts - Angular application → Telemetry dashboard: routes to
frontend/src/app/app.routes.ts - Angular application → Admin pages: routes to
frontend/src/app/app.routes.ts - Admin pages → NestJS API: manages clusters
- NestJS API → Cluster management: routes cluster requests
- NestJS API → User management: routes user requests
- Cluster management → PostgreSQL: persists clusters
- User management → PostgreSQL: persists users
- MQTT device → MQTT broker: publishes telemetry
- Telemetry simulator → MQTT broker: publishes telemetry
- MQTT broker → MQTT ingestion: delivers messages
- MQTT ingestion → Telemetry service: passes readings
- Telemetry service → PostgreSQL: stores readings
- Telemetry dashboard → NestJS API: requests telemetry
- Industrial test runners → MQTT broker: monitors MQTT
- Industrial test status → Telemetry dashboard: reports test status
- NestJS API → Camera management and relay: routes camera requests
backend/src/camera/camera.controller.ts - Camera management and relay → IP cameras: relays stream
- NestJS API → Alerts and email: routes alert requests
- Telemetry dashboard → Weather panel: shows weather
- Weather panel → OpenWeather: fetches forecast