How diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real works
This is a Spring REST core-banking API for customer registration, account opening and lookup, and monetary transfers. Its main workflow accepts and validates HTTP requests, delegates account or transfer operations to services, and persists the resulting entities through Spring Data repositories. Transfers lock accounts in ID order, check currency and funds, update balances, and record a transaction atomically. The README documents PostgreSQL and Flyway-backed schema setup. Edges reflect excerpts and explicit README or source-index references; unsampled deposit, withdrawal, and database wiring are not expanded beyond documented evidence.
Main entry points: model JPA Entities · AccountService.java Account Service · TransferService.java Transfer Service · AccountRepository.java Account Repository
Components 17
REST API
- User API
src/main/java/com/bank/core/controller/UserController.java - Account API
src/main/java/com/bank/core/controller/AccountController.java - Transfer API
src/main/java/com/bank/core/controller/TransactionController.java - Request/Response DTOs
src/main/java/com/bank/core/dto
Banking Services
- User Service
src/main/java/com/bank/core/service/UserService.java - Account Service
src/main/java/com/bank/core/service/AccountService.java - Transfer Service
src/main/java/com/bank/core/service/TransferService.java
Persistence
- User Repository
src/main/java/com/bank/core/repository/UserRepository.java - Account Repository
src/main/java/com/bank/core/repository/AccountRepository.java - Transaction Repository
src/main/java/com/bank/core/repository/TransactionRepository.java - Flyway Schema
src/main/resources/db/migration/V1__init_schema.sql - PostgreSQL
Domain Model
- JPA Entities
src/main/java/com/bank/core/model
Error Handling
- Domain Exceptions
src/main/java/com/bank/core/exception - Global Error Handler
src/main/java/com/bank/core/exception/GlobalExceptionHandler.java - Error Response
src/main/java/com/bank/core/exception/ErrorResponse.java
Other components
- API Client
Connections 26
- API Client → User API: registers users
README.md - API Client → Account API: opens or reads
README.md - API Client → Transfer API: requests transfer
README.md - User API → Request/Response DTOs: accepts and returns
src/main/java/com/bank/core/controller/UserController.java - Account API → Request/Response DTOs: accepts and returns
src/main/java/com/bank/core/controller/AccountController.java - Transfer API → Request/Response DTOs: accepts and returns
src/main/java/com/bank/core/controller/TransactionController.java - User API → User Service: delegates to
src/main/java/com/bank/core/controller/UserController.java - Account API → Account Service: delegates to
src/main/java/com/bank/core/controller/AccountController.java - Transfer API → Transfer Service: delegates to
src/main/java/com/bank/core/controller/TransactionController.java - User Service → User Repository: reads and saves
src/main/java/com/bank/core/service/UserService.java - Account Service → User Repository: finds account owner
src/main/java/com/bank/core/service/AccountService.java - Account Service → Account Repository: reads and saves
src/main/java/com/bank/core/service/AccountService.java - Transfer Service → Account Repository: locks and saves
src/main/java/com/bank/core/service/TransferService.java - Transfer Service → Transaction Repository: records transfer
src/main/java/com/bank/core/service/TransferService.java - User Service → JPA Entities: creates users
src/main/java/com/bank/core/service/UserService.java - Account Service → JPA Entities: updates accounts
src/main/java/com/bank/core/service/AccountService.java - Transfer Service → JPA Entities: updates and records
src/main/java/com/bank/core/service/TransferService.java - User Repository → JPA Entities: persists users
src/main/java/com/bank/core/repository/UserRepository.java - Account Repository → JPA Entities: persists accounts
src/main/java/com/bank/core/repository/AccountRepository.java - Transaction Repository → JPA Entities: persists transactions
src/main/java/com/bank/core/repository/TransactionRepository.java - Account Service → Domain Exceptions: throws on failure
src/main/java/com/bank/core/service/AccountService.java - Transfer Service → Domain Exceptions: throws on failure
src/main/java/com/bank/core/service/TransferService.java - Global Error Handler → Domain Exceptions: handles exceptions
src/main/java/com/bank/core/exception/GlobalExceptionHandler.java - Global Error Handler → Error Response: serializes errors
src/main/java/com/bank/core/exception/GlobalExceptionHandler.java - Account Repository → PostgreSQL: accesses via JPA
README.md - Flyway Schema → PostgreSQL: defines tables
README.md