# kishore2005-kish/spacedebri-guard architecture

> Architecture diagram of the GitHub repository kishore2005-kish/spacedebri-guard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kishore2005-kish/spacedebri-guard
- Repository: https://github.com/kishore2005-kish/spacedebri-guard

## Overview

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: [`src/lib/services.ts`](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/services.ts) (Domain Services), [`src/lib/simulation/analysis.ts`](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/simulation/analysis.ts) (Analysis Runner), [`src/lib/orbital/conjunction.ts`](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/orbital/conjunction.ts) (Conjunction Screening), [`src/components/simulation/analyze-view.tsx`](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/simulation/analyze-view.tsx) (Analysis Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User Interface"]
  node_dashboard["Dashboard<br/>[dashboard-view.tsx]"]
  node_catalog_ui["Satellite Catalog"]
  node_analysis_ui["Analysis Views<br/>[analyze-view.tsx]"]
  node_results_ui["Conjunction Views"]
  node_globe["Orbit Globe<br/>[cesium-globe.tsx]"]
  node_weather_ui["Weather Views"]
  node_ai_ui["AI Assistant<br/>[ai-assistant.tsx]"]
end

subgraph group_api["API and Services"]
  node_analysis_route["Analysis API<br/>[route.ts]"]
  node_conjunction_route["Conjunction API<br/>[route.ts]"]
  node_satellite_route["Satellite API<br/>[route.ts]"]
  node_analysis["Analysis Runner<br/>[analysis.ts]"]
  node_services["Domain Services<br/>[services.ts]"]
  node_database[("Application Database<br/>[db.ts]")]
end

subgraph group_orbit["Orbital Analysis"]
  node_sgp4["SGP4 Propagation<br/>[sgp4.ts]"]
  node_conjunction["Conjunction Screening<br/>[conjunction.ts]"]
  node_risk["Risk Assessment<br/>[engine.ts]"]
  node_maneuver["Maneuver Simulation<br/>[simulator.ts]"]
end

subgraph group_integrations["Data and Integrations"]
  node_catalog["CelesTrak Ingestion<br/>[client.ts]"]
  node_stk["STK Adapter<br/>[service.ts]"]
  node_recordings["Analysis Recordings<br/>[recordings.ts]"]
end

subgraph group_weather["Weather and AI"]
  node_weather_api["Weather API Client<br/>[weather-api.ts]"]
  node_weather_context["Weather Context"]
  node_ai_route["AI Ask API<br/>[route.ts]"]
end

node_user(("Operator"))

node_user -.->|"opens"| node_dashboard
node_dashboard -.->|"navigates"| node_catalog_ui
node_user -.->|"configures"| node_analysis_ui
node_analysis_ui -.->|"submits analysis"| node_analysis_route
node_analysis_route -->|"starts analysis"| node_analysis
node_analysis -->|"uses services"| node_services
node_analysis -->|"persists analysis"| node_database
node_analysis -->|"screens pairs"| node_conjunction
node_analysis -->|"assesses risk"| node_risk
node_analysis -->|"requests comparison"| node_stk
node_analysis -->|"records results"| node_recordings
node_conjunction -->|"propagates states"| node_sgp4
node_conjunction -->|"refines TCA"| node_sgp4
node_services -->|"fetches catalog"| node_catalog
node_services -->|"propagates objects"| node_sgp4
node_services -.->|"screens conjunctions"| node_conjunction
node_services -.->|"scores risk"| node_risk
node_services -.->|"simulates maneuvers"| node_maneuver
node_conjunction_route -->|"calls services"| node_services
node_satellite_route -->|"calls services"| node_services
node_results_ui -.->|"loads events"| node_conjunction_route
node_analysis_ui -.->|"views results"| node_results_ui
node_results_ui -.->|"opens visualization"| node_globe
node_stk -.->|"requires installed STK"| node_user
node_weather_ui -.->|"reads weather state"| node_weather_context
node_weather_context -->|"fetches weather"| node_weather_api
node_ai_ui -.->|"asks question"| node_ai_route
node_ai_route -->|"uses domain services"| node_services

click node_dashboard "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/dashboard/dashboard-view.tsx"
click node_catalog_ui "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/satellites/satellites-view.tsx"
click node_analysis_ui "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/simulation/analyze-view.tsx"
click node_results_ui "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/conjunction/conjunction-detail.tsx"
click node_globe "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/simulation/cesium-globe.tsx"
click node_weather_ui "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/weather/views/WeatherLiveView.tsx"
click node_ai_ui "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/ai/ai-assistant.tsx"
click node_analysis_route "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/analysis/route.ts"
click node_conjunction_route "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/conjunctions/route.ts"
click node_satellite_route "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/satellites/route.ts"
click node_analysis "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/simulation/analysis.ts"
click node_services "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/services.ts"
click node_database "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/db.ts"
click node_catalog "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/data/celestrak/client.ts"
click node_sgp4 "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/orbital/sgp4.ts"
click node_conjunction "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/orbital/conjunction.ts"
click node_risk "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/risk/engine.ts"
click node_maneuver "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/maneuver/simulator.ts"
click node_stk "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/stk/service.ts"
click node_recordings "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/supabase/recordings.ts"
click node_weather_api "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/weather-api.ts"
click node_weather_context "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/context/SpaceWeatherContext.tsx"
click node_ai_route "https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/ai/ask/route.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_catalog_ui,node_analysis_ui,node_results_ui,node_globe,node_weather_ui,node_ai_ui toneBlue
class node_analysis_route,node_conjunction_route,node_satellite_route,node_analysis,node_services,node_database toneAmber
class node_sgp4,node_conjunction,node_risk,node_maneuver toneMint
class node_catalog,node_stk,node_recordings toneRose
class node_weather_api,node_weather_context,node_ai_route,node_user toneIndigo
```

## Components

### User Interface

- [Dashboard](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/dashboard/dashboard-view.tsx): `src/components/dashboard/dashboard-view.tsx`
- [Satellite Catalog](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/satellites/satellites-view.tsx): `src/components/satellites/satellites-view.tsx`
- [Analysis Views](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/simulation/analyze-view.tsx): `src/components/simulation/analyze-view.tsx`
- [Conjunction Views](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/conjunction/conjunction-detail.tsx): `src/components/conjunction/conjunction-detail.tsx`
- [Orbit Globe](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/simulation/cesium-globe.tsx): `src/components/simulation/cesium-globe.tsx`
- [Weather Views](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/weather/views/WeatherLiveView.tsx): `src/components/weather/views/WeatherLiveView.tsx`
- [AI Assistant](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/components/ai/ai-assistant.tsx): `src/components/ai/ai-assistant.tsx`

### API and Services

- [Analysis API](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/analysis/route.ts): `src/app/api/analysis/route.ts`
- [Conjunction API](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/conjunctions/route.ts): `src/app/api/conjunctions/route.ts`
- [Satellite API](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/satellites/route.ts): `src/app/api/satellites/route.ts`
- [Analysis Runner](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/simulation/analysis.ts): `src/lib/simulation/analysis.ts`
- [Domain Services](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/services.ts): `src/lib/services.ts`
- [Application Database](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/db.ts): `src/lib/db.ts`

### Orbital Analysis

- [SGP4 Propagation](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/orbital/sgp4.ts): `src/lib/orbital/sgp4.ts`
- [Conjunction Screening](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/orbital/conjunction.ts): `src/lib/orbital/conjunction.ts`
- [Risk Assessment](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/risk/engine.ts): `src/lib/risk/engine.ts`
- [Maneuver Simulation](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/maneuver/simulator.ts): `src/lib/maneuver/simulator.ts`

### Data and Integrations

- [CelesTrak Ingestion](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/data/celestrak/client.ts): `src/lib/data/celestrak/client.ts`
- [STK Adapter](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/stk/service.ts): `src/lib/stk/service.ts`
- [Analysis Recordings](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/supabase/recordings.ts): `src/lib/supabase/recordings.ts`

### Weather and AI

- [Weather API Client](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/lib/weather-api.ts): `src/lib/weather-api.ts`
- [Weather Context](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/context/SpaceWeatherContext.tsx): `src/context/SpaceWeatherContext.tsx`
- [AI Ask API](https://github.com/kishore2005-kish/spacedebri-guard/blob/main/src/app/api/ai/ask/route.ts): `src/app/api/ai/ask/route.ts`

### Other components

- **Operator**

## Connections

- Operator → Dashboard: opens (evidence: `README.md`)
- Dashboard → Satellite Catalog: navigates (evidence: `README.md`)
- Operator → Analysis Views: configures (evidence: `README.md`)
- Analysis Views → Analysis API: submits analysis (evidence: `README.md`)
- Analysis API → Analysis Runner: starts analysis (evidence: `src/app/api/analysis/route.ts`)
- Analysis Runner → Domain Services: uses services (evidence: `src/lib/simulation/analysis.ts`)
- Analysis Runner → Application Database: persists analysis (evidence: `src/lib/simulation/analysis.ts`)
- Analysis Runner → Conjunction Screening: screens pairs (evidence: `src/lib/simulation/analysis.ts`)
- Analysis Runner → Risk Assessment: assesses risk (evidence: `src/lib/simulation/analysis.ts`)
- Analysis Runner → STK Adapter: requests comparison (evidence: `src/lib/simulation/analysis.ts`)
- Analysis Runner → Analysis Recordings: records results (evidence: `src/lib/simulation/analysis.ts`)
- Conjunction Screening → SGP4 Propagation: propagates states (evidence: `src/lib/orbital/conjunction.ts`)
- Conjunction Screening → SGP4 Propagation: refines TCA (evidence: `src/lib/orbital/conjunction.ts`)
- Domain Services → CelesTrak Ingestion: fetches catalog (evidence: `src/lib/services.ts`)
- Domain Services → SGP4 Propagation: propagates objects (evidence: `src/lib/services.ts`)
- Domain Services → Conjunction Screening: screens conjunctions (evidence: `src/lib/services.ts`)
- Domain Services → Risk Assessment: scores risk (evidence: `src/lib/services.ts`)
- Domain Services → Maneuver Simulation: simulates maneuvers (evidence: `src/lib/services.ts`)
- Conjunction API → Domain Services: calls services (evidence: `src/app/api/conjunctions/route.ts`)
- Satellite API → Domain Services: calls services (evidence: `src/app/api/satellites/route.ts`)
- Conjunction Views → Conjunction API: loads events (evidence: `README.md`)
- Analysis Views → Conjunction Views: views results (evidence: `README.md`)
- Conjunction Views → Orbit Globe: opens visualization (evidence: `README.md`)
- STK Adapter → Operator: requires installed STK (evidence: `README.md`)
- Weather Views → Weather Context: reads weather state
- Weather Context → Weather API Client: fetches weather (evidence: `src/context/SpaceWeatherContext.tsx`)
- AI Assistant → AI Ask API: asks question
- AI Ask API → Domain Services: uses domain services (evidence: `src/app/api/ai/ask/route.ts`)
