A Spring and React based dispatch & delivery management application

by React

WeDelivery

WeDelivery is a Spring and React based dispatch & delivery management application. Our service is to use robots and drones to help users in San Francisco deliver small and medium-sized packages.

This project was bootstrapped with Create React App. Front-end part is implemented by Javascript, CSS, html and React, backend is executed in Java environment, with assistance of libraries of Spring framework, Hibernate and Tomcat. Database used for storing users' input was established on MySQL instance of AWS RDB system.

The introduction of details could be seen in slides.

The demo video could be seen at demo link

How to run the project to launch the website

  1. Set the application server to be Tomcat > 9.0 version.
  2. The data has to be stored to Amazon relational database service (RDS), please create your own RDS and import the data. Don't forget to change the url in the Application config file to connect to your own database.
  3. Run Maven clean and install to import all dependencies we need.
  4. Run Tomcat, wait for a couple of minutes to have the project built.
  5. Run npm build then npm start under wedelivery-app to start the frontend.
  6. Open your browser, enter http://localhost:8080/ to connect to the website, and you will see the home page

What can we do on this website

  1. At beginning, here's the welcome page that you could start our webapp or enter a tracking number to know where your package is.

  2. At first page, please enter the account and password for log in. If it's your first time visiting the website, please hit Register button on top-right corner

  3. Enter the information about your account, please note that error might pop-up if the content does not meet requirements.

  4. After registration, you should be able to get back to home page, then enter your registered account and password. Hit the eyeball could show the password you entered.

  5. Here's the main page of creating new package or organizing previous package list, hit add Add new package button if you want to add more packages.

  6. Input the information of the package you would like to deliver.

  7. Options will pop up so that you could choose to use either drone or robot as your preferred delivery carrier. Use radio button for making decision.

  8. Hit add button to add to be delivered packages into cart, and press Cart to see the total price and added orders. Hit CheckOut if you wish to complete the order.

  9. Once checkout completes, you will get an notification sent to your email address for the use of tracking your package.

  10. You could enter the package number at welcome package or hit Track button on top-right corner to head into tracking page. Here you could know where your package is, and the estimated delivery time.

  11. Ready for your or your friend to receive the gift!

GitHub

https://github.com/Leluth/WeDelivery