# koliankit/space-guard-ai- architecture

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

- Interactive diagram: https://gitdiagram.com/koliankit/space-guard-ai-
- Repository: https://github.com/koliankit/space-guard-ai-

## Overview

Spaceguard AI appears to be an Android satellite-monitoring app: users inspect mission telemetry, ingest data, review anomaly and risk analysis, and view reports or audit history. The tree identifies UI screens, analysis modules, and local persistence, but no README or runtime source excerpts were provided, so their connections are inferred and shown as unverified. Major capabilities such as mission simulation, component monitoring, and satellite visualization are retained as separate UI components.

Main entry points: [`app/src/main/java/com/example/ui/screens/MissionControlScreen.kt`](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/MissionControlScreen.kt) (Mission control), [`app/src/main/java/com/example/domain/ml/AnalysisPipeline.kt`](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/AnalysisPipeline.kt) (Analysis pipeline), [`app/src/main/java/com/example/MainActivity.kt`](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/MainActivity.kt) (App entry), [`app/src/main/java/com/example/ui/viewmodel/SpaceguardViewModel.kt`](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/viewmodel/SpaceguardViewModel.kt) (App state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ux["Mission interface"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_viewmodel["App state"]
  node_mission["Mission control"]
  node_ingestion["Data ingestion"]
  node_reports["Reports<br/>[ReportsScreen.kt]"]
  node_audit["Audit log<br/>[AuditLogScreen.kt]"]
  node_simulation["Mission simulation"]
  node_telemetrychart["Telemetry chart<br/>[TelemetryChart.kt]"]
  node_monitorlist["Component monitor"]
  node_anomalyalert["Anomaly alert"]
  node_intelligence["Component intelligence"]
  node_comparison["AI comparison"]
  node_mapping["Column mapping"]
  node_canvas["Satellite visualization"]
end

subgraph group_analysis["Telemetry analysis"]
  node_pipeline["Analysis pipeline"]
  node_decision["Decision engine<br/>[DecisionEngine.kt]"]
  node_risk["Risk engine<br/>[RiskEngine.kt]"]
  node_drift["Drift prediction<br/>[DriftPredictor.kt]"]
  node_forest["Isolation forest<br/>[IsolationForest.kt]"]
  node_lotanalysis["Lot analysis"]
end

subgraph group_persistence["Local data"]
  node_repository["Data repository"]
  node_dao["Database access<br/>[Daos.kt]"]
  node_entities["Stored records<br/>[Entities.kt]"]
  node_database[("Local database")]
  node_seeder["Database seeding<br/>[DatabaseSeeder.kt]"]
end

subgraph group_satellite["Satellite model"]
  node_satmodel["Satellite model<br/>[SatelliteModel.kt]"]
  node_vector["3D vectors<br/>[Vector3D.kt]"]
end

node_user(("Operator"))

node_user -.->|"opens app"| node_activity
node_activity -.->|"shows screen"| node_mission
node_activity -.->|"uses state"| node_viewmodel
node_viewmodel -.->|"requests data"| node_repository
node_viewmodel -.->|"requests analysis"| node_pipeline
node_ingestion -.->|"configures columns"| node_mapping
node_pipeline -.->|"derives decisions"| node_decision
node_pipeline -.->|"assesses risk"| node_risk
node_pipeline -.->|"predicts drift"| node_drift
node_pipeline -.->|"detects outliers"| node_forest
node_pipeline -.->|"compares lots"| node_lotanalysis
node_repository -.->|"uses access"| node_dao
node_dao -.->|"queries"| node_database
node_database -.->|"stores records"| node_entities
node_seeder -.->|"initializes"| node_database
node_mission -.->|"presents telemetry"| node_telemetrychart
node_mission -.->|"shows components"| node_monitorlist
node_mission -.->|"shows alerts"| node_anomalyalert
node_mission -.->|"offers simulation"| node_simulation
node_mission -.->|"visualizes satellite"| node_canvas
node_canvas -.->|"renders model"| node_satmodel
node_satmodel -.->|"uses vectors"| node_vector
node_reports -.->|"presents comparison"| node_comparison
node_mission -.->|"shows insights"| node_intelligence

click node_activity "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_viewmodel "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/viewmodel/SpaceguardViewModel.kt"
click node_mission "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/MissionControlScreen.kt"
click node_ingestion "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/DataIngestionScreen.kt"
click node_reports "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/ReportsScreen.kt"
click node_audit "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/AuditLogScreen.kt"
click node_simulation "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/MissionSimulationPanel.kt"
click node_telemetrychart "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/TelemetryChart.kt"
click node_monitorlist "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ComponentMonitorList.kt"
click node_anomalyalert "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/CriticalAnomalyAlert.kt"
click node_intelligence "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ComponentIntelligenceSheet.kt"
click node_comparison "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/TraditionalVsAiCard.kt"
click node_mapping "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ColumnMappingDialog.kt"
click node_pipeline "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/AnalysisPipeline.kt"
click node_decision "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/DecisionEngine.kt"
click node_risk "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/RiskEngine.kt"
click node_drift "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/DriftPredictor.kt"
click node_forest "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/IsolationForest.kt"
click node_lotanalysis "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/LotRelativeAnalyzer.kt"
click node_repository "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/repository/SpaceguardRepository.kt"
click node_dao "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/Daos.kt"
click node_entities "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/Entities.kt"
click node_database "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/SpaceguardDatabase.kt"
click node_seeder "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/DatabaseSeeder.kt"
click node_satmodel "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/satellite/SatelliteModel.kt"
click node_vector "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/satellite/Vector3D.kt"
click node_canvas "https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/Satellite3DCanvas.kt"

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_activity,node_viewmodel,node_mission,node_ingestion,node_reports,node_audit,node_simulation,node_telemetrychart,node_monitorlist,node_anomalyalert,node_intelligence,node_comparison,node_mapping,node_canvas toneBlue
class node_pipeline,node_decision,node_risk,node_drift,node_forest,node_lotanalysis toneAmber
class node_repository,node_dao,node_entities,node_database,node_seeder toneMint
class node_satmodel,node_vector toneRose
class node_user toneIndigo
```

## Components

### Mission interface

- [App entry](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [App state](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/viewmodel/SpaceguardViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/SpaceguardViewModel.kt`
- [Mission control](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/MissionControlScreen.kt): `app/src/main/java/com/example/ui/screens/MissionControlScreen.kt`
- [Data ingestion](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/DataIngestionScreen.kt): `app/src/main/java/com/example/ui/screens/DataIngestionScreen.kt`
- [Reports](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/ReportsScreen.kt): `app/src/main/java/com/example/ui/screens/ReportsScreen.kt`
- [Audit log](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/screens/AuditLogScreen.kt): `app/src/main/java/com/example/ui/screens/AuditLogScreen.kt`
- [Mission simulation](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/MissionSimulationPanel.kt): `app/src/main/java/com/example/ui/components/MissionSimulationPanel.kt`
- [Telemetry chart](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/TelemetryChart.kt): `app/src/main/java/com/example/ui/components/TelemetryChart.kt`
- [Component monitor](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ComponentMonitorList.kt): `app/src/main/java/com/example/ui/components/ComponentMonitorList.kt`
- [Anomaly alert](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/CriticalAnomalyAlert.kt): `app/src/main/java/com/example/ui/components/CriticalAnomalyAlert.kt`
- [Component intelligence](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ComponentIntelligenceSheet.kt): `app/src/main/java/com/example/ui/components/ComponentIntelligenceSheet.kt`
- [AI comparison](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/TraditionalVsAiCard.kt): `app/src/main/java/com/example/ui/components/TraditionalVsAiCard.kt`
- [Column mapping](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/ColumnMappingDialog.kt): `app/src/main/java/com/example/ui/components/ColumnMappingDialog.kt`
- [Satellite visualization](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/ui/components/Satellite3DCanvas.kt): `app/src/main/java/com/example/ui/components/Satellite3DCanvas.kt`

### Telemetry analysis

- [Analysis pipeline](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/AnalysisPipeline.kt): `app/src/main/java/com/example/domain/ml/AnalysisPipeline.kt`
- [Decision engine](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/DecisionEngine.kt): `app/src/main/java/com/example/domain/ml/DecisionEngine.kt`
- [Risk engine](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/RiskEngine.kt): `app/src/main/java/com/example/domain/ml/RiskEngine.kt`
- [Drift prediction](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/DriftPredictor.kt): `app/src/main/java/com/example/domain/ml/DriftPredictor.kt`
- [Isolation forest](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/IsolationForest.kt): `app/src/main/java/com/example/domain/ml/IsolationForest.kt`
- [Lot analysis](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/ml/LotRelativeAnalyzer.kt): `app/src/main/java/com/example/domain/ml/LotRelativeAnalyzer.kt`

### Local data

- [Data repository](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/repository/SpaceguardRepository.kt): `app/src/main/java/com/example/data/repository/SpaceguardRepository.kt`
- [Database access](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/Daos.kt): `app/src/main/java/com/example/data/local/Daos.kt`
- [Stored records](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/Entities.kt): `app/src/main/java/com/example/data/local/Entities.kt`
- [Local database](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/SpaceguardDatabase.kt): `app/src/main/java/com/example/data/local/SpaceguardDatabase.kt`
- [Database seeding](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/data/local/DatabaseSeeder.kt): `app/src/main/java/com/example/data/local/DatabaseSeeder.kt`

### Satellite model

- [Satellite model](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/satellite/SatelliteModel.kt): `app/src/main/java/com/example/domain/satellite/SatelliteModel.kt`
- [3D vectors](https://github.com/koliankit/space-guard-ai-/blob/main/app/src/main/java/com/example/domain/satellite/Vector3D.kt): `app/src/main/java/com/example/domain/satellite/Vector3D.kt`

### Other components

- **Operator**

## Connections

- Operator → App entry: opens app
- App entry → Mission control: shows screen
- App entry → App state: uses state
- App state → Data repository: requests data
- App state → Analysis pipeline: requests analysis
- Data ingestion → Column mapping: configures columns
- Analysis pipeline → Decision engine: derives decisions
- Analysis pipeline → Risk engine: assesses risk
- Analysis pipeline → Drift prediction: predicts drift
- Analysis pipeline → Isolation forest: detects outliers
- Analysis pipeline → Lot analysis: compares lots
- Data repository → Database access: uses access
- Database access → Local database: queries
- Local database → Stored records: stores records
- Database seeding → Local database: initializes
- Mission control → Telemetry chart: presents telemetry
- Mission control → Component monitor: shows components
- Mission control → Anomaly alert: shows alerts
- Mission control → Mission simulation: offers simulation
- Mission control → Satellite visualization: visualizes satellite
- Satellite visualization → Satellite model: renders model
- Satellite model → 3D vectors: uses vectors
- Reports → AI comparison: presents comparison
- Mission control → Component intelligence: shows insights
