How baldev-sinh/novabank-platform works
NovaBank is a digital-banking platform: a user signs in through the Angular client, then uses protected banking operations. The backend separates identity, customer/KYC, accounts and funds, ledger, and payment-saga responsibilities across five services with individual PostgreSQL databases; Kafka carries service messages through transactional outboxes. The graph preserves those documented domain stages and the shared platform layer. Cross-service links follow the README’s documented architecture; only the internal calls visible in sampled source are asserted directly, since most service wiring was not sampled.
Main entry points: authentication.service.ts Web auth state · app.routes.ts Protected routing · auth Auth service · OpenAccountService.java Open account
Components 26
Web client
- Angular app
frontend/novabank-web/src/app/app.component.ts - Login screen
frontend/novabank-web/src/app/features/auth/pages/login/login.component.ts - Web auth state
frontend/novabank-web/src/app/features/auth/services/authentication.service.ts - Token storage
frontend/novabank-web/src/app/features/auth/services/token-storage.service.ts - Protected routing
frontend/novabank-web/src/app/app.routes.ts - Banking dashboard
frontend/novabank-web/src/app/features/dashboard/pages/dashboard/dashboard.component.ts
Identity
- Auth service
services/novabank-auth-service/src/main/java/com/novabank/auth - Session rotation
services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java - JWT issuance
services/novabank-auth-service/src/main/java/com/novabank/auth/infrastructure/security/JwtTokenService.java
Customer lifecycle
- Customer profiles
services/novabank-customer-service/src/main/java/com/novabank/customer - KYC approval
services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java
Banking operations
- Account service
services/novabank-account-service/src/main/java/com/novabank/account - Open account
services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java - Account lifecycle
services/novabank-account-service/src/main/java/com/novabank/account/domain/model/Account.java - Funds and holds
services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java - Ledger service
services/novabank-ledger-service/src/main/java/com/novabank/ledger - Post transactions
services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java - Ledger queries
services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/LedgerQueryService.java - Payment service
services/novabank-payment-service/src/main/java/com/novabank/payment - Initiate payment
services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java - Payment saga
services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java
Shared platform
- Service databases
- Kafka messaging
- Platform starter
libs/novabank-platform-starter/src/main/java/com/novabank/platform - Email delivery
Other components
- Bank customer
Connections 32
- Bank customer → Login screen: signs in
README.md - Login screen → Web auth state: submits credentials
- Web auth state → Auth service: REST + JWT
README.md - Angular app → Protected routing: routes through
frontend/novabank-web/src/app/app.routes.ts - Protected routing → Login screen: shows guest page
frontend/novabank-web/src/app/app.routes.ts - Protected routing → Banking dashboard: guards access
frontend/novabank-web/src/app/app.routes.ts - Web auth state → Token storage: stores tokens
frontend/novabank-web/src/app/features/auth/services/authentication.service.ts - Auth service → Session rotation: handles sessions
services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java - Session rotation → JWT issuance: issues access token
services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java - Auth service → Email delivery: sends verification
README.md - Bank customer → Customer profiles: manages profile
README.md - Customer profiles → KYC approval: reviews KYC
services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java - KYC approval → Kafka messaging: publishes verification
services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java - Bank customer → Account service: opens account
README.md - Account service → Open account: handles opening
services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java - Open account → Account lifecycle: creates account
services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java - Open account → Customer profiles: checks eligibility
services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java - Bank customer → Payment service: transfers or deposits
README.md - Payment service → Initiate payment: starts payment
services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java - Initiate payment → Payment saga: advances workflow
- Initiate payment → Kafka messaging: writes first command
services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java - Payment saga → Kafka messaging: dispatches saga steps
services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java - Kafka messaging → Funds and holds: delivers commands
README.md - Funds and holds → Kafka messaging: emits hold outcomes
services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java - Kafka messaging → Post transactions: delivers postings
README.md - Post transactions → Kafka messaging: publishes posting result
services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java - Bank customer → Ledger service: queries ledger
README.md - Ledger service → Ledger queries: serves queries
services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/LedgerQueryService.java - Funds and holds → Service databases: stores holds and balances
- Post transactions → Service databases: persists postings
- Platform starter → Kafka messaging: supports messaging
README.md - Platform starter → Service databases: supports persistence