How kishore2005-kish/spacedebri-guard works
SENTINEL is a satellite conjunction-awareness application. Users browse a satellite catalog, configure and submit background analyses, then inspect close-approach results, risk assessments, timelines, and visualizations; optional maneuver simulation and STK comparison support mitigation and validation. The main runtime is Next.js UI and API routes backed by orbital, risk, and simulation services plus a database. README documents additional weather and AI capabilities. The sampled code supports key service and API relationships, but many UI, route, and weather implementations were not inspected, so those links are documented or left unverified.
Main entry points: services.ts Domain Services · analysis.ts Analysis Runner · conjunction.ts Conjunction Screening · analyze-view.tsx Analysis Views
Components 24
User Interface
- Dashboard
src/components/dashboard/dashboard-view.tsx - Satellite Catalog
src/components/satellites/satellites-view.tsx - Analysis Views
src/components/simulation/analyze-view.tsx - Conjunction Views
src/components/conjunction/conjunction-detail.tsx - Orbit Globe
src/components/simulation/cesium-globe.tsx - Weather Views
src/components/weather/views/WeatherLiveView.tsx - AI Assistant
src/components/ai/ai-assistant.tsx
API and Services
- Analysis API
src/app/api/analysis/route.ts - Conjunction API
src/app/api/conjunctions/route.ts - Satellite API
src/app/api/satellites/route.ts - Analysis Runner
src/lib/simulation/analysis.ts - Domain Services
src/lib/services.ts - Application Database
src/lib/db.ts
Orbital Analysis
- SGP4 Propagation
src/lib/orbital/sgp4.ts - Conjunction Screening
src/lib/orbital/conjunction.ts - Risk Assessment
src/lib/risk/engine.ts - Maneuver Simulation
src/lib/maneuver/simulator.ts
Data and Integrations
- CelesTrak Ingestion
src/lib/data/celestrak/client.ts - STK Adapter
src/lib/stk/service.ts - Analysis Recordings
src/lib/supabase/recordings.ts
Weather and AI
- Weather API Client
src/lib/weather-api.ts - Weather Context
src/context/SpaceWeatherContext.tsx - AI Ask API
src/app/api/ai/ask/route.ts
Other components
- Operator
Connections 28
- Operator → Dashboard: opens
README.md - Dashboard → Satellite Catalog: navigates
README.md - Operator → Analysis Views: configures
README.md - Analysis Views → Analysis API: submits analysis
README.md - Analysis API → Analysis Runner: starts analysis
src/app/api/analysis/route.ts - Analysis Runner → Domain Services: uses services
src/lib/simulation/analysis.ts - Analysis Runner → Application Database: persists analysis
src/lib/simulation/analysis.ts - Analysis Runner → Conjunction Screening: screens pairs
src/lib/simulation/analysis.ts - Analysis Runner → Risk Assessment: assesses risk
src/lib/simulation/analysis.ts - Analysis Runner → STK Adapter: requests comparison
src/lib/simulation/analysis.ts - Analysis Runner → Analysis Recordings: records results
src/lib/simulation/analysis.ts - Conjunction Screening → SGP4 Propagation: propagates states
src/lib/orbital/conjunction.ts - Conjunction Screening → SGP4 Propagation: refines TCA
src/lib/orbital/conjunction.ts - Domain Services → CelesTrak Ingestion: fetches catalog
src/lib/services.ts - Domain Services → SGP4 Propagation: propagates objects
src/lib/services.ts - Domain Services → Conjunction Screening: screens conjunctions
src/lib/services.ts - Domain Services → Risk Assessment: scores risk
src/lib/services.ts - Domain Services → Maneuver Simulation: simulates maneuvers
src/lib/services.ts - Conjunction API → Domain Services: calls services
src/app/api/conjunctions/route.ts - Satellite API → Domain Services: calls services
src/app/api/satellites/route.ts - Conjunction Views → Conjunction API: loads events
README.md - Analysis Views → Conjunction Views: views results
README.md - Conjunction Views → Orbit Globe: opens visualization
README.md - STK Adapter → Operator: requires installed STK
README.md - Weather Views → Weather Context: reads weather state
- Weather Context → Weather API Client: fetches weather
src/context/SpaceWeatherContext.tsx - AI Assistant → AI Ask API: asks question
- AI Ask API → Domain Services: uses domain services
src/app/api/ai/ask/route.ts