How 1nnamdi/orbitwatch works
OrbitWatch gathers satellite and launch data, stores catalog and history, analyzes orbital changes and decay, and presents tracking and domain dashboards. The main user workflow runs from the React app through its typed API client to FastAPI endpoints and PostgreSQL-backed results; satellite positions, tracks, and passes are also computed server-side, while the globe and detail panel propagate TLEs client-side. Scheduled ingestion and optional Space-Track enrichment form a separate data-entry path. Edges reflect README documentation and SOURCE INDEX references; unsampled endpoint behavior is represented at subsystem level.
Main entry points: App.tsx App routing · api.ts Typed API client · models.py Domain records · main.py FastAPI app
Components 25
Data ingestion
- CelesTrak ingestion
backend/app/sources/celestrak.py - Launch Library ingestion
backend/app/sources/launchlibrary.py - Space-Track integration
backend/app/sources/spacetrack.py
Backend services
- FastAPI app
backend/app/main.py - Satellite endpoints
backend/app/api/satellites.py - Domain endpoints
backend/app/api - Orbital propagation
backend/app/services/propagation.py - Maneuver analysis
backend/app/services/maneuvers.py - Decay analysis
backend/app/services/decay.py
Persistence
- Database sessions
backend/app/db.py - Domain records
backend/app/models.py - PostgreSQL
User experience
- App routing
frontend/src/App.tsx - 3D globe
frontend/src/pages/GlobePage.tsx - Ground track map
frontend/src/pages/MapPage.tsx - Pass predictions
frontend/src/pages/PassesPage.tsx - Events dashboard
frontend/src/pages/EventsPage.tsx - Launch tracker
frontend/src/pages/LaunchesPage.tsx - Re-entry dashboard
frontend/src/pages/ReentryPage.tsx - Constellation views
frontend/src/pages/ConstellationsPage.tsx - Satellite details
frontend/src/components/SatDetails.tsx - Satellite search
frontend/src/components/SatelliteSearch.tsx - Typed API client
frontend/src/api.ts
Other components
- OrbitWatch user
- Public data sources
Connections 41
- OrbitWatch user → App routing: uses
frontend/src/App.tsx - App routing → 3D globe: routes to
frontend/src/App.tsx - App routing → Ground track map: routes to
frontend/src/App.tsx - App routing → Pass predictions: routes to
frontend/src/App.tsx - App routing → Events dashboard: routes to
frontend/src/App.tsx - App routing → Launch tracker: routes to
frontend/src/App.tsx - App routing → Re-entry dashboard: routes to
frontend/src/App.tsx - App routing → Constellation views: routes to
frontend/src/App.tsx - App routing → Typed API client: fetches stats
frontend/src/App.tsx - 3D globe → Typed API client: requests data
frontend/src/pages/GlobePage.tsx - Ground track map → Typed API client: requests data
frontend/src/pages/MapPage.tsx - Pass predictions → Typed API client: requests data
frontend/src/pages/PassesPage.tsx - Events dashboard → Typed API client: requests data
frontend/src/pages/EventsPage.tsx - Launch tracker → Typed API client: requests data
frontend/src/pages/LaunchesPage.tsx - Re-entry dashboard → Typed API client: requests data
frontend/src/pages/ReentryPage.tsx - Constellation views → Typed API client: requests data
frontend/src/pages/ConstellationsPage.tsx - 3D globe → Satellite search: renders
frontend/src/pages/GlobePage.tsx - 3D globe → Satellite details: renders
frontend/src/pages/GlobePage.tsx - Ground track map → Satellite search: renders
frontend/src/pages/MapPage.tsx - Ground track map → Satellite details: renders
frontend/src/pages/MapPage.tsx - Satellite search → Typed API client: searches via
frontend/src/components/SatelliteSearch.tsx - Typed API client → Domain endpoints: calls API
frontend/src/api.ts - FastAPI app → Satellite endpoints: registers router
backend/app/main.py - FastAPI app → Domain endpoints: registers routers
backend/app/main.py - Satellite endpoints → Orbital propagation: uses
backend/app/api/satellites.py - Domain endpoints → Maneuver analysis: uses
backend/app/api/events.py - Domain endpoints → Decay analysis: uses
backend/app/api/reentries.py - FastAPI app → CelesTrak ingestion: schedules ingestion
backend/app/main.py - FastAPI app → Launch Library ingestion: schedules ingestion
backend/app/main.py - FastAPI app → Space-Track integration: schedules ingestion
backend/app/main.py - FastAPI app → Maneuver analysis: schedules analysis
backend/app/main.py - Public data sources → CelesTrak ingestion: provides TLEs
README.md - CelesTrak ingestion → Domain records: stores satellite TLEs
backend/app/sources/celestrak.py - Launch Library ingestion → Domain records: stores launches
backend/app/sources/launchlibrary.py - Space-Track integration → Domain records: stores catalog and history
backend/app/sources/spacetrack.py - Maneuver analysis → Domain records: reads and writes events
backend/app/services/maneuvers.py - Decay analysis → Domain records: analyzes orbital history
backend/app/services/decay.py - Satellite endpoints → Domain records: queries catalog
backend/app/api/satellites.py - Domain endpoints → Domain records: queries domain data
backend/app/api/launches.py - Database sessions → Domain records: provides ORM base
backend/app/models.py - Database sessions → PostgreSQL: connects
backend/app/db.py