# furkannzmnn/credit-service architecture

> Architecture diagram of the GitHub repository furkannzmnn/credit-service, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/furkannzmnn/credit-service
- Repository: https://github.com/furkannzmnn/credit-service

## Overview

##### Main Components

a) Core Components:
- Domain Layer (Hexagon Center)
- Credit Domain
- Installment Domain
- Use Cases
- Domain Ports

b) Infrastructure Layer (Hexagon Outside)
- REST Controllers
- JPA Adapters
- Redis Adapter
- Scheduler

c) External Systems:
- PostgreSQL Database
- Redis Cache
- API Clients

##### Detailed Component Breakdown

Domain Core (Inner Hexagon):
- Credit Domain
- * Credit Aggregate
- * Credit Use Cases
- * Credit Status
- Installment Domain
- * Installment Aggregate
- * Installment Use Cases
- * Installment Status

Ports (Middle Layer):
- CreditPort
- InstallmentPort
- CachePort

Adapters (Outer Layer):
**Input Adapters:**
- REST Controllers
- * CreateCreditRestController
- * FilterCreditController
- * ListCreditRestController
- * InstallmentPayRestController
- Scheduler
- * OverdueFeeScheduler

**Output Adapters:**
- CreditJpaAdapter
- InstallmentJpaAdapter
- RedisAdapter

##### Key Relationships to Highlight

- Incoming HTTP requests from clients to REST Controllers
- Flow from controllers through use cases to domain logic
- Database interactions through JPA adapters
- Demonstrate cache interactions through Redis adapter
- Scheduled tasks interaction with the domain

##### Additional Elements

Supporting components:
- Configuration Management
- Exception Handling
- Message Source (i18n)
- Test Components

##### Implementation Details

Use these specific visual elements:
- Hexagons for architectural layers
- Cloud symbol for external services

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph External["External Systems"]
        DB[(PostgreSQL)]
        REDIS[(Redis Cache)]
        CLIENT[Client Applications]
    end

    subgraph Domain["Domain Layer"]
        direction TB
        subgraph Core["Core Domain"]
            CREDIT[Credit Domain]:::core
            INSTALL[Installment Domain]:::core
        end

        subgraph UseCases["Use Case Handlers"]
            CREATE_UC[Create Credit Handler]:::usecase
            FILTER_UC[Filter Credit Handler]:::usecase
            LIST_UC[List Credit Handler]:::usecase
            PAY_UC[Installment Pay Handler]:::usecase
        end

        subgraph Ports["Domain Ports"]
            CREDIT_PORT[Credit Port]:::port
            INSTALL_PORT[Installment Port]:::port
            CACHE_PORT[Cache Port]:::port
        end
    end

    subgraph Infra["Infrastructure Layer"]
        direction TB
        subgraph REST["REST Controllers"]
            CREATE_REST[Create Credit Controller]:::adapter
            FILTER_REST[Filter Credit Controller]:::adapter
            LIST_REST[List Credit Controller]:::adapter
            PAY_REST[Installment Pay Controller]:::adapter
        end

        subgraph Adapters["Infrastructure Adapters"]
            CREDIT_JPA[Credit JPA Adapter]:::adapter
            INSTALL_JPA[Installment JPA Adapter]:::adapter
            REDIS_ADAPTER[Redis Adapter]:::adapter
            SCHEDULER[Overdue Fee Scheduler]:::adapter
        end

        subgraph Config["Configuration"]
            EXC_HANDLE[Exception Handler]:::config
            MSG_SOURCE[Message Source]:::config
            CACHE_CONFIG[Cache Properties]:::config
        end
    end

    %% External System Connections
    CLIENT --> REST
    CREDIT_JPA --> DB
    INSTALL_JPA --> DB
    REDIS_ADAPTER --> REDIS

    %% REST to Use Case Connections
    CREATE_REST --> CREATE_UC
    FILTER_REST --> FILTER_UC
    LIST_REST --> LIST_UC
    PAY_REST --> PAY_UC

    %% Use Cases to Core Connections
    CREATE_UC --> CREDIT
    FILTER_UC --> CREDIT
    LIST_UC --> CREDIT
    PAY_UC --> INSTALL

    %% Port Connections
    CREDIT --> CREDIT_PORT
    INSTALL --> INSTALL_PORT
    INSTALL --> CACHE_PORT

    %% Adapter to Port Connections
    CREDIT_JPA --> CREDIT_PORT
    INSTALL_JPA --> INSTALL_PORT
    REDIS_ADAPTER --> CACHE_PORT
    SCHEDULER --> CREDIT

    %% Styling
    classDef core fill:#e1f5fe,stroke:#01579b
    classDef port fill:#0277bd,stroke:#01579b,color:#fff
    classDef adapter fill:#a5d6a7,stroke:#2e7d32
    classDef usecase fill:#90caf9,stroke:#1565c0
    classDef config fill:#fff3e0,stroke:#ff6f00

    %% Click Events
    click CREDIT "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/credit/model/Credit.java"
    click INSTALL "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/installment/model/Installment.java"
    click CREDIT_PORT "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/credit/port/CreditPort.java"
    click INSTALL_PORT "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/installment/port/InstallmentPort.java"
    click CACHE_PORT "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/installment/port/CachePort.java"
    click CREATE_REST "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/credit/adapter/rest/CreateCreditRestController.java"
    click FILTER_REST "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/credit/adapter/rest/FilterCreditController.java"
    click LIST_REST "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/credit/adapter/rest/ListCreditRestController.java"
    click PAY_REST "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/installment/adapter/rest/InstallmentPayRestController.java"
    click CREDIT_JPA "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/credit/adapter/jpa/CreditJpaAdapter.java"
    click INSTALL_JPA "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/installment/adapter/jpa/InstallmentJpaAdapter.java"
    click REDIS_ADAPTER "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/installment/adapter/redis/RedisAdapter.java"
    click SCHEDULER "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/credit/adapter/scheduler/OverdueFeeScheduler.java"
    click CREATE_UC "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/credit/CreateCreditUseCaseHandler.java"
    click FILTER_UC "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/credit/FilterCreditUseCaseHandler.java"
    click LIST_UC "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/credit/ListCreditUseCaseHandler.java"
    click PAY_UC "https://github.com/furkannzmnn/credit-service/blob/main/domain/src/main/java/org/fintech/domain/installment/InstallmentPayUseCaseHandler.java"
    click EXC_HANDLE "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/config/GlobalExceptionHandler.java"
    click MSG_SOURCE "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/config/MessageSourceConfig.java"
    click CACHE_CONFIG "https://github.com/furkannzmnn/credit-service/blob/main/infra/src/main/java/org/fintech/infra/config/CacheProperties.java"
```
