# yagelx101/world-cup-2026-informer architecture

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

- Interactive diagram: https://gitdiagram.com/yagelx101/world-cup-2026-informer
- Repository: https://github.com/yagelx101/world-cup-2026-informer

## Overview

World Cup 2026 Informer is a STOMP-based live sports update service. Users connect and authenticate, subscribe to game channels, report event files, and receive channel updates; the client also supports summaries and graceful logout. The server can run with thread-per-client or Reactor networking and tracks account, login, and upload history through a Python SQL service. The tree also contains a separate remote-command newsfeed example. Edges reflect README statements or the shown source/index references; unsampled details are not inferred as direct calls.

Main entry points: [`server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java`](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java) (STOMP Handling), [`server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java`](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java) (STOMP Server Setup), [`server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java`](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java) (Newsfeed Server), [`client/src/StompClient.cpp`](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/StompClient.cpp) (Console Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["C++ Client"]
  node_client_app["Console Client<br/>[StompClient.cpp]"]
  node_client_socket["Socket Handler"]
  node_client_protocol["STOMP Commands<br/>[StompProtocol.cpp]"]
  node_event_parser["Event Parser<br/>[event.cpp]"]
  node_client_types["Event Types<br/>[event.h]"]
end

subgraph group_stomp["STOMP Service"]
  node_stomp_server["STOMP Server Setup<br/>[StompServer.java]"]
  node_stomp_protocol["STOMP Handling<br/>[StompProtocol.java]"]
  node_frame["STOMP Frames<br/>[Frame.java]"]
  node_stomp_codec["STOMP Codec"]
  node_subscriptions["Channel Routing"]
end

subgraph group_net["Networking Runtime"]
  node_server_api["Server Factory<br/>[Server.java]"]
  node_tpc_handler["Blocking Handler"]
  node_reactor["Reactor<br/>[Reactor.java]"]
  node_nb_handler["Nonblocking Handler"]
  node_connection_api["Connection API<br/>[Connections.java]"]
end

subgraph group_data["Persistence"]
  node_database[("Account and History<br/>[Database.java]")]
  node_sql_service[("SQLite SQL Service<br/>[sql_server.py]")]
end

subgraph group_rci["Remote Newsfeed"]
  node_newsfeed_server["Newsfeed Server"]
  node_newsfeed_store["Newsfeed Store<br/>[NewsFeed.java]"]
  node_publish_command["Publish Command"]
  node_fetch_command["Fetch Command"]
  node_rci_protocol["Command Protocol"]
  node_rci_codec["Object Codec"]
end

node_user(("User"))

node_user -->|"enters commands"| node_client_app
node_client_app -->|"dispatches commands"| node_client_protocol
node_client_app -->|"uses socket"| node_client_socket
node_client_protocol -.->|"parses reports"| node_event_parser
node_client_protocol -->|"sends STOMP"| node_stomp_server
node_stomp_server -->|"selects server"| node_server_api
node_server_api -->|"creates TPC"| node_tpc_handler
node_server_api -->|"creates Reactor"| node_reactor
node_tpc_handler -->|"processes frames"| node_stomp_protocol
node_nb_handler -->|"processes frames"| node_stomp_protocol
node_reactor -->|"dispatches I/O"| node_nb_handler
node_stomp_server -->|"configures protocol"| node_stomp_protocol
node_stomp_server -->|"configures codec"| node_stomp_codec
node_stomp_protocol -->|"authenticates users"| node_database
node_stomp_protocol -->|"routes subscriptions"| node_subscriptions
node_tpc_handler -->|"registers connection"| node_subscriptions
node_nb_handler -->|"registers connection"| node_subscriptions
node_stomp_protocol -->|"handles frames"| node_frame
node_stomp_codec -->|"encodes frames"| node_frame
node_database -->|"executes SQL"| node_sql_service
node_newsfeed_server -->|"shares store"| node_newsfeed_store
node_newsfeed_server -->|"configures protocol"| node_rci_protocol
node_newsfeed_server -->|"configures codec"| node_rci_codec
node_publish_command -->|"publishes news"| node_newsfeed_store
node_fetch_command -->|"fetches news"| node_newsfeed_store
node_rci_protocol -->|"executes commands"| node_publish_command
node_rci_protocol -->|"executes commands"| node_fetch_command

click node_client_app "https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/StompClient.cpp"
click node_client_socket "https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/ConnectionHandler.cpp"
click node_client_protocol "https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/StompProtocol.cpp"
click node_event_parser "https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/event.cpp"
click node_client_types "https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/include/event.h"
click node_stomp_server "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java"
click node_stomp_protocol "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java"
click node_frame "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/Frame.java"
click node_stomp_codec "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompEncoderDecoder.java"
click node_subscriptions "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/ConnectionImpl.java"
click node_server_api "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Server.java"
click node_tpc_handler "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/BlockingConnectionHandler.java"
click node_reactor "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Reactor.java"
click node_nb_handler "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/NonBlockingConnectionHandler.java"
click node_connection_api "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Connections.java"
click node_database "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/data/Database.java"
click node_sql_service "https://github.com/yagelx101/world-cup-2026-informer/blob/main/data/sql_server.py"
click node_newsfeed_server "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java"
click node_newsfeed_store "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeed.java"
click node_publish_command "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/PublishNewsCommand.java"
click node_fetch_command "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/FetchNewsCommand.java"
click node_rci_protocol "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/rci/RemoteCommandInvocationProtocol.java"
click node_rci_codec "https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/rci/ObjectEncoderDecoder.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_app,node_client_socket,node_client_protocol,node_event_parser,node_client_types,node_user toneBlue
class node_stomp_server,node_stomp_protocol,node_frame,node_stomp_codec,node_subscriptions toneAmber
class node_server_api,node_tpc_handler,node_reactor,node_nb_handler,node_connection_api toneMint
class node_database,node_sql_service toneRose
class node_newsfeed_server,node_newsfeed_store,node_publish_command,node_fetch_command,node_rci_protocol,node_rci_codec toneIndigo
```

## Components

### C++ Client

- [Console Client](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/StompClient.cpp): `client/src/StompClient.cpp`
- [Socket Handler](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/ConnectionHandler.cpp): `client/src/ConnectionHandler.cpp`
- [STOMP Commands](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/StompProtocol.cpp): `client/src/StompProtocol.cpp`
- [Event Parser](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/src/event.cpp): `client/src/event.cpp`
- [Event Types](https://github.com/yagelx101/world-cup-2026-informer/blob/main/client/include/event.h): `client/include/event.h`

### STOMP Service

- [STOMP Server Setup](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java): `server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java`
- [STOMP Handling](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java): `server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java`
- [STOMP Frames](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/Frame.java): `server/src/main/java/bgu/spl/net/impl/stomp/Frame.java`
- [STOMP Codec](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/stomp/StompEncoderDecoder.java): `server/src/main/java/bgu/spl/net/impl/stomp/StompEncoderDecoder.java`
- [Channel Routing](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/ConnectionImpl.java): `server/src/main/java/bgu/spl/net/impl/ConnectionImpl.java`

### Networking Runtime

- [Server Factory](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Server.java): `server/src/main/java/bgu/spl/net/srv/Server.java`
- [Blocking Handler](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/BlockingConnectionHandler.java): `server/src/main/java/bgu/spl/net/srv/BlockingConnectionHandler.java`
- [Reactor](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Reactor.java): `server/src/main/java/bgu/spl/net/srv/Reactor.java`
- [Nonblocking Handler](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/NonBlockingConnectionHandler.java): `server/src/main/java/bgu/spl/net/srv/NonBlockingConnectionHandler.java`
- [Connection API](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/srv/Connections.java): `server/src/main/java/bgu/spl/net/srv/Connections.java`

### Persistence

- [Account and History](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/data/Database.java): `server/src/main/java/bgu/spl/net/impl/data/Database.java`
- [SQLite SQL Service](https://github.com/yagelx101/world-cup-2026-informer/blob/main/data/sql_server.py): `data/sql_server.py`

### Remote Newsfeed

- [Newsfeed Server](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java): `server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java`
- [Newsfeed Store](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeed.java): `server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeed.java`
- [Publish Command](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/PublishNewsCommand.java): `server/src/main/java/bgu/spl/net/impl/newsfeed/PublishNewsCommand.java`
- [Fetch Command](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/newsfeed/FetchNewsCommand.java): `server/src/main/java/bgu/spl/net/impl/newsfeed/FetchNewsCommand.java`
- [Command Protocol](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/rci/RemoteCommandInvocationProtocol.java): `server/src/main/java/bgu/spl/net/impl/rci/RemoteCommandInvocationProtocol.java`
- [Object Codec](https://github.com/yagelx101/world-cup-2026-informer/blob/main/server/src/main/java/bgu/spl/net/impl/rci/ObjectEncoderDecoder.java): `server/src/main/java/bgu/spl/net/impl/rci/ObjectEncoderDecoder.java`

### Other components

- **User**

## Connections

- User → Console Client: enters commands
- Console Client → STOMP Commands: dispatches commands (evidence: `client/src/StompClient.cpp`)
- Console Client → Socket Handler: uses socket (evidence: `client/src/StompClient.cpp`)
- STOMP Commands → Event Parser: parses reports
- STOMP Commands → STOMP Server Setup: sends STOMP
- STOMP Server Setup → Server Factory: selects server (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java`)
- Server Factory → Blocking Handler: creates TPC (evidence: `server/src/main/java/bgu/spl/net/srv/Server.java`)
- Server Factory → Reactor: creates Reactor (evidence: `server/src/main/java/bgu/spl/net/srv/Server.java`)
- Blocking Handler → STOMP Handling: processes frames (evidence: `server/src/main/java/bgu/spl/net/srv/BlockingConnectionHandler.java`)
- Nonblocking Handler → STOMP Handling: processes frames (evidence: `server/src/main/java/bgu/spl/net/srv/NonBlockingConnectionHandler.java`)
- Reactor → Nonblocking Handler: dispatches I/O (evidence: `server/src/main/java/bgu/spl/net/srv/Reactor.java`)
- STOMP Server Setup → STOMP Handling: configures protocol (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java`)
- STOMP Server Setup → STOMP Codec: configures codec (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompServer.java`)
- STOMP Handling → Account and History: authenticates users (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java`)
- STOMP Handling → Channel Routing: routes subscriptions (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java`)
- Blocking Handler → Channel Routing: registers connection (evidence: `server/src/main/java/bgu/spl/net/srv/BlockingConnectionHandler.java`)
- Nonblocking Handler → Channel Routing: registers connection (evidence: `server/src/main/java/bgu/spl/net/srv/NonBlockingConnectionHandler.java`)
- STOMP Handling → STOMP Frames: handles frames (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompProtocol.java`)
- STOMP Codec → STOMP Frames: encodes frames (evidence: `server/src/main/java/bgu/spl/net/impl/stomp/StompEncoderDecoder.java`)
- Account and History → SQLite SQL Service: executes SQL (evidence: `server/src/main/java/bgu/spl/net/impl/data/Database.java`)
- Newsfeed Server → Newsfeed Store: shares store (evidence: `server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java`)
- Newsfeed Server → Command Protocol: configures protocol (evidence: `server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java`)
- Newsfeed Server → Object Codec: configures codec (evidence: `server/src/main/java/bgu/spl/net/impl/newsfeed/NewsFeedServerMain.java`)
- Publish Command → Newsfeed Store: publishes news (evidence: `server/src/main/java/bgu/spl/net/impl/newsfeed/PublishNewsCommand.java`)
- Fetch Command → Newsfeed Store: fetches news (evidence: `server/src/main/java/bgu/spl/net/impl/newsfeed/FetchNewsCommand.java`)
- Command Protocol → Publish Command: executes commands (evidence: `server/src/main/java/bgu/spl/net/impl/rci/RemoteCommandInvocationProtocol.java`)
- Command Protocol → Fetch Command: executes commands (evidence: `server/src/main/java/bgu/spl/net/impl/rci/RemoteCommandInvocationProtocol.java`)
