Flight Tracker

A comprehensive web app for scheduling and tracking flights in a flight simulator environment. Designed for virtual aviation enthusiasts, it enables seamless management of flights, aircraft, airports, crews, and passengers.

With this app, you can:

• Plan & manage flights with detailed flight plans
• Track flights step-by-step from departure to arrival
• Generate timesheets & loadsheets for accurate record-keeping
• Monitor aircraft status and optimize resource allocation

Take full control of your virtual airline operations with a realistic and structured workflow for flight simulation

This is server part of the project. For client part, please visit this repository.

Repository contents

Repository contains server code for Flight Tracker app.

Project is using Node.js and TypeScript in versions listed below:

Technology	Version
Node.js	24
TypeScript	^5.8

Main dependencies are Nest.js and Prisma ORM in versions listed below.

Vendor	Version
Nest.js	^11.1
Prisma	^6.11.0

Getting Started

Environment

This app uses docker-based virtualization to run. In order to set up project, follow these steps:

1. Clone project by running:

git@github.com:oskarbarcz/flight-tracker-api.git

2. Prepare environment variable file by copying .env.example to .env and fill it with your data.

cd flight-tracker-api
cp .env.dist .env

3. Use docker compose to set up the environment

docker compose up -d --build

Packages, database schema, seed data will be configured automatically.

4. Your project should be up and running. Open browser and go to http://localhost/api to see the api documentation.

Default credentials for the API are:

Role	Username	Password
Cabin crew	cabin-crew@example.com	P@$$w0rd
Operations	operations@example.com	P@$$w0rd
Admin	admin@example.com	P@$$w0rd

WebSocket flight events

In addition to the REST API, the server exposes a Socket.IO namespace at /flight-events for receiving flight lifecycle events as they happen. Clients (cabin-crew tablets, operations consoles) should subscribe instead of polling GET /api/v1/flight/:id/events.

Connect

• URL: ws://localhost/flight-events (production: wss://api.flights.barcz.me/flight-events)
• Auth: pass a JWT access token in the Socket.IO auth.token handshake field. The same token issued by POST /api/v1/auth/sign-in is accepted. Connections without a valid token, or with a role other than CabinCrew or Operations, are disconnected immediately.

Messages the client sends

Event	Payload	Effect
subscribe	{ flightId: string }	Join the per-flight room and receive the historical event stream then live updates. flightId must be a UUID v4.
unsubscribe	{ flightId: string }	Leave the room. The server stops emitting events for that flight on this socket.

Messages the server emits

Event	Payload	Notes
flight.events	FlightEventResponse[]	Initial history replay sent once per subscribe, ordered by createdAt ascending. Same shape as GET /api/v1/flight/:id/events.
flight.event	NewFlightEvent	Live lifecycle event broadcast to all sockets subscribed to that flight room.
flight.subscribe.error	{ flightId, message }	Emitted when subscribe cannot be fulfilled (e.g. the flight ID does not exist).

Any event emitted by the domain that EventsRepository persists (boarding started/finished, off-block, takeoff, arrival, on-block, offboarding, close, gate/runway/timesheet/loadsheet changes, emergencies, rotation links, track saves, live positions) is forwarded as a flight.event to subscribers of the matching flight.

Browser example

import { io } from 'socket.io-client';

const socket = io('http://localhost/flight-events', {
  auth: { token: accessToken },
  transports: ['websocket'],
});

socket.on('flight.events', (history) => console.log('history', history));
socket.on('flight.event', (event) => console.log('live', event));
socket.on('flight.subscribe.error', (err) => console.error(err));

socket.emit('subscribe', { flightId: '3c8ba7a7-1085-423c-8cc3-d51f5ab0cd05' });

Generating certs

Application has by default configured EC certificates. However, if you want to create custom ones, use the command below:

openssl ecparam -genkey -name prime256v1 -noout -out private.key
openssl ec -in private.key -pubout -out public.key

Build, Test and Deploy

This project uses semantic versioning.

This project has configured continuous integration and continuous deployment pipelines. It uses GitHub Actions to automatically build, test and deploy the app to the DigitalOcean. You can find the configuration in .github/workflows directory.

License

This projects adapts UNLICENSE. For more information, please visit UNLICENSE file.

Disclaimer

I am experienced software engineer, but I am not connected anyhow with airline industry. This project is created for educational purposes only and should not be used for real-world aviation operations.