{"id":34705963,"url":"https://github.com/telman03/aerotrack","last_synced_at":"2026-04-28T16:34:00.453Z","repository":{"id":311149768,"uuid":"1035584665","full_name":"telman03/aerotrack","owner":"telman03","description":"A real-time flight tracker backend built with Go and WebSockets. Demonstrates stateful, event-driven architecture and uses Docker for easy deployment.","archived":false,"fork":false,"pushed_at":"2025-08-22T11:08:10.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-22T13:26:35.504Z","etag":null,"topics":["docker","docker-compose","golang","grpc-go","websockets"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/telman03.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-10T17:52:37.000Z","updated_at":"2025-08-22T11:11:06.000Z","dependencies_parsed_at":"2025-08-22T13:26:37.206Z","dependency_job_id":"9017edac-3746-4d79-9ff5-efc6014e2df9","html_url":"https://github.com/telman03/aerotrack","commit_stats":null,"previous_names":["telman03/aerotrack"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/telman03/aerotrack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telman03%2Faerotrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telman03%2Faerotrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telman03%2Faerotrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telman03%2Faerotrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telman03","download_url":"https://codeload.github.com/telman03/aerotrack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telman03%2Faerotrack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28012139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","golang","grpc-go","websockets"],"created_at":"2025-12-24T23:21:47.827Z","updated_at":"2025-12-24T23:21:49.682Z","avatar_url":"https://github.com/telman03.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✈️ **AeroTrack: Real-Time Flight Tracker**\n\nAeroTrack is a real-time geospatial tracking system built to monitor and visualize live flight data. It demonstrates a stateful, event-driven architecture by ingesting live data, managing the current state of each flight, and pushing updates in real-time to connected clients.\n\n---\n\n## **Technologies Used**\n\n- **Go (Golang):** Core backend service  \n- **WebSockets:** Low-latency, real-time communication  \n- **PostgreSQL:** Source of truth for flight data  \n- **Docker:** Containerization for easy setup  \n\n---\n\n##  **Core Features**\n\n- **Live Data Ingestion:**  \n  Background process simulates or ingests flight coordinate data.\n\n- **Real-Time State Management:**  \n  Maintains current location and status for each flight in memory.\n\n- **WebSocket Broadcast:**  \n  Broadcasts location changes to all connected clients.\n\n- **Data Persistence:**  \n  Persists all flight data and route history in PostgreSQL.\n\n---\n\n##  **Getting Started**\n\nThis project is containerized with Docker for a straightforward setup.\n\n### **Prerequisites**\n\n- Docker \u0026 Docker Compose  \n- Go (if running outside Docker)\n\n### **Setup**\n\n```sh\ngit clone https://github.com/telman03/aerotrack.git\ncd aerotrack \n```\n\n**Start the services:**\n\n```sh\ndocker-compose up --build -d\n```\n\n**Check the logs:**\n\n```sh\ndocker-compose logs -f aerotrack-service\n```\n\n---\n\n##  **Architecture Overview**\n\nThe system follows a simple client-server model with a focus on real-time data flow.\n\n```\n+-------------------+         WebSocket         +---------------------+\n|   Go Backend      | \u003c-----------------------\u003e |   Client Dashboard  |\n| (Data, DB, WS)    |                          | (Map Visualization) |\n+-------------------+                          +---------------------+\n         |\n         | PostgreSQL\n         v\n+-------------------+\n|   Flight Data DB  |\n+-------------------+\n```\n\n- **Go Backend:**  \n  - Data Simulation (Goroutine)  \n  - PostgreSQL Interface  \n  - WebSocket Server\n\n- **PostgreSQL:**  \n  Stores flight data (long-term memory)\n\n- **Client Dashboard:**  \n  (Not included) Connects via WebSockets to visualize live flight paths\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelman03%2Faerotrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelman03%2Faerotrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelman03%2Faerotrack/lists"}