# bincynizam-lab/banking-transaction-system architecture

> Architecture diagram of the GitHub repository bincynizam-lab/banking-transaction-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bincynizam-lab/banking-transaction-system
- Repository: https://github.com/bincynizam-lab/banking-transaction-system

## Overview

This is a Spring Boot banking REST API. Clients authenticate at login to receive a JWT, then request account operations; account services create/read accounts or atomically transfer funds and record a transaction. Optimistic locking on accounts addresses concurrent updates, while centralized exception handling shapes failures. The README also lists transaction history and Swagger, though no history endpoint or Swagger implementation was sampled. Edges follow excerpts, SOURCE INDEX references, or README claims; unsampled links are omitted rather than inferred.

Main entry points: [`src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java) (Account Operations), [`src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java`](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java) (Account API), [`src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java) (Login API), [`src/main/java/com/bincy/banking/bankingtransactionsystem/repository/UserRepository.java`](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/UserRepository.java) (User Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_account_api["Account API"]
  node_auth_api["Login API"]
  node_api_dto["API DTOs"]
end

subgraph group_banking["Account Operations"]
  node_account_contract["Account Service"]
  node_account_ops["Account Operations"]
  node_history["Transaction History"]
end

subgraph group_identity["Identity and Security"]
  node_user_contract["User Service<br/>[IUserService.java]"]
  node_user_ops["User Management"]
  node_jwt["JWT Utilities<br/>[JwtUtil.java]"]
  node_jwt_filter["JWT Filter"]
  node_security_config["Security Config"]
end

subgraph group_persistence["Domain and Persistence"]
  node_account_entity["Account Entity<br/>[Account.java]"]
  node_user_entity["User Entity<br/>[AppUser.java]"]
  node_transaction_entity["Transaction Entity<br/>[Transaction.java]"]
  node_account_repo["Account Repository"]
  node_user_repo["User Repository"]
end

subgraph group_runtime["Runtime Support"]
  node_global_errors["Error Mapping"]
  node_data_loader["User Bootstrap<br/>[DataLoader.java]"]
  node_app["Spring Boot App"]
end

node_client(("API Client"))
node_mysql[("MySQL")]
node_swagger["Swagger UI"]

node_client -->|"requests"| node_account_api
node_client -->|"logs in"| node_auth_api
node_account_api -->|"delegates to"| node_account_contract
node_account_api -->|"uses transfer DTO"| node_api_dto
node_auth_api -->|"accepts credentials"| node_api_dto
node_account_contract -->|"implemented by"| node_account_ops
node_account_ops -->|"reads and saves"| node_account_repo
node_account_ops -->|"records transfers"| node_history
node_account_ops -->|"updates balances"| node_account_entity
node_account_ops -->|"builds ledger entry"| node_transaction_entity
node_history -.->|"persists records"| node_mysql
node_account_repo -.->|"persists accounts"| node_mysql
node_user_repo -.->|"persists users"| node_mysql
node_auth_api -->|"looks up user"| node_user_repo
node_auth_api -->|"issues token"| node_jwt
node_security_config -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates tokens"| node_jwt
node_user_ops -->|"manages users"| node_user_repo
node_user_ops -->|"creates users"| node_user_entity
node_user_contract -->|"implemented by"| node_user_ops
node_data_loader -->|"loads user"| node_user_repo
node_account_api -.->|"errors mapped by"| node_global_errors
node_client -.->|"explores API"| node_swagger

click node_account_api "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java"
click node_auth_api "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java"
click node_api_dto "https://github.com/bincynizam-lab/banking-transaction-system/tree/main/src/main/java/com/bincy/banking/bankingtransactionsystem/dto"
click node_account_contract "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/AccountService.java"
click node_account_ops "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java"
click node_history "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/TransactionRepository.java"
click node_user_contract "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/IUserService.java"
click node_user_ops "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java"
click node_jwt "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtUtil.java"
click node_jwt_filter "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/config/SecurityConfig.java"
click node_account_entity "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Account.java"
click node_user_entity "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/AppUser.java"
click node_transaction_entity "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Transaction.java"
click node_account_repo "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/AccountRepository.java"
click node_user_repo "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/UserRepository.java"
click node_global_errors "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/exception/GlobalExceptionHandler.java"
click node_data_loader "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/config/DataLoader.java"
click node_app "https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/BankingTransactionSystemApplication.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_api_dto,node_client,node_swagger toneBlue
class node_account_contract,node_account_ops,node_history,node_mysql toneAmber
class node_user_contract,node_user_ops,node_jwt,node_jwt_filter,node_security_config toneMint
class node_account_entity,node_user_entity,node_transaction_entity,node_account_repo,node_user_repo toneRose
class node_global_errors,node_data_loader,node_app toneIndigo
```

## Components

### REST API

- [Account API](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java`
- [Login API](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`
- [API DTOs](https://github.com/bincynizam-lab/banking-transaction-system/tree/main/src/main/java/com/bincy/banking/bankingtransactionsystem/dto): `src/main/java/com/bincy/banking/bankingtransactionsystem/dto`

### Account Operations

- [Account Service](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/AccountService.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/service/AccountService.java`
- [Account Operations](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`
- [Transaction History](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/TransactionRepository.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/repository/TransactionRepository.java`

### Identity and Security

- [User Service](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/IUserService.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/service/IUserService.java`
- [User Management](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java`
- [JWT Utilities](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtUtil.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtUtil.java`
- [JWT Filter](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtAuthenticationFilter.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtAuthenticationFilter.java`
- [Security Config](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/config/SecurityConfig.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/config/SecurityConfig.java`

### Domain and Persistence

- [Account Entity](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Account.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Account.java`
- [User Entity](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/AppUser.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/entity/AppUser.java`
- [Transaction Entity](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Transaction.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/entity/Transaction.java`
- [Account Repository](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/AccountRepository.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/repository/AccountRepository.java`
- [User Repository](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/repository/UserRepository.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/repository/UserRepository.java`

### Runtime Support

- [Error Mapping](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/exception/GlobalExceptionHandler.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/exception/GlobalExceptionHandler.java`
- [User Bootstrap](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/config/DataLoader.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/config/DataLoader.java`
- [Spring Boot App](https://github.com/bincynizam-lab/banking-transaction-system/blob/main/src/main/java/com/bincy/banking/bankingtransactionsystem/BankingTransactionSystemApplication.java): `src/main/java/com/bincy/banking/bankingtransactionsystem/BankingTransactionSystemApplication.java`

### Other components

- **API Client**
- **MySQL**
- **Swagger UI**

## Connections

- API Client → Account API: requests (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java`)
- API Client → Login API: logs in (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`)
- Account API → Account Service: delegates to (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java`)
- Account API → API DTOs: uses transfer DTO (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AccountController.java`)
- Login API → API DTOs: accepts credentials (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`)
- Account Service → Account Operations: implemented by (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`)
- Account Operations → Account Repository: reads and saves (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`)
- Account Operations → Transaction History: records transfers (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`)
- Account Operations → Account Entity: updates balances (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`)
- Account Operations → Transaction Entity: builds ledger entry (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/AccountServiceImpl.java`)
- Transaction History → MySQL: persists records (evidence: `README.md`)
- Account Repository → MySQL: persists accounts (evidence: `README.md`)
- User Repository → MySQL: persists users (evidence: `README.md`)
- Login API → User Repository: looks up user (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`)
- Login API → JWT Utilities: issues token (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/controller/AuthController.java`)
- Security Config → JWT Filter: registers filter (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/config/SecurityConfig.java`)
- JWT Filter → JWT Utilities: validates tokens (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/security/JwtAuthenticationFilter.java`)
- User Management → User Repository: manages users (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java`)
- User Management → User Entity: creates users (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java`)
- User Service → User Management: implemented by (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/service/impl/UserServiceImpl.java`)
- User Bootstrap → User Repository: loads user (evidence: `src/main/java/com/bincy/banking/bankingtransactionsystem/config/DataLoader.java`)
- Account API → Error Mapping: errors mapped by
- API Client → Swagger UI: explores API (evidence: `README.md`)
