# baldev-sinh/novabank-platform architecture

> Architecture diagram of the GitHub repository baldev-sinh/novabank-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baldev-sinh/novabank-platform
- Repository: https://github.com/baldev-sinh/novabank-platform

## Overview

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: [`frontend/novabank-web/src/app/features/auth/services/authentication.service.ts`](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/services/authentication.service.ts) (Web auth state), [`frontend/novabank-web/src/app/app.routes.ts`](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/app.routes.ts) (Protected routing), [`services/novabank-auth-service/src/main/java/com/novabank/auth`](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-auth-service/src/main/java/com/novabank/auth) (Auth service), [`services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java`](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java) (Open account)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webapp["Angular app<br/>[app.component.ts]"]
  node_login["Login screen<br/>[login.component.ts]"]
  node_web_auth["Web auth state"]
  node_web_token[("Token storage")]
  node_routing["Protected routing<br/>[app.routes.ts]"]
  node_dashboard["Banking dashboard"]
end

subgraph group_identity["Identity"]
  node_authsvc["Auth service"]
  node_sessions["Session rotation"]
  node_jwt["JWT issuance"]
end

subgraph group_customer["Customer lifecycle"]
  node_customer_svc["Customer profiles"]
  node_kyc["KYC approval"]
end

subgraph group_banking["Banking operations"]
  node_account_svc["Account service"]
  node_open_account["Open account"]
  node_account_domain["Account lifecycle<br/>[Account.java]"]
  node_funds["Funds and holds<br/>[FundsService.java]"]
  node_ledger["Ledger service"]
  node_ledger_post["Post transactions"]
  node_ledger_query["Ledger queries"]
  node_payment["Payment service"]
  node_initiate["Initiate payment"]
  node_saga["Payment saga"]
end

subgraph group_platform["Shared platform"]
  node_dbs[("Service databases")]
  node_kafka["Kafka messaging"]
  node_starter["Platform starter"]
  node_mail["Email delivery"]
end

node_user(("Bank customer"))

node_user -->|"signs in"| node_login
node_login -.->|"submits credentials"| node_web_auth
node_web_auth -->|"REST + JWT"| node_authsvc
node_webapp -->|"routes through"| node_routing
node_routing -->|"shows guest page"| node_login
node_routing -->|"guards access"| node_dashboard
node_web_auth -.->|"stores tokens"| node_web_token
node_authsvc -.->|"handles sessions"| node_sessions
node_sessions -->|"issues access token"| node_jwt
node_authsvc -.->|"sends verification"| node_mail
node_user -->|"manages profile"| node_customer_svc
node_customer_svc -.->|"reviews KYC"| node_kyc
node_kyc -->|"publishes verification"| node_kafka
node_user -->|"opens account"| node_account_svc
node_account_svc -.->|"handles opening"| node_open_account
node_open_account -->|"creates account"| node_account_domain
node_open_account -->|"checks eligibility"| node_customer_svc
node_user -->|"transfers or deposits"| node_payment
node_payment -.->|"starts payment"| node_initiate
node_initiate -.->|"advances workflow"| node_saga
node_initiate -->|"writes first command"| node_kafka
node_saga -->|"dispatches saga steps"| node_kafka
node_kafka -.->|"delivers commands"| node_funds
node_funds -->|"emits hold outcomes"| node_kafka
node_kafka -.->|"delivers postings"| node_ledger_post
node_ledger_post -->|"publishes posting result"| node_kafka
node_user -->|"queries ledger"| node_ledger
node_ledger -.->|"serves queries"| node_ledger_query
node_funds -.->|"stores holds and balances"| node_dbs
node_ledger_post -.->|"persists postings"| node_dbs
node_starter -.->|"supports messaging"| node_kafka
node_starter -.->|"supports persistence"| node_dbs

