# parasdahia/banking-webapp architecture

> Architecture diagram of the GitHub repository parasdahia/banking-webapp, 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/parasdahia/banking-webapp
- Repository: https://github.com/parasdahia/banking-webapp

## Overview

This Flask banking portal serves login and dashboard pages, then handles authenticated account, beneficiary, transfer, password-reset, and transaction-history requests. The main workflow is: a customer logs in, views account details, resolves an IMPS or UPI beneficiary, submits a transfer, and checks the resulting history. Flask routes coordinate these stages; DatabaseManager validates credentials and performs database reads and updates, including an atomic balance transfer with transaction logging. The HTML files are present but unsampled, so their specific browser-side interactions are not mapped.

Main entry points: [`main.py`](https://github.com/parasdahia/banking-webapp/blob/main/main.py) (Flask routes), [`packages/database_manager.py`](https://github.com/parasdahia/banking-webapp/blob/main/packages/database_manager.py) (Database manager), [`templates/login.html`](https://github.com/parasdahia/banking-webapp/blob/main/templates/login.html) (Login page), [`templates/dashboard.html`](https://github.com/parasdahia/banking-webapp/blob/main/templates/dashboard.html) (Dashboard page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_login_page["Login page<br/>[login.html]"]
  node_dashboard_page["Dashboard page<br/>[dashboard.html]"]
  node_flask_app["Flask routes<br/>[main.py]"]
end

subgraph group_services["Banking workflows"]
  node_authentication["Authentication<br/>[main.py]"]
  node_account_details["Account details<br/>[main.py]"]
  node_beneficiary["Beneficiary lookup<br/>[main.py]"]
  node_transfer["Fund transfer<br/>[main.py]"]
  node_password_reset["Password reset<br/>[main.py]"]
  node_history["Transaction history<br/>[main.py]"]
end

subgraph group_data["Persistence"]
  node_database_manager["Database manager"]
  node_mysql[("MySQL database")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_flask_app
node_flask_app -->|"renders"| node_login_page
node_flask_app -->|"renders"| node_dashboard_page
node_flask_app -->|"routes login"| node_authentication
node_authentication -->|"validates credentials"| node_database_manager
node_flask_app -->|"routes request"| node_account_details
node_account_details -->|"fetches account"| node_database_manager
node_flask_app -->|"routes request"| node_beneficiary
node_beneficiary -->|"looks up beneficiary"| node_database_manager
node_flask_app -->|"routes request"| node_transfer
node_transfer -->|"performs transfer"| node_database_manager
node_flask_app -->|"routes request"| node_password_reset
node_password_reset -->|"updates password"| node_database_manager
node_flask_app -->|"routes request"| node_history
node_history -->|"fetches history"| node_database_manager
node_database_manager -->|"queries and updates"| node_mysql

click node_login_page "https://github.com/parasdahia/banking-webapp/blob/main/templates/login.html"
click node_dashboard_page "https://github.com/parasdahia/banking-webapp/blob/main/templates/dashboard.html"
click node_flask_app "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_authentication "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_account_details "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_beneficiary "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_transfer "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_password_reset "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_history "https://github.com/parasdahia/banking-webapp/blob/main/main.py"
click node_database_manager "https://github.com/parasdahia/banking-webapp/blob/main/packages/database_manager.py"

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_login_page,node_dashboard_page,node_flask_app toneBlue
class node_authentication,node_account_details,node_beneficiary,node_transfer,node_password_reset,node_history toneAmber
class node_database_manager,node_mysql toneMint
class node_customer toneIndigo
```

## Components

### Web interface

- [Login page](https://github.com/parasdahia/banking-webapp/blob/main/templates/login.html): `templates/login.html`
- [Dashboard page](https://github.com/parasdahia/banking-webapp/blob/main/templates/dashboard.html): `templates/dashboard.html`
- [Flask routes](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`

### Banking workflows

- [Authentication](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`
- [Account details](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`
- [Beneficiary lookup](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`
- [Fund transfer](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`
- [Password reset](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`
- [Transaction history](https://github.com/parasdahia/banking-webapp/blob/main/main.py): `main.py`

### Persistence

- [Database manager](https://github.com/parasdahia/banking-webapp/blob/main/packages/database_manager.py): `packages/database_manager.py`
- **MySQL database**

### Other components

- **Customer**

## Connections

- Customer → Flask routes: uses (evidence: `main.py`)
- Flask routes → Login page: renders (evidence: `main.py`)
- Flask routes → Dashboard page: renders (evidence: `main.py`)
- Flask routes → Authentication: routes login (evidence: `main.py`)
- Authentication → Database manager: validates credentials (evidence: `main.py`)
- Flask routes → Account details: routes request (evidence: `main.py`)
- Account details → Database manager: fetches account (evidence: `main.py`)
- Flask routes → Beneficiary lookup: routes request (evidence: `main.py`)
- Beneficiary lookup → Database manager: looks up beneficiary (evidence: `main.py`)
- Flask routes → Fund transfer: routes request (evidence: `main.py`)
- Fund transfer → Database manager: performs transfer (evidence: `main.py`)
- Flask routes → Password reset: routes request (evidence: `main.py`)
- Password reset → Database manager: updates password (evidence: `main.py`)
- Flask routes → Transaction history: routes request (evidence: `main.py`)
- Transaction history → Database manager: fetches history (evidence: `main.py`)
- Database manager → MySQL database: queries and updates (evidence: `packages/database_manager.py`)
