How mythri005/orbitscope works
OrbitScope is a web dashboard for exploring satellite positions and planning observations. Users sign in, choose satellites and observer locations, then view live tracking, predicted passes, calendars, and planning or analytics results; favorites, alerts, and history support ongoing use. The graph captures the React-to-FastAPI request path and the documented feature branches. Sampled source confirms selected route-to-service calls; unsampled feature implementations are represented by their exact tree paths, without assuming their internal wiring.
Main entry points: app.py FastAPI app · App.tsx React routes · satelliteService.ts Feature API clients · satellite_routes.py Satellite routes
Components 23
Web client
- React routes
frontend/src/App.tsx - Auth context
frontend/src/context/AuthContext.tsx - Observation pages
frontend/src/pages/Tracking.tsx - Planning pages
frontend/src/pages/NightPlanner.tsx - Analysis pages
frontend/src/pages/SatelliteComparison.tsx - Feature API clients
frontend/src/services/satelliteService.ts - HTTP client
frontend/src/services/api.ts
API and domain
- FastAPI app
backend/app.py - Auth routes
backend/routes/auth_routes.py - Satellite routes
backend/routes/satellite_routes.py - Location routes
backend/routes/location_routes.py - Alert routes
backend/routes/pass_alert_routes.py - Favorite routes
backend/routes/favorite_routes.py
Satellite operations
- Satellite calculations
backend/services/satellite_service.py - Tracking history
backend/services/historical_tracking_service.py - Night planning
backend/services/night_planner_service.py - Pass alerts
backend/services/pass_alert_service.py
User and state
- Authentication
backend/services/auth_service.py - Observer locations
backend/services/observer_location_service.py - Favorites
backend/services/favorite_service.py - Application database
backend/database/database.py
Other components
- Observer
- TLE data source
Connections 24
- Observer → React routes: uses
- React routes → Auth context: checks session
- React routes → Observation pages: routes to
- React routes → Planning pages: routes to
- React routes → Analysis pages: routes to
- Observation pages → Feature API clients: requests tracking
- Planning pages → Feature API clients: requests planning
- Analysis pages → Feature API clients: requests analysis
- Feature API clients → HTTP client: sends requests
- HTTP client → FastAPI app: HTTP requests
- FastAPI app → Auth routes: dispatches
- FastAPI app → Satellite routes: dispatches
- FastAPI app → Location routes: dispatches
- FastAPI app → Alert routes: dispatches
- FastAPI app → Favorite routes: dispatches
- Auth routes → Authentication: calls
- Authentication → Application database: reads and writes
- Satellite routes → Satellite calculations: calls
- Satellite routes → Tracking history: calls
- Location routes → Observer locations: calls
- Location routes → Night planning: calls
- Alert routes → Pass alerts: calls
- Favorite routes → Favorites: calls
- Satellite calculations → TLE data source: refreshes data