# hayk364/terminal-messenger architecture

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

- Interactive diagram: https://gitdiagram.com/hayk364/terminal-messenger
- Repository: https://github.com/hayk364/terminal-messenger

## Overview

Messenger is a terminal chat client backed by an Express service and MongoDB. Users register or log in, select another user, then send messages while a background updater periodically retrieves and displays the conversation. The server encrypts stored credentials and messages and decrypts them for comparison or chat responses. The README is empty; the graph follows the sampled client calls and server routes, and does not infer unsampled client endpoint wiring.

Main entry points: [`MessengerServer/server.js`](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js) (HTTP API), [`Messenger/backend.cpp`](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/backend.cpp) (HTTP backend client), [`Messenger/main.cpp`](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/main.cpp) (Terminal workflow), [`Messenger/json-2.hpp`](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/json-2.hpp) (JSON parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Terminal client"]
  node_terminal["Terminal workflow<br/>[main.cpp]"]
  node_backend["HTTP backend client<br/>[backend.cpp]"]
  node_json["JSON parser<br/>[json-2.hpp]"]
end

subgraph group_service["Messaging service"]
  node_api["HTTP API<br/>[server.js]"]
  node_registration["Registration route<br/>[server.js]"]
  node_login["Login route<br/>[server.js]"]
  node_userlist["User listing route<br/>[server.js]"]
  node_send["Message send route<br/>[server.js]"]
  node_history["Chat history route<br/>[server.js]"]
  node_encryption["AES encryption<br/>[server.js]"]
end

subgraph group_storage["Persistence"]
  node_mongo[("MongoDB")]
end

node_user(("Messenger user"))

node_user -->|"uses"| node_terminal
node_terminal -->|"calls"| node_backend
node_backend -->|"parses JSON"| node_json
node_backend -->|"requests chat history"| node_api
node_api -->|"routes"| node_registration
node_api -->|"routes"| node_login
node_api -->|"routes"| node_userlist
node_api -->|"routes"| node_send
node_api -->|"routes"| node_history
node_registration -->|"encrypts password"| node_encryption
node_registration -->|"writes user"| node_mongo
node_login -->|"reads user"| node_mongo
node_login -->|"decrypts password"| node_encryption
node_userlist -->|"reads users"| node_mongo
node_send -->|"encrypts message"| node_encryption
node_send -->|"writes message"| node_mongo
node_history -->|"reads messages"| node_mongo
node_history -->|"decrypts messages"| node_encryption

click node_terminal "https://github.com/hayk364/terminal-messenger/blob/main/Messenger/main.cpp"
click node_backend "https://github.com/hayk364/terminal-messenger/blob/main/Messenger/backend.cpp"
click node_json "https://github.com/hayk364/terminal-messenger/blob/main/Messenger/json-2.hpp"
click node_api "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_registration "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_login "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_userlist "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_send "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_history "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"
click node_encryption "https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js"

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_terminal,node_backend,node_json,node_user toneBlue
class node_api,node_registration,node_login,node_userlist,node_send,node_history,node_encryption toneAmber
class node_mongo toneMint
```

## Components

### Terminal client

- [Terminal workflow](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/main.cpp): `Messenger/main.cpp`
- [HTTP backend client](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/backend.cpp): `Messenger/backend.cpp`
- [JSON parser](https://github.com/hayk364/terminal-messenger/blob/main/Messenger/json-2.hpp): `Messenger/json-2.hpp`

### Messaging service

- [HTTP API](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [Registration route](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [Login route](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [User listing route](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [Message send route](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [Chat history route](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`
- [AES encryption](https://github.com/hayk364/terminal-messenger/blob/main/MessengerServer/server.js): `MessengerServer/server.js`

### Persistence

- **MongoDB**

### Other components

- **Messenger user**

## Connections

- Messenger user → Terminal workflow: uses (evidence: `Messenger/main.cpp`)
- Terminal workflow → HTTP backend client: calls (evidence: `Messenger/main.cpp`)
- HTTP backend client → JSON parser: parses JSON (evidence: `Messenger/backend.cpp`)
- HTTP backend client → HTTP API: requests chat history (evidence: `Messenger/backend.cpp`)
- HTTP API → Registration route: routes (evidence: `MessengerServer/server.js`)
- HTTP API → Login route: routes (evidence: `MessengerServer/server.js`)
- HTTP API → User listing route: routes (evidence: `MessengerServer/server.js`)
- HTTP API → Message send route: routes (evidence: `MessengerServer/server.js`)
- HTTP API → Chat history route: routes (evidence: `MessengerServer/server.js`)
- Registration route → AES encryption: encrypts password (evidence: `MessengerServer/server.js`)
- Registration route → MongoDB: writes user (evidence: `MessengerServer/server.js`)
- Login route → MongoDB: reads user (evidence: `MessengerServer/server.js`)
- Login route → AES encryption: decrypts password (evidence: `MessengerServer/server.js`)
- User listing route → MongoDB: reads users (evidence: `MessengerServer/server.js`)
- Message send route → AES encryption: encrypts message (evidence: `MessengerServer/server.js`)
- Message send route → MongoDB: writes message (evidence: `MessengerServer/server.js`)
- Chat history route → MongoDB: reads messages (evidence: `MessengerServer/server.js`)
- Chat history route → AES encryption: decrypts messages (evidence: `MessengerServer/server.js`)
