# jonathanvj/secure-bank-transactions architecture

> Architecture diagram of the GitHub repository jonathanvj/secure-bank-transactions, 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/jonathanvj/secure-bank-transactions
- Repository: https://github.com/jonathanvj/secure-bank-transactions

## Overview

Secure-Bank-Transactions is a Tkinter banking simulation that uses facial recognition as a second factor. A user registers card details, captures face samples, and trains a recognizer; at the ATM, card/PIN/name checks precede face authentication, which enables balance, deposit, and withdrawal actions. The implementation is concentrated in main.py, with image samples and the trained model represented as file-backed resources. The supplied excerpts show the main calls and transaction logic; some tracking internals are omitted, so their links rely on the README’s workflow description.

Main entry points: [`main.py`](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py) (Face verification), [`TrainingImage`](https://github.com/jonathanvj/secure-bank-transactions/tree/main/TrainingImage) (Training samples), [`Trainer.yml`](https://github.com/jonathanvj/secure-bank-transactions/blob/main/Trainer.yml) (Trained model), [`ImagesUnknown`](https://github.com/jonathanvj/secure-bank-transactions/tree/main/ImagesUnknown) (Unknown face images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Enrollment and training"]
  node_registration["Registration UI<br/>[main.py]"]
  node_sample_capture["Face capture<br/>[main.py]"]
  node_training_images[("Training samples")]
  node_trainer["Model training<br/>[main.py]"]
  node_model_file["Trained model<br/>[Trainer.yml]"]
end

subgraph group_auth["ATM authentication"]
  node_atm["ATM UI<br/>[main.py]"]
  node_card_check["Card details check<br/>[main.py]"]
  node_face_check["Face verification<br/>[main.py]"]
  node_unknown_images[("Unknown face images")]
end

subgraph group_banking["Banking actions"]
  node_transaction_ui["Transaction options<br/>[main.py]"]
  node_balance["Balance lookup<br/>[main.py]"]
  node_deposit["Deposit<br/>[main.py]"]
  node_withdraw["Withdrawal<br/>[main.py]"]
  node_account_state[("Account balances<br/>[main.py]")]
end

node_user(("Bank user"))
node_camera["Webcam"]

node_user -->|"enters details"| node_registration
node_registration -->|"starts capture"| node_sample_capture
node_camera -->|"provides frames"| node_sample_capture
node_sample_capture -->|"saves samples"| node_training_images
node_registration -->|"starts training"| node_trainer
node_trainer -->|"loads samples"| node_training_images
node_trainer -->|"saves model"| node_model_file
node_user -->|"enters card details"| node_atm
node_atm -->|"submits details"| node_card_check
node_card_check -->|"starts face check"| node_face_check
node_camera -->|"provides frames"| node_face_check
node_face_check -->|"uses recognizer"| node_model_file
node_face_check -->|"stores unknowns"| node_unknown_images
node_face_check -->|"enables on success"| node_transaction_ui
node_transaction_ui -->|"invokes"| node_balance
node_transaction_ui -->|"invokes"| node_deposit
node_transaction_ui -->|"invokes"| node_withdraw
node_balance -->|"reads balance"| node_account_state
node_deposit -->|"updates balance"| node_account_state
node_withdraw -->|"updates balance"| node_account_state

click node_registration "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_sample_capture "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_training_images "https://github.com/jonathanvj/secure-bank-transactions/tree/main/TrainingImage"
click node_trainer "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_model_file "https://github.com/jonathanvj/secure-bank-transactions/blob/main/Trainer.yml"
click node_atm "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_card_check "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_face_check "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_unknown_images "https://github.com/jonathanvj/secure-bank-transactions/tree/main/ImagesUnknown"
click node_transaction_ui "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_balance "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_deposit "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_withdraw "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py"
click node_account_state "https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.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_registration,node_sample_capture,node_training_images,node_trainer,node_model_file,node_user toneBlue
class node_atm,node_card_check,node_face_check,node_unknown_images toneAmber
class node_transaction_ui,node_balance,node_deposit,node_withdraw,node_account_state toneMint
class node_camera toneIndigo
```

## Components

### Enrollment and training

- [Registration UI](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Face capture](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Training samples](https://github.com/jonathanvj/secure-bank-transactions/tree/main/TrainingImage): `TrainingImage`
- [Model training](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Trained model](https://github.com/jonathanvj/secure-bank-transactions/blob/main/Trainer.yml): `Trainer.yml`

### ATM authentication

- [ATM UI](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Card details check](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Face verification](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Unknown face images](https://github.com/jonathanvj/secure-bank-transactions/tree/main/ImagesUnknown): `ImagesUnknown`

### Banking actions

- [Transaction options](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Balance lookup](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Deposit](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Withdrawal](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`
- [Account balances](https://github.com/jonathanvj/secure-bank-transactions/blob/main/main.py): `main.py`

### Other components

- **Bank user**
- **Webcam**

## Connections

- Bank user → Registration UI: enters details (evidence: `README.md`)
- Registration UI → Face capture: starts capture (evidence: `main.py`)
- Webcam → Face capture: provides frames (evidence: `main.py`)
- Face capture → Training samples: saves samples (evidence: `README.md`)
- Registration UI → Model training: starts training (evidence: `main.py`)
- Model training → Training samples: loads samples (evidence: `main.py`)
- Model training → Trained model: saves model (evidence: `main.py`)
- Bank user → ATM UI: enters card details (evidence: `README.md`)
- ATM UI → Card details check: submits details (evidence: `main.py`)
- Card details check → Face verification: starts face check (evidence: `main.py`)
- Webcam → Face verification: provides frames (evidence: `main.py`)
- Face verification → Trained model: uses recognizer (evidence: `README.md`)
- Face verification → Unknown face images: stores unknowns (evidence: `main.py`)
- Face verification → Transaction options: enables on success (evidence: `main.py`)
- Transaction options → Balance lookup: invokes (evidence: `main.py`)
- Transaction options → Deposit: invokes (evidence: `main.py`)
- Transaction options → Withdrawal: invokes (evidence: `main.py`)
- Balance lookup → Account balances: reads balance (evidence: `main.py`)
- Deposit → Account balances: updates balance (evidence: `main.py`)
- Withdrawal → Account balances: updates balance (evidence: `main.py`)
