Skip to content

Latest commit

 

History

History
108 lines (81 loc) · 4.73 KB

README.md

File metadata and controls

108 lines (81 loc) · 4.73 KB
Raw

GeaRMIT

Website link: Gearmit-env.eba-mrcbnsqb.ap-southeast-1.elasticbeanstalk.com

Table of Contents

Project Description

GeaRMIT is a fullstack, mobile-friendly ecommerce website that focuses on gaming peripherals with the best prices for RMIT University community. It aims to provide a satisfying online shopping experience combined with an intuitive design which is our slogan: "Satisfy your desire for gaming gears".

The application is built using the following tech stack:

  • Frontend:
    • HTML + CSS + Vanilla JavaScript
    • jQuery
    • Owl Carousel
    • Font Awesome
  • Backend:
    • Spring framework: Spring Boot, Spring MVC, Spring Security
    • PostgreSQL
    • AWS

How to run the project

Before building the project, make sure you have JDK 16 SE installed to run the project. Otherwise, you can re-configure your Java version in the pom.xml file.

Make sure you are connected to the Internet to use the mail server for account confirmation.

Quick run: Make sure you have Apache Maven 3.8 installed to quickly build and run the project

  1. Navigate to the GeaRMIT project folder
  2. Open the folder in Terminal/Command line. Make sure the currently opened folder contains the pom.xml file
  3. Type in the following command for Maven to build the project automatically: mvn spring-boot:run
  4. Go to localhost:8080 on your web browser
  5. Give us full HD

To use localhost database:

  • Create a local postgres database name "gearmit" with the user name "postgres" and password "root" on port 5432
  • Create a schema in "gearmit" name "public"

To use AWS database:

  • Open application.properties file in "src/main/resources/"
  • Comment out line 5 - 7 (Below comment "#Localhost")
  • Uncomment line 10 - 12 (Below comment "#AWS")
  • To switch back to localhost from AWS, do the opposite

To run the project:

  • Open the folder GeaRMIT with Intellij
  • Run "create.sql" to drop all table and create table for the schema of database
  • Run "populate.sql" to drop all records and add default data to the table of the database
  • Run "GeaRmitApplication.java" in "src/main/java/com/group5/gearmit/" with Intellij to run the project
  • Open browser and type the link "http://localhost:8080" to visit the website

To access the admin page:

  • Go to the login page and login with the username: "admin" and password: "admin".
  • Before exiting the page, make sure to logout or the admin username will be saved to the browser

Acknowledged problems

  • Dependency problem: In Intellij in Maven tab, click "Download Sources" -> Click "Reload All Maven Projects"
  • Mail Server problems:
    • Some network block connection to gmail smpt server (Ex: RMIT University network) so connect to a differenct network.
    • If the problem persist: disable firewall and anti virus software.
    • If the problem continue to persist: Comment out line 87 in "CustomerServiceI.java" in "src/main/java/com/group5/gearmit/service".
  • AWS database connection problems:
    • Some network block connection to AWS (Ex: RMIT University network) so connect to a different network.
    • If the problem persist, switch back to localhost and contact the group via email.

App screenshots

Responsive design

Category page

Product page

Login page

Create account

Admin dashboard

Contributors