click node_webapp "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/app.component.ts"
click node_login "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/pages/login/login.component.ts"
click node_web_auth "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/services/authentication.service.ts"
click node_web_token "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/services/token-storage.service.ts"
click node_routing "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/app.routes.ts"
click node_dashboard "https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/dashboard/pages/dashboard/dashboard.component.ts"
click node_authsvc "https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-auth-service/src/main/java/com/novabank/auth"
click node_sessions "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java"
click node_jwt "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-auth-service/src/main/java/com/novabank/auth/infrastructure/security/JwtTokenService.java"
click node_customer_svc "https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-customer-service/src/main/java/com/novabank/customer"
click node_kyc "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java"
click node_account_svc "https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-account-service/src/main/java/com/novabank/account"
click node_open_account "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java"
click node_account_domain "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/domain/model/Account.java"
click node_funds "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java"
click node_ledger "https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger"
click node_ledger_post "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java"
click node_ledger_query "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/LedgerQueryService.java"
click node_payment "https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-payment-service/src/main/java/com/novabank/payment"
click node_initiate "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java"
click node_saga "https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java"
click node_starter "https://github.com/baldev-sinh/novabank-platform/tree/main/libs/novabank-platform-starter/src/main/java/com/novabank/platform"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_login,node_web_auth,node_web_token,node_routing,node_dashboard toneBlue
class node_authsvc,node_sessions,node_jwt toneAmber
class node_customer_svc,node_kyc toneMint
class node_account_svc,node_open_account,node_account_domain,node_funds,node_ledger,node_ledger_post,node_ledger_query,node_payment,node_initiate,node_saga toneRose
class node_dbs,node_kafka,node_starter,node_mail,node_user toneIndigo
```

## Components

### Web client

- [Angular app](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/app.component.ts): `frontend/novabank-web/src/app/app.component.ts`
- [Login screen](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/pages/login/login.component.ts): `frontend/novabank-web/src/app/features/auth/pages/login/login.component.ts`
- [Web auth state](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/services/authentication.service.ts): `frontend/novabank-web/src/app/features/auth/services/authentication.service.ts`
- [Token storage](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/auth/services/token-storage.service.ts): `frontend/novabank-web/src/app/features/auth/services/token-storage.service.ts`
- [Protected routing](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/app.routes.ts): `frontend/novabank-web/src/app/app.routes.ts`
- [Banking dashboard](https://github.com/baldev-sinh/novabank-platform/blob/main/frontend/novabank-web/src/app/features/dashboard/pages/dashboard/dashboard.component.ts): `frontend/novabank-web/src/app/features/dashboard/pages/dashboard/dashboard.component.ts`

### Identity

- [Auth service](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-auth-service/src/main/java/com/novabank/auth): `services/novabank-auth-service/src/main/java/com/novabank/auth`
- [Session rotation](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java): `services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java`
- [JWT issuance](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-auth-service/src/main/java/com/novabank/auth/infrastructure/security/JwtTokenService.java): `services/novabank-auth-service/src/main/java/com/novabank/auth/infrastructure/security/JwtTokenService.java`

### Customer lifecycle

- [Customer profiles](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-customer-service/src/main/java/com/novabank/customer): `services/novabank-customer-service/src/main/java/com/novabank/customer`
- [KYC approval](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java): `services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java`

### Banking operations

- [Account service](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-account-service/src/main/java/com/novabank/account): `services/novabank-account-service/src/main/java/com/novabank/account`
- [Open account](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java): `services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java`
- [Account lifecycle](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/domain/model/Account.java): `services/novabank-account-service/src/main/java/com/novabank/account/domain/model/Account.java`
- [Funds and holds](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java): `services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java`
- [Ledger service](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger): `services/novabank-ledger-service/src/main/java/com/novabank/ledger`
- [Post transactions](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java): `services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java`
- [Ledger queries](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/LedgerQueryService.java): `services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/LedgerQueryService.java`
- [Payment service](https://github.com/baldev-sinh/novabank-platform/tree/main/services/novabank-payment-service/src/main/java/com/novabank/payment): `services/novabank-payment-service/src/main/java/com/novabank/payment`
- [Initiate payment](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java): `services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java`
- [Payment saga](https://github.com/baldev-sinh/novabank-platform/blob/main/services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java): `services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java`

### Shared platform

- **Service databases**
- **Kafka messaging**
- [Platform starter](https://github.com/baldev-sinh/novabank-platform/tree/main/libs/novabank-platform-starter/src/main/java/com/novabank/platform): `libs/novabank-platform-starter/src/main/java/com/novabank/platform`
- **Email delivery**

### Other components

- **Bank customer**

## Connections

- Bank customer → Login screen: signs in (evidence: `README.md`)
- Login screen → Web auth state: submits credentials
- Web auth state → Auth service: REST + JWT (evidence: `README.md`)
- Angular app → Protected routing: routes through (evidence: `frontend/novabank-web/src/app/app.routes.ts`)
- Protected routing → Login screen: shows guest page (evidence: `frontend/novabank-web/src/app/app.routes.ts`)
- Protected routing → Banking dashboard: guards access (evidence: `frontend/novabank-web/src/app/app.routes.ts`)
- Web auth state → Token storage: stores tokens (evidence: `frontend/novabank-web/src/app/features/auth/services/authentication.service.ts`)
- Auth service → Session rotation: handles sessions (evidence: `services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java`)
- Session rotation → JWT issuance: issues access token (evidence: `services/novabank-auth-service/src/main/java/com/novabank/auth/application/service/SessionService.java`)
- Auth service → Email delivery: sends verification (evidence: `README.md`)
- Bank customer → Customer profiles: manages profile (evidence: `README.md`)
- Customer profiles → KYC approval: reviews KYC (evidence: `services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java`)
- KYC approval → Kafka messaging: publishes verification (evidence: `services/novabank-customer-service/src/main/java/com/novabank/customer/application/service/ApproveKycService.java`)
- Bank customer → Account service: opens account (evidence: `README.md`)
- Account service → Open account: handles opening (evidence: `services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java`)
- Open account → Account lifecycle: creates account (evidence: `services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java`)
- Open account → Customer profiles: checks eligibility (evidence: `services/novabank-account-service/src/main/java/com/novabank/account/application/service/OpenAccountService.java`)
- Bank customer → Payment service: transfers or deposits (evidence: `README.md`)
- Payment service → Initiate payment: starts payment (evidence: `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 (evidence: `services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/InitiatePaymentService.java`)
- Payment saga → Kafka messaging: dispatches saga steps (evidence: `services/novabank-payment-service/src/main/java/com/novabank/payment/application/service/PaymentSagaService.java`)
- Kafka messaging → Funds and holds: delivers commands (evidence: `README.md`)
- Funds and holds → Kafka messaging: emits hold outcomes (evidence: `services/novabank-account-service/src/main/java/com/novabank/account/application/service/FundsService.java`)
- Kafka messaging → Post transactions: delivers postings (evidence: `README.md`)
- Post transactions → Kafka messaging: publishes posting result (evidence: `services/novabank-ledger-service/src/main/java/com/novabank/ledger/application/service/PostLedgerTransactionService.java`)
- Bank customer → Ledger service: queries ledger (evidence: `README.md`)
- Ledger service → Ledger queries: serves queries (evidence: `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 (evidence: `README.md`)
- Platform starter → Service databases: supports persistence
