# enduserrr/webserv architecture

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

- Interactive diagram: https://gitdiagram.com/enduserrr/webserv
- Repository: https://github.com/enduserrr/webserv

## Overview

WEBSERV is a C++ HTTP/1.1 server. Its main workflow is configuration loading, socket polling and client-session handling, HTTP request parsing, routing, then response generation for static content, CGI, or uploads and deletions. Configuration also controls virtual hosts, locations, limits, redirects, and error pages. The graph combines excerpted declarations and SOURCE INDEX references with documented README capabilities; some handler dispatch details were not shown, so those links are marked unverified or omitted.

Main entry points: [`src/ServerLoop.cpp`](https://github.com/enduserrr/webserv/blob/main/src/ServerLoop.cpp) (Poll Server Loop), [`src/Router.cpp`](https://github.com/enduserrr/webserv/blob/main/src/Router.cpp) (Request Router), [`src/main.cpp`](https://github.com/enduserrr/webserv/blob/main/src/main.cpp) (Program Entry), [`src/Methods.cpp`](https://github.com/enduserrr/webserv/blob/main/src/Methods.cpp) (Method Handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Configuration"]
  node_config_file["Server Config<br/>[default.conf]"]
  node_main["Program Entry<br/>[main.cpp]"]
  node_config_parser["Config Parser<br/>[ConfParser.cpp]"]
  node_server_config["Virtual Server Config<br/>[ServerBlock.cpp]"]
end

subgraph group_runtime["Connection Runtime"]
  node_server_loop["Poll Server Loop<br/>[ServerLoop.cpp]"]
  node_sessions["Client Sessions<br/>[ClientSession.cpp]"]
end

subgraph group_http["HTTP Processing"]
  node_http_parser["HTTP Parser<br/>[HttpParser.cpp]"]
  node_request["Request Context<br/>[HttpRequest.cpp]"]
  node_router["Request Router<br/>[Router.cpp]"]
  node_methods["Method Handling<br/>[Methods.cpp]"]
end

subgraph group_responses["Response Services"]
  node_static["Static Content<br/>[StaticHandler.cpp]"]
  node_cgi["CGI Execution<br/>[CgiHandler.cpp]"]
  node_uploads["Upload Handling<br/>[UploadHandler.cpp]"]
end

subgraph group_content["Content and Errors"]
  node_site_content[("Web Content")]
  node_cgi_scripts["CGI Scripts"]
  node_error_pages["Error Pages"]
  node_logger["Logging and Errors<br/>[Logger.cpp]"]
  node_mime["MIME Types<br/>[Types.cpp]"]
end

node_operator(("Server Operator"))

node_operator -->|"provides settings"| node_config_file
node_operator -->|"starts server"| node_main
node_main -->|"loads configuration"| node_config_parser
node_main -->|"starts runtime"| node_server_loop
node_config_parser -->|"builds server blocks"| node_server_config
node_server_loop -->|"uses configuration"| node_server_config
node_server_loop -->|"tracks clients"| node_sessions
node_server_loop -->|"parses requests"| node_http_parser
node_http_parser -->|"populates request"| node_request
node_server_loop -->|"routes requests"| node_router
node_router -.->|"dispatches static"| node_static
node_router -.->|"dispatches CGI"| node_cgi
node_static -.->|"serves files"| node_site_content
node_router -.->|"selects methods"| node_methods
node_methods -.->|"handles uploads"| node_uploads
node_methods -.->|"deletes resources"| node_site_content
node_cgi -.->|"executes scripts"| node_cgi_scripts
node_cgi -->|"reads request data"| node_request
node_logger -.->|"loads error content"| node_error_pages
node_static -.->|"uses content types"| node_mime

click node_config_file "https://github.com/enduserrr/webserv/blob/main/config/default.conf"
click node_main "https://github.com/enduserrr/webserv/blob/main/src/main.cpp"
click node_config_parser "https://github.com/enduserrr/webserv/blob/main/src/ConfParser.cpp"
click node_server_config "https://github.com/enduserrr/webserv/blob/main/src/ServerBlock.cpp"
click node_server_loop "https://github.com/enduserrr/webserv/blob/main/src/ServerLoop.cpp"
click node_sessions "https://github.com/enduserrr/webserv/blob/main/src/ClientSession.cpp"
click node_http_parser "https://github.com/enduserrr/webserv/blob/main/src/HttpParser.cpp"
click node_request "https://github.com/enduserrr/webserv/blob/main/src/HttpRequest.cpp"
click node_router "https://github.com/enduserrr/webserv/blob/main/src/Router.cpp"
click node_methods "https://github.com/enduserrr/webserv/blob/main/src/Methods.cpp"
click node_static "https://github.com/enduserrr/webserv/blob/main/src/StaticHandler.cpp"
click node_cgi "https://github.com/enduserrr/webserv/blob/main/src/CgiHandler.cpp"
click node_uploads "https://github.com/enduserrr/webserv/blob/main/src/UploadHandler.cpp"
click node_site_content "https://github.com/enduserrr/webserv/tree/main/www"
click node_cgi_scripts "https://github.com/enduserrr/webserv/tree/main/www/cgi-bin"
click node_error_pages "https://github.com/enduserrr/webserv/tree/main/www/error_pages"
click node_logger "https://github.com/enduserrr/webserv/blob/main/src/Logger.cpp"
click node_mime "https://github.com/enduserrr/webserv/blob/main/src/Types.cpp"

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_config_file,node_main,node_config_parser,node_server_config toneBlue
class node_server_loop,node_sessions toneAmber
class node_http_parser,node_request,node_router,node_methods,node_operator toneMint
class node_static,node_cgi,node_uploads toneRose
class node_site_content,node_cgi_scripts,node_error_pages,node_logger,node_mime toneIndigo
```

## Components

### Startup and Configuration

- [Server Config](https://github.com/enduserrr/webserv/blob/main/config/default.conf): `config/default.conf`
- [Program Entry](https://github.com/enduserrr/webserv/blob/main/src/main.cpp): `src/main.cpp`
- [Config Parser](https://github.com/enduserrr/webserv/blob/main/src/ConfParser.cpp): `src/ConfParser.cpp`
- [Virtual Server Config](https://github.com/enduserrr/webserv/blob/main/src/ServerBlock.cpp): `src/ServerBlock.cpp`

### Connection Runtime

- [Poll Server Loop](https://github.com/enduserrr/webserv/blob/main/src/ServerLoop.cpp): `src/ServerLoop.cpp`
- [Client Sessions](https://github.com/enduserrr/webserv/blob/main/src/ClientSession.cpp): `src/ClientSession.cpp`

### HTTP Processing

- [HTTP Parser](https://github.com/enduserrr/webserv/blob/main/src/HttpParser.cpp): `src/HttpParser.cpp`
- [Request Context](https://github.com/enduserrr/webserv/blob/main/src/HttpRequest.cpp): `src/HttpRequest.cpp`
- [Request Router](https://github.com/enduserrr/webserv/blob/main/src/Router.cpp): `src/Router.cpp`
- [Method Handling](https://github.com/enduserrr/webserv/blob/main/src/Methods.cpp): `src/Methods.cpp`

### Response Services

- [Static Content](https://github.com/enduserrr/webserv/blob/main/src/StaticHandler.cpp): `src/StaticHandler.cpp`
- [CGI Execution](https://github.com/enduserrr/webserv/blob/main/src/CgiHandler.cpp): `src/CgiHandler.cpp`
- [Upload Handling](https://github.com/enduserrr/webserv/blob/main/src/UploadHandler.cpp): `src/UploadHandler.cpp`

### Content and Errors

- [Web Content](https://github.com/enduserrr/webserv/tree/main/www): `www`
- [CGI Scripts](https://github.com/enduserrr/webserv/tree/main/www/cgi-bin): `www/cgi-bin`
- [Error Pages](https://github.com/enduserrr/webserv/tree/main/www/error_pages): `www/error_pages`
- [Logging and Errors](https://github.com/enduserrr/webserv/blob/main/src/Logger.cpp): `src/Logger.cpp`
- [MIME Types](https://github.com/enduserrr/webserv/blob/main/src/Types.cpp): `src/Types.cpp`

### Other components

- **Server Operator**

## Connections

- Server Operator → Server Config: provides settings (evidence: `README.md`)
- Server Operator → Program Entry: starts server (evidence: `README.md`)
- Program Entry → Config Parser: loads configuration (evidence: `src/main.cpp`)
- Program Entry → Poll Server Loop: starts runtime (evidence: `src/main.cpp`)
- Config Parser → Virtual Server Config: builds server blocks (evidence: `src/ConfParser.cpp`)
- Poll Server Loop → Virtual Server Config: uses configuration (evidence: `src/ServerLoop.cpp`)
- Poll Server Loop → Client Sessions: tracks clients
- Poll Server Loop → HTTP Parser: parses requests (evidence: `src/ServerLoop.cpp`)
- HTTP Parser → Request Context: populates request
- Poll Server Loop → Request Router: routes requests (evidence: `src/ServerLoop.cpp`)
- Request Router → Static Content: dispatches static
- Request Router → CGI Execution: dispatches CGI
- Static Content → Web Content: serves files (evidence: `README.md`)
- Request Router → Method Handling: selects methods
- Method Handling → Upload Handling: handles uploads (evidence: `README.md`)
- Method Handling → Web Content: deletes resources (evidence: `README.md`)
- CGI Execution → CGI Scripts: executes scripts (evidence: `README.md`)
- CGI Execution → Request Context: reads request data
- Logging and Errors → Error Pages: loads error content (evidence: `README.md`)
- Static Content → MIME Types: uses content types
