# jharlan-hash/jschat architecture

> Architecture diagram of the GitHub repository jharlan-hash/jschat, 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/jharlan-hash/jschat
- Repository: https://github.com/jharlan-hash/jschat

## Overview

JSChat is a terminal chat client/server application. A client connects to the server, exchanges an RSA public key to obtain the shared AES key, then encrypts terminal messages for server relay and decrypts messages received from other clients. The server accepts multiple clients and forwards each message to the others. The graph shows the principal encryption, transport, and relay stages; StreamGobbler is not connected because no runtime use is shown in the excerpts.

Main entry points: [`JSChat/src/main/java/com/jacksovern/Server/Server.java`](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Server/Server.java) (Server listener), [`JSChat/src/main/java/com/jacksovern/Client/Client.java`](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/Client.java) (Client session), [`JSChat/src/main/java/com/jacksovern/Client/MessageSender.java`](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageSender.java) (Message sender), [`JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java`](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java) (Message receiver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Terminal Client"]
  node_clientapp["Client session<br/>[Client.java]"]
  node_sender["Message sender<br/>[MessageSender.java]"]
  node_receiver["Message receiver"]
end

subgraph group_security["Encryption"]
  node_aes["AES encryption<br/>[AES.java]"]
  node_rsa["RSA key exchange<br/>[RSA.java]"]
end

subgraph group_server["Chat Server"]
  node_serverapp["Server listener<br/>[Server.java]"]
  node_connection["Client connection<br/>[ServerClient.java]"]
end

subgraph group_protocol["Message Protocol"]
  node_message["Relay message<br/>[Message.java]"]
end

node_user(("Terminal user"))
node_otherclients(("Other clients"))

node_user -->|"uses terminal"| node_clientapp
node_clientapp -->|"connects to"| node_serverapp
node_clientapp -->|"creates keypair"| node_rsa
node_serverapp -->|"encrypts AES key"| node_rsa
node_clientapp -->|"starts sender"| node_sender
node_clientapp -->|"starts receiver"| node_receiver
node_user -->|"enters messages"| node_sender
node_sender -->|"encrypts text"| node_aes
node_receiver -->|"decrypts payload"| node_aes
node_sender -->|"sends payload"| node_serverapp
node_serverapp -->|"creates connection"| node_connection
node_serverapp -->|"wraps payload"| node_message
node_serverapp -->|"forwards payload"| node_otherclients
node_otherclients -->|"delivers payload"| node_receiver

click node_clientapp "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/Client.java"
click node_sender "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageSender.java"
click node_receiver "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java"
click node_aes "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/AES.java"
click node_rsa "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/RSA.java"
click node_serverapp "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Server/Server.java"
click node_connection "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Server/ServerClient.java"
click node_message "https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Message.java"

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_clientapp,node_sender,node_receiver,node_user,node_otherclients toneBlue
class node_aes,node_rsa toneAmber
class node_serverapp,node_connection toneMint
class node_message toneRose
```

## Components

### Terminal Client

- [Client session](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/Client.java): `JSChat/src/main/java/com/jacksovern/Client/Client.java`
- [Message sender](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageSender.java): `JSChat/src/main/java/com/jacksovern/Client/MessageSender.java`
- [Message receiver](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java): `JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java`

### Encryption

- [AES encryption](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/AES.java): `JSChat/src/main/java/com/jacksovern/Client/AES.java`
- [RSA key exchange](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Client/RSA.java): `JSChat/src/main/java/com/jacksovern/Client/RSA.java`

### Chat Server

- [Server listener](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Server/Server.java): `JSChat/src/main/java/com/jacksovern/Server/Server.java`
- [Client connection](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Server/ServerClient.java): `JSChat/src/main/java/com/jacksovern/Server/ServerClient.java`

### Message Protocol

- [Relay message](https://github.com/jharlan-hash/jschat/blob/main/JSChat/src/main/java/com/jacksovern/Message.java): `JSChat/src/main/java/com/jacksovern/Message.java`

### Other components

- **Terminal user**
- **Other clients**

## Connections

- Terminal user → Client session: uses terminal (evidence: `README.md`)
- Client session → Server listener: connects to (evidence: `JSChat/src/main/java/com/jacksovern/Client/Client.java`)
- Client session → RSA key exchange: creates keypair (evidence: `JSChat/src/main/java/com/jacksovern/Client/Client.java`)
- Server listener → RSA key exchange: encrypts AES key (evidence: `JSChat/src/main/java/com/jacksovern/Server/Server.java`)
- Client session → Message sender: starts sender (evidence: `JSChat/src/main/java/com/jacksovern/Client/Client.java`)
- Client session → Message receiver: starts receiver (evidence: `JSChat/src/main/java/com/jacksovern/Client/Client.java`)
- Terminal user → Message sender: enters messages (evidence: `JSChat/src/main/java/com/jacksovern/Client/MessageSender.java`)
- Message sender → AES encryption: encrypts text (evidence: `JSChat/src/main/java/com/jacksovern/Client/MessageSender.java`)
- Message receiver → AES encryption: decrypts payload (evidence: `JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java`)
- Message sender → Server listener: sends payload (evidence: `JSChat/src/main/java/com/jacksovern/Client/MessageSender.java`)
- Server listener → Client connection: creates connection (evidence: `JSChat/src/main/java/com/jacksovern/Server/Server.java`)
- Server listener → Relay message: wraps payload (evidence: `JSChat/src/main/java/com/jacksovern/Server/Server.java`)
- Server listener → Other clients: forwards payload (evidence: `JSChat/src/main/java/com/jacksovern/Server/Server.java`)
- Other clients → Message receiver: delivers payload (evidence: `JSChat/src/main/java/com/jacksovern/Client/MessageReceiver.java`)
