muskanmahajan37 / account

Account API For Existing Customer

---

Spring Boot and ReactJS Application

---

This project provides to create account for existing customers.

Summary

The assessment consists of an API to be used for opening a new “current account” of already existing customers.

Requirements

• The API will expose an endpoint which accepts the user information (customerID, initialCredit).

• Once the endpoint is called, a new account will be opened connected to the user whose ID is customerID.

• Also, if initialCredit is not 0, a transaction will be sent to the new account.

• Another Endpoint will output the user information showing Name, Surname, balance, and transactions of the accounts.

---

The application has 2 apis

• AccountAPI
• CustomerAPI

POST /v1/account - creates a new account for existing customer
GET /v1/customer/{customerId} - retrieves a customer
GET /v1/customer - retrieves all customers

JUnit test coverage is 100% as well as integration tests are available.

Tech Stack

---

• Java 11
• Spring Boot
• Spring Data JPA
• Kotlin 1.5.0
• Restful API
• OpenAPI documentation
• H2 In memory database
• Docker
• Docker compose
• JUnit 5
• ReactJS for frontend

Prerequisites

---

• Maven
• Docker

Run & Build

---

There are 2 ways of run & build the application.

Docker Compose

For docker compose usage, docker images already push to docker.io

You just need to run docker-compose up command

---

$PORT: 8080

$ cd account
$ docker-compose up

Maven

For maven usage, you need to change proxy value in the account-fe/package.json file by "http://localhost:8080" due to the default value has been settled for docker image network proxy.

---

$PORT: 8080

$ cd account/account-api
$ mvn clean install
$ mvn spring-boot:run

$ cd account/account-fe
$ npm install
$ npm start

Swagger UI will be run on this url

http://localhost:${PORT}/swagger-ui.html