Projet_Genie_Logiciel

Introduction

As part of the "Génie Logiciel Avancé" course, we plan to carry out the development of a flight sharing web-based platform. This platform will connect certified pilots with passengers wishing to book one of their flight. The purpose of this website, and therefore the outcome of the project, is to allow clients to book seats for a flight of their choice.

The purpose of the project is to create a performing platform that is easy to use, both for the pilots and the aspiring passengers. We will make all information about the available flights and their details accessible for anyone to browse through. Once logged, a passenger will be able to book a flight. The pilot will then be able to accept or refuse their request through an email. In case of acceptance by the pilot, the passengers will have access to all the private information of the flight.

How to run this project

Important ! Check ElasticSearch version first! it has to be elastic search version 5.x.x

• In Dao, we used transport client which is deprecated in 7.0.0. the TransportClient is deprecated in favour of the Java High Level REST Client and will be removed in Elasticsearch 8.0.
  For more informations check https://www.elastic.co/guide/en/elasticsearch/client/java-api/current/transport-client.html
• We chose to stock different types of informations in the same index(flight_sharing) which is only supported in version 5 .In fact, indices created in 6.x only allow a single-type per index. Any name can be used for the type, but there can be only one.
  More info pls check https://www.elastic.co/guide/en/elasticsearch/reference/current/removal-of-types.html

Steps to run this project

1. lunch elastic search version 5.x.x
2. import the project as maven project in IDE
3. run FillData.java in dao
4. run JettyMain.java
5. browser localhost:8081 or localhost:8081/index.html

Potential problems and solutions

• Class not found error : make sure you set up java SE 8 in the environment, then create a new folder src/main/test

• DataBase error: Check if you have run elasticsearch 5.x.x and run FillData.java to fill the database

• Server error : Run maven install on this project (right-click on pom.xml and run maven install)

• Address in use problem : stop the program and kill the running server program in port 8081, then run again.

• Make sure you are in Branche Master

Delay

• There is a little bit delay when log in / book a flight /aprouve a flight /disapprove a flight (Because of sending email/binding database.. ) , if it doesn't work , wait and click again!!! Deleting a flight can cause one minute.

Details of this project

fillData.java

• Some prefill data just to test. If you don't want it, you can run Jettymain.java directly.

Search flight policy

• It's a flight-sharing platform. At first, withou login, users can search flights with a departure and/or a date or nothing (all flights). In the departure field, user can type a short version of a city (like p/pa/par/pari/paris for paris and it's not case sensetive)

• The system will show all the flights available with their basic information and users can filter the result with other fields.Also, Users can sort the results by all the fields.

• Users can read more informations (public informations/pilot ..etc ) without login. But once a user login as passenger/pilot, he can book the filght.

Reservation policy

• Once you login (as pilot or passenger), you can book any flight you want if there is a seat available. But the pilot has the right to accpet or deny the reservation.

Private information policy

• Each flight has its own private information (meeting day/place defined by the pilot), only the pilot and the passengers of the flight can read it.

Email policy

• Once user books a flight, the pilot will receive an email

• Once Pilot comfirms/denies a reservation, the passsenger will receive an email

• Once Pilot cancels a flight, passengers who book this flight will receive an email

• Users will receive a welcome email once they sign up

• 24 hours before a flight, the pilot and the passengers receive a reminder for the flight

Changes Flight policy

• Pilot can change anything of his flight, he just need to click on edit.

• Piolt can delete his flight, if he does this , all the reservations on this flight will be canceled.

UX Design ( except for these policies, we also considerate user experience design)

• Users can go back to previous pages or other pages by a navigation bar or the button Back.

• If a user chooses to log in on one page, he will be redirected to the same page after his login.

• Users can easily log in/log out

• Users can filter/sort the search result

• Only available flight(seats>=1) could be seen by users when searching a flight

• If users enter an empty field to search/filter a flight, that means no restristion in that field

• Pilots can book a flight except for his own flights

• A pilot can only enter changes(not necessarily all the informations) when editing his flight

• A pilot can check his flight list and the to-approve-reservation list (sorting and searching keywords are available )

• A user can check his reservation list (sorting and searching keywords are available )

• A destination photo will show up when a user want to see more detail of the flight

• A comfirmation box containing key information will show up if a user want to book a flight and if a pilot wants to approve/disapprove a flight

Design Pattern

• DAO - Factory method pattern:

  • FactoryDao.java -> The factory : We create Dao objects only from this class.

  • ActionDao.java -> Implements database related functions with elastic search methods.