# antoine-perfettini/menu-network-simulation architecture

> Architecture diagram of the GitHub repository antoine-perfettini/menu-network-simulation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antoine-perfettini/menu-network-simulation
- Repository: https://github.com/antoine-perfettini/menu-network-simulation

## Overview

This is a local C simulation of menu lookup, not a network service: a user enters a QR-style code, a client sends the identifiers through a FIFO to a router, and a data server reads the matching menu file and returns the result to that client. The router handles requests in threads while locking its shared server exchange; the server also processes requests in threads. The main workflow is visible in the excerpts. Menu files are documented by the README, but their reading was not sampled individually.

Main entry points: [`src/routeur.c`](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/routeur.c) (Router exchange worker), [`src/client.c`](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/client.c) (QR input and display), [`include/protocol.h`](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/include/protocol.h) (FIFO and message protocol), [`src/serveur.c`](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/serveur.c) (Menu lookup worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client interaction"]
  node_client_app["QR input and display<br/>[client.c]"]
end

subgraph group_routing["FIFO routing"]
  node_protocol["FIFO and message protocol<br/>[protocol.h]"]
  node_router_main["Router request listener<br/>[routeur.c]"]
  node_router_worker["Router exchange worker<br/>[routeur.c]"]
end

subgraph group_data["Menu data"]
  node_server_listener["Server request listener<br/>[serveur.c]"]
  node_server_worker["Menu lookup worker<br/>[serveur.c]"]
  node_menu_files[("Menu text files")]
end

node_user(("Menu requester"))

node_user -->|"enters code"| node_client_app
node_client_app -->|"writes request"| node_router_main
node_router_main -->|"dispatches request"| node_router_worker
node_router_worker -->|"sends query"| node_server_listener
node_server_listener -->|"dispatches query"| node_server_worker
node_server_worker -->|"reads menu"| node_menu_files
node_server_worker -->|"writes response"| node_router_worker
node_router_worker -->|"writes private response"| node_client_app
node_protocol -->|"defines messages"| node_client_app
node_protocol -->|"defines messages"| node_router_main
node_protocol -->|"defines messages"| node_server_listener

click node_client_app "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/client.c"
click node_protocol "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/include/protocol.h"
click node_router_main "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/routeur.c"
click node_router_worker "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/routeur.c"
click node_server_listener "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/serveur.c"
click node_server_worker "https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/serveur.c"
click node_menu_files "https://github.com/antoine-perfettini/menu-network-simulation/tree/main/data"

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 toneBlue
class node_protocol,node_router_main,node_router_worker toneAmber
class node_server_listener,node_server_worker,node_menu_files,node_user toneMint
```

## Components

### Client interaction

- [QR input and display](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/client.c): `src/client.c`

### FIFO routing

- [FIFO and message protocol](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/include/protocol.h): `include/protocol.h`
- [Router request listener](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/routeur.c): `src/routeur.c`
- [Router exchange worker](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/routeur.c): `src/routeur.c`

### Menu data

- [Server request listener](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/serveur.c): `src/serveur.c`
- [Menu lookup worker](https://github.com/antoine-perfettini/menu-network-simulation/blob/main/src/serveur.c): `src/serveur.c`
- [Menu text files](https://github.com/antoine-perfettini/menu-network-simulation/tree/main/data): `data`

### Other components

- **Menu requester**

## Connections

- Menu requester → QR input and display: enters code (evidence: `README.md`)
- QR input and display → Router request listener: writes request (evidence: `src/client.c`)
- Router request listener → Router exchange worker: dispatches request (evidence: `src/routeur.c`)
- Router exchange worker → Server request listener: sends query (evidence: `src/routeur.c`)
- Server request listener → Menu lookup worker: dispatches query (evidence: `src/serveur.c`)
- Menu lookup worker → Menu text files: reads menu (evidence: `src/serveur.c`)
- Menu lookup worker → Router exchange worker: writes response (evidence: `src/serveur.c`)
- Router exchange worker → QR input and display: writes private response (evidence: `src/routeur.c`)
- FIFO and message protocol → QR input and display: defines messages (evidence: `src/client.c`)
- FIFO and message protocol → Router request listener: defines messages (evidence: `src/routeur.c`)
- FIFO and message protocol → Server request listener: defines messages (evidence: `src/serveur.c`)
