EasyTrain.live

- Gabriele Jansen
- Calton Manhique
- Jacques Navarro
- Kai Prager 

In today's fast-paced world, travelers face numerous challenges when booking train tickets, including long queues, inconvenient booking hours, and a lack of real-time information on train availability and schedules. Our efficient and user-friendly train booking application streamlines this process, providing a convenient solution for travelers to book tickets anytime, anywhere, with up-to-date information, reducing stress and enhancing the overall travel experience.

• Java 17+
• Maven
• PostgreSQL
• MySQL
• IntelliJ IDEA (recommended)

1. Clone the repository:

   git clone https://github.com/EasyTrain/application.git
   cd application

2. Set up the PostgreSQL database:

   • Install PostgreSQL.
   • Create a new database and configure it in src/main/resources/application.properties.

3. Run the application:

   mvn spring-boot:run

4. Run additional database scripts

   • src/main/resources/database/easeytrain_db_schema.sql
   • src/main/resources/database/et_station_data.sql
   • src/main/resources/database/ice stations.sql

1. Access the application: Open your web browser and navigate to http://localhost:8081/easytrain.

2. Create an account and log in

   • Select "Register".
   • Fill out the form and follow further steps.
   • Log in, select "Settings" and complete your profile.
   • Additionally you can edit your profile, change your email or delete your accout.

3. Booking tickets:

   • Go to "Home" or "Booking".
   • Select a station, your destination and a time.
   • Select a train and book your tickets.
   • Pay directly or pay later under "Settings -> Journeys"

4. Check the timetables:

   • Go to "Timetable"
   • Select a station and a time

5. Simulate Payments

   • To simulate payments, run api-payments https://github.com/EasyTrain/api-payments

• Java
• Spring Boot
• Maven

• HTML
• CSS
• Bootstrap
• JavaScript

• PostgreSQL
• pgAdmin
• MySQL
• MySQL Workbench
• DB Timetables API

All communication between clients and the server is encrypted from end-to-end. Additionally, all passwords are hashed using the bcrypt algorithm before they are stored in the database.

A valid email address is required to register an EasyTrain user account. After successfully creating an account, the user will receive and email with a verification email. Before a user can login they must enable their account by clicking the verification email.

• Jakarta EE (JAX-WS)

The EasyTrain application is deployed to AWS using a basic architecture pictured in the diagram below.

A Route53 hosted zone resolves DNS inquiries to the load balancer. The load balancer then forwards requests to the application which runs on an EC2 instance.

A custom Amazon Machine Image (AMI) is built using Ubuntu Server 24.04 LTS as the base image. Packer installs Open-JDK 21, PostgreSQL and the EasyTrain Spring Boot application. It then packages application and enables a Systemd service that starts the application when the instance starts up.

The repo for the Packer template can be found at easytrain/packer.

Terraform templates are used to provision all of the required AWS resources. A custom VPC is launched in the eu-central-1 AWS region. Within the custom VPC, a public subnet is created in the eu-central-1a availability zone. A routing table directs traffic within and outside of the VPC via an internet gateway.

A Route53 hosted zone resolves the easytrain.live domain which was purchased through Namecheap to load balancer. The load balancer sends all traffic to an EC2 instance that runs on a custom AMI build with Packer. A CA certificate is attached to the load balancer which secures traffic to the load balancer.

The repo for the Terraform templates is can be found at easytrain/terraform.

This project is licensed under the MIT License.

You are free to use, modify, and distribute this software under the terms of the MIT License. See the LICENSE file for more details

The project was created as a final project for DCI - Digital Career Institute. Special thanks to our teachers Bardha Islami, Nootan Vijapure, and our mentor Safwan Kherallah.