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