How chaithanyabs441-ux/cosmic-eye-telemetry-pipeline works
Cosmic Eye is a React/FastAPI explorer for NASA SPHEREx infrared archive observations. Users search by object name or coordinates, browse recent or curated targets, and inspect observation images, metadata, and archive links; Color Lab changes image bands and palettes. A separate sky-map branch provides deep-sky targets and an interactive Solar System model. The repository also contains a course-project telemetry/warehouse analytics pipeline, but the supplied README excerpt does not describe its runtime data flow, so its components are shown without speculative connections. Backend route/service details are partly unsampled.
Main entry points: client.ts HTTP Client · App.tsx React App · observations.ts Observation Client · observations.py Observation Routes
Components 27
Explorer UI
- React App
frontend/src/App.tsx - Name Search
frontend/src/routes/AISearchPage.tsx - Browse Targets
frontend/src/routes/BrowsePage.tsx - Coordinate Search
frontend/src/routes/ExplorePage.tsx - Color Lab
frontend/src/routes/RGBExplorerPage.tsx - Sky Map
frontend/src/routes/SkyMapPage.tsx - Observation Viewer
frontend/src/components/ObservationViewer.tsx - HTTP Client
frontend/src/api/client.ts - Observation Client
frontend/src/api/observations.ts
Archive API
- FastAPI App
backend/app/main.py - Observation Routes
backend/app/api/observations.py - Name Resolution
backend/app/services/ai_service.py - Archive Search
backend/app/services/archive_service.py - IRSA Adapter
backend/app/adapters/irsa_spherex.py - FITS Preview
backend/app/services/preview_service.py - Featured Targets
backend/app/services/featured_service.py - NASA SPHEREx Archive
Sky Models
- Solar Explorer
frontend/src/components/SolarSystemExplorer.tsx - Orbital Model
backend/app/services/solar_system_model_service.py - JPL Data Services
Telemetry Analytics
- Telemetry Ingest
pipeline/ingest.py - Streaming
pipeline/streaming.py - MongoDB Sync
pipeline/sync_mongodb.py - Warehouse Dashboard
dashboard/app.py - Warehouse Insights
dashboard/pages/1_Warehouse_Insights.py - Analytics Queries
queries/run_query.py
Other components
- Explorer
Connections 27
- Explorer → React App: uses
README.md - React App → Name Search: routes to
frontend/src/App.tsx - React App → Browse Targets: routes to
frontend/src/App.tsx - React App → Coordinate Search: routes to
frontend/src/App.tsx - React App → Color Lab: routes to
frontend/src/App.tsx - React App → Sky Map: routes to
frontend/src/App.tsx - Name Search → HTTP Client: resolves name
frontend/src/routes/AISearchPage.tsx - Name Search → Observation Client: searches coordinates
frontend/src/routes/AISearchPage.tsx - Browse Targets → Observation Client: loads observations
frontend/src/api/observations.ts - Coordinate Search → Observation Client: searches archive
- Color Lab → Observation Client: loads bands
frontend/src/api/observations.ts - Sky Map → Observation Client: loads targets
frontend/src/routes/SkyMapPage.tsx - Sky Map → HTTP Client: resolves added target
frontend/src/routes/SkyMapPage.tsx - Sky Map → Solar Explorer: renders solar view
frontend/src/routes/SkyMapPage.tsx - Observation Viewer → HTTP Client: requests previews
frontend/src/components/ObservationViewer.tsx - HTTP Client → FastAPI App: HTTP requests
README.md - Observation Client → HTTP Client: fetches JSON
frontend/src/api/observations.ts - FastAPI App → Observation Routes: mounts routes
backend/app/main.py - Observation Routes → Name Resolution: resolves names
README.md - Observation Routes → Archive Search: searches products
README.md - Archive Search → IRSA Adapter: queries coverage
backend/app/services/archive_service.py - IRSA Adapter → NASA SPHEREx Archive: queries products
README.md - Observation Routes → FITS Preview: builds previews
README.md - Observation Routes → Featured Targets: serves curated targets
- Solar Explorer → HTTP Client: fetches model
frontend/src/components/SolarSystemExplorer.tsx - HTTP Client → Orbital Model: requests model
README.md - Orbital Model → JPL Data Services: retrieves orbital data
README.md