# ptuon25/spring-boot-bank architecture

> Architecture diagram of the GitHub repository ptuon25/spring-boot-bank, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ptuon25/spring-boot-bank
- Repository: https://github.com/ptuon25/spring-boot-bank

## Overview

This is a Spring-based banking backend for client and company services, account management, transactions, and investments. The principal visible workflow is login: authentication is delegated to Spring Security, then a JWT is issued; other API workflows are represented by controller and service modules. Services validate and manipulate domain entities and use repositories for persistence. The README is empty, and the excerpts cover only selected modules, so relationships among unsampled API branches are omitted rather than inferred.

Main entry points: [`src/main/java/com/tuon/tbank/service/auth/AuthService.java`](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/auth/AuthService.java) (Authentication service), [`src/main/java/com/tuon/tbank/service/company/CompanyService.java`](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyService.java) (Company service), [`src/main/java/com/tuon/tbank/repository/person/ClientRepository.java`](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/person/ClientRepository.java) (Client repository), [`src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java`](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java) (Membership service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_user_details["User lookup"]
  node_jwt["JWT service<br/>[JwtService.java]"]
end

subgraph group_customers["People and companies"]
  node_client["Bank client<br/>[Client.java]"]
  node_company["Company<br/>[Company.java]"]
  node_client_api["Client API"]
  node_client_service["Client service<br/>[ClientService.java]"]
  node_company_service["Company service"]
  node_membership_service["Membership service"]
  node_client_repo["Client repository"]
  node_company_repo["Company repository"]
end

subgraph group_accounts["Bank accounts"]
  node_account["Account model<br/>[Account.java]"]
  node_business_account_service["Business account service"]
  node_business_account_api["Business account API"]
  node_account_repos["Account repositories"]
end

subgraph group_payments["Transactions and audit"]
  node_transactions["Transaction APIs"]
  node_transaction_services["Transaction services"]
  node_audit["Audit records<br/>[AuditRecord.java]"]
  node_audit_service["Audit service"]
end

subgraph group_investments["Investments"]
  node_investment_apis["Investment APIs"]
  node_investment_services["Investment services"]
  node_investment_return_service["Monthly returns"]
  node_investment_return_repo["Return repository"]
  node_investment_portfolio_service["Portfolio service"]
  node_investment["Investment model<br/>[Investment.java]"]
end

node_actor(("Bank user"))
node_spring_auth["Spring authentication"]

node_actor -.->|"submits login"| node_auth_service
node_auth_service -->|"authenticates"| node_spring_auth
node_auth_service -->|"issues token"| node_jwt
node_user_details -->|"looks up client"| node_client_repo
node_client_api -->|"delegates to"| node_client_service
node_client_service -->|"reads and saves"| node_client_repo
node_company_service -->|"reads and saves"| node_company_repo
node_company_service -->|"uses person model"| node_client
node_membership_service -->|"uses company service"| node_company_service
node_membership_service -->|"reads client"| node_client_repo
node_business_account_api -->|"delegates to"| node_business_account_service
node_business_account_service -->|"persists account"| node_account_repos
node_investment_return_service -->|"reads returns"| node_investment_return_repo
node_investment_portfolio_service -->|"uses investment model"| node_investment

click node_client "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/person/Client.java"
click node_company "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/company/Company.java"
click node_client_api "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/controller/person/ClientController.java"
click node_client_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/person/ClientService.java"
click node_company_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyService.java"
click node_membership_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java"
click node_client_repo "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/person/ClientRepository.java"
click node_company_repo "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/company/CompanyRepository.java"
click node_account "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/account/Account.java"
click node_business_account_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java"
click node_business_account_api "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java"
click node_account_repos "https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/repository/account"
click node_transactions "https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/controller/transaction"
click node_transaction_services "https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/service/transaction"
click node_audit "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/audit/AuditRecord.java"
click node_audit_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/audit/AuditRecordService.java"
click node_auth_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/auth/AuthService.java"
click node_user_details "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java"
click node_jwt "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/security/auth/JwtService.java"
click node_investment_apis "https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/controller/investment"
click node_investment_services "https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/service/investment"
click node_investment_return_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java"
click node_investment_return_repo "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/investment/InvestmentMonthlyReturnRepository.java"
click node_investment_portfolio_service "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java"
click node_investment "https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/investment/Investment.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_auth_service,node_user_details,node_jwt,node_actor toneBlue
class node_client,node_company,node_client_api,node_client_service,node_company_service,node_membership_service,node_client_repo,node_company_repo toneAmber
class node_account,node_business_account_service,node_business_account_api,node_account_repos toneMint
class node_transactions,node_transaction_services,node_audit,node_audit_service toneRose
class node_investment_apis,node_investment_services,node_investment_return_service,node_investment_return_repo,node_investment_portfolio_service,node_investment,node_spring_auth toneIndigo
```

## Components

### Identity and access

- [Authentication service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/auth/AuthService.java): `src/main/java/com/tuon/tbank/service/auth/AuthService.java`
- [User lookup](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java): `src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java`
- [JWT service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/security/auth/JwtService.java): `src/main/java/com/tuon/tbank/security/auth/JwtService.java`

### People and companies

- [Bank client](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/person/Client.java): `src/main/java/com/tuon/tbank/entity/person/Client.java`
- [Company](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/company/Company.java): `src/main/java/com/tuon/tbank/entity/company/Company.java`
- [Client API](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/controller/person/ClientController.java): `src/main/java/com/tuon/tbank/controller/person/ClientController.java`
- [Client service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/person/ClientService.java): `src/main/java/com/tuon/tbank/service/person/ClientService.java`
- [Company service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyService.java): `src/main/java/com/tuon/tbank/service/company/CompanyService.java`
- [Membership service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java): `src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java`
- [Client repository](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/person/ClientRepository.java): `src/main/java/com/tuon/tbank/repository/person/ClientRepository.java`
- [Company repository](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/company/CompanyRepository.java): `src/main/java/com/tuon/tbank/repository/company/CompanyRepository.java`

### Bank accounts

- [Account model](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/account/Account.java): `src/main/java/com/tuon/tbank/entity/account/Account.java`
- [Business account service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java): `src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java`
- [Business account API](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java): `src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java`
- [Account repositories](https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/repository/account): `src/main/java/com/tuon/tbank/repository/account`

### Transactions and audit

- [Transaction APIs](https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/controller/transaction): `src/main/java/com/tuon/tbank/controller/transaction`
- [Transaction services](https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/service/transaction): `src/main/java/com/tuon/tbank/service/transaction`
- [Audit records](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/audit/AuditRecord.java): `src/main/java/com/tuon/tbank/entity/audit/AuditRecord.java`
- [Audit service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/audit/AuditRecordService.java): `src/main/java/com/tuon/tbank/service/audit/AuditRecordService.java`

### Investments

- [Investment APIs](https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/controller/investment): `src/main/java/com/tuon/tbank/controller/investment`
- [Investment services](https://github.com/ptuon25/spring-boot-bank/tree/master/src/main/java/com/tuon/tbank/service/investment): `src/main/java/com/tuon/tbank/service/investment`
- [Monthly returns](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java): `src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java`
- [Return repository](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/repository/investment/InvestmentMonthlyReturnRepository.java): `src/main/java/com/tuon/tbank/repository/investment/InvestmentMonthlyReturnRepository.java`
- [Portfolio service](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java): `src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java`
- [Investment model](https://github.com/ptuon25/spring-boot-bank/blob/master/src/main/java/com/tuon/tbank/entity/investment/Investment.java): `src/main/java/com/tuon/tbank/entity/investment/Investment.java`

### Other components

- **Bank user**
- **Spring authentication**

## Connections

- Bank user → Authentication service: submits login
- Authentication service → Spring authentication: authenticates (evidence: `src/main/java/com/tuon/tbank/service/auth/AuthService.java`)
- Authentication service → JWT service: issues token (evidence: `src/main/java/com/tuon/tbank/service/auth/AuthService.java`)
- User lookup → Client repository: looks up client (evidence: `src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java`)
- Client API → Client service: delegates to (evidence: `src/main/java/com/tuon/tbank/controller/person/ClientController.java`)
- Client service → Client repository: reads and saves (evidence: `src/main/java/com/tuon/tbank/service/person/ClientService.java`)
- Company service → Company repository: reads and saves (evidence: `src/main/java/com/tuon/tbank/service/company/CompanyService.java`)
- Company service → Bank client: uses person model (evidence: `src/main/java/com/tuon/tbank/service/company/CompanyService.java`)
- Membership service → Company service: uses company service (evidence: `src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java`)
- Membership service → Client repository: reads client (evidence: `src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java`)
- Business account API → Business account service: delegates to (evidence: `src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java`)
- Business account service → Account repositories: persists account (evidence: `src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java`)
- Monthly returns → Return repository: reads returns (evidence: `src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java`)
- Portfolio service → Investment model: uses investment model (evidence: `src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java`)
