# starom00n/onlinebanking architecture

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

- Interactive diagram: https://gitdiagram.com/starom00n/onlinebanking
- Repository: https://github.com/starom00n/onlinebanking

## Overview

This is a Spring Boot banking web application for account registration and login, balance dashboards, deposits, withdrawals, transfers, and transaction history. Authenticated users enter through MVC controllers; transaction operations are handled by a service that updates users and records transaction entries through repositories. Registration and login use a separate user service and Spring Security configuration. The source excerpts show controller, service, repository, and model relationships; template wiring is visible in controller return values. Other template behavior and runtime database configuration were not inspected.

Main entry points: [`src/main/java/com/bankapp/services/TransactionService.java`](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/services/TransactionService.java) (Transaction service), [`src/main/java/com/bankapp/repositories/UserRepository.java`](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/repositories/UserRepository.java) (User repository), [`src/main/java/com/bankapp/controllers/DashboardController.java`](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/DashboardController.java) (Dashboard handler), [`src/main/java/com/bankapp/controllers/TransactionController.java`](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/TransactionController.java) (Transaction handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_application["Spring Boot app"]
  node_dashboard["Dashboard handler"]
  node_dashboard_view["Dashboard view<br/>[dashboard.html]"]
  node_transactions["Transaction handler"]
  node_transaction_views["Transaction views"]
end

subgraph group_identity["Identity and access"]
  node_user_handler["User handler"]
  node_identity_views["Login and register views"]
  node_security["Security configuration"]
  node_user_service["User service<br/>[UserService.java]"]
end

subgraph group_banking["Banking domain"]
  node_transaction_service["Transaction service"]
end

subgraph group_persistence["Domain persistence"]
  node_user_entity[("User account<br/>[User.java]")]
  node_transaction_entity[("Transaction record<br/>[Transaction.java]")]
  node_user_repository["User repository"]
  node_transaction_repository["Transaction repository"]
end

node_customer(("Customer"))

node_customer -->|"registers or logs in"| node_user_handler
node_customer -->|"opens dashboard"| node_dashboard
node_customer -->|"manages transactions"| node_transactions
node_user_handler -->|"registers user"| node_user_service
node_user_handler -->|"returns login or register"| node_identity_views
node_security -->|"routes login"| node_user_handler
node_user_service -->|"looks up and saves"| node_user_repository
node_user_service -->|"registers account"| node_user_entity
node_dashboard -->|"looks up account"| node_user_repository
node_dashboard -->|"gets balance and totals"| node_transaction_service
node_dashboard -->|"renders dashboard"| node_dashboard_view
node_transactions -->|"resolves account"| node_user_repository
node_transactions -->|"executes operations"| node_transaction_service
node_transactions -->|"returns transaction pages"| node_transaction_views
node_transaction_service -->|"reads and updates accounts"| node_user_repository
node_transaction_service -->|"records and queries entries"| node_transaction_repository
node_transaction_service -->|"changes balances"| node_user_entity
node_transaction_service -->|"creates entries"| node_transaction_entity
node_user_repository -->|"persists accounts"| node_user_entity
node_transaction_repository -->|"persists entries"| node_transaction_entity

click node_application "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/BankAppApplication.java"
click node_dashboard "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/DashboardController.java"
click node_dashboard_view "https://github.com/starom00n/onlinebanking/blob/main/src/main/resources/templates/dashboard.html"
click node_transactions "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/TransactionController.java"
click node_transaction_views "https://github.com/starom00n/onlinebanking/tree/main/src/main/resources/templates"
click node_user_handler "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/UserController.java"
click node_identity_views "https://github.com/starom00n/onlinebanking/tree/main/src/main/resources/templates"
click node_security "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/SecurityConfig.java"
click node_user_service "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/services/UserService.java"
click node_transaction_service "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/services/TransactionService.java"
click node_user_entity "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/models/User.java"
click node_transaction_entity "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/models/Transaction.java"
click node_user_repository "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/repositories/UserRepository.java"
click node_transaction_repository "https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/repositories/TransactionRepository.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_application,node_dashboard,node_dashboard_view,node_transactions,node_transaction_views toneBlue
class node_user_handler,node_identity_views,node_security,node_user_service toneAmber
class node_transaction_service toneMint
class node_user_entity,node_transaction_entity,node_user_repository,node_transaction_repository toneRose
class node_customer toneIndigo
```

## Components

### Web workflows

- [Spring Boot app](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/BankAppApplication.java): `src/main/java/com/bankapp/BankAppApplication.java`
- [Dashboard handler](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/DashboardController.java): `src/main/java/com/bankapp/controllers/DashboardController.java`
- [Dashboard view](https://github.com/starom00n/onlinebanking/blob/main/src/main/resources/templates/dashboard.html): `src/main/resources/templates/dashboard.html`
- [Transaction handler](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/TransactionController.java): `src/main/java/com/bankapp/controllers/TransactionController.java`
- [Transaction views](https://github.com/starom00n/onlinebanking/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Identity and access

- [User handler](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/controllers/UserController.java): `src/main/java/com/bankapp/controllers/UserController.java`
- [Login and register views](https://github.com/starom00n/onlinebanking/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Security configuration](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/SecurityConfig.java): `src/main/java/com/bankapp/SecurityConfig.java`
- [User service](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/services/UserService.java): `src/main/java/com/bankapp/services/UserService.java`

### Banking domain

- [Transaction service](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/services/TransactionService.java): `src/main/java/com/bankapp/services/TransactionService.java`

### Domain persistence

- [User account](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/models/User.java): `src/main/java/com/bankapp/models/User.java`
- [Transaction record](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/models/Transaction.java): `src/main/java/com/bankapp/models/Transaction.java`
- [User repository](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/repositories/UserRepository.java): `src/main/java/com/bankapp/repositories/UserRepository.java`
- [Transaction repository](https://github.com/starom00n/onlinebanking/blob/main/src/main/java/com/bankapp/repositories/TransactionRepository.java): `src/main/java/com/bankapp/repositories/TransactionRepository.java`

### Other components

- **Customer**

## Connections

- Customer → User handler: registers or logs in (evidence: `src/main/java/com/bankapp/controllers/UserController.java`)
- Customer → Dashboard handler: opens dashboard (evidence: `src/main/java/com/bankapp/controllers/DashboardController.java`)
- Customer → Transaction handler: manages transactions (evidence: `src/main/java/com/bankapp/controllers/TransactionController.java`)
- User handler → User service: registers user (evidence: `src/main/java/com/bankapp/controllers/UserController.java`)
- User handler → Login and register views: returns login or register (evidence: `src/main/java/com/bankapp/controllers/UserController.java`)
- Security configuration → User handler: routes login (evidence: `src/main/java/com/bankapp/SecurityConfig.java`)
- User service → User repository: looks up and saves (evidence: `src/main/java/com/bankapp/services/UserService.java`)
- User service → User account: registers account (evidence: `src/main/java/com/bankapp/services/UserService.java`)
- Dashboard handler → User repository: looks up account (evidence: `src/main/java/com/bankapp/controllers/DashboardController.java`)
- Dashboard handler → Transaction service: gets balance and totals (evidence: `src/main/java/com/bankapp/controllers/DashboardController.java`)
- Dashboard handler → Dashboard view: renders dashboard (evidence: `src/main/java/com/bankapp/controllers/DashboardController.java`)
- Transaction handler → User repository: resolves account (evidence: `src/main/java/com/bankapp/controllers/TransactionController.java`)
- Transaction handler → Transaction service: executes operations (evidence: `src/main/java/com/bankapp/controllers/TransactionController.java`)
- Transaction handler → Transaction views: returns transaction pages (evidence: `src/main/java/com/bankapp/controllers/TransactionController.java`)
- Transaction service → User repository: reads and updates accounts (evidence: `src/main/java/com/bankapp/services/TransactionService.java`)
- Transaction service → Transaction repository: records and queries entries (evidence: `src/main/java/com/bankapp/services/TransactionService.java`)
- Transaction service → User account: changes balances (evidence: `src/main/java/com/bankapp/services/TransactionService.java`)
- Transaction service → Transaction record: creates entries (evidence: `src/main/java/com/bankapp/services/TransactionService.java`)
- User repository → User account: persists accounts (evidence: `src/main/java/com/bankapp/repositories/UserRepository.java`)
- Transaction repository → Transaction record: persists entries (evidence: `src/main/java/com/bankapp/repositories/TransactionRepository.java`)
