# kozman-eg/projict_bank architecture

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

- Interactive diagram: https://gitdiagram.com/kozman-eg/projict_bank
- Repository: https://github.com/kozman-eg/projict_bank

## Overview

This is a C++ console banking application. Users enter through login, then navigate the main menu to client, transaction, user, or currency functions; those functions manage records and present results. The README documents text-file persistence, permissions, login records, transfers, balances, and currency conversion. The graph preserves these domain branches, but sampled implementation evidence is uneven: several edges are documented or indexed rather than verified in full source, so unverified runtime links are dashed and left uncited.

Main entry points: [`projict_Bank/src/Screen/clsMainScreen.cpp`](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsMainScreen.cpp) (Main menu), [`projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp) (Transaction menu), [`projict_Bank/src/Core/clsBankCLient.cpp`](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsBankCLient.cpp) (Client records), [`projict_Bank/src/Screen/clsLoginScreen.cpp`](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsLoginScreen.cpp) (Login screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Console entry"]
  node_app["Application entry<br/>[projict_Bank.cpp]"]
  node_login["Login screen<br/>[clsLoginScreen.cpp]"]
  node_menu["Main menu<br/>[clsMainScreen.cpp]"]
  node_screenbase["Screen access checks<br/>[clsScreen.cpp]"]
end

subgraph group_client["Client banking"]
  node_clientui["Client operations UI"]
  node_clientmodel["Client records<br/>[clsBankCLient.cpp]"]
  node_clientfiles[("Text-file records<br/>[data.h]")]
end

subgraph group_transactions["Transactions"]
  node_transactionui["Transaction menu"]
  node_deposit["Deposit and withdrawal"]
  node_transfer["Account transfers"]
  node_history["Transfer history"]
  node_balances["Total balances"]
  node_transferdata[("Transfer log file<br/>[data.h]")]
end

subgraph group_identity["Users and access"]
  node_userui["User administration"]
  node_usermodel["User records and permissions<br/>[clsUser.cpp]"]
  node_userfiles[("User and login files<br/>[data.h]")]
end

subgraph group_currency["Currency services"]
  node_currencyui["Currency operations"]
  node_currencymodel["Currency records and conversion<br/>[clsCurrency.cpp]"]
  node_currencyfile[("Currency text file<br/>[data.h]")]
end

node_operator(("Bank operator"))
node_utilities["Validation and date utilities"]

node_operator -.->|"starts"| node_app
node_app -->|"launches"| node_login
node_operator -.->|"provides credentials"| node_login
node_login -.->|"opens after login"| node_menu
node_menu -->|"dispatches"| node_clientui
node_menu -->|"dispatches"| node_transactionui
node_menu -->|"dispatches"| node_userui
node_menu -->|"dispatches"| node_currencyui
node_clientui -.->|"manages clients"| node_clientmodel
node_clientmodel -->|"reads and writes"| node_clientfiles
node_transactionui -->|"dispatches"| node_deposit
node_transactionui -->|"dispatches"| node_transfer
node_transactionui -->|"dispatches"| node_history
node_transactionui -->|"dispatches"| node_balances
node_deposit -.->|"updates balances"| node_clientmodel
node_transfer -.->|"transfers funds"| node_clientmodel
node_transfer -.->|"records transfer"| node_transferdata
node_history -.->|"reads history"| node_transferdata
node_balances -.->|"calculates total"| node_clientmodel
node_userui -.->|"manages users"| node_usermodel
node_login -.->|"authenticates"| node_usermodel
node_usermodel -.->|"reads and writes"| node_userfiles
node_usermodel -.->|"checks permissions"| node_screenbase
node_currencyui -.->|"uses currency records"| node_currencymodel
node_currencymodel -.->|"reads and writes"| node_currencyfile
node_utilities -.->|"validates input"| node_clientui

click node_app "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/projict_Bank.cpp"
click node_login "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsLoginScreen.cpp"
click node_menu "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsMainScreen.cpp"
click node_screenbase "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsScreen.cpp"
click node_clientui "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Client"
click node_clientmodel "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsBankCLient.cpp"
click node_clientfiles "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h"
click node_transactionui "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp"
click node_deposit "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions"
click node_transfer "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/Transactions/clsTransferScreen.cpp"
click node_history "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions"
click node_balances "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions"
click node_transferdata "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h"
click node_userui "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/User"
click node_usermodel "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsUser.cpp"
click node_userfiles "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h"
click node_currencyui "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Currencies"
click node_currencymodel "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsCurrency.cpp"
click node_currencyfile "https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h"
click node_utilities "https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/include/Lib"

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_app,node_login,node_menu,node_screenbase toneBlue
class node_clientui,node_clientmodel,node_clientfiles toneAmber
class node_transactionui,node_deposit,node_transfer,node_history,node_balances,node_transferdata toneMint
class node_userui,node_usermodel,node_userfiles toneRose
class node_currencyui,node_currencymodel,node_currencyfile,node_operator toneIndigo
class node_utilities toneTeal
```

## Components

### Console entry

- [Application entry](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/projict_Bank.cpp): `projict_Bank/projict_Bank.cpp`
- [Login screen](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsLoginScreen.cpp): `projict_Bank/src/Screen/clsLoginScreen.cpp`
- [Main menu](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsMainScreen.cpp): `projict_Bank/src/Screen/clsMainScreen.cpp`
- [Screen access checks](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/clsScreen.cpp): `projict_Bank/src/Screen/clsScreen.cpp`

### Client banking

- [Client operations UI](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Client): `projict_Bank/src/Screen/Client`
- [Client records](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsBankCLient.cpp): `projict_Bank/src/Core/clsBankCLient.cpp`
- [Text-file records](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h): `projict_Bank/data/data.h`

### Transactions

- [Transaction menu](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp): `projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`
- [Deposit and withdrawal](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions): `projict_Bank/src/Screen/Transactions`
- [Account transfers](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Screen/Transactions/clsTransferScreen.cpp): `projict_Bank/src/Screen/Transactions/clsTransferScreen.cpp`
- [Transfer history](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions): `projict_Bank/src/Screen/Transactions`
- [Total balances](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Transactions): `projict_Bank/src/Screen/Transactions`
- [Transfer log file](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h): `projict_Bank/data/data.h`

### Users and access

- [User administration](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/User): `projict_Bank/src/Screen/User`
- [User records and permissions](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsUser.cpp): `projict_Bank/src/Core/clsUser.cpp`
- [User and login files](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h): `projict_Bank/data/data.h`

### Currency services

- [Currency operations](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/src/Screen/Currencies): `projict_Bank/src/Screen/Currencies`
- [Currency records and conversion](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/src/Core/clsCurrency.cpp): `projict_Bank/src/Core/clsCurrency.cpp`
- [Currency text file](https://github.com/kozman-eg/projict_bank/blob/master/projict_Bank/data/data.h): `projict_Bank/data/data.h`

### Other components

- **Bank operator**
- [Validation and date utilities](https://github.com/kozman-eg/projict_bank/tree/master/projict_Bank/include/Lib): `projict_Bank/include/Lib`

## Connections

- Bank operator → Application entry: starts
- Application entry → Login screen: launches (evidence: `projict_Bank/projict_Bank.cpp`)
- Bank operator → Login screen: provides credentials
- Login screen → Main menu: opens after login
- Main menu → Client operations UI: dispatches (evidence: `projict_Bank/src/Screen/clsMainScreen.cpp`)
- Main menu → Transaction menu: dispatches (evidence: `projict_Bank/src/Screen/clsMainScreen.cpp`)
- Main menu → User administration: dispatches (evidence: `projict_Bank/src/Screen/clsMainScreen.cpp`)
- Main menu → Currency operations: dispatches (evidence: `projict_Bank/src/Screen/clsMainScreen.cpp`)
- Client operations UI → Client records: manages clients
- Client records → Text-file records: reads and writes (evidence: `projict_Bank/src/Core/clsBankCLient.cpp`)
- Transaction menu → Deposit and withdrawal: dispatches (evidence: `projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`)
- Transaction menu → Account transfers: dispatches (evidence: `projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`)
- Transaction menu → Transfer history: dispatches (evidence: `projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`)
- Transaction menu → Total balances: dispatches (evidence: `projict_Bank/src/Screen/Transactions/clsTransactionsScreen.cpp`)
- Deposit and withdrawal → Client records: updates balances
- Account transfers → Client records: transfers funds
- Account transfers → Transfer log file: records transfer
- Transfer history → Transfer log file: reads history
- Total balances → Client records: calculates total
- User administration → User records and permissions: manages users
- Login screen → User records and permissions: authenticates
- User records and permissions → User and login files: reads and writes
- User records and permissions → Screen access checks: checks permissions
- Currency operations → Currency records and conversion: uses currency records
- Currency records and conversion → Currency text file: reads and writes
- Validation and date utilities → Client operations UI: validates input (evidence: `projict_Bank/src/Screen/Client/clsUpdateClientScreen.cpp`)
