# anasjwd/webserver architecture

> Architecture diagram of the GitHub repository anasjwd/webserver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anasjwd/webserver
- Repository: https://github.com/anasjwd/webserver

## Overview

##### Project Type and Purpose
- This is a standalone, full-feature HTTP/1.1 web server (“Webserv” / “GEET”) implemented in C++.
- It listens on TCP sockets, parses a custom configuration format, accepts multiple virtual hosts, parses HTTP requests, serves static files, executes CGI scripts, and builds HTTP responses.

##### File Structure
- Top-level entrypoints:
- Webserv.cpp & server_core.cpp: program initialization, argument parsing, setup of the listening socket, main event loop (select()).
- Connection.cpp/hpp: abstraction for client connections.
- conf/: configuration parser and directives
- cfg_parser, tokenizer, grammar rules, DirectiveFactory, individual directive classes (Listen, ServerName, Location, AutoIndex, etc.).
- request/: HTTP request modeling and parsing
- RequestLine, RequestHeaders, RequestBody, FileHandler for multipart/form-data.
- response/: HTTP response construction
- ResponseHandler, CgiHandler, ErrorResponse, FileResponse, DirectoryListing, ReturnHandler, MimeTypes.
- www/: document root, static assets, custom error pages, CGI scripts under cgi-bin/.
- Makefile: build orchestrator.

##### README
- Confirms use of non-blocking sockets with select(), support for GET/POST/DELETE, virtual hosting, chunked transfer, CGI execution, autoindex, MIME detection, and custom error pages.

##### Main Components & Their Interactions
a. Network Layer
- TCP Listener (socket(), bind(), listen())
- Connection Manager (select-based I/O loop)
- Connection objects (Connection.cpp)
b. Configuration Loader
- cfg_parser + DirectiveFactory → in‐memory config model (Servers, Locations, Directives)
c. Request Processing
- RequestParser module (request/srcs):
– Parse request line, headers, body
– Validate method, target, HTTP version
d. Routing & Dispatch
- Virtual Host selector (by “Host” header and listen directives)
- Location matcher (path prefixes, regex)
- Handler resolver (static file vs. directory listing vs. CGI vs. autoindex vs. error pages vs. custom return)
e. Response Generation
- FileResponse for static content
- DirectoryListing for autoindex
- CgiHandler for CGI scripts (fork(), exec(), environment setup)
- ErrorResponse for HTTP error codes
- Chunked encoding if needed
f. Resource Store
- File system under www/
- CGI scripts under www/cgi-bin/
g. Utilities
- MimeTypes lookup, logging (if any), utils for URL decoding, file I/O.

