# ak-270704/network-stability-predictor-dashboard-v2 architecture

> Architecture diagram of the GitHub repository ak-270704/network-stability-predictor-dashboard-v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ak-270704/network-stability-predictor-dashboard-v2
- Repository: https://github.com/ak-270704/network-stability-predictor-dashboard-v2

## Overview

This repository implements a network-stability monitoring product: network measurements are collected or ingested, validated and stored, then surfaced with predictions in a live dashboard. The backend also exposes location, alert, metric and prediction APIs; an ML service provides current and future predictions. Edges follow the shown imports, calls and route registrations. The README is empty, and some listed subsystems (including automatic prediction and alert/location behavior) were not sampled, so their internal relationships are not inferred.

Main entry points: [`backend/controllers/mlMetricController.js`](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/mlMetricController.js) (ML Metric API), [`backend/services/predictionRecoveryService.js`](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/predictionRecoveryService.js) (Prediction Recovery), [`frontend/src/App.jsx`](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/App.jsx) (Dashboard), [`backend/controllers/predictionController.js`](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/predictionController.js) (Prediction API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Measurement Collection"]
  node_network_collector["Network Collector"]
  node_retry_queue["Retry Queue<br/>[retry_queue.py]"]
  node_backend_sender["Backend Sender<br/>[backend_sender.py]"]
end

subgraph group_backend["Backend API"]
  node_express_app["API Application<br/>[app.js]"]
  node_metric_routes["Metric Routes<br/>[metricRoutes.js]"]
  node_prediction_routes["Prediction Routes"]
  node_metric_controller["Metric API"]
  node_ml_metric_controller["ML Metric API"]
  node_location_api["Location API"]
  node_alert_api["Alert API<br/>[alertController.js]"]
  node_prediction_controller["Prediction API"]
  node_metric_processing["Metric Processing"]
  node_collector_service["Collector Service"]
  node_location_store[("Locations<br/>[Location.js]")]
  node_metric_store[("Metrics<br/>[Metric.js]")]
  node_ml_metric_store[("ML Metrics<br/>[MLNetworkMetric.js]")]
  node_prediction_store[("Predictions<br/>[Prediction.js]")]
  node_alert_store[("Alerts<br/>[Alert.js]")]
  node_socket_service["Socket Updates<br/>[socket.js]"]
end

subgraph group_prediction["Prediction Services"]
  node_recovery_service["Prediction Recovery"]
  node_automatic_prediction["Automatic Predictions"]
  node_ml_client["ML HTTP Client<br/>[mlService.js]"]
end

subgraph group_dashboard["Live Dashboard"]
  node_dashboard_app["Dashboard<br/>[App.jsx]"]
  node_api_client["API Client<br/>[api.js]"]
  node_socket_client["Socket Client<br/>[socket.js]"]
  node_metric_card["Metric Card<br/>[MetricCard.jsx]"]
  node_prediction_panel["Prediction Panel"]
end

subgraph group_ml["ML Runtime"]
  node_ml_api["ML Prediction API<br/>[main.py]"]
  node_model_loader["Model Loader<br/>[model_loader.py]"]
end

node_collector_actor(("Network Environment"))
node_user(("Dashboard User"))

node_collector_actor -->|"provides measurements"| node_network_collector
node_network_collector -->|"sends measurements"| node_backend_sender
node_network_collector -->|"uses retries"| node_retry_queue
node_express_app -->|"mounts routes"| node_metric_routes
node_express_app -->|"mounts routes"| node_prediction_routes
node_metric_routes -->|"dispatches requests"| node_metric_controller
node_metric_routes -->|"dispatches requests"| node_ml_metric_controller
node_prediction_routes -->|"dispatches requests"| node_prediction_controller
node_metric_controller -->|"collects measurements"| node_collector_service
node_metric_controller -->|"processes metrics"| node_metric_processing
node_metric_processing -->|"writes metrics"| node_metric_store
node_metric_processing -->|"emits updates"| node_socket_service
node_ml_metric_controller -->|"checks location"| node_location_store
node_ml_metric_controller -->|"stores and reads metrics"| node_ml_metric_store
node_ml_metric_controller -->|"processes prediction"| node_recovery_service
node_ml_metric_controller -->|"emits metric update"| node_socket_service
node_prediction_controller -->|"requests predictions"| node_ml_client
node_prediction_controller -->|"creates and reads"| node_prediction_store
node_prediction_controller -->|"emits prediction"| node_socket_service
node_recovery_service -->|"claims and updates"| node_ml_metric_store
node_recovery_service -->|"recovers or creates"| node_prediction_store
node_recovery_service -->|"requests prediction"| node_ml_client
node_recovery_service -->|"emits prediction"| node_socket_service
node_ml_client -->|"posts predictions"| node_ml_api
node_ml_api -->|"loads model"| node_model_loader
node_dashboard_app -->|"loads data"| node_api_client
node_dashboard_app -->|"subscribes to updates"| node_socket_client
node_dashboard_app -->|"renders metrics"| node_metric_card
node_dashboard_app -->|"renders predictions"| node_prediction_panel
node_user -->|"views status"| node_dashboard_app
node_automatic_prediction -.->|"may trigger processing"| node_recovery_service
node_alert_api -.->|"reads and writes alerts"| node_alert_store
node_location_api -.->|"manages locations"| node_location_store
node_backend_sender -.->|"submits metrics"| node_ml_metric_controller

click node_network_collector "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/network_collector.py"
click node_retry_queue "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/retry_queue.py"
click node_backend_sender "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/backend_sender.py"
click node_express_app "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/app.js"
click node_metric_routes "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/routes/metricRoutes.js"
click node_prediction_routes "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/routes/predictionRoutes.js"
click node_metric_controller "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/metricController.js"
click node_ml_metric_controller "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/mlMetricController.js"
click node_location_api "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/locationController.js"
click node_alert_api "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/alertController.js"
click node_prediction_controller "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/predictionController.js"
click node_metric_processing "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/metricProcessingService.js"
click node_collector_service "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/collectorService.js"
click node_location_store "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Location.js"
click node_metric_store "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Metric.js"
click node_ml_metric_store "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/MLNetworkMetric.js"
click node_prediction_store "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Prediction.js"
click node_alert_store "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Alert.js"
click node_socket_service "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/sockets/socket.js"
click node_recovery_service "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/predictionRecoveryService.js"
click node_automatic_prediction "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/automaticPredictionService.js"
click node_ml_client "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/mlService.js"
click node_ml_api "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/src/api/main.py"
click node_model_loader "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/src/api/model_loader.py"
click node_dashboard_app "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/services/api.js"
click node_socket_client "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/services/socket.js"
click node_metric_card "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/components/Dashboard/MetricCard.jsx"
click node_prediction_panel "https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/components/Dashboard/PredictionPanel.jsx"

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_network_collector,node_retry_queue,node_backend_sender,node_user toneBlue
class node_express_app,node_metric_routes,node_prediction_routes,node_metric_controller,node_ml_metric_controller,node_location_api,node_alert_api,node_prediction_controller,node_metric_processing,node_collector_service,node_location_store,node_metric_store,node_ml_metric_store,node_prediction_store,node_alert_store,node_socket_service toneAmber
class node_recovery_service,node_automatic_prediction,node_ml_client toneMint
class node_dashboard_app,node_api_client,node_socket_client,node_metric_card,node_prediction_panel toneRose
class node_ml_api,node_model_loader,node_collector_actor toneIndigo
```

## Components

### Measurement Collection

- [Network Collector](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/network_collector.py): `python-ml/collector/network_collector.py`
- [Retry Queue](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/retry_queue.py): `python-ml/collector/retry_queue.py`
- [Backend Sender](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/collector/backend_sender.py): `python-ml/collector/backend_sender.py`

### Backend API

- [API Application](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/app.js): `backend/app.js`
- [Metric Routes](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/routes/metricRoutes.js): `backend/routes/metricRoutes.js`
- [Prediction Routes](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/routes/predictionRoutes.js): `backend/routes/predictionRoutes.js`
- [Metric API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/metricController.js): `backend/controllers/metricController.js`
- [ML Metric API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/mlMetricController.js): `backend/controllers/mlMetricController.js`
- [Location API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/locationController.js): `backend/controllers/locationController.js`
- [Alert API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/alertController.js): `backend/controllers/alertController.js`
- [Prediction API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/controllers/predictionController.js): `backend/controllers/predictionController.js`
- [Metric Processing](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/metricProcessingService.js): `backend/services/metricProcessingService.js`
- [Collector Service](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/collectorService.js): `backend/services/collectorService.js`
- [Locations](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Location.js): `backend/models/Location.js`
- [Metrics](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Metric.js): `backend/models/Metric.js`
- [ML Metrics](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/MLNetworkMetric.js): `backend/models/MLNetworkMetric.js`
- [Predictions](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Prediction.js): `backend/models/Prediction.js`
- [Alerts](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/models/Alert.js): `backend/models/Alert.js`
- [Socket Updates](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/sockets/socket.js): `backend/sockets/socket.js`

### Prediction Services

- [Prediction Recovery](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/predictionRecoveryService.js): `backend/services/predictionRecoveryService.js`
- [Automatic Predictions](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/automaticPredictionService.js): `backend/services/automaticPredictionService.js`
- [ML HTTP Client](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/backend/services/mlService.js): `backend/services/mlService.js`

### Live Dashboard

- [Dashboard](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API Client](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Socket Client](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/services/socket.js): `frontend/src/services/socket.js`
- [Metric Card](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/components/Dashboard/MetricCard.jsx): `frontend/src/components/Dashboard/MetricCard.jsx`
- [Prediction Panel](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/frontend/src/components/Dashboard/PredictionPanel.jsx): `frontend/src/components/Dashboard/PredictionPanel.jsx`

### ML Runtime

- [ML Prediction API](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/src/api/main.py): `python-ml/src/api/main.py`
- [Model Loader](https://github.com/ak-270704/network-stability-predictor-dashboard-v2/blob/main/python-ml/src/api/model_loader.py): `python-ml/src/api/model_loader.py`

### Other components

- **Network Environment**
- **Dashboard User**

## Connections

- Network Environment → Network Collector: provides measurements
- Network Collector → Backend Sender: sends measurements (evidence: `python-ml/collector/network_collector.py`)
- Network Collector → Retry Queue: uses retries (evidence: `python-ml/collector/network_collector.py`)
- API Application → Metric Routes: mounts routes (evidence: `backend/app.js`)
- API Application → Prediction Routes: mounts routes (evidence: `backend/app.js`)
- Metric Routes → Metric API: dispatches requests (evidence: `backend/routes/metricRoutes.js`)
- Metric Routes → ML Metric API: dispatches requests (evidence: `backend/routes/metricRoutes.js`)
- Prediction Routes → Prediction API: dispatches requests (evidence: `backend/routes/predictionRoutes.js`)
- Metric API → Collector Service: collects measurements (evidence: `backend/controllers/metricController.js`)
- Metric API → Metric Processing: processes metrics (evidence: `backend/controllers/metricController.js`)
- Metric Processing → Metrics: writes metrics (evidence: `backend/services/metricProcessingService.js`)
- Metric Processing → Socket Updates: emits updates (evidence: `backend/services/metricProcessingService.js`)
- ML Metric API → Locations: checks location (evidence: `backend/controllers/mlMetricController.js`)
- ML Metric API → ML Metrics: stores and reads metrics (evidence: `backend/controllers/mlMetricController.js`)
- ML Metric API → Prediction Recovery: processes prediction (evidence: `backend/controllers/mlMetricController.js`)
- ML Metric API → Socket Updates: emits metric update (evidence: `backend/controllers/mlMetricController.js`)
- Prediction API → ML HTTP Client: requests predictions (evidence: `backend/controllers/predictionController.js`)
- Prediction API → Predictions: creates and reads (evidence: `backend/controllers/predictionController.js`)
- Prediction API → Socket Updates: emits prediction (evidence: `backend/controllers/predictionController.js`)
- Prediction Recovery → ML Metrics: claims and updates (evidence: `backend/services/predictionRecoveryService.js`)
- Prediction Recovery → Predictions: recovers or creates (evidence: `backend/services/predictionRecoveryService.js`)
- Prediction Recovery → ML HTTP Client: requests prediction (evidence: `backend/services/predictionRecoveryService.js`)
- Prediction Recovery → Socket Updates: emits prediction (evidence: `backend/services/predictionRecoveryService.js`)
- ML HTTP Client → ML Prediction API: posts predictions (evidence: `backend/services/mlService.js`)
- ML Prediction API → Model Loader: loads model (evidence: `python-ml/src/api/main.py`)
- Dashboard → API Client: loads data (evidence: `frontend/src/App.jsx`)
- Dashboard → Socket Client: subscribes to updates (evidence: `frontend/src/App.jsx`)
- Dashboard → Metric Card: renders metrics (evidence: `frontend/src/App.jsx`)
- Dashboard → Prediction Panel: renders predictions (evidence: `frontend/src/App.jsx`)
- Dashboard User → Dashboard: views status
- Automatic Predictions → Prediction Recovery: may trigger processing
- Alert API → Alerts: reads and writes alerts (evidence: `backend/controllers/alertController.js`)
- Location API → Locations: manages locations (evidence: `backend/controllers/locationController.js`)
- Backend Sender → ML Metric API: submits metrics
