How mehandihasan2023/digital-banking-platform works
This is a Java/Spring microservices digital banking backend. A client enters through the API gateway, authenticates with the auth service, then uses customer and account APIs; transactions are handled synchronously by the transaction service, which coordinates balance changes with the account service. Transaction events are published asynchronously through Kafka for notification and audit processing. The README documents the principal service routes, isolated schemas, and event flow; sampled service code confirms transaction orchestration, account locking, and consumer-side deduplication. Other wiring is not inferred from filenames alone.
Main entry points: ApiGatewayApplication.java API gateway · TransactionService.java Transaction service · NotificationKafkaConsumer.java Notification consumer and service · AuditKafkaConsumer.java Audit consumer and service
Components 18
API entry
- API gateway
api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java
Identity and profiles
- Auth service
auth-service/src/main/java/com/banking/auth/service/AuthService.java - Auth schema
auth-service/src/main/java/com/banking/auth/repository/UserRepository.java - Customer profiles
customer-service/src/main/java/com/banking/customer/service/CustomerService.java - Customer schema
customer-service/src/main/java/com/banking/customer/repository/CustomerRepository.java
Accounts and transactions
- Account service
account-service/src/main/java/com/banking/account/service/AccountService.java - Account schema
account-service/src/main/java/com/banking/account/repository/AccountRepository.java - Transaction service
transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java - Idempotency
transaction-service/src/main/java/com/banking/transaction/service/IdempotencyService.java - Transaction schema
transaction-service/src/main/java/com/banking/transaction/repository/TransactionRepository.java
Events and side effects
- Outbox publisher
transaction-service/src/main/java/com/banking/transaction/publisher/OutboxPublisher.java - Kafka broker
- Notification consumer and service
notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java - Notification schema
notification-service/src/main/java/com/banking/notification/repository/NotificationRepository.java - Audit consumer and service
audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java - Audit schema
audit-service/src/main/java/com/banking/audit/repository/AuditLogRepository.java
Shared contracts
- Shared events and API types
banking-common/src/main/java/com/banking/common/event/TransactionEvent.java
Other components
- Banking client
Connections 22
- Banking client → API gateway: sends requests
README.md - API gateway → Auth service: routes auth
README.md - API gateway → Customer profiles: routes profiles
README.md - API gateway → Account service: routes accounts
README.md - API gateway → Transaction service: routes transactions
README.md - API gateway → Notification consumer and service: routes notifications
README.md - API gateway → Audit consumer and service: routes audit
README.md - Auth service → Auth schema: reads and writes
auth-service/src/main/java/com/banking/auth/service/AuthService.java - Customer profiles → Customer schema: reads and writes
customer-service/src/main/java/com/banking/customer/service/CustomerService.java - Account service → Account schema: reads and locks
account-service/src/main/java/com/banking/account/service/AccountService.java - Transaction service → Idempotency: checks keys
transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java - Transaction service → Account service: requests balance changes
README.md - Transaction service → Transaction schema: records transactions
transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java - Transaction service → Outbox publisher: records events
README.md - Outbox publisher → Kafka broker: publishes events
README.md - Kafka broker → Notification consumer and service: dispatches events
README.md - Kafka broker → Audit consumer and service: dispatches events
README.md - Notification consumer and service → Notification schema: saves notices
- Audit consumer and service → Audit schema: saves audit logs
- Transaction service → Shared events and API types: uses event contract
transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java - Notification consumer and service → Shared events and API types: uses event contract
- Audit consumer and service → Shared events and API types: uses event contract