# chetanpaliwal22/bank-customer-multithreading-project architecture

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

- Interactive diagram: https://gitdiagram.com/chetanpaliwal22/bank-customer-multithreading-project
- Repository: https://github.com/chetanpaliwal22/bank-customer-multithreading-project

## Overview

This repository implements a concurrent loan simulation in Java and Erlang. In the Java workflow, Money loads bank and customer data, starts their threads, and shares a request queue; customers request loans, banks approve or deny them, and customers report whether they met their objectives. The README also documents an Erlang version, but its source was not sampled, so its internal relationships are left unverified. The sampled Java sources show the queue protocol and reporting; they do not establish a global completion coordinator.

Main entry points: [`src/com/concordia/multithreading/Money.java`](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Money.java) (Java launcher), [`src/com/concordia/multithreading/Customer.java`](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Customer.java) (Customer thread), [`src/com/concordia/multithreading/Bank.java`](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Bank.java) (Bank thread), [`erlangsrc/money.erl`](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/money.erl) (Erlang entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_java["Java simulation"]
  node_money["Java launcher<br/>[Money.java]"]
  node_customer["Customer thread<br/>[Customer.java]"]
  node_bank["Bank thread<br/>[Bank.java]"]
  node_request["Request protocol<br/>[Request.java]"]
end

subgraph group_erl["Erlang simulation"]
  node_erlmoney["Erlang entry point<br/>[money.erl]"]
  node_erlbank["Erlang bank<br/>[bank.erl]"]
  node_erlcustomer["Erlang customer<br/>[customer.erl]"]
end

subgraph group_data["Inputs and exchange"]
  node_queue["Shared request queue<br/>[Money.java]"]
  node_banksfile["Bank data<br/>[banks.txt]"]
  node_customersfile["Customer data<br/>[customers.txt]"]
end

node_operator(("Operator"))
node_console(("Console output"))

node_operator -->|"runs"| node_money
node_money -->|"reads"| node_banksfile
node_money -->|"reads"| node_customersfile
node_money -->|"starts threads"| node_customer
node_money -->|"starts threads"| node_bank
node_money -->|"shares"| node_queue
node_customer -->|"posts requests"| node_queue
node_customer -->|"checks replies"| node_queue
node_bank -->|"resolves requests"| node_queue
node_customer -->|"creates"| node_request
node_bank -->|"creates replies"| node_request
node_customer -->|"reports results"| node_money
node_bank -->|"reports balance"| node_money
node_operator -->|"runs"| node_erlmoney
node_erlmoney -.-> node_erlbank
node_erlmoney -.-> node_erlcustomer

click node_money "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Money.java"
click node_customer "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Customer.java"
click node_bank "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Bank.java"
click node_request "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Request.java"
click node_queue "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Money.java"
click node_banksfile "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/banks.txt"
click node_customersfile "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/customers.txt"
click node_erlmoney "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/money.erl"
click node_erlbank "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/bank.erl"
click node_erlcustomer "https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/customer.erl"

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_money,node_customer,node_bank,node_request toneBlue
class node_erlmoney,node_erlbank,node_erlcustomer toneAmber
class node_queue,node_banksfile,node_customersfile toneMint
class node_operator,node_console toneIndigo
```

## Components

### Java simulation

- [Java launcher](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Money.java): `src/com/concordia/multithreading/Money.java`
- [Customer thread](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Customer.java): `src/com/concordia/multithreading/Customer.java`
- [Bank thread](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Bank.java): `src/com/concordia/multithreading/Bank.java`
- [Request protocol](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Request.java): `src/com/concordia/multithreading/Request.java`

### Erlang simulation

- [Erlang entry point](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/money.erl): `erlangsrc/money.erl`
- [Erlang bank](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/bank.erl): `erlangsrc/bank.erl`
- [Erlang customer](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/erlangsrc/customer.erl): `erlangsrc/customer.erl`

### Inputs and exchange

- [Shared request queue](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/src/com/concordia/multithreading/Money.java): `src/com/concordia/multithreading/Money.java`
- [Bank data](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/banks.txt): `banks.txt`
- [Customer data](https://github.com/chetanpaliwal22/bank-customer-multithreading-project/blob/master/customers.txt): `customers.txt`

### Other components

- **Operator**
- **Console output**

## Connections

- Operator → Java launcher: runs (evidence: `README.md`)
- Java launcher → Bank data: reads (evidence: `src/com/concordia/multithreading/Money.java`)
- Java launcher → Customer data: reads (evidence: `src/com/concordia/multithreading/Money.java`)
- Java launcher → Customer thread: starts threads (evidence: `src/com/concordia/multithreading/Money.java`)
- Java launcher → Bank thread: starts threads (evidence: `src/com/concordia/multithreading/Money.java`)
- Java launcher → Shared request queue: shares (evidence: `src/com/concordia/multithreading/Money.java`)
- Customer thread → Shared request queue: posts requests (evidence: `src/com/concordia/multithreading/Customer.java`)
- Customer thread → Shared request queue: checks replies (evidence: `src/com/concordia/multithreading/Customer.java`)
- Bank thread → Shared request queue: resolves requests (evidence: `src/com/concordia/multithreading/Bank.java`)
- Customer thread → Request protocol: creates (evidence: `src/com/concordia/multithreading/Customer.java`)
- Bank thread → Request protocol: creates replies (evidence: `src/com/concordia/multithreading/Bank.java`)
- Customer thread → Java launcher: reports results (evidence: `src/com/concordia/multithreading/Customer.java`)
- Bank thread → Java launcher: reports balance (evidence: `src/com/concordia/multithreading/Bank.java`)
- Operator → Erlang entry point: runs (evidence: `README.md`)
- Erlang entry point → Erlang bank
- Erlang entry point → Erlang customer
