# ranjit-sharma/uass-monitoring-system architecture

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

- Interactive diagram: https://gitdiagram.com/ranjit-sharma/uass-monitoring-system
- Repository: https://github.com/ranjit-sharma/uass-monitoring-system

## Overview

UASS Monitoring System is a full-stack telemetry application for upper-air sounding observations. Users sign in, view dashboard and live telemetry, track flights, and inspect or manage historical observations; operators can control collection, while administrators manage users and review audit logs. The client uses REST and Socket.IO to reach an Express server, which coordinates domain services, MongoDB persistence, and simulator or LAN telemetry sources. The README documents the major product capabilities; source excerpts and the SOURCE INDEX clarify several client and server calls, but some subsystem internals were not sampled.

Main entry points: [`client/src/App.jsx`](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/App.jsx) (React application), [`server/src/app.js`](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/app.js) (Express API), [`server/src/config/database.js`](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/config/database.js) (MongoDB), [`server/src/collectors/lanReceiver.js`](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/collectors/lanReceiver.js) (Simulator and LAN receivers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_login["Sign-in and account<br/>[LoginPage.jsx]"]
  node_authclient["Client auth state<br/>[AuthContext.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_monitoring["Live monitoring"]
  node_tracking["Flight tracking"]
  node_observations["Observation history"]
  node_collectionui["Collection controls"]
  node_adminui["Admin tools"]
end

subgraph group_api["API workflows"]
  node_apiserver["Express API<br/>[app.js]"]
  node_authflow["Authentication API<br/>[auth.controller.js]"]
  node_observationflow["Observation API"]
  node_collectionflow["Collection API"]
  node_dashboardflow["Dashboard API"]
  node_adminflow["Users and audit API<br/>[user.controller.js]"]
end

subgraph group_telemetry["Telemetry ingestion"]
  node_socket["Live event service<br/>[socket.server.js]"]
  node_collectors["Simulator and LAN receivers<br/>[lanReceiver.js]"]
end

subgraph group_state["Identity and persistence"]
  node_authservice["Authentication service<br/>[auth.service.js]"]
  node_obsservice["Observation service"]
  node_mongo[("MongoDB<br/>[database.js]")]
end

node_browser(("Browser user"))
node_externaltelemetry(("Telemetry equipment"))

node_browser -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_login
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_monitoring
node_webapp -->|"routes to"| node_tracking
node_webapp -->|"routes to"| node_observations
node_webapp -->|"routes to"| node_collectionui
node_webapp -->|"routes to"| node_adminui
node_login -.->|"authenticates via"| node_authclient
node_authclient -->|"REST requests"| node_authflow
node_dashboard -.->|"loads summary"| node_dashboardflow
node_monitoring -->|"receives updates"| node_socket
node_tracking -.->|"receives telemetry"| node_socket
node_observations -.->|"REST requests"| node_observationflow
node_collectionui -.->|"controls sessions"| node_collectionflow
node_adminui -.->|"admin requests"| node_adminflow
node_apiserver -->|"routes requests"| node_authflow
node_apiserver -->|"routes requests"| node_observationflow
node_apiserver -->|"routes requests"| node_collectionflow
node_apiserver -->|"routes requests"| node_dashboardflow
node_apiserver -->|"routes requests"| node_adminflow
node_authflow -->|"calls"| node_authservice
node_authservice -->|"reads users"| node_mongo
node_observationflow -->|"calls"| node_obsservice
node_obsservice -->|"persists observations"| node_mongo
node_collectionflow -.->|"records sessions"| node_mongo
node_collectors -.->|"supplies telemetry"| node_collectionflow
node_externaltelemetry -->|"sends UDP/TCP"| node_collectors
node_collectors -->|"stores observations"| node_mongo
node_collectors -->|"broadcasts updates"| node_socket
node_socket -->|"pushes events"| node_monitoring
node_dashboardflow -.->|"reads summaries"| node_mongo
node_adminflow -.->|"manages records"| node_mongo

click node_webapp "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/App.jsx"
click node_login "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/LoginPage.jsx"
click node_authclient "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/DashboardPage.jsx"
click node_monitoring "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/LiveMonitoringPage.jsx"
click node_tracking "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/FlightTrackingPage.jsx"
click node_observations "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/ObservationsPage.jsx"
click node_collectionui "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/DataCollectionPage.jsx"
click node_adminui "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/UserManagementPage.jsx"
click node_apiserver "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/app.js"
click node_authflow "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/auth.controller.js"
click node_observationflow "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/observation.controller.js"
click node_collectionflow "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/collection.controller.js"
click node_dashboardflow "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/dashboard.controller.js"
click node_adminflow "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/user.controller.js"
click node_socket "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/sockets/socket.server.js"
click node_collectors "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/collectors/lanReceiver.js"
click node_authservice "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/services/auth.service.js"
click node_obsservice "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/services/observation.service.js"
click node_mongo "https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/config/database.js"

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_webapp,node_login,node_authclient,node_dashboard,node_monitoring,node_tracking,node_observations,node_collectionui,node_adminui,node_browser toneBlue
class node_apiserver,node_authflow,node_observationflow,node_collectionflow,node_dashboardflow,node_adminflow toneAmber
class node_socket,node_collectors toneMint
class node_authservice,node_obsservice,node_mongo toneRose
class node_externaltelemetry toneIndigo
```

## Components

### Browser experience

- [React application](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in and account](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Client auth state](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/DashboardPage.jsx): `client/src/pages/DashboardPage.jsx`
- [Live monitoring](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/LiveMonitoringPage.jsx): `client/src/pages/LiveMonitoringPage.jsx`
- [Flight tracking](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/FlightTrackingPage.jsx): `client/src/pages/FlightTrackingPage.jsx`
- [Observation history](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/ObservationsPage.jsx): `client/src/pages/ObservationsPage.jsx`
- [Collection controls](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/DataCollectionPage.jsx): `client/src/pages/DataCollectionPage.jsx`
- [Admin tools](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/client/src/pages/UserManagementPage.jsx): `client/src/pages/UserManagementPage.jsx`

### API workflows

- [Express API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/app.js): `server/src/app.js`
- [Authentication API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [Observation API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/observation.controller.js): `server/src/controllers/observation.controller.js`
- [Collection API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/collection.controller.js): `server/src/controllers/collection.controller.js`
- [Dashboard API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/dashboard.controller.js): `server/src/controllers/dashboard.controller.js`
- [Users and audit API](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/controllers/user.controller.js): `server/src/controllers/user.controller.js`

### Telemetry ingestion

- [Live event service](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/sockets/socket.server.js): `server/src/sockets/socket.server.js`
- [Simulator and LAN receivers](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/collectors/lanReceiver.js): `server/src/collectors/lanReceiver.js`

### Identity and persistence

- [Authentication service](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/services/auth.service.js): `server/src/services/auth.service.js`
- [Observation service](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/services/observation.service.js): `server/src/services/observation.service.js`
- [MongoDB](https://github.com/ranjit-sharma/uass-monitoring-system/blob/main/server/src/config/database.js): `server/src/config/database.js`

### Other components

- **Browser user**
- **Telemetry equipment**

## Connections

- Browser user → React application: uses (evidence: `README.md`)
- React application → Sign-in and account: routes to (evidence: `client/src/App.jsx`)
- React application → Dashboard: routes to (evidence: `client/src/App.jsx`)
- React application → Live monitoring: routes to (evidence: `client/src/App.jsx`)
- React application → Flight tracking: routes to (evidence: `client/src/App.jsx`)
- React application → Observation history: routes to (evidence: `client/src/App.jsx`)
- React application → Collection controls: routes to (evidence: `client/src/App.jsx`)
- React application → Admin tools: routes to (evidence: `client/src/App.jsx`)
- Sign-in and account → Client auth state: authenticates via
- Client auth state → Authentication API: REST requests
- Dashboard → Dashboard API: loads summary
- Live monitoring → Live event service: receives updates (evidence: `README.md`)
- Flight tracking → Live event service: receives telemetry
- Observation history → Observation API: REST requests
- Collection controls → Collection API: controls sessions
- Admin tools → Users and audit API: admin requests
- Express API → Authentication API: routes requests (evidence: `server/src/app.js`)
- Express API → Observation API: routes requests (evidence: `server/src/app.js`)
- Express API → Collection API: routes requests (evidence: `server/src/app.js`)
- Express API → Dashboard API: routes requests (evidence: `server/src/app.js`)
- Express API → Users and audit API: routes requests (evidence: `server/src/app.js`)
- Authentication API → Authentication service: calls (evidence: `server/src/controllers/auth.controller.js`)
- Authentication service → MongoDB: reads users (evidence: `server/src/services/auth.service.js`)
- Observation API → Observation service: calls (evidence: `server/src/controllers/observation.controller.js`)
- Observation service → MongoDB: persists observations (evidence: `README.md`)
- Collection API → MongoDB: records sessions
- Simulator and LAN receivers → Collection API: supplies telemetry
- Telemetry equipment → Simulator and LAN receivers: sends UDP/TCP (evidence: `README.md`)
- Simulator and LAN receivers → MongoDB: stores observations (evidence: `README.md`)
- Simulator and LAN receivers → Live event service: broadcasts updates (evidence: `README.md`)
- Live event service → Live monitoring: pushes events (evidence: `README.md`)
- Dashboard API → MongoDB: reads summaries
- Users and audit API → MongoDB: manages records
