Skip to content
jhub04Public

About

Findigo is an e-commerce marketplace for buying and selling items

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

386 Commits

Folders and files

Repository files navigation

E-commerce marketplace: Findigo

Findigo is a full-stack application developed with Vue.js and Spring Boot. The project was developed as the final assesment in the course IDATT2105 Fullstack-Applikasjonsutvikling for the spring semester of 2025 at NTNU.

Link to the hosted Findigo: https://idatt2105-09.idi.ntnu.no

NB! This repository contains the backend source code. You can find the frontend source code here

The team

  • Aryan Malekian
  • Scott Langum du Plessis
  • Jonathan Skomsøy Hübertz
  • Mikael Stray Frøyshov

Table of contents

  1. Overview
  2. Features
  3. System Architecture
  4. ER Diagram
  5. Setup for Development and Test Environments
    1. Prerequisites
    2. Spring Profiles
    3. Setup
    4. Admin user credentials (use on login)
  6. Continuous Deployment
    1. Hosting Environment
    2. Self-hosted runners

Overview

The project is a full-stack webapplication aiming to provide a user-friendly e-commerce platform for users to buy, sell and look at items.

The project utilizes the following technologies:

  • Frontend: Vue 3 with Node.js
  • Backend: Springboot V3 with Maven and Java 21
  • Database: MySQL V8 for production and development, and H2 for tests

Features

  • Secure login: Users can securely log in, register, and update their account details
  • Listing Creation: Users can create listings and publish them to the marketplace
  • Archiving: A user can archive his own listings, so that they're not available on the public marketplace
  • Favorite Selection: Users can favorite listings they like or find interesting, and view all of them from the profile page
  • Recommendation algorithm: Listings on the homepage are filtered based on an advanced recommendation algorithm, and can be further filtered based on category.
  • Advanced search: Users can search for listings and filter based on category, price, location, and the listing creation date
  • Map View: Users get to see listings marked on a real map and filter them with advanced search
  • Messaging: Users can send messages to each other to negotiate or inquire on listed items
  • Admin functionality: Admin users can do administrate actions such as adding, modifying, and deleting categories and listings
  • Internationalization: The application has support language support for English, Norwegian, Spanish, as well as Nepali and Urdu

System Architecture

Screenshot 2025-04-06 at 19 17 28

ER Diagram

image

Setup for Development and Test Environments

Prerequisites

  • JDK 21
  • Maven
  • MySQL

Spring Profiles

The backend uses Spring profiles to separate dev, test and prod configurations:

  • application-dev.properties is used during local development
  • application-prod.properties is used for deployment on the VM server
  • application-test.properties is used for testing the development environment
  • Common config is stored in application.properties

Setup

You need to make sure you have the right environmental variables, as well as the correct keystore.jks file. You need to get this from another developer.

  1. Clone the repository
git clone https://github.com/jhub04/Findigo.git
  1. Navigate to the project root folder
cd Findigo
  1. Run the application:
  • Running the application for development

    mvn spring-boot:run -Dspring-boot.run.profiles=dev
  • Running the application for testing:

    mvn spring-boot:run -Dspring-boot.run.profiles=test

    or configure your run configuration to use the spring dev profile in your chosen IDE.

You can find the swagger API documentation here (dev or prod backend has to be running locally)

Running tests

Open the root folder of the project and type mvn test in the terminal

To see the backend test coverage go to github actions for the backend repo and go to the newest Java CI run and download the JaCoCo report. To see total test coverage open index.html.

Admin user credentials (use on login)

  • Username: admin
  • Password: admin123

Continuous Deployment

Findigo is deployed at https://idatt2105-09.idi.ntnu.no, hosted on a dedicated virtual machine within the NTNU network. The application will remain online until the administrator at NTNU shuts it down.

Hosting Environment

The project is deployed on an Ubuntu-based virtual machine using the following stack:

  • Backend: Spring Boot (Java 21, Maven)
  • Frontend: Vue 3 (Vite)
  • Database: MySQL 8
  • Web Server / Reverse Proxy: Nginx
  • Deployment Automation: GitHub Actions (CI/CD)

Self-hosted runners

We created self-hosted runner for both of the repos, so that it was possible to communicate with the NTNU virtual machine from Github. The continuous deployment workflows were configured to:

  • Backend: Build the backend application into a self-contained JAR and set up a systemd service for automatic startup and easier management.
  • Frontend: Deployed the static build files to Nginx's root directory.

About

Findigo is an e-commerce marketplace for buying and selling items

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages