# kuroineko2511/chatroom architecture

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

- Interactive diagram: https://gitdiagram.com/kuroineko2511/chatroom
- Repository: https://github.com/kuroineko2511/chatroom

## Overview

This repository implements a TCP chat room: a user enters messages in a client, the server receives them and broadcasts them to other connected clients, whose listeners print them. Client and server entry points start their respective runtimes; handlers manage per-connection I/O. The README is empty, so the client/server network link is shown as unverified: the code uses sockets and matching port 5000, but the excerpts do not directly wire the two classes together.

Main entry points: [`Server/ChatServer.java`](https://github.com/kuroineko2511/chatroom/blob/main/Server/ChatServer.java) (Chat server), [`Client/ChatClient.java`](https://github.com/kuroineko2511/chatroom/blob/main/Client/ChatClient.java) (Chat client), [`Server/ClientHandler.java`](https://github.com/kuroineko2511/chatroom/blob/main/Server/ClientHandler.java) (Connection handler), [`Client/Client.java`](https://github.com/kuroineko2511/chatroom/blob/main/Client/Client.java) (Client entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Chat client"]
  node_client_entry["Client entry<br/>[Client.java]"]
  node_chat_client["Chat client<br/>[ChatClient.java]"]
  node_client_listener["Message listener"]
end

subgraph group_server["Chat server"]
  node_server_entry["Server entry<br/>[Server.java]"]
  node_chat_server["Chat server<br/>[ChatServer.java]"]
  node_client_handler["Connection handler<br/>[ClientHandler.java]"]
end

node_user(("Terminal user"))

node_user -->|"starts client"| node_client_entry
node_client_entry -->|"starts runtime"| node_chat_client
node_chat_client -->|"starts listener"| node_client_listener
node_user -->|"enters messages"| node_chat_client
node_client_listener -->|"prints messages"| node_user
node_server_entry -->|"starts server"| node_chat_server
node_chat_server -->|"creates handler"| node_client_handler
node_client_handler -->|"broadcasts message"| node_chat_server
node_chat_server -->|"sends to peers"| node_client_handler
node_chat_client -.->|"connects by socket"| node_chat_server

click node_client_entry "https://github.com/kuroineko2511/chatroom/blob/main/Client/Client.java"
click node_chat_client "https://github.com/kuroineko2511/chatroom/blob/main/Client/ChatClient.java"
click node_client_listener "https://github.com/kuroineko2511/chatroom/blob/main/Client/ClientListener.java"
click node_server_entry "https://github.com/kuroineko2511/chatroom/blob/main/Server/Server.java"
click node_chat_server "https://github.com/kuroineko2511/chatroom/blob/main/Server/ChatServer.java"
click node_client_handler "https://github.com/kuroineko2511/chatroom/blob/main/Server/ClientHandler.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_client_entry,node_chat_client,node_client_listener,node_user toneBlue
class node_server_entry,node_chat_server,node_client_handler toneAmber
```

## Components

### Chat client

- [Client entry](https://github.com/kuroineko2511/chatroom/blob/main/Client/Client.java): `Client/Client.java`
- [Chat client](https://github.com/kuroineko2511/chatroom/blob/main/Client/ChatClient.java): `Client/ChatClient.java`
- [Message listener](https://github.com/kuroineko2511/chatroom/blob/main/Client/ClientListener.java): `Client/ClientListener.java`

### Chat server

- [Server entry](https://github.com/kuroineko2511/chatroom/blob/main/Server/Server.java): `Server/Server.java`
- [Chat server](https://github.com/kuroineko2511/chatroom/blob/main/Server/ChatServer.java): `Server/ChatServer.java`
- [Connection handler](https://github.com/kuroineko2511/chatroom/blob/main/Server/ClientHandler.java): `Server/ClientHandler.java`

### Other components

- **Terminal user**

## Connections

- Terminal user → Client entry: starts client (evidence: `Client/Client.java`)
- Client entry → Chat client: starts runtime (evidence: `Client/Client.java`)
- Chat client → Message listener: starts listener (evidence: `Client/ChatClient.java`)
- Terminal user → Chat client: enters messages (evidence: `Client/ChatClient.java`)
- Message listener → Terminal user: prints messages (evidence: `Client/ClientListener.java`)
- Server entry → Chat server: starts server (evidence: `Server/Server.java`)
- Chat server → Connection handler: creates handler (evidence: `Server/ChatServer.java`)
- Connection handler → Chat server: broadcasts message (evidence: `Server/ClientHandler.java`)
- Chat server → Connection handler: sends to peers (evidence: `Server/ChatServer.java`)
- Chat client → Chat server: connects by socket
