# jiyan-0525/42core_webserv architecture

> Architecture diagram of the GitHub repository jiyan-0525/42core_webserv, 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/jiyan-0525/42core_webserv
- Repository: https://github.com/jiyan-0525/42core_webserv

## Overview

webserv is a C++ HTTP/1.1 server. A client connection is accepted by the epoll event loop, its complete request is parsed and dispatched against the selected server/location configuration, and the resulting response is serialized and sent. The handler supports static files, autoindex listings, uploads, deletes, CGI, and configured error pages. The graph follows the README and shown source references; some handler dispatch details and event-loop internals are unsampled, so those links are documented or left unasserted.

Main entry points: [`srcs/handlers/requestHandler.cpp`](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp) (Request Router), [`srcs/server/server.cpp`](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/server/server.cpp) (Epoll Event Loop), [`www`](https://github.com/jiyan-0525/42core_webserv/tree/main/www) (Web Content and Uploads), [`main.cpp`](https://github.com/jiyan-0525/42core_webserv/blob/main/main.cpp) (Program Startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Configuration"]
  node_main["Program Startup<br/>[main.cpp]"]
  node_config_parser["Config Parser<br/>[configParser.cpp]"]
  node_server_config["Server Configuration<br/>[config.hpp]"]
  node_signal_handling["Signal Handling<br/>[signals.cpp]"]
end

subgraph group_network["Connections and HTTP"]
  node_event_loop["Epoll Event Loop<br/>[server.cpp]"]
  node_client_state["Client State<br/>[client.hpp]"]
  node_request_parser["HTTP Request Parser<br/>[httpRequest.cpp]"]
  node_response_builder["HTTP Response Builder<br/>[httpResponse.cpp]"]
end

subgraph group_handling["Request Handling"]
  node_request_handler["Request Router<br/>[requestHandler.cpp]"]
  node_path_helpers["Path and Query Helpers"]
end

subgraph group_content["Content and Integrations"]
  node_static_content["Static Files and Autoindex<br/>[requestHandler.cpp]"]
  node_uploads["File Uploads<br/>[requestHandler.cpp]"]
  node_file_deletion["File Deletion<br/>[requestHandler.cpp]"]
  node_error_pages["Configured Error Pages<br/>[requestHandler.cpp]"]
  node_cgi["CGI Execution<br/>[handleCGI.cpp]"]
  node_filesystem[("Web Content and Uploads")]
end

node_client(("HTTP Client"))

node_client -->|"sends requests"| node_event_loop
node_main -->|"loads configuration"| node_config_parser
node_main -->|"starts loop"| node_event_loop
node_main -->|"registers signals"| node_signal_handling
node_config_parser -->|"builds settings"| node_server_config
node_event_loop -->|"uses settings"| node_server_config
node_event_loop -->|"tracks connections"| node_client_state
node_event_loop -->|"parses requests"| node_request_parser
node_event_loop -->|"dispatches requests"| node_request_handler
node_request_handler -->|"uses helpers"| node_path_helpers
node_request_handler -->|"serves files"| node_static_content
node_request_handler -->|"saves uploads"| node_uploads
node_request_handler -->|"removes files"| node_file_deletion
node_request_handler -->|"builds errors"| node_error_pages
node_request_handler -->|"runs CGI"| node_cgi
node_static_content -->|"reads content"| node_filesystem
node_uploads -->|"writes uploads"| node_filesystem
node_file_deletion -->|"deletes files"| node_filesystem
node_error_pages -->|"reads page files"| node_filesystem
node_request_handler -->|"returns response"| node_response_builder
node_response_builder -.->|"serializes for sending"| node_event_loop

click node_main "https://github.com/jiyan-0525/42core_webserv/blob/main/main.cpp"
click node_config_parser "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/config/configParser.cpp"
click node_server_config "https://github.com/jiyan-0525/42core_webserv/blob/main/includes/config.hpp"
click node_signal_handling "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/server/signals/signals.cpp"
click node_event_loop "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/server/server.cpp"
click node_client_state "https://github.com/jiyan-0525/42core_webserv/blob/main/includes/client.hpp"
click node_request_parser "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/http/httpRequest.cpp"
click node_request_handler "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp"
click node_path_helpers "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requesHanddlerUtils.cpp"
click node_response_builder "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/http/httpResponse.cpp"
click node_static_content "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp"
click node_uploads "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp"
click node_file_deletion "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp"
click node_error_pages "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp"
click node_cgi "https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/handleCGI.cpp"
click node_filesystem "https://github.com/jiyan-0525/42core_webserv/tree/main/www"

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_main,node_config_parser,node_server_config,node_signal_handling,node_client toneBlue
class node_event_loop,node_client_state,node_request_parser,node_response_builder toneAmber
class node_request_handler,node_path_helpers toneMint
class node_static_content,node_uploads,node_file_deletion,node_error_pages,node_cgi,node_filesystem toneRose
```

## Components

### Startup and Configuration

- [Program Startup](https://github.com/jiyan-0525/42core_webserv/blob/main/main.cpp): `main.cpp`
- [Config Parser](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/config/configParser.cpp): `srcs/config/configParser.cpp`
- [Server Configuration](https://github.com/jiyan-0525/42core_webserv/blob/main/includes/config.hpp): `includes/config.hpp`
- [Signal Handling](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/server/signals/signals.cpp): `srcs/server/signals/signals.cpp`

### Connections and HTTP

- [Epoll Event Loop](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/server/server.cpp): `srcs/server/server.cpp`
- [Client State](https://github.com/jiyan-0525/42core_webserv/blob/main/includes/client.hpp): `includes/client.hpp`
- [HTTP Request Parser](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/http/httpRequest.cpp): `srcs/http/httpRequest.cpp`
- [HTTP Response Builder](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/http/httpResponse.cpp): `srcs/http/httpResponse.cpp`

### Request Handling

- [Request Router](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp): `srcs/handlers/requestHandler.cpp`
- [Path and Query Helpers](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requesHanddlerUtils.cpp): `srcs/handlers/requesHanddlerUtils.cpp`

### Content and Integrations

- [Static Files and Autoindex](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp): `srcs/handlers/requestHandler.cpp`
- [File Uploads](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp): `srcs/handlers/requestHandler.cpp`
- [File Deletion](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp): `srcs/handlers/requestHandler.cpp`
- [Configured Error Pages](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/requestHandler.cpp): `srcs/handlers/requestHandler.cpp`
- [CGI Execution](https://github.com/jiyan-0525/42core_webserv/blob/main/srcs/handlers/handleCGI.cpp): `srcs/handlers/handleCGI.cpp`
- [Web Content and Uploads](https://github.com/jiyan-0525/42core_webserv/tree/main/www): `www`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Epoll Event Loop: sends requests (evidence: `README.md`)
- Program Startup → Config Parser: loads configuration (evidence: `main.cpp`)
- Program Startup → Epoll Event Loop: starts loop (evidence: `main.cpp`)
- Program Startup → Signal Handling: registers signals (evidence: `main.cpp`)
- Config Parser → Server Configuration: builds settings (evidence: `srcs/config/configParser.cpp`)
- Epoll Event Loop → Server Configuration: uses settings (evidence: `srcs/server/server.cpp`)
- Epoll Event Loop → Client State: tracks connections (evidence: `srcs/server/server.cpp`)
- Epoll Event Loop → HTTP Request Parser: parses requests (evidence: `srcs/server/server.cpp`)
- Epoll Event Loop → Request Router: dispatches requests (evidence: `srcs/server/server.cpp`)
- Request Router → Path and Query Helpers: uses helpers (evidence: `srcs/handlers/requestHandler.cpp`)
- Request Router → Static Files and Autoindex: serves files (evidence: `README.md`)
- Request Router → File Uploads: saves uploads (evidence: `README.md`)
- Request Router → File Deletion: removes files (evidence: `README.md`)
- Request Router → Configured Error Pages: builds errors (evidence: `srcs/handlers/requestHandler.cpp`)
- Request Router → CGI Execution: runs CGI (evidence: `srcs/handlers/requestHandler.cpp`)
- Static Files and Autoindex → Web Content and Uploads: reads content (evidence: `srcs/handlers/requestHandler.cpp`)
- File Uploads → Web Content and Uploads: writes uploads (evidence: `srcs/handlers/requestHandler.cpp`)
- File Deletion → Web Content and Uploads: deletes files (evidence: `srcs/handlers/requestHandler.cpp`)
- Configured Error Pages → Web Content and Uploads: reads page files (evidence: `srcs/handlers/requestHandler.cpp`)
- Request Router → HTTP Response Builder: returns response (evidence: `README.md`)
- HTTP Response Builder → Epoll Event Loop: serializes for sending
