amnaredo / ironhack-final-project

Full Stack Development Ironhack Bootcamp - Final Project (Mar 2021)

Full Stack Web Application with Microservices

Cryptocurrency Portfolio Manager

This project features a simple application to manage cyrptocurrency portfolios with different positions.

The backend side of the application follows a microservices architecture, meaning that the services offered by the application have been developed and implemented independently of each other, including its databases. It is based in Java, using the Spring Boot lightweight infrastructure with Spring JPA + Hibernate using MySQL database, and Spring Cloud to coordinate the distributed services system.

The frontend is based in Typescript with Angular as the development framework. It also takes advantage of an external REST API provided by CoinGecko, used to fetch all the live information about cryptocurrency markets.

The application developed here let end users to register new portfolios on their profile, and attach them positions with different cryptocurrencies. It also calculates the total value of the portfolio with the current market price of these currencies, and keeps records about the updates made by the user on these positions.

Backend Overview

The backend present a microservices architecture, by using Spring Cloud. It features:

• Service registration and discovery with Spring Cloud Netflix Eureka
• Distributed/versioned configuration with Spring Cloud Config
• Declarative REST client with Spring Cloud OpenFeign
• Circuit breakers with Resilience4J

The application itself is made up of five different services:

• Manager Service: it is the edge service that provides the API endpoints that are accessed from the frontend.
• User Profile Service: is the service that saves and provides data about users profiles.
• Portfolio Service: this service stores general information about users' portfolios. Also in turn makes use of the two following microservices.
• Position Service: stores and provides data about the different positions of the portfolios
• Position Update Service: stores and provides information regarding the different position updates in users' portfolios.

Microservices Architecture

API Endpoints (edge service)

/users

• GET Read all user profiles

• POST Create user profile

/users/{id}

• GET Read user profile

• PUT Update user profile

• DELETE Delete user profile

/portfolios/{id}

• GET Read portfolio

• PUT Update portfolio

• DELETE Delete portfolio

/users/{idUser}/portfolios

• GET Read all user portfolios

• POST Create portfolio

/portfolios/{id}/positions

• POST Add position to portfolio

/positions/{id}

• DELETE Delete position

/positions/{idPosition}/updates

• POST Add position update

/updates/{id}

• DELETE Delete position update

Frontend Overview

The frontend is an Angular application, it makes HTTP requests to the backend through the edge service REST API. It also performs requests to an external API to get additional live info about cryptcourrencies and markets (see CoinGecko API).

It is divided in three major sections:

• Profile: this section shows user profile information, data can be updated from this section.

• Portfolios: this section shows the collection of portfolios owned by the user. You can add new portfolios, delete old portfolios and see or edit each portfolio's positions, with its updates history log.

• Search: this section shows a full list of coins that the external API provides, so you can choose any coin to get info details, and add a position with an amount to an existing portfolio from there.