Merge pull request pauldragoslav#1 from Nayananga/main

Add support for new APIs

Author: pauldragoslav

Banking.postman_collection.json

@@ -1,14 +1,14 @@
 {
 	"info": {
-		"_postman_id": "527d1a6d-ae07-4484-947b-e7f5501c1c6b",
+		"_postman_id": "485cda16-0d43-4aa6-ac55-116fb41d8f17",
 		"name": "Banking",
 		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 	},
 	"item": [
 		{
-			"name": "Account Balance",
+			"name": "Create Account",
 			"request": {
-				"method": "POST",
+				"method": "PUT",
 				"header": [
 					{
 						"key": "Content-Type",
@@ -19,7 +19,7 @@
 				],
 				"body": {
 					"mode": "raw",
-					"raw": "{\n\t\"sortCode\": \"53-68-92\",\n\t\"accountNumber\": \"73084635\"\n}\n\n"
+					"raw": "{\n\t\"bankName\": \"Bank of Ceyloan\",\n\t\"ownerName\": \"Nayananga Muhandiram\"\n}\n"
 				},
 				"url": {
 					"raw": "localhost:8080/api/v1/accounts",
@@ -66,6 +66,99 @@
 				}
 			},
 			"response": []
+		},
+		{
+			"name": "Check Balance",
+			"request": {
+				"method": "POST",
+				"header": [
+					{
+						"key": "Content-Type",
+						"name": "Content-Type",
+						"value": "application/json",
+						"type": "text"
+					}
+				],
+				"body": {
+					"mode": "raw",
+					"raw": "{\n\t\"sortCode\": \"35-16-67\",\n\t\"accountNumber\": \"95753174\"\n}\n"
+				},
+				"url": {
+					"raw": "localhost:8080/api/v1/accounts",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"v1",
+						"accounts"
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Withdraw",
+			"request": {
+				"method": "POST",
+				"header": [
+					{
+						"key": "Content-Type",
+						"name": "Content-Type",
+						"type": "text",
+						"value": "application/json"
+					}
+				],
+				"body": {
+					"mode": "raw",
+					"raw": "{\n\t\"sortCode\": \"35-16-67\",\n\t\"accountNumber\": \"95753174\",\n    \"amount\": 100.00\n}\n"
+				},
+				"url": {
+					"raw": "localhost:8080/api/v1/withdraw",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"v1",
+						"withdraw"
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Deposit",
+			"request": {
+				"method": "POST",
+				"header": [
+					{
+						"key": "Content-Type",
+						"name": "Content-Type",
+						"type": "text",
+						"value": "application/json"
+					}
+				],
+				"body": {
+					"mode": "raw",
+					"raw": "{\n\t\"targetAccountNo\": \"95753174\",\n    \"amount\": 1000.00\n}\n"
+				},
+				"url": {
+					"raw": "localhost:8080/api/v1/deposit",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"v1",
+						"deposit"
+					]
+				}
+			},
+			"response": []
 		}
 	]
 }

README.md

@@ -3,18 +3,53 @@ Example project demonstrating the use of Java and Spring-boot to build a microse
 
 ## Running locally
 ```
-./mvnw clean package
+./mvnw clean install -DskipTests=true
+```
+
+```
 java -jar target/Banking-0.0.1.jar
 ```
 
 ## Running on Docker
 ```
 docker build -t "spring-boot:banking" .
+```
+
+```
 docker run -p 8080:8080 spring-boot:banking
 ```
 
 ## Testing
-1. Import the Postman collection file into the application or copy the request body from there
+Import the Postman collection file into the application or copy the request body from there
+
+### How to test
+1. Create account
+   > Use create account API to create an account by providing a `bankName` and `ownerName`
+   > 
+   ![Create Account](screenshots/create_account.png)
+
+> Make sure to write down the `sortCode` and the `accountNumber` to proceed with other APIs
+
+2. Deposit Cash
+   >Use noted `accountNumber` as `targetAccountNo` and provide amount greater than zero to deposit cash into an account
+   
+   ![Deposit cash](screenshots/deposit.png)
+
+3. Check Balance
+   >Use noted `accountNumber` and `sortCode` to check account balance
+
+   ![Check Balance](screenshots/check_balance.png)
+   
+4. Withdraw Cash
+   >Use noted `accountNumber` and `sortCode` and `amount` grater than zero to withdraw cash from an account
+
+   ![Withdraw cash](screenshots/withdraw.png)
+    
+5. Check Balance again to verify withdrawal
+
+   ![Check Balance](screenshots/check_balance_2.png)
+   
+
 
 ### Extensions
 1. Use of persisted database

mvnw

@@ -32,6 +32,11 @@
 			<artifactId>spring-boot-starter-web</artifactId>
 		</dependency>
 
+		<dependency>
+			<groupId>com.github.mifmif</groupId>
+			<artifactId>generex</artifactId>
+			<version>1.0.2</version>
+		</dependency>
 		<dependency>
 			<groupId>com.h2database</groupId>
 			<artifactId>h2</artifactId>

pom.xml

@@ -0,0 +1,6 @@
+package com.example.paul.constants;
+
+public enum ACTION {
+    DEPOSIT,
+    WITHDRAW
+}