Kredin Bizde

Kredinbizde is a system where users can register and create applications.

System Architecture

• kredinbizde-service: Receives users' registration requests, produces a notification according to the user's request, and writes these requests to the RabbitMQ queue.
• notification-service: Listens to the RabbitMQ queue and takes action.
• akbank-service: Applications received by kredinbizde-service are evaluated by akbank-service.
• kredinbizde-discovery: Eureka server, services register to this service.
• kredinbizde-gw: It is the gateway of the system opening to the outside.

Technologies

• Spring Boot
• Spring Data JPA
• Unit Test
• MySQL
• RabbitMQ
• Redis
• Eureka Server
• Swagger

How to run

If you don't change anything, the gateway will work on port 8084. So you can send your requests to localhost:8084/api/v1/..

Ports:

8084 -> kredinbizde-gateway

8080 -> kredinbizde-service

8761 -> kredinbizde-discovery

8081 -> akbank-service

8082 -> notification-service

Prerequisite: You need to have maven, docker, rabbitmq, redis, and mysql

MYSQL

docker run -d --name mysql-db -e MYSQL_ROOT_PASSWORD=your_password -e MYSQL_DATABASE=kredinbizde_db -e MYSQL_DATABASE=akbank_db -p 3306:3306 mysql:latest

RabbitMQ

docker run -d --hostname my-rabbit --name myrabbit -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=123456 -p 5672:5672 -p 15672:15672 rabbitmq:3-management

Redis

docker run --name my-redis-container -d -p 6379:6379 redis

Maven run for services (run seperately, change jar file name according to service)

maven clean install

java -jar target/kredinbizde-discovery-0.0.1-SNAPSHOT.jar

java -jar target/kredinbizde-gw-0.0.1-SNAPSHOT.jar

java -jar target/kredinbizde-service-0.0.1-SNAPSHOT.jar

java -jar target/akbank-service-0.0.1-SNAPSHOT.jar

java -jar target/notification-service-0.0.1-SNAPSHOT.jar

API Endpoints

• POST api/v1/users -> create user

• GET api/v1/users -> get all users

• GET api/v1/users/{userId} -> get all users

• PUT api/v1/users/{userId} -> update user by id

• POST api/v1/applications -> create application

• GET api/v1/applications -> get all applications

• GET api/v1/applications/{applicationId} -> get application by id

API Documentation

Used Swagger to document the API.

After running the project, you can click the link below to see how to use the API.

API Documentation

API Usage

Added postman collection for usage. You can import to postman and try.

kredinbizde-gw.postman_collection.json

1. Create user

HTTP Metodu: POST

Endpoint: api/v1/users

Request:

{
    "name":"esref",
    "surname":"dogan",
    "birthDate": "2024-04-05",
    "email":"[email protected]",
    "password":"password",
    "phoneNumber":"555555555",
    "address":{
        "addressTitle":"title",
        "addressDescription":"description",
        "province":"province"
    }
}

Response:

{
    "id": 1,
    "name": "esref",
    "surname": "dogan",
    "birthDate": "2024-04-05",
    "email": "[email protected]",
    "password": "password",
    "phoneNumber": "555555555",
    "isActive": true,
    "address": {
        "id": 1,
        "addressTitle": "title",
        "addressDescription": "description",
        "province": "province"
    },
    "applications": []
}

Email already exist exception:

{
    "message": "email already exists",
    "httpStatus": "NOT_FOUND"
}

2. Get all users

HTTP Metodu: GET

Endpoint: api/v1/users

Response:

[
    {
        "id": 1,
        "name": "esref",
        "surname": "dogan",
        "birthDate": "2024-04-05",
        "email": "[email protected]",
        "password": "password",
        "phoneNumber": "555555555",
        "isActive": true,
        "address": {
            "id": 1,
            "addressTitle": "title",
            "addressDescription": "description",
            "province": "province"
        },
        "applications": []
    },
    {
        "id": 2,
        "name": "test",
        "surname": "test",
        "birthDate": "2024-04-05",
        "email": "[email protected]",
        "password": "test",
        "phoneNumber": "555555555",
        "isActive": true,
        "address": {
            "id": 2,
            "addressTitle": "title",
            "addressDescription": "description",
            "province": "province"
        },
        "applications": []
    }
]

3. Get user by id

HTTP Metodu: POST

Endpoint: api/v1/users/{userId}

Response:

{
    "id": 1,
    "name": "esref",
    "surname": "dogan",
    "birthDate": "2024-04-05",
    "email": "[email protected]",
    "password": "password",
    "phoneNumber": "555555555",
    "isActive": true,
    "address": {
        "id": 1,
        "addressTitle": "title",
        "addressDescription": "description",
        "province": "province"
    },
    "applications": []
}

User not found exception:

{
    "message": "user not found",
    "httpStatus": "NOT_FOUND"
}

4. Update user by id

HTTP Metodu: POST

Endpoint: api/v1/users/{userId}

Request:

{
    "name":"cagatay",
    "password": "passwordchange",
    "phoneNumber": "999999"
}

Response:

{
    "id": 1,
    "name": "cagatay",
    "surname": "dogan",
    "birthDate": "2024-04-05",
    "email": "[email protected]",
    "password": "passwordchange",
    "phoneNumber": "999999",
    "isActive": true,
    "address": {
        "id": 1,
        "addressTitle": "title",
        "addressDescription": "description",
        "province": "province"
    },
    "applications": []
}

5. Create application

HTTP Metodu: POST

Endpoint: api/v1/applications

Request:

{
    "userId":1
}

Response:

{
    "id": 2,
    "userId": 1,
    "applicationStatus": "INITIAL"
}

6. Get all aplications

HTTP Metodu: GET

Endpoint: api/v1/applications

Response:

[
    {
        "id": 1,
        "userId": 1,
        "applicationStatus": "INITIAL"
    },
    {
        "id": 2,
        "userId": 1,
        "applicationStatus": "INITIAL"
    }
]

7. Get application by id

HTTP Metodu: GET

Endpoint: api/v1/application/{applicationId}

Response:

{
        "id": 1,
        "userId": 1,
        "applicationStatus": "INITIAL"
    }

Application not found exception:

{
    "message": "application not found",
    "httpStatus": "NOT_FOUND"
}