How nani-1205/aerotrack works
AeroTrack is a microservice aircraft-tracking product: users enter through the authenticated portal and gateway, while the tracking service ingests global and watched-flight feeds, maintains live flight state, and serves tracking APIs. The README also documents admin authentication, analytics fed by auth events, and shared status UI. Edges below are limited to excerpted calls or explicit README relationships; unsampled subsystems are represented at their exact directory paths, with unverified wiring dashed.
Main entry points: server Authentication · server.ts Gateway proxy · http.rs Tracking API · ingest.rs Ingestion loops
Components 28
Web portals
- User portal
frontend/projects/user-portal/src/app/pages/home/home.ts - User session
frontend/projects/user-portal/src/app/core/auth.service.ts - Admin portal
frontend/projects/admin-portal/src/app/pages/dashboard/dashboard.ts - Admin session
frontend/projects/admin-portal/src/app/core/admin-auth.service.ts - Shared UI core
frontend/projects/shared/src/lib
API edge
- Gateway proxy
gateway/src/server.ts - Route policy
gateway/src/config.ts
Identity and analytics
- Authentication
services/auth-service/internal/server - Auth persistence
services/auth-service/internal/store/store.go - Token sessions
services/auth-service/internal/session/session.go - GitHub OAuth
services/auth-service/internal/github/github.go - Auth events
services/auth-service/internal/events/events.go - Analytics
services/analytics-service/app/controllers - Analytics store
services/analytics-service/db/migrate/20261121000001_create_daily_stats.rb
Live tracking
- Tracking API
services/tracking-service/src/http.rs - Ingestion loops
services/tracking-service/src/ingest.rs - Provider dispatch
services/tracking-service/src/providers/mod.rs - OpenSky feed
services/tracking-service/src/providers/opensky.rs - adsb.lol refresh
services/tracking-service/src/providers/adsblol.rs - Flight simulator
services/tracking-service/src/providers/simulator.rs - Airline catalogue
services/tracking-service/src/catalogue.rs - Flight domain model
services/tracking-service/src/model.rs - Live state
services/tracking-service/src/live.rs - Tracking database
services/tracking-service/src/db.rs
Other components
- User
- Administrator
- Redis
- PostgreSQL
Connections 36
- User → User portal: uses
README.md - Administrator → Admin portal: uses
README.md - User portal → User session: checks session
- Admin portal → Admin session: checks session
frontend/projects/admin-portal/src/app/pages/dashboard/dashboard.ts - User session → Gateway proxy: requests API
frontend/projects/user-portal/src/app/core/auth.service.ts - Admin session → Gateway proxy: requests API
frontend/projects/admin-portal/src/app/core/admin-auth.service.ts - Shared UI core → User portal: provides status
- Gateway proxy → Route policy: loads routes
gateway/src/server.ts - Gateway proxy → Authentication: proxies auth
README.md - Gateway proxy → Tracking API: proxies tracking
README.md - Gateway proxy → Analytics: proxies analytics
README.md - User session → Authentication: signs in
README.md - Admin session → Authentication: signs in
README.md - Authentication → GitHub OAuth: OAuth flow
README.md - Authentication → Auth persistence: reads and writes
README.md - Authentication → Token sessions: manages sessions
README.md - Token sessions → Redis: stores refresh hashes
README.md - Authentication → Auth events: publishes login events
README.md - Auth events → Redis: writes stream
README.md - Analytics → Auth events: consumes events
README.md - Analytics → Analytics store: persists stats
README.md - Tracking API → Ingestion loops: starts ingestion
services/tracking-service/src/main.rs - Ingestion loops → Provider dispatch: polls feeds
services/tracking-service/src/ingest.rs - Provider dispatch → OpenSky feed: dispatches snapshot
services/tracking-service/src/providers/mod.rs - Provider dispatch → Flight simulator: dispatches snapshot
services/tracking-service/src/providers/mod.rs - Ingestion loops → adsb.lol refresh: refreshes watched flights
services/tracking-service/src/ingest.rs - OpenSky feed → Flight domain model: produces observations
services/tracking-service/src/providers/opensky.rs - Flight simulator → Flight domain model: produces observations
services/tracking-service/src/providers/simulator.rs - adsb.lol refresh → Flight domain model: produces observations
services/tracking-service/src/providers/adsblol.rs - Ingestion loops → Live state: applies snapshots
services/tracking-service/src/ingest.rs - Ingestion loops → Airline catalogue: reloads catalogue
services/tracking-service/src/ingest.rs - Tracking API → Live state: serves live data
services/tracking-service/src/http.rs - Tracking API → Airline catalogue: serves catalogue
services/tracking-service/src/http.rs - Tracking API → Tracking database: queries database
services/tracking-service/src/http.rs - Tracking database → PostgreSQL: connects
- Live state → Redis: stores live state