{"id":50860810,"url":"https://github.com/debuggerdragon311/airline-reservation-system","last_synced_at":"2026-06-14T21:04:21.554Z","repository":{"id":361086541,"uuid":"1253033982","full_name":"debuggerdragon311/airline-reservation-system","owner":"debuggerdragon311","description":"A concurrent flight booking system with seat locking, booking lifecycle management, and admin controls — built with Spring Boot and PostgreSQL.","archived":false,"fork":false,"pushed_at":"2026-06-07T16:00:36.000Z","size":3836,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T17:24:50.673Z","etag":null,"topics":["airline-reservation","backend","booking-system","concurrent-programming","docker","hibernate","java","jpa","jwt-authentication","maven","postgresql","react","rest-api","spring-boot","swagger"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/debuggerdragon311.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T05:12:49.000Z","updated_at":"2026-06-07T15:58:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/debuggerdragon311/airline-reservation-system","commit_stats":null,"previous_names":["debuggerdragon311/airline-reservation-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/debuggerdragon311/airline-reservation-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fairline-reservation-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fairline-reservation-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fairline-reservation-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fairline-reservation-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/debuggerdragon311","download_url":"https://codeload.github.com/debuggerdragon311/airline-reservation-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fairline-reservation-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34337554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"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":["airline-reservation","backend","booking-system","concurrent-programming","docker","hibernate","java","jpa","jwt-authentication","maven","postgresql","react","rest-api","spring-boot","swagger"],"created_at":"2026-06-14T21:04:20.745Z","updated_at":"2026-06-14T21:04:21.547Z","avatar_url":"https://github.com/debuggerdragon311.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cbr/\u003e\n\n#  ✈  AEROBOOK\n\n**A concurrent flight reservation platform built for reliability.**\n\n[![Java](https://img.shields.io/badge/Java_25-ED8B00?style=flat-square\u0026logo=openjdk\u0026logoColor=white)](https://openjdk.org/projects/jdk/21/)\n[![Spring Boot](https://img.shields.io/badge/Spring_Boot_4-6DB33F?style=flat-square\u0026logo=springboot\u0026logoColor=white)](https://spring.io/projects/spring-boot)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL_16-316192?style=flat-square\u0026logo=postgresql\u0026logoColor=white)](https://www.postgresql.org/)\n[![React](https://img.shields.io/badge/React-20232A?style=flat-square\u0026logo=react\u0026logoColor=61DAFB)](https://react.dev/)\n[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square\u0026logo=docker\u0026logoColor=white)](https://www.docker.com/)\n[![Status](https://img.shields.io/badge/Status-In_Development-orange?style=flat-square)]()\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square)](LICENSE)\n\n\n\u003c/div\u003e\n\n---\n\n\u003e **Work in progress.** Repo is freshly set up — architecture is locked, active development starting now. This document reflects the intended design.\n\n---\n\n## What We're Building\n\nAeroBook is a backend-first flight reservation system that tackles real concurrency and state-management problems: race conditions on seat booking, booking lifecycle transitions, overbooking logic, and JWT-secured role-based access — all through a clean REST API.\n\nThis is not a CRUD tutorial. It's modelled on how real airline backends are structured.\n\n---\n\n## Planned Features\n\n**Booking Engine**\n- Concurrent seat booking with optimistic locking (no double-booking under load)\n- Booking lifecycle: `PENDING → CONFIRMED → CHECKED_IN → CANCELLED`\n- Overbooking support (~5–10% oversell, configurable per flight)\n- Price tiers based on booking window\n\n**Flight Management**\n- Search by origin, destination, date, class, and stops\n- Flight state machine: `SCHEDULED → BOARDING → DEPARTED → LANDED → CANCELLED`\n- Seat map (rows A–F, Economy / Business)\n\n**Auth \u0026 Access**\n- JWT authentication with refresh token support\n- Role-based access: `PASSENGER` and `ADMIN`\n- Secure endpoints via Spring Security\n\n---\n\n## Tech Stack\n\n| Layer | Technology                  |\n|---|-----------------------------|\n| Backend | Java 25, Spring Boot 4      |\n| Database | PostgreSQL 16               |\n| ORM | Spring Data JPA / Hibernate |\n| Auth | Spring Security + JWT       |\n| Frontend | React (Vite)                |\n| API Docs | Swagger / OpenAPI 4         |\n| Build | Maven                       |\n| Infrastructure | Docker, Docker Compose      |\n\n---\n\n## Planned API\n\n| Method | Endpoint | Description |\n|---|---|---|\n| `GET` | `/flights/search` | Search flights by route and date |\n| `POST` | `/auth/register` | Create a passenger account |\n| `POST` | `/auth/login` | Authenticate and receive JWT |\n| `POST` | `/bookings` | Book a seat on a flight |\n| `GET` | `/bookings/{id}` | Retrieve booking details |\n| `DELETE` | `/bookings/{id}` | Cancel a booking |\n| `PATCH` | `/admin/flights/{id}/status` | Update flight status (admin) |\n\nFull spec will live in [`docs/API.md`](docs/API.md) once scaffolding is done.\n\n---\n\n## Project Structure\n\n```\nairline-reservation/\n├── backend/\n│   └── src/main/java/com/airline/\n│       ├── controller/       # REST endpoints\n│       ├── service/          # Business logic\n│       ├── repository/       # JPA repositories\n│       ├── model/            # Entities: Flight, Booking, Passenger, Seat\n│       ├── dto/              # Request / Response DTOs\n│       └── config/           # Security, Swagger\n├── frontend/                 # React (Vite) app\n├── docs/\n│   ├── ER-diagram.png\n│   └── API.md\n├── docker-compose.yml\n└── README.md\n```\n\n---\n\n## Team\n\n| Track | Scope |\n|---|---|\n| **Backend — Data** | Schema design, JPA entities, seed data, repositories |\n| **Backend — API** | Controllers, services, seat locking, auth endpoints |\n| **Frontend / Admin** | React booking flow, admin panel, Swagger validation |\n\n---\n\n## Getting Started (once scaffolding is up)\n\n```bash\ngit clone https://github.com/your-org/airline-reservation-system.git\ncd airline-reservation-system\ndocker-compose up -d\n```\n\nSetup instructions will be expanded as the project progresses.\n\n---\n\n## License\n\nApache 2.0 — see [`LICENSE`](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdebuggerdragon311%2Fairline-reservation-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdebuggerdragon311%2Fairline-reservation-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdebuggerdragon311%2Fairline-reservation-system/lists"}