How ranjit-sharma/uass-monitoring-system works
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: App.jsx React application · app.js Express API · database.js MongoDB · lanReceiver.js Simulator and LAN receivers
Components 22
Browser experience
- React application
client/src/App.jsx - Sign-in and account
client/src/pages/LoginPage.jsx - Client auth state
client/src/context/AuthContext.jsx - Dashboard
client/src/pages/DashboardPage.jsx - Live monitoring
client/src/pages/LiveMonitoringPage.jsx - Flight tracking
client/src/pages/FlightTrackingPage.jsx - Observation history
client/src/pages/ObservationsPage.jsx - Collection controls
client/src/pages/DataCollectionPage.jsx - Admin tools
client/src/pages/UserManagementPage.jsx
API workflows
- Express API
server/src/app.js - Authentication API
server/src/controllers/auth.controller.js - Observation API
server/src/controllers/observation.controller.js - Collection API
server/src/controllers/collection.controller.js - Dashboard API
server/src/controllers/dashboard.controller.js - Users and audit API
server/src/controllers/user.controller.js
Telemetry ingestion
- Live event service
server/src/sockets/socket.server.js - Simulator and LAN receivers
server/src/collectors/lanReceiver.js
Identity and persistence
- Authentication service
server/src/services/auth.service.js - Observation service
server/src/services/observation.service.js - MongoDB
server/src/config/database.js
Other components
- Browser user
- Telemetry equipment
Connections 33
- Browser user → React application: uses
README.md - React application → Sign-in and account: routes to
client/src/App.jsx - React application → Dashboard: routes to
client/src/App.jsx - React application → Live monitoring: routes to
client/src/App.jsx - React application → Flight tracking: routes to
client/src/App.jsx - React application → Observation history: routes to
client/src/App.jsx - React application → Collection controls: routes to
client/src/App.jsx - React application → Admin tools: routes to
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
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
server/src/app.js - Express API → Observation API: routes requests
server/src/app.js - Express API → Collection API: routes requests
server/src/app.js - Express API → Dashboard API: routes requests
server/src/app.js - Express API → Users and audit API: routes requests
server/src/app.js - Authentication API → Authentication service: calls
server/src/controllers/auth.controller.js - Authentication service → MongoDB: reads users
server/src/services/auth.service.js - Observation API → Observation service: calls
server/src/controllers/observation.controller.js - Observation service → MongoDB: persists observations
README.md - Collection API → MongoDB: records sessions
- Simulator and LAN receivers → Collection API: supplies telemetry
- Telemetry equipment → Simulator and LAN receivers: sends UDP/TCP
README.md - Simulator and LAN receivers → MongoDB: stores observations
README.md - Simulator and LAN receivers → Live event service: broadcasts updates
README.md - Live event service → Live monitoring: pushes events
README.md - Dashboard API → MongoDB: reads summaries
- Users and audit API → MongoDB: manages records