# hienltt24810310243/bank_project architecture

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

- Interactive diagram: https://gitdiagram.com/hienltt24810310243/bank_project
- Repository: https://github.com/hienltt24810310243/bank_project

## Overview

EPU Bank is a distributed ATM and core-banking simulation. A customer selects an ATM terminal, authenticates a card and PIN, then uses the menu for cash withdrawal, transfer, transaction history, or PIN change; transfer includes recipient lookup, and successful activity can produce a receipt. The WinForms client sends TCP commands to a server that dispatches banking operations to shared SQL helpers; the server also tracks terminal registration, heartbeat, and maintenance for its dashboard. Core transaction handlers and several client screens are unsampled, so only documented or excerpt-supported links are shown.

Main entry points: [`Bank.Client/AtmClientSocket.cs`](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/AtmClientSocket.cs) (TCP Client), [`Bank.Client/Form1.cs`](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Form1.cs) (ATM Kiosk), [`Bank.Client/Screens/UcScreenMenu.cs`](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenMenu.cs) (Service Menu), [`Bank.Client/Screens/UcScreenLogin.cs`](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenLogin.cs) (Card Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["ATM Client"]
  node_atmframe["ATM Kiosk<br/>[Form1.cs]"]
  node_login["Card Login<br/>[UcScreenLogin.cs]"]
  node_session["ATM Session<br/>[AtmSession.cs]"]
  node_menu["Service Menu<br/>[UcScreenMenu.cs]"]
  node_withdraw["Cash Withdrawal"]
  node_transfer["Account Transfer"]
  node_history["Transaction History<br/>[UcScreenHistory.cs]"]
  node_pinchange["PIN Change"]
  node_receipt["Receipt Output<br/>[FormReceipt.cs]"]
  node_socketclient["TCP Client<br/>[AtmClientSocket.cs]"]
end

subgraph group_server["Core Server"]
  node_serverentry["TCP Command Server<br/>[Program.cs]"]
end

subgraph group_banking["Banking Data"]
  node_bankdbhelper["Bank Operations<br/>[DatabaseHelper.cs]"]
  node_accountdto["Account Data<br/>[AccountDTO.cs]"]
  node_sqlserver[("Central SQL Database<br/>[BankATM_DB.sql]")]
end

subgraph group_monitoring["ATM Monitoring"]
  node_atmmanager["Terminal Manager<br/>[AtmManager.cs]"]
  node_dashboard["Monitoring Dashboard"]
  node_terminaldto["Terminal Data<br/>[AtmTerminalDTO.cs]"]
end

node_customer(("ATM Customer"))

node_customer -->|"operates"| node_atmframe
node_atmframe -->|"starts at"| node_login
node_atmframe -->|"selects terminal"| node_session
node_atmframe -->|"registers and heartbeats"| node_socketclient
node_atmframe -->|"routes input"| node_login
node_login -->|"sends login"| node_socketclient
node_login -->|"stores account"| node_session
node_login -->|"opens on success"| node_menu
node_menu -->|"opens"| node_withdraw
node_menu -->|"opens"| node_transfer
node_menu -->|"opens"| node_history
node_menu -->|"opens"| node_pinchange
node_transfer -->|"sends lookup and transfer"| node_socketclient
node_pinchange -->|"sends PIN change"| node_socketclient
node_withdraw -->|"sends withdrawal"| node_socketclient
node_history -->|"requests history"| node_socketclient
node_history -->|"uses receipt"| node_receipt
node_receipt -->|"reads session"| node_session
node_socketclient -->|"exchanges TCP commands"| node_serverentry
node_serverentry -->|"registers terminals"| node_atmmanager
node_serverentry -->|"dispatches banking operations"| node_bankdbhelper
node_bankdbhelper -.->|"reads and updates"| node_sqlserver
node_bankdbhelper -->|"returns account data"| node_accountdto
node_atmmanager -->|"loads and updates terminal data"| node_bankdbhelper
node_atmmanager -->|"manages terminal records"| node_terminaldto
node_serverentry -->|"launches"| node_dashboard
node_dashboard -->|"monitors network"| node_atmmanager

click node_atmframe "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Form1.cs"
click node_login "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenLogin.cs"
click node_session "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/AtmSession.cs"
click node_menu "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenMenu.cs"
click node_withdraw "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenWithdraw.cs"
click node_transfer "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenTransfer.cs"
click node_history "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenHistory.cs"
click node_pinchange "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenChangePin.cs"
click node_receipt "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/FormReceipt.cs"
click node_socketclient "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/AtmClientSocket.cs"
click node_serverentry "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/Program.cs"
click node_bankdbhelper "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/DatabaseHelper.cs"
click node_accountdto "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/AccountDTO.cs"
click node_sqlserver "https://github.com/hienltt24810310243/bank_project/blob/master/Database/BankATM_DB.sql"
click node_atmmanager "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/AtmManager.cs"
click node_dashboard "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/FormServerDashboard.cs"
click node_terminaldto "https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/AtmTerminalDTO.cs"

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_atmframe,node_login,node_session,node_menu,node_withdraw,node_transfer,node_history,node_pinchange,node_receipt,node_socketclient toneBlue
class node_serverentry toneAmber
class node_bankdbhelper,node_accountdto,node_sqlserver toneMint
class node_atmmanager,node_dashboard,node_terminaldto toneRose
class node_customer toneIndigo
```

## Components

### ATM Client

- [ATM Kiosk](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Form1.cs): `Bank.Client/Form1.cs`
- [Card Login](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenLogin.cs): `Bank.Client/Screens/UcScreenLogin.cs`
- [ATM Session](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/AtmSession.cs): `Bank.Client/Screens/AtmSession.cs`
- [Service Menu](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenMenu.cs): `Bank.Client/Screens/UcScreenMenu.cs`
- [Cash Withdrawal](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenWithdraw.cs): `Bank.Client/Screens/UcScreenWithdraw.cs`
- [Account Transfer](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenTransfer.cs): `Bank.Client/Screens/UcScreenTransfer.cs`
- [Transaction History](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenHistory.cs): `Bank.Client/Screens/UcScreenHistory.cs`
- [PIN Change](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/Screens/UcScreenChangePin.cs): `Bank.Client/Screens/UcScreenChangePin.cs`
- [Receipt Output](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/FormReceipt.cs): `Bank.Client/FormReceipt.cs`
- [TCP Client](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Client/AtmClientSocket.cs): `Bank.Client/AtmClientSocket.cs`

### Core Server

- [TCP Command Server](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/Program.cs): `Bank.Server/Program.cs`

### Banking Data

- [Bank Operations](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/DatabaseHelper.cs): `Bank.Common/DatabaseHelper.cs`
- [Account Data](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/AccountDTO.cs): `Bank.Common/AccountDTO.cs`
- [Central SQL Database](https://github.com/hienltt24810310243/bank_project/blob/master/Database/BankATM_DB.sql): `Database/BankATM_DB.sql`

### ATM Monitoring

- [Terminal Manager](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/AtmManager.cs): `Bank.Server/AtmManager.cs`
- [Monitoring Dashboard](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Server/FormServerDashboard.cs): `Bank.Server/FormServerDashboard.cs`
- [Terminal Data](https://github.com/hienltt24810310243/bank_project/blob/master/Bank.Common/AtmTerminalDTO.cs): `Bank.Common/AtmTerminalDTO.cs`

### Other components

- **ATM Customer**

## Connections

- ATM Customer → ATM Kiosk: operates (evidence: `README.md`)
- ATM Kiosk → Card Login: starts at (evidence: `Bank.Client/Form1.cs`)
- ATM Kiosk → ATM Session: selects terminal (evidence: `Bank.Client/Form1.cs`)
- ATM Kiosk → TCP Client: registers and heartbeats (evidence: `Bank.Client/Form1.cs`)
- ATM Kiosk → Card Login: routes input (evidence: `Bank.Client/Form1.cs`)
- Card Login → TCP Client: sends login (evidence: `Bank.Client/Screens/UcScreenLogin.cs`)
- Card Login → ATM Session: stores account (evidence: `Bank.Client/Screens/UcScreenLogin.cs`)
- Card Login → Service Menu: opens on success (evidence: `Bank.Client/Screens/UcScreenLogin.cs`)
- Service Menu → Cash Withdrawal: opens (evidence: `Bank.Client/Screens/UcScreenMenu.cs`)
- Service Menu → Account Transfer: opens (evidence: `Bank.Client/Screens/UcScreenMenu.cs`)
- Service Menu → Transaction History: opens (evidence: `Bank.Client/Screens/UcScreenMenu.cs`)
- Service Menu → PIN Change: opens (evidence: `Bank.Client/Screens/UcScreenMenu.cs`)
- Account Transfer → TCP Client: sends lookup and transfer (evidence: `Bank.Client/Screens/UcScreenTransfer.cs`)
- PIN Change → TCP Client: sends PIN change (evidence: `Bank.Client/Screens/UcScreenChangePin.cs`)
- Cash Withdrawal → TCP Client: sends withdrawal (evidence: `Bank.Client/Screens/UcScreenWithdraw.cs`)
- Transaction History → TCP Client: requests history (evidence: `Bank.Client/Screens/UcScreenHistory.cs`)
- Transaction History → Receipt Output: uses receipt (evidence: `Bank.Client/Screens/UcScreenHistory.cs`)
- Receipt Output → ATM Session: reads session (evidence: `Bank.Client/FormReceipt.cs`)
- TCP Client → TCP Command Server: exchanges TCP commands (evidence: `README.md`)
- TCP Command Server → Terminal Manager: registers terminals (evidence: `Bank.Server/Program.cs`)
- TCP Command Server → Bank Operations: dispatches banking operations (evidence: `Bank.Server/Program.cs`)
- Bank Operations → Central SQL Database: reads and updates
- Bank Operations → Account Data: returns account data (evidence: `Bank.Common/DatabaseHelper.cs`)
- Terminal Manager → Bank Operations: loads and updates terminal data (evidence: `Bank.Server/AtmManager.cs`)
- Terminal Manager → Terminal Data: manages terminal records (evidence: `Bank.Server/AtmManager.cs`)
- TCP Command Server → Monitoring Dashboard: launches (evidence: `Bank.Server/Program.cs`)
- Monitoring Dashboard → Terminal Manager: monitors network (evidence: `Bank.Server/FormServerDashboard.cs`)
