How ptuon25/spring-boot-bank works
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: AuthService.java Authentication service · CompanyService.java Company service · ClientRepository.java Client repository · CompanyMembershipService.java Membership service
Components 27
Identity and access
- Authentication service
src/main/java/com/tuon/tbank/service/auth/AuthService.java - User lookup
src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java - JWT service
src/main/java/com/tuon/tbank/security/auth/JwtService.java
People and companies
- Bank client
src/main/java/com/tuon/tbank/entity/person/Client.java - Company
src/main/java/com/tuon/tbank/entity/company/Company.java - Client API
src/main/java/com/tuon/tbank/controller/person/ClientController.java - Client service
src/main/java/com/tuon/tbank/service/person/ClientService.java - Company service
src/main/java/com/tuon/tbank/service/company/CompanyService.java - Membership service
src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java - Client repository
src/main/java/com/tuon/tbank/repository/person/ClientRepository.java - Company repository
src/main/java/com/tuon/tbank/repository/company/CompanyRepository.java
Bank accounts
- Account model
src/main/java/com/tuon/tbank/entity/account/Account.java - Business account service
src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java - Business account API
src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java - Account repositories
src/main/java/com/tuon/tbank/repository/account
Transactions and audit
- Transaction APIs
src/main/java/com/tuon/tbank/controller/transaction - Transaction services
src/main/java/com/tuon/tbank/service/transaction - Audit records
src/main/java/com/tuon/tbank/entity/audit/AuditRecord.java - Audit service
src/main/java/com/tuon/tbank/service/audit/AuditRecordService.java
Investments
- Investment APIs
src/main/java/com/tuon/tbank/controller/investment - Investment services
src/main/java/com/tuon/tbank/service/investment - Monthly returns
src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java - Return repository
src/main/java/com/tuon/tbank/repository/investment/InvestmentMonthlyReturnRepository.java - Portfolio service
src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java - Investment model
src/main/java/com/tuon/tbank/entity/investment/Investment.java
Other components
- Bank user
- Spring authentication
Connections 14
- Bank user → Authentication service: submits login
- Authentication service → Spring authentication: authenticates
src/main/java/com/tuon/tbank/service/auth/AuthService.java - Authentication service → JWT service: issues token
src/main/java/com/tuon/tbank/service/auth/AuthService.java - User lookup → Client repository: looks up client
src/main/java/com/tuon/tbank/security/auth/BankUserDetailsService.java - Client API → Client service: delegates to
src/main/java/com/tuon/tbank/controller/person/ClientController.java - Client service → Client repository: reads and saves
src/main/java/com/tuon/tbank/service/person/ClientService.java - Company service → Company repository: reads and saves
src/main/java/com/tuon/tbank/service/company/CompanyService.java - Company service → Bank client: uses person model
src/main/java/com/tuon/tbank/service/company/CompanyService.java - Membership service → Company service: uses company service
src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java - Membership service → Client repository: reads client
src/main/java/com/tuon/tbank/service/company/CompanyMembershipService.java - Business account API → Business account service: delegates to
src/main/java/com/tuon/tbank/controller/account/BusinessAccountController.java - Business account service → Account repositories: persists account
src/main/java/com/tuon/tbank/service/account/BusinessAccountService.java - Monthly returns → Return repository: reads returns
src/main/java/com/tuon/tbank/service/investment/InvestmentMonthlyReturnService.java - Portfolio service → Investment model: uses investment model
src/main/java/com/tuon/tbank/service/investment/InvestmentPortfolioService.java