How alirezamohamadian1998/neobank works
NeoBank is a Spring Boot banking backend. Its core user-to-result flow is authenticated customer money movement: deposit, withdrawal, or transfer services validate and coordinate a request, optionally use a cached FX-rate lock, post balanced ledger entries, and record idempotency results. Account/customer management, debit-card issuing, FX-rate lookup, and transaction history are distinct product capabilities. Source excerpts show the money-movement and ledger boundaries; several other branches are represented from the README and file tree, so their internal calls are not inferred.
Main entry points: DepositService.java Deposits · WithdrawalService.java Withdrawals · TransferService.java Transfers · LedgerPostingService.java Ledger posting
Components 21
Identity and customers
- Customer management
src/main/java/com/neobank/neobank/customer/CustomerService.java - JWT authentication
src/main/java/com/neobank/neobank/auth/AuthService.java
Accounts and cards
- Account management
src/main/java/com/neobank/neobank/account/AccountService.java - Accounts and balances
src/main/java/com/neobank/neobank/account/Account.java - Debit cards
src/main/java/com/neobank/neobank/card/DebitCardService.java - Card issuer
src/main/java/com/neobank/neobank/card/issuing/DebitCardIssuer.java
Money movement
- Deposits
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Transfers
src/main/java/com/neobank/neobank/transaction/transfer/TransferService.java - Transaction history
src/main/java/com/neobank/neobank/transaction/history/TransactionHistoryService.java - Idempotency
src/main/java/com/neobank/neobank/idempotency/IdempotencyService.java - Idempotency records
src/main/java/com/neobank/neobank/idempotency/IdempotencyRecord.java
Ledger and persistence
- Ledger posting
src/main/java/com/neobank/neobank/ledger/LedgerPostingService.java - Ledger accounts
src/main/java/com/neobank/neobank/ledger/LedgerAccount.java - Bank transactions
src/main/java/com/neobank/neobank/transaction/BankTransaction.java - Settlement accounts
src/main/java/com/neobank/neobank/internalaccount/InternalAccount.java
FX rates
- FX rate locks
src/main/java/com/neobank/neobank/fx/FxRateService.java - Rate caches
src/main/java/com/neobank/neobank/fx/ProviderRateCache.java - Rates integration
src/main/java/com/neobank/neobank/fx/openexchangerates/OpenExchangeRatesClient.java
Other components
- Customer
- Open Exchange Rates
Connections 35
- Customer → Customer management: registers
README.md - Customer → JWT authentication: logs in
README.md - Customer → Account management: manages accounts
README.md - Customer → Deposits: requests deposit
README.md - Customer → Withdrawals: requests withdrawal
README.md - Customer → Transfers: requests transfer
README.md - Customer → Transaction history: views history
- Customer → Debit cards: manages cards
- Account management → Accounts and balances: creates and reads
src/main/java/com/neobank/neobank/account/AccountService.java - Debit cards → Accounts and balances: loads funding account
src/main/java/com/neobank/neobank/card/DebitCardService.java - Debit cards → Card issuer: issues card
src/main/java/com/neobank/neobank/card/DebitCardService.java - Deposits → Accounts and balances: loads account
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals → Accounts and balances: loads account
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Transfers → Accounts and balances: loads accounts
src/main/java/com/neobank/neobank/transaction/transfer/TransferService.java - Deposits → FX rate locks: gets locked rates
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals → FX rate locks: gets locked rates
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Transfers → FX rate locks: gets locked rates
src/main/java/com/neobank/neobank/transaction/transfer/TransferService.java - FX rate locks → Rate caches: reads and stores rates
src/main/java/com/neobank/neobank/fx/FxRateService.java - Open Exchange Rates → Rates integration: supplies rates
README.md - Rates integration → Rate caches: provides cached rates
- Deposits → Ledger posting: posts entries
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals → Ledger posting: posts entries
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Transfers → Ledger posting: posts entries
src/main/java/com/neobank/neobank/transaction/transfer/TransferService.java - Deposits → Settlement accounts: loads settlement account
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals → Settlement accounts: loads settlement account
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Ledger posting → Ledger accounts: updates balance
src/main/java/com/neobank/neobank/ledger/LedgerPostingService.java - Ledger posting → Bank transactions: adds entry
src/main/java/com/neobank/neobank/ledger/LedgerPostingService.java - Deposits → Bank transactions: completes transaction
README.md - Withdrawals → Bank transactions: completes transaction
README.md - Transfers → Bank transactions: completes transaction
README.md - Deposits → Idempotency: checks and saves key
src/main/java/com/neobank/neobank/transaction/deposit/DepositService.java - Withdrawals → Idempotency: checks and saves key
src/main/java/com/neobank/neobank/transaction/withdrawal/WithdrawalService.java - Transfers → Idempotency: checks and saves key
src/main/java/com/neobank/neobank/transaction/transfer/TransferService.java - Idempotency → Idempotency records: reads and writes
src/main/java/com/neobank/neobank/idempotency/IdempotencyService.java - Transaction history → Bank transactions: reads transactions