AL BORAQ - Train Reservation Application

Al Boraq is a web-based application built using the Jakarta EE architecture, designed for train ticket management and reservation. This academic project was developed to apply software development concepts and the MVC architectural pattern in a real-world scenario. The application provides a complete solution, from route searching to PDF ticket generation, including a secure payment simulation system.

---

Table of Contents

• Features
• Technical Architecture
• System Design (UML)
• Installation and Deployment
• Docker Deployment

---

Features

The application covers the essential functionalities of a modern railway ticketing system:

Passenger Area

• User account creation and authentication.
• User profile management.

Advanced Search

• Selection of departure and arrival stations.
• Travel date selection.
• Choice between one-way or round-trip journeys.

Ticket Reservation

• Schedule selection and fare consultation.
• Choice of travel class (First or Second Class).
• Passenger quantity management.
• Real-time seat availability management.

Secure Payment

• Simulated credit card payment interface.
• Validation and verification of banking information.

PDF Ticketing

• Automatic generation and display of transport tickets in PDF format after confirmation.

Administration Panel

• Management of reference data such as trains, stations, and schedules through the back-office system.

---

🛠 Technical Architecture

The project follows a strict MVC (Model-View-Controller) architecture, ensuring a clear separation between business logic, data access, and the user interface.

Technology Stack

• Programming Language: Java
• Web Framework: Jakarta EE (Servlets, JSP)
• Application Server: Apache Tomcat
• Database: MySQL
• Data Access: JDBC (DAO Pattern)
• Project Management: Maven
• Frontend: HTML5, CSS3, JSP
• Containerization: Docker

Project Structure

• WEB Layer: Controllers (Servlets) and Views (JSP) handling user interactions.
• BUSINESS Layer: Classes representing the application logic (Train, Reservation, AlBoraq, etc.).
• DAO Layer: Handles persistence and SQL database interactions.

---

System Design (UML)

The system modeling is based on standard UML diagrams:

• Use Case Diagram: Represents interactions between actors and the system.
• Class Diagram: Defines the structure of core entities such as Passenger, Ticket, Trip, BankCard, and others.

---

Installation and Deployment

Option 1 — Local Setup

1. Prerequisites

• JDK (Java Development Kit) 11+
• Apache Tomcat (v9 or v10)
• MySQL Server
• Maven

2. Configuration

• Clone the GitHub repository.
• Create a local MySQL database named Gestion_Reservation.
• Configure the JDBC connection in the file src/Dao/dbconnexion.java using your local database credentials.

3. Launch

Compile the project:

mvn clean install

Deploy the generated .war file to your Tomcat server.

Access the application at:

Docker Deployment

The application is fully containerized using Docker, ensuring environment reproducibility and simplified deployment.

How it works

A multi-stage build is used in the Dockerfile:

• Stage 1: Maven compiles the source code and generates the .war file.
• Stage 2: The .war is deployed on an Apache Tomcat server in the final lightweight image.

The app container and the MySQL container communicate through a dedicated Docker network (alboraq-network).

Prerequisites

• Docker Desktop installed and running.

Steps

1. Build the Docker image:

docker build -t alboraq-app .

2. Create the Docker network:

docker network create alboraq-network

3. Start the MySQL container:

docker run -d \
  --name alboraq-db \
  --network alboraq-network \
  -e MYSQL_ROOT_PASSWORD=root \
  -e MYSQL_DATABASE=gestion_reservation \
  -e MYSQL_USER=alboraq \
  -e MYSQL_PASSWORD=alboraq123 \
  -p 3307:3306 \
  mysql:8.0

4. Start the application container:

docker run -d \
  --name alboraq-app \
  --network alboraq-network \
  -p 8080:8080 \
  alboraq-app

5. Access the application:

© 2025 Al Boraq Project — All Rights Reserved.