How mahmudsaidxonov/bank-core works
This repository is the bank-core service in a documented banking microservices system. Its main workflow is registration/login to create an authenticated user and account, then account operations and transfers; transfers lock accounts, update balances, record transaction history and queue a notification event. The graph also shows the transactional outbox publisher, JWT security, and the documented broker and notification-service boundary. Evidence is limited to the README and indexed excerpts/read files; unshown integrations are dashed.
Main entry points: TransactionService.java Transfers and history · UserService.java User and auth · AccountRepository.java Account repository · OutboxScheduler.java Outbox scheduler
Components 21
API
- User API
src/main/java/uz/banking/bank_core/controller/UserController.java - Account API
src/main/java/uz/banking/bank_core/controller/AccountController.java - Transaction API
src/main/java/uz/banking/bank_core/controller/TransactionController.java - Internal user API
src/main/java/uz/banking/bank_core/controller/InternalUserController.java
Banking operations
- User and auth
src/main/java/uz/banking/bank_core/service/UserService.java - Account operations
src/main/java/uz/banking/bank_core/service/AccountService.java - Transfers and history
src/main/java/uz/banking/bank_core/service/TransactionService.java - Failed transfer audit
src/main/java/uz/banking/bank_core/service/TransactionAuditService.java
Persistence
- Banking records
src/main/java/uz/banking/bank_core/entity - Account repository
src/main/java/uz/banking/bank_core/repository/AccountRepository.java - User repository
src/main/java/uz/banking/bank_core/repository/UserRepository.java - Transaction repository
src/main/java/uz/banking/bank_core/repository/TransactionRepository.java - Outbox repository
src/main/java/uz/banking/bank_core/repository/OutboxRepository.java
Security and messaging
- JWT filter and utilities
src/main/java/uz/banking/bank_core/security - Outbox scheduler
src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java - RabbitMQ configuration
src/main/java/uz/banking/bank_core/config/RabbitMQConfig.java
Other components
- Banking client
- PostgreSQL
- RabbitMQ
- bank-notification
- Eureka registry
Connections 28
- Banking client → User API: register or login
src/main/java/uz/banking/bank_core/controller/UserController.java - Banking client → Account API: manage accounts
src/main/java/uz/banking/bank_core/controller/AccountController.java - Banking client → Transaction API: request transfer
src/main/java/uz/banking/bank_core/controller/TransactionController.java - Banking client → Internal user API: request user data
src/main/java/uz/banking/bank_core/controller/InternalUserController.java - User API → User and auth: delegates
src/main/java/uz/banking/bank_core/controller/UserController.java - Account API → Account operations: delegates
src/main/java/uz/banking/bank_core/controller/AccountController.java - Transaction API → Transfers and history: delegates
src/main/java/uz/banking/bank_core/controller/TransactionController.java - Internal user API → User and auth: delegates
src/main/java/uz/banking/bank_core/controller/InternalUserController.java - User and auth → User repository: reads and saves users
src/main/java/uz/banking/bank_core/service/UserService.java - User and auth → Account repository: creates account
src/main/java/uz/banking/bank_core/service/UserService.java - User and auth → JWT filter and utilities: issues token
src/main/java/uz/banking/bank_core/service/UserService.java - Account operations → Account repository: reads and updates
src/main/java/uz/banking/bank_core/service/AccountService.java - Account operations → User repository: checks user
src/main/java/uz/banking/bank_core/service/AccountService.java - Transfers and history → Account repository: locks accounts
src/main/java/uz/banking/bank_core/service/TransactionService.java - Transfers and history → Transaction repository: records and queries
src/main/java/uz/banking/bank_core/service/TransactionService.java - Transfers and history → Failed transfer audit: records failed transfer
src/main/java/uz/banking/bank_core/service/TransactionService.java - Failed transfer audit → Transaction repository: saves failed record
src/main/java/uz/banking/bank_core/service/TransactionAuditService.java - Transfers and history → Outbox repository: queues event
src/main/java/uz/banking/bank_core/service/TransactionService.java - Outbox scheduler → Outbox repository: polls and locks events
src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java - Outbox scheduler → RabbitMQ configuration: uses broker settings
src/main/java/uz/banking/bank_core/scheduler/OutboxScheduler.java - Outbox scheduler → RabbitMQ: publishes events
README.md - RabbitMQ → bank-notification: delivers transfer events
README.md - Eureka registry → bank-notification: supports discovery
README.md - Eureka registry → RabbitMQ configuration: supports service discovery
README.md - User repository → PostgreSQL: persists users
README.md - Account repository → PostgreSQL: persists accounts
README.md - Transaction repository → PostgreSQL: persists transactions
README.md - Outbox repository → PostgreSQL: persists outbox
README.md