# tamizh591-here/minibank architecture

> Architecture diagram of the GitHub repository tamizh591-here/minibank, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tamizh591-here/minibank
- Repository: https://github.com/tamizh591-here/minibank

## Overview

MiniBank is a web-facing banking application split into customer, account, transaction, and notification services. The main workflow is customer registration/login, account access, then deposit, withdrawal, or transfer; transactions update account balances, are recorded, and emit notification events. The frontend and unsampled service wiring are represented cautiously: the README is empty, so some cross-service and messaging links cannot be verified from the shown excerpts.

Main entry points: [`transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java) (Transaction workflow), [`notification-service/src/main/java/com/minibank/notification/service/NotificationService.java`](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/service/NotificationService.java) (Notification handling), [`frontend/app.js`](https://github.com/tamizh591-here/minibank/blob/main/frontend/app.js) (Banking UI), [`customer-service/src/main/java/com/minibank/customer/service/CustomerService.java`](https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/service/CustomerService.java) (Registration and login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_web["Banking UI<br/>[app.js]"]
end

subgraph group_customers["Customer Service"]
  node_customer_api["Customer API"]
  node_customer_ops["Registration and login"]
  node_customer_dto["Auth requests"]
  node_customer_store[("Customer records")]
  node_customer_model["Customer entity<br/>[Customer.java]"]
end

subgraph group_accounts["Account Service"]
  node_account_api["Account API"]
  node_account_ops["Account operations"]
  node_account_store[("Account records")]
  node_account_model["Account entity<br/>[Account.java]"]
end

subgraph group_transactions["Transaction Service"]
  node_transaction_api["Transaction API"]
  node_transaction_ops["Transaction workflow"]
  node_account_client["Account client<br/>[AccountClient.java]"]
  node_transaction_store[("Transaction records")]
  node_transaction_model["Transaction entity"]
  node_notification_producer["Event producer"]
  node_event_contract["Notification event"]
end

subgraph group_notifications["Notification Service"]
  node_notification_consumer["Event consumer"]
  node_notification_ops["Notification handling"]
  node_notification_api["Notification API"]
  node_notification_store[("Notification records")]
  node_notification_model["Notification entity<br/>[Notification.java]"]
end

node_customer(("Bank customer"))
node_broker["ActiveMQ broker"]

node_customer -.->|"uses"| node_web
node_web -.->|"submits auth"| node_customer_api
node_customer_api -->|"calls"| node_customer_ops
node_customer_ops -->|"reads and writes"| node_customer_store
node_customer_api -->|"accepts"| node_customer_dto
node_customer_ops -->|"uses"| node_customer_dto
node_customer_ops -->|"creates and checks"| node_customer_model
node_customer_store -->|"stores"| node_customer_model
node_web -.->|"requests account"| node_account_api
node_account_api -->|"calls"| node_account_ops
node_account_ops -->|"reads and writes"| node_account_store
node_account_store -->|"stores"| node_account_model
node_web -.->|"submits transactions"| node_transaction_api
node_transaction_api -->|"calls"| node_transaction_ops
node_transaction_ops -->|"calls account service"| node_account_client
node_account_client -.->|"requests balance changes"| node_account_api
node_transaction_ops -->|"saves and queries"| node_transaction_store
node_transaction_store -->|"stores"| node_transaction_model
node_transaction_ops -->|"publishes via"| node_notification_producer
node_transaction_ops -->|"creates"| node_event_contract
node_notification_producer -.->|"sends event"| node_broker
node_broker -.->|"delivers event"| node_notification_consumer
node_notification_consumer -->|"calls"| node_notification_ops
node_notification_ops -->|"saves and queries"| node_notification_store
node_notification_store -->|"stores"| node_notification_model
node_notification_ops -->|"builds"| node_notification_model
node_notification_api -->|"calls"| node_notification_ops
node_notification_ops -->|"maps event fields"| node_event_contract

click node_web "https://github.com/tamizh591-here/minibank/blob/main/frontend/app.js"
click node_customer_api "https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/controller/CustomerController.java"
click node_customer_ops "https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/service/CustomerService.java"
click node_customer_dto "https://github.com/tamizh591-here/minibank/tree/main/customer-service/src/main/java/com/minibank/customer/dto"
click node_customer_store "https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/repository/CustomerRepository.java"
click node_customer_model "https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/model/Customer.java"
click node_account_api "https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/controller/AccountController.java"
click node_account_ops "https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/service/AccountService.java"
click node_account_store "https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/repository/AccountRepository.java"
click node_account_model "https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/model/Account.java"
click node_transaction_api "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/controller/TransactionController.java"
click node_transaction_ops "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java"
click node_account_client "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/client/AccountClient.java"
click node_transaction_store "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/repository/TransactionRepository.java"
click node_transaction_model "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/model/BankTransaction.java"
click node_notification_producer "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationProducer.java"
click node_event_contract "https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationEvent.java"
click node_notification_consumer "https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/messaging/NotificationConsumer.java"
click node_notification_ops "https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/service/NotificationService.java"
click node_notification_api "https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/controller/NotificationController.java"
click node_notification_store "https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/repository/NotificationRepository.java"
click node_notification_model "https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/model/Notification.java"

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_web toneBlue
class node_customer_api,node_customer_ops,node_customer_dto,node_customer_store,node_customer_model toneAmber
class node_account_api,node_account_ops,node_account_store,node_account_model toneMint
class node_transaction_api,node_transaction_ops,node_account_client,node_transaction_store,node_transaction_model,node_notification_producer,node_event_contract toneRose
class node_notification_consumer,node_notification_ops,node_notification_api,node_notification_store,node_notification_model,node_customer,node_broker toneIndigo
```

## Components

### Client

- [Banking UI](https://github.com/tamizh591-here/minibank/blob/main/frontend/app.js): `frontend/app.js`

### Customer Service

- [Customer API](https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/controller/CustomerController.java): `customer-service/src/main/java/com/minibank/customer/controller/CustomerController.java`
- [Registration and login](https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/service/CustomerService.java): `customer-service/src/main/java/com/minibank/customer/service/CustomerService.java`
- [Auth requests](https://github.com/tamizh591-here/minibank/tree/main/customer-service/src/main/java/com/minibank/customer/dto): `customer-service/src/main/java/com/minibank/customer/dto`
- [Customer records](https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/repository/CustomerRepository.java): `customer-service/src/main/java/com/minibank/customer/repository/CustomerRepository.java`
- [Customer entity](https://github.com/tamizh591-here/minibank/blob/main/customer-service/src/main/java/com/minibank/customer/model/Customer.java): `customer-service/src/main/java/com/minibank/customer/model/Customer.java`

### Account Service

- [Account API](https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/controller/AccountController.java): `account-service/src/main/java/com/minibank/account/controller/AccountController.java`
- [Account operations](https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/service/AccountService.java): `account-service/src/main/java/com/minibank/account/service/AccountService.java`
- [Account records](https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/repository/AccountRepository.java): `account-service/src/main/java/com/minibank/account/repository/AccountRepository.java`
- [Account entity](https://github.com/tamizh591-here/minibank/blob/main/account-service/src/main/java/com/minibank/account/model/Account.java): `account-service/src/main/java/com/minibank/account/model/Account.java`

### Transaction Service

- [Transaction API](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/controller/TransactionController.java): `transaction-service/src/main/java/com/minibank/transaction/controller/TransactionController.java`
- [Transaction workflow](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java): `transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`
- [Account client](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/client/AccountClient.java): `transaction-service/src/main/java/com/minibank/transaction/client/AccountClient.java`
- [Transaction records](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/repository/TransactionRepository.java): `transaction-service/src/main/java/com/minibank/transaction/repository/TransactionRepository.java`
- [Transaction entity](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/model/BankTransaction.java): `transaction-service/src/main/java/com/minibank/transaction/model/BankTransaction.java`
- [Event producer](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationProducer.java): `transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationProducer.java`
- [Notification event](https://github.com/tamizh591-here/minibank/blob/main/transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationEvent.java): `transaction-service/src/main/java/com/minibank/transaction/messaging/NotificationEvent.java`

### Notification Service

- [Event consumer](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/messaging/NotificationConsumer.java): `notification-service/src/main/java/com/minibank/notification/messaging/NotificationConsumer.java`
- [Notification handling](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/service/NotificationService.java): `notification-service/src/main/java/com/minibank/notification/service/NotificationService.java`
- [Notification API](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/controller/NotificationController.java): `notification-service/src/main/java/com/minibank/notification/controller/NotificationController.java`
- [Notification records](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/repository/NotificationRepository.java): `notification-service/src/main/java/com/minibank/notification/repository/NotificationRepository.java`
- [Notification entity](https://github.com/tamizh591-here/minibank/blob/main/notification-service/src/main/java/com/minibank/notification/model/Notification.java): `notification-service/src/main/java/com/minibank/notification/model/Notification.java`

### Other components

- **Bank customer**
- **ActiveMQ broker**

## Connections

- Bank customer → Banking UI: uses
- Banking UI → Customer API: submits auth
- Customer API → Registration and login: calls (evidence: `customer-service/src/main/java/com/minibank/customer/controller/CustomerController.java`)
- Registration and login → Customer records: reads and writes (evidence: `customer-service/src/main/java/com/minibank/customer/service/CustomerService.java`)
- Customer API → Auth requests: accepts (evidence: `customer-service/src/main/java/com/minibank/customer/controller/CustomerController.java`)
- Registration and login → Auth requests: uses (evidence: `customer-service/src/main/java/com/minibank/customer/service/CustomerService.java`)
- Registration and login → Customer entity: creates and checks (evidence: `customer-service/src/main/java/com/minibank/customer/service/CustomerService.java`)
- Customer records → Customer entity: stores (evidence: `customer-service/src/main/java/com/minibank/customer/repository/CustomerRepository.java`)
- Banking UI → Account API: requests account
- Account API → Account operations: calls (evidence: `account-service/src/main/java/com/minibank/account/controller/AccountController.java`)
- Account operations → Account records: reads and writes (evidence: `account-service/src/main/java/com/minibank/account/service/AccountService.java`)
- Account records → Account entity: stores (evidence: `account-service/src/main/java/com/minibank/account/repository/AccountRepository.java`)
- Banking UI → Transaction API: submits transactions
- Transaction API → Transaction workflow: calls (evidence: `transaction-service/src/main/java/com/minibank/transaction/controller/TransactionController.java`)
- Transaction workflow → Account client: calls account service (evidence: `transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`)
- Account client → Account API: requests balance changes
- Transaction workflow → Transaction records: saves and queries (evidence: `transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`)
- Transaction records → Transaction entity: stores (evidence: `transaction-service/src/main/java/com/minibank/transaction/repository/TransactionRepository.java`)
- Transaction workflow → Event producer: publishes via (evidence: `transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`)
- Transaction workflow → Notification event: creates (evidence: `transaction-service/src/main/java/com/minibank/transaction/service/TransactionService.java`)
- Event producer → ActiveMQ broker: sends event
- ActiveMQ broker → Event consumer: delivers event
- Event consumer → Notification handling: calls (evidence: `notification-service/src/main/java/com/minibank/notification/messaging/NotificationConsumer.java`)
- Notification handling → Notification records: saves and queries (evidence: `notification-service/src/main/java/com/minibank/notification/service/NotificationService.java`)
- Notification records → Notification entity: stores (evidence: `notification-service/src/main/java/com/minibank/notification/repository/NotificationRepository.java`)
- Notification handling → Notification entity: builds (evidence: `notification-service/src/main/java/com/minibank/notification/service/NotificationService.java`)
- Notification API → Notification handling: calls (evidence: `notification-service/src/main/java/com/minibank/notification/controller/NotificationController.java`)
- Notification handling → Notification event: maps event fields (evidence: `notification-service/src/main/java/com/minibank/notification/service/NotificationService.java`)
