Fix typos and improve formatting in README.md

README.md

@@ -5,44 +5,97 @@
 [![Build Status](https://travis-ci.org/mertakdut/Spring-Boot-Sample-Project.svg?branch=master)](https://travis-ci.org/mertakdut/Spring-Boot-Sample-Project)
 [![Coverage Status](https://coveralls.io/repos/github/mertakdut/Spring-Boot-Sample-Project/badge.svg?branch=master)](https://coveralls.io/github/mertakdut/Spring-Boot-Sample-Project?branch=master)
 
-This is a sample Java / Maven / Spring Boot application which provides RESTful services. It can be used as a starter project. Currently it is designed to work as [this project](https://github.com/mertakdut/React-Sample-Project)'s backend.
+This is a sample Java / Maven / Spring Boot application that provides RESTful services.  
+It can be used as a starter project. Currently, it is designed to work as the [backend](https://github.com/mertakdut/React-Sample-Project) for this project.
 
-## Installation Instructions
-  You can import the project as a maven application to your favorite IDE. I made my tests by using eclipse jee-2018-12.
-
-  If lombok gets in your way, by referring [this answer](https://stackoverflow.com/a/22332248/4130569), you can install lombok by its jar file.
-
-## To run the application
-Use one of the several ways of running a Spring Boot application. Below are just three options:
-
-1. Build using maven goal (or by using maven wrapper): `mvn clean package` and execute the resulting artifact as follows `java -jar BankApplicationBackend-0.0.1-SNAPSHOT.jar` or
-2. On Unix/Linux based systems: run `mvn clean package` then run the resulting jar as any other executable `./BankApplicationBackend-0.0.1-SNAPSHOT.jar`
-3. Run as a [Docker](https://www.docker.com/) container.  
-    1) Clone the repository.
-    2) cd to project root directory.
-    3) `docker build -t demo/bankapp .`
-      * If you get a `./mvnw not found` error, just run `mvn -N io.takari:maven:wrapper -Dmaven=3.5.3` while in the root directory of the project.
-    4) `docker run --expose 8080 -p 8080:8080 demo/bankapp`
-
-## To test the application
-  1. Create a user with /api/user/create url.
-
-    `$ curl -X POST localhost:8080/api/user/create -d "{\"username\": \"yourUsername\", \"password\": \"yourPassword\", \"tcno\": \"12512561125\"}" -H "Content-Type:application/json"`
-  You'll get a response as in below.
-
-    `{"username":"yourUsername","tcno":"12512561125"}`
-  2. Generate an access token by /api/login url.
-
-  `$ curl -H "Content-Type: application/json" -X POST -d "{\"username\": \"yourUsername\", \"password\": \"yourPassword\"}" http://localhost:8080/api/login`
-
-  You'll be getting an access token similar to this.
+
+## 🚀 Installation
+
+You can import this project as a Maven application into your favorite IDE.  
+> ✅ Tested on: **Eclipse JEE 2018-12**
+
+If you encounter issues with Lombok, you can install it manually using the `.jar` file.  
+[→ StackOverflow answer](https://stackoverflow.com/a/22332248/4130569)
+
+
+## ▶️ Running the Application
+
+You can run this Spring Boot application in multiple ways:
+
+### 1. Using Maven
+```bash
+mvn clean package
+java -jar BankApplicationBackend-0.0.1-SNAPSHOT.jar
+```
+
+### 2. On Unix/Linux as Executable Jar
+```bash
+mvn clean package
+chmod +x BankApplicationBackend-0.0.1-SNAPSHOT.jar
+./BankApplicationBackend-0.0.1-SNAPSHOT.jar
+```
+
+### 3. Using Docker
+```bash
+# Clone the repository
+git clone https://github.com/mertakdut/Spring-Boot-Sample-Project.git
+cd Spring-Boot-Sample-Project
+
+# Build the Docker image
+docker build -t demo/bankapp .
+
+# If you get a './mvnw not found' error, generate the Maven wrapper:
+mvn -N io.takari:maven:wrapper -Dmaven=3.5.3
+
+# Run the Docker container
+docker run -p 8080:8080 demo/bankapp
+```
+
+## 🧪 Testing the Application
+  ### 1. Create a User
+  ```bash
+  curl -X POST localhost:8080/api/user/create \
+    -H "Content-Type: application/json" \
+    -d '{"username": "yourUsername", "password": "yourPassword", "tcno": "12512561125"}'
+  ```
+  ```json
+  {
+    "username": "yourUsername",
+    "tcno": "12512561125"
+  }
+  ```
+
+  ### 2. Generate an Access Token
+  ```bash
+  curl -X POST http://localhost:8080/api/login \
+    -H "Content-Type: application/json" \
+    -d '{"username": "yourUsername", "password": "yourPassword"}'
+  ```
 
-  `eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ5b3VyVXNlcm5hbWUiLCJleHAiOjE1NTI0NDMzNjZ9.0WSCg4vaP7BVeJz8tQnL3s-BYjBB6UWXlQKCZHm1_zqEVIiA8_71Ni7tbPDm2DbW-Qc_fPP9CQF1jKcRC9njFQ`
+  **Response (sample token):**
+  ```text
+  eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9...
+  ```
 
-  3. Use the token to access content available to all authenticated users, through the RESTful API.
-
-  Http.Get request example:
-    `curl -i -H "Accept: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ5b3VyVXNlcm5hbWUiLCJleHAiOjE1NTI0NDMzNjZ9.0WSCg4vaP7BVeJz8tQnL3s-BYjBB6UWXlQKCZHm1_zqEVIiA8_71Ni7tbPDm2DbW-Qc_fPP9CQF1jKcRC9njFQ" -X GET http://localhost:8080/api/user/find/all`
-
-  Http.Post request example:
-    `curl -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ5b3VyVXNlcm5hbWUiLCJleHAiOjE1NTI0NDMzNjZ9.0WSCg4vaP7BVeJz8tQnL3s-BYjBB6UWXlQKCZHm1_zqEVIiA8_71Ni7tbPDm2DbW-Qc_fPP9CQF1jKcRC9njFQ" -X POST -d "{\"username\": \"yourUsername\", \"buying\": \"true\", \"currency\": \"USD\", \"amount\": \"250\"}" http://localhost:8080/api/transaction/create`
+  ### 3. Authenticated Requests with Token
+  **Get All Users**
+  ```bash
+  curl -X GET http://localhost:8080/api/user/find/all \
+    -H "Accept: application/json" \
+    -H "Authorization: Bearer <your-access-token>"
+  ```
+  **Create a Transaction**
+  ```bash
+  curl -X POST http://localhost:8080/api/transaction/create \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer <your-access-token>" \
+    -d '{
+      "username": "yourUsername",
+      "buying": true,
+      "currency": "USD",
+      "amount": "250"
+    }'
+  ```
+
+  ## ✅ Done!
+  You are now ready to explore and extend this Spring Boot sample backend!