##### Architectural Patterns & Design Principles
- Modular layering: Network → Core Loop → Config → Request → Routing → Handlers → Response
- Factory pattern for directives and possibly for handlers
- Strategy pattern: different response handlers behind a common ResponseHandler interface
- Single-threaded, event-driven: select() loop for multiplexing
- Separation of concerns: parsing, routing, business logic (handlers), I/O

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Network Layer
    subgraph "Network Layer"
        direction TB
        Clients["Clients (Browsers)"]:::external
        TCPListener["TCP Listener\n(socket, bind, listen)"]:::network
        ConnectionManager["Connection Manager\n(select loop)"]:::network
        ConnectionObj["Connection Objects\n(Connection.cpp/hpp)"]:::network
    end

    %% Configuration
    subgraph "Configuration" 
        direction TB
        ConfigParser["Config Parser\n(conf/cfg_parser.cpp/hpp)"]:::config
        DirectiveFactory["Directive Factory\n(conf/DirectiveFactory.cpp)"]:::config
    end

    %% Request Processing
    subgraph "Request Processing"
        direction TB
        RequestParser["Request Parser\n(request parsing modules)"]:::request
    end

    %% Routing & Dispatch
    subgraph "Routing & Dispatch"
        direction TB
        Router["Virtual Host & Location Router"]:::routing
    end

    %% Handlers
    subgraph "Handler Modules"
        direction TB
        StaticFileHandler["Static File Handler"]:::handler
        AutoIndexHandler["AutoIndex Handler"]:::handler
        CgiHandler["CGI Handler"]:::handler
        ErrorHandler["Error Handler"]:::handler
    end

    %% Response Builder
    subgraph "Response Generation"
        direction TB
        ResponseBuilder["Response Builder\n(ResponseHandler)"]:::response
    end

    %% Resources
    subgraph "Resources & OS"
        direction TB
        Filesystem["File System (www/)"]:::resource
        OSCalls["OS System Calls\n(socket, select, fork/exec)"]:::resource
    end

    %% Data Flow
    Clients -->|"HTTP Request"| TCPListener
    TCPListener --> ConnectionManager
    ConnectionManager --> ConnectionObj
    ConnectionManager --> RequestParser
    RequestParser -->|"Parsed Request"| Router
    Router -->|static| StaticFileHandler
    Router -->|autoindex| AutoIndexHandler
    Router -->|cgi| CgiHandler
    Router -->|error| ErrorHandler
    StaticFileHandler --> Filesystem
    AutoIndexHandler --> Filesystem
    CgiHandler --> Filesystem
    CgiHandler --> OSCalls
    ErrorHandler --> Filesystem
    StaticFileHandler --> ResponseBuilder
    AutoIndexHandler --> ResponseBuilder
    CgiHandler --> ResponseBuilder
    ErrorHandler --> ResponseBuilder
    ResponseBuilder --> ConnectionManager
    ConnectionManager --> TCPListener
    TCPListener -->|"HTTP Response"| Clients

    %% Config influences
    ConfigParser --> ConnectionManager
    ConfigParser --> Router
    DirectiveFactory --> ConfigParser

    %% Click Events
    click TCPListener "https://github.com/anasjwd/webserver/blob/main/Webserv.cpp"
    click TCPListener "https://github.com/anasjwd/webserver/blob/main/server_core.cpp"
    click ConnectionManager "https://github.com/anasjwd/webserver/blob/main/Connection.cpp"
    click ConnectionObj "https://github.com/anasjwd/webserver/blob/main/Connection.hpp"
    click ConfigParser "https://github.com/anasjwd/webserver/blob/main/conf/cfg_parser.cpp"
    click DirectiveFactory "https://github.com/anasjwd/webserver/blob/main/conf/DirectiveFactory.cpp"
    click RequestParser "https://github.com/anasjwd/webserver/blob/main/request/incs/RequestLine.hpp"
    click Router "https://github.com/anasjwd/webserver/blob/main/conf/Server.cpp"
    click StaticFileHandler "https://github.com/anasjwd/webserver/blob/main/response/include/FileResponse.hpp"
    click AutoIndexHandler "https://github.com/anasjwd/webserver/blob/main/response/include/DirectoryListing.hpp"
    click CgiHandler "https://github.com/anasjwd/webserver/blob/main/response/include/CgiHandler.hpp"
    click ErrorHandler "https://github.com/anasjwd/webserver/blob/main/response/include/ErrorResponse.hpp"
    click ResponseBuilder "https://github.com/anasjwd/webserver/blob/main/response/include/ResponseHandler.hpp"
    click Filesystem "https://github.com/anasjwd/webserver/tree/main/www/"

    %% Styles
    classDef network fill:#D0E8FF,stroke:#0066CC,color:#003366;
    classDef config fill:#EAD1DC,stroke:#B0005E,color:#660033;
    classDef request fill:#FFF2CC,stroke:#FFD324,color:#B38F00;
    classDef routing fill:#CCF2E0,stroke:#00A868,color:#005032;
    classDef handler fill:#DFFFD6,stroke:#27A500,color:#0A570A;
    classDef response fill:#FFE5CC,stroke:#FF8C00,color:#8C4600;
    classDef resource fill:#FFE4E1,stroke:#FF4500,color:#8B0000;
    classDef external fill:#F2F2F2,stroke:#999999,color:#333333;
```
