A backend API for satellite operations, designed to manage ground stations, track satellites, calculate overpasses, and schedule flight plans.

Features

• Ground Station Management: Full CRUD for ground stations with automated, periodic health checks via a background worker.
• Satellite Tracking: Manages a catalog of satellites and automatically updates TLE data from Celestrack.
• Overpass Calculation: Predicts satellite visibility windows for any ground station.
• Flight Plan Scheduling: Create, update (with versioning), and manage the approval lifecycle of flight plans.
• Object Storage: Integrates with MinIO for scalable storage of large binary data like satellite imagery.
• Containerized: Ready to run with Docker and Docker Compose.

Technology Stack

• .NET 8 / ASP.NET Core
• Entity Framework Core
• PostgreSQL + PostGIS for relational and spatial data.
• Minio for S3-compatible object storage.
• Docker for containerization

Getting Started

Prerequisites

• .NET 8 SDK
• Docker Desktop

Running the Application

1. Clone the repository:

   git clone https://github.com/your-username/dietzy1-satops.git
   cd dietzy1-satops

2. Run with Docker Compose: This command will build the API image, start the PostgreSQL database, apply migrations, and run the application.

   docker-compose up --build

3. Access the API: The SatOps API (Swagger) will be available at http://localhost:5111/.

API Structure & Endpoints

The platform exposes two distinct APIs, documented via separate Swagger UIs.

Public API (/api/v1/...)

Intended for human operators and external management tools. Authentication is handled via local JWTs.

• GET /api/v1/ground-stations - List all ground stations.
• POST /api/v1/ground-stations - Create a new ground station.
• GET /api/v1/ground-stations/{id} - Get details for a specific ground station.
• GET /api/v1/satellites - List available satellites.
• GET /api/v1/overpasses/satellite/{satId}/groundstation/{gsId} - Calculate satellite overpasses.
• CRUD /api/v1/flight-plans - Manage the flight plan lifecycle.

Internal API (/api/internal/... & /api/auth/...)

A machine-to-machine API for ground stations. It is protected and requires a ground-station-specific JWT.

• POST /api/auth/token - Acquire a JWT using the ground station's Application ID & API Key.
• POST /api/internal/operations/images - Upload captured image files from a ground station.

Logging & Monitoring

This project is configured with Serilog for powerful structured logging.

When running with Docker Compose, all logs from the satops-api service are automatically sent to a Seq container. This provides a rich, searchable interface for viewing and analyzing log data.

• Seq UI: Available at http://localhost:5341