# kamilcaliskan/fintech-ledger architecture

> Architecture diagram of the GitHub repository kamilcaliskan/fintech-ledger, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kamilcaliskan/fintech-ledger
- Repository: https://github.com/kamilcaliskan/fintech-ledger

## Overview

FinTech Ledger is a Spring Boot API for account management and money transfers, with transaction auditing and JWT-based access control. The principal workflow is a client making an authenticated financial request; the README documents the product capabilities but no source excerpts were provided, so internal call paths are not verified. Dashed, uncited edges mark those implied relationships rather than confirmed calls.

Main entry points: [`src/main/java/com/example/fintechledger/service/AccountService.java`](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/AccountService.java) (Account operations), [`src/main/java/com/example/fintechledger/controller/AccountController.java`](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AccountController.java) (Account API), [`src/main/java/com/example/fintechledger/controller/AuthController.java`](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AuthController.java) (Authentication API), [`src/main/java/com/example/fintechledger/service/TransactionLogger.java`](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/TransactionLogger.java) (Transaction auditing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and errors"]
  node_account_api["Account API"]
  node_auth_api["Authentication API"]
  node_error_handling["Error handling"]
end

subgraph group_ledger["Ledger operations"]
  node_account_service["Account operations"]
  node_transaction_logger["Transaction auditing"]
  node_account_model["Account model<br/>[Account.java]"]
  node_transaction_model["Transaction model<br/>[Transaction.java]"]
  node_transaction_status["Transaction status"]
end

subgraph group_identity["Identity and security"]
  node_jwt_filter["JWT filter"]
  node_jwt_util["JWT utilities<br/>[JwtUtil.java]"]
  node_security_config["Security configuration"]
  node_user_details["User details"]
  node_user_model["User model<br/>[User.java]"]
end

subgraph group_persistence["Persistence"]
  node_account_repository["Account repository"]
  node_transaction_repository["Transaction repository"]
  node_user_repository["User repository"]
  node_postgres[("PostgreSQL")]
end

node_client(("API client"))

node_client -.->|"authenticates"| node_auth_api
node_client -.->|"requests transfer"| node_account_api
node_account_api -.->|"handles operations"| node_account_service
node_account_service -.->|"audits transactions"| node_transaction_logger
node_account_service -.->|"persists accounts"| node_account_repository
node_transaction_logger -.->|"records transactions"| node_transaction_repository
node_account_repository -.->|"stores account data"| node_postgres
node_transaction_repository -.->|"stores audit data"| node_postgres
node_user_repository -.->|"stores user data"| node_postgres
node_jwt_filter -.->|"validates tokens"| node_jwt_util
node_security_config -.->|"configures filtering"| node_jwt_filter
node_user_details -.->|"loads users"| node_user_repository
node_auth_api -.->|"uses JWT"| node_jwt_util

click node_account_api "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AccountController.java"
click node_auth_api "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AuthController.java"
click node_error_handling "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/exception/GlobalExceptionHandler.java"
click node_account_service "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/AccountService.java"
click node_transaction_logger "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/TransactionLogger.java"
click node_account_model "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/Account.java"
click node_transaction_model "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/Transaction.java"
click node_transaction_status "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/TransactionStatus.java"
click node_account_repository "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/AccountRepository.java"
click node_transaction_repository "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/TransactionRepository.java"
click node_user_repository "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/UserRepository.java"
click node_jwt_filter "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/security/JwtAuthenticationFilter.java"
click node_jwt_util "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/security/JwtUtil.java"
click node_security_config "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/config/SecurityConfig.java"
click node_user_details "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/UserDetailsServiceImpl.java"
click node_user_model "https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/User.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_account_api,node_auth_api,node_error_handling,node_client toneBlue
class node_account_service,node_transaction_logger,node_account_model,node_transaction_model,node_transaction_status toneAmber
class node_jwt_filter,node_jwt_util,node_security_config,node_user_details,node_user_model toneMint
class node_account_repository,node_transaction_repository,node_user_repository,node_postgres toneRose
```

## Components

### API and errors

- [Account API](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AccountController.java): `src/main/java/com/example/fintechledger/controller/AccountController.java`
- [Authentication API](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/controller/AuthController.java): `src/main/java/com/example/fintechledger/controller/AuthController.java`
- [Error handling](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/exception/GlobalExceptionHandler.java): `src/main/java/com/example/fintechledger/exception/GlobalExceptionHandler.java`

### Ledger operations

- [Account operations](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/AccountService.java): `src/main/java/com/example/fintechledger/service/AccountService.java`
- [Transaction auditing](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/TransactionLogger.java): `src/main/java/com/example/fintechledger/service/TransactionLogger.java`
- [Account model](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/Account.java): `src/main/java/com/example/fintechledger/model/Account.java`
- [Transaction model](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/Transaction.java): `src/main/java/com/example/fintechledger/model/Transaction.java`
- [Transaction status](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/TransactionStatus.java): `src/main/java/com/example/fintechledger/model/TransactionStatus.java`

### Identity and security

- [JWT filter](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/security/JwtAuthenticationFilter.java): `src/main/java/com/example/fintechledger/security/JwtAuthenticationFilter.java`
- [JWT utilities](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/security/JwtUtil.java): `src/main/java/com/example/fintechledger/security/JwtUtil.java`
- [Security configuration](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/config/SecurityConfig.java): `src/main/java/com/example/fintechledger/config/SecurityConfig.java`
- [User details](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/service/UserDetailsServiceImpl.java): `src/main/java/com/example/fintechledger/service/UserDetailsServiceImpl.java`
- [User model](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/model/User.java): `src/main/java/com/example/fintechledger/model/User.java`

### Persistence

- [Account repository](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/AccountRepository.java): `src/main/java/com/example/fintechledger/repository/AccountRepository.java`
- [Transaction repository](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/TransactionRepository.java): `src/main/java/com/example/fintechledger/repository/TransactionRepository.java`
- [User repository](https://github.com/kamilcaliskan/fintech-ledger/blob/main/src/main/java/com/example/fintechledger/repository/UserRepository.java): `src/main/java/com/example/fintechledger/repository/UserRepository.java`
- **PostgreSQL**

### Other components

- **API client**

## Connections

- API client → Authentication API: authenticates
- API client → Account API: requests transfer
- Account API → Account operations: handles operations
- Account operations → Transaction auditing: audits transactions
- Account operations → Account repository: persists accounts
- Transaction auditing → Transaction repository: records transactions
- Account repository → PostgreSQL: stores account data
- Transaction repository → PostgreSQL: stores audit data
- User repository → PostgreSQL: stores user data
- JWT filter → JWT utilities: validates tokens
- Security configuration → JWT filter: configures filtering
- User details → User repository: loads users
- Authentication API → JWT utilities: uses JWT
