# babayagaboy/42-webserv architecture

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

## Overview

Webserv is a poll-driven C++98 HTTP server, accompanied by a React file-management demo. The main server workflow is configuration loading, listening and client polling, request parsing/routing, method handling, then response generation; configured routes also enable CGI and upload behavior. The frontend browses, inspects, creates, edits, and deletes files through HTTP requests. Internal control-flow details are limited where source was not sampled; those links are omitted or marked unverified.

Main entry points: [`src/server/ServerConnection.cpp`](https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerConnection.cpp) (Client connections), [`src/app/main.cpp`](https://github.com/babayagaboy/42-webserv/blob/main/src/app/main.cpp) (Webserv), [`src/config/configFile.cpp`](https://github.com/babayagaboy/42-webserv/blob/main/src/config/configFile.cpp) (Config loading), [`src/http/RequestHandlers.cpp`](https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestHandlers.cpp) (Method handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config["Configuration"]
  node_config_read["Config loading<br/>[configFile.cpp]"]
  node_directive_validation["Directive validation<br/>[keyWordsFunc.cpp]"]
  node_server_settings["Server settings<br/>[ServerConf.cpp]"]
  node_location_settings["Route settings<br/>[Location.cpp]"]
end

subgraph group_runtime["Server Runtime"]
  node_webserv["Webserv<br/>[main.cpp]"]
  node_polling["Poll loop<br/>[Server.cpp]"]
  node_connections["Client connections"]
  node_client_state["Client state<br/>[Client.cpp]"]
  node_sessions["Sessions<br/>[ServerSession.cpp]"]
  node_body_read["Request bodies"]
  node_cgi["CGI execution<br/>[ServerCgi.cpp]"]
  node_filesystem[("Served files<br/>[main.cpp]")]
end

subgraph group_http["HTTP Processing"]
  node_request_parse["HTTP parsing<br/>[HTTPrequest.cpp]"]
  node_request_dispatch["Route and method dispatch"]
  node_method_handlers["Method handlers"]
  node_request_support["Request support<br/>[RequestSupport.cpp]"]
  node_response_build["Response building<br/>[ServerResponse.cpp]"]
  node_response_model["HTTP responses<br/>[HTTPresponse.cpp]"]
end

subgraph group_demo["File Manager Demo"]
  node_frontend_app["Frontend routes<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_theme["Theme selection<br/>[ThemeSelector.jsx]"]
  node_files_page["File browser<br/>[Files.jsx]"]
  node_editor_page["File editor<br/>[FileEditor.jsx]"]
  node_method_inspector["Method inspector"]
  node_file_api["File API client<br/>[files.js]"]
  node_file_scripts["File operations<br/>[list_files.py]"]
  node_demo_scripts["Demo scripts<br/>[app.js]"]
end

node_user(("Browser user"))

node_user -->|"uses"| node_frontend_app
node_frontend_app -->|"routes to"| node_files_page
node_frontend_app -->|"routes to"| node_editor_page
node_frontend_app -->|"renders"| node_navbar
node_navbar -->|"renders"| node_theme
node_files_page -->|"calls"| node_file_api
node_editor_page -->|"calls"| node_file_api
node_files_page -->|"renders"| node_method_inspector
node_user -->|"sends requests"| node_webserv
node_webserv -->|"loads config"| node_config_read
node_config_read -.->|"validates directives"| node_directive_validation
node_config_read -.->|"builds settings"| node_server_settings
node_config_read -.->|"builds routes"| node_location_settings
node_webserv -->|"starts runtime"| node_polling
node_polling -->|"polls clients"| node_connections
node_connections -.->|"tracks clients"| node_client_state
node_connections -.->|"receives requests"| node_request_parse
node_connections -.->|"reads bodies"| node_body_read
node_request_parse -->|"dispatches request"| node_request_dispatch
node_request_dispatch -->|"selects method"| node_method_handlers
node_method_handlers -.->|"uses helpers"| node_request_support
node_method_handlers -.->|"serves or changes"| node_filesystem
node_connections -->|"manages sessions"| node_sessions
node_connections -.->|"runs configured CGI"| node_cgi
node_cgi -->|"converts CGI output"| node_response_model
node_method_handlers -.->|"produces response"| node_response_build
node_response_build -.->|"formats response"| node_response_model
node_file_api -.->|"HTTP requests"| node_webserv
node_webserv -.->|"routes requests"| node_file_scripts
node_demo_scripts -.->|"calls scripts"| node_file_scripts

click node_webserv "https://github.com/babayagaboy/42-webserv/blob/main/src/app/main.cpp"
click node_config_read "https://github.com/babayagaboy/42-webserv/blob/main/src/config/configFile.cpp"
click node_directive_validation "https://github.com/babayagaboy/42-webserv/blob/main/src/config/keyWordsFunc.cpp"
click node_server_settings "https://github.com/babayagaboy/42-webserv/blob/main/src/config/ServerConf.cpp"
click node_location_settings "https://github.com/babayagaboy/42-webserv/blob/main/src/config/Location.cpp"
click node_polling "https://github.com/babayagaboy/42-webserv/blob/main/src/server/Server.cpp"
click node_connections "https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerConnection.cpp"
click node_client_state "https://github.com/babayagaboy/42-webserv/blob/main/src/server/Client.cpp"
click node_sessions "https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerSession.cpp"
click node_body_read "https://github.com/babayagaboy/42-webserv/blob/main/src/server/RequestBodyParsing.cpp"
click node_request_parse "https://github.com/babayagaboy/42-webserv/blob/main/src/http/HTTPrequest.cpp"
click node_request_dispatch "https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestDispatch.cpp"
click node_method_handlers "https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestHandlers.cpp"
click node_request_support "https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestSupport.cpp"
click node_cgi "https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerCgi.cpp"
click node_response_build "https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerResponse.cpp"
click node_response_model "https://github.com/babayagaboy/42-webserv/blob/main/src/http/HTTPresponse.cpp"
click node_frontend_app "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/App.jsx"
click node_navbar "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/Navbar.jsx"
click node_theme "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/ThemeSelector.jsx"
click node_files_page "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/pages/Files.jsx"
click node_editor_page "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/pages/FileEditor.jsx"
click node_method_inspector "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/MethodInspector.jsx"
click node_file_api "https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/lib/files.js"
click node_file_scripts "https://github.com/babayagaboy/42-webserv/blob/main/www/simple/bin/list_files.py"
click node_demo_scripts "https://github.com/babayagaboy/42-webserv/blob/main/www/simple/scripts/app.js"
click node_filesystem "https://github.com/babayagaboy/42-webserv/blob/main/www/simple/files/main.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_read,node_directive_validation,node_server_settings,node_location_settings,node_user toneBlue
class node_webserv,node_polling,node_connections,node_client_state,node_sessions,node_body_read,node_cgi,node_filesystem toneAmber
class node_request_parse,node_request_dispatch,node_method_handlers,node_request_support,node_response_build,node_response_model toneMint
class node_frontend_app,node_navbar,node_theme,node_files_page,node_editor_page,node_method_inspector,node_file_api,node_file_scripts,node_demo_scripts toneRose
```

## Components

### Configuration

- [Config loading](https://github.com/babayagaboy/42-webserv/blob/main/src/config/configFile.cpp): `src/config/configFile.cpp`
- [Directive validation](https://github.com/babayagaboy/42-webserv/blob/main/src/config/keyWordsFunc.cpp): `src/config/keyWordsFunc.cpp`
- [Server settings](https://github.com/babayagaboy/42-webserv/blob/main/src/config/ServerConf.cpp): `src/config/ServerConf.cpp`
- [Route settings](https://github.com/babayagaboy/42-webserv/blob/main/src/config/Location.cpp): `src/config/Location.cpp`

### Server Runtime

- [Webserv](https://github.com/babayagaboy/42-webserv/blob/main/src/app/main.cpp): `src/app/main.cpp`
- [Poll loop](https://github.com/babayagaboy/42-webserv/blob/main/src/server/Server.cpp): `src/server/Server.cpp`
- [Client connections](https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerConnection.cpp): `src/server/ServerConnection.cpp`
- [Client state](https://github.com/babayagaboy/42-webserv/blob/main/src/server/Client.cpp): `src/server/Client.cpp`
- [Sessions](https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerSession.cpp): `src/server/ServerSession.cpp`
- [Request bodies](https://github.com/babayagaboy/42-webserv/blob/main/src/server/RequestBodyParsing.cpp): `src/server/RequestBodyParsing.cpp`
- [CGI execution](https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerCgi.cpp): `src/server/ServerCgi.cpp`
- [Served files](https://github.com/babayagaboy/42-webserv/blob/main/www/simple/files/main.cpp): `www/simple/files/main.cpp`

### HTTP Processing

- [HTTP parsing](https://github.com/babayagaboy/42-webserv/blob/main/src/http/HTTPrequest.cpp): `src/http/HTTPrequest.cpp`
- [Route and method dispatch](https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestDispatch.cpp): `src/http/RequestDispatch.cpp`
- [Method handlers](https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestHandlers.cpp): `src/http/RequestHandlers.cpp`
- [Request support](https://github.com/babayagaboy/42-webserv/blob/main/src/http/RequestSupport.cpp): `src/http/RequestSupport.cpp`
- [Response building](https://github.com/babayagaboy/42-webserv/blob/main/src/server/ServerResponse.cpp): `src/server/ServerResponse.cpp`
- [HTTP responses](https://github.com/babayagaboy/42-webserv/blob/main/src/http/HTTPresponse.cpp): `src/http/HTTPresponse.cpp`

### File Manager Demo

- [Frontend routes](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Navigation](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [Theme selection](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/ThemeSelector.jsx): `frontend/src/components/ThemeSelector.jsx`
- [File browser](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/pages/Files.jsx): `frontend/src/pages/Files.jsx`
- [File editor](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/pages/FileEditor.jsx): `frontend/src/pages/FileEditor.jsx`
- [Method inspector](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/components/MethodInspector.jsx): `frontend/src/components/MethodInspector.jsx`
- [File API client](https://github.com/babayagaboy/42-webserv/blob/main/frontend/src/lib/files.js): `frontend/src/lib/files.js`
- [File operations](https://github.com/babayagaboy/42-webserv/blob/main/www/simple/bin/list_files.py): `www/simple/bin/list_files.py`
- [Demo scripts](https://github.com/babayagaboy/42-webserv/blob/main/www/simple/scripts/app.js): `www/simple/scripts/app.js`

### Other components

- **Browser user**

## Connections

- Browser user → Frontend routes: uses (evidence: `frontend/src/App.jsx`)
- Frontend routes → File browser: routes to (evidence: `frontend/src/App.jsx`)
- Frontend routes → File editor: routes to (evidence: `frontend/src/App.jsx`)
- Frontend routes → Navigation: renders (evidence: `frontend/src/App.jsx`)
- Navigation → Theme selection: renders (evidence: `frontend/src/components/Navbar.jsx`)
- File browser → File API client: calls (evidence: `frontend/src/pages/Files.jsx`)
- File editor → File API client: calls (evidence: `frontend/src/pages/FileEditor.jsx`)
- File browser → Method inspector: renders (evidence: `frontend/src/pages/Files.jsx`)
- Browser user → Webserv: sends requests
- Webserv → Config loading: loads config
- Config loading → Directive validation: validates directives
- Config loading → Server settings: builds settings
- Config loading → Route settings: builds routes
- Webserv → Poll loop: starts runtime
- Poll loop → Client connections: polls clients
- Client connections → Client state: tracks clients
- Client connections → HTTP parsing: receives requests
- Client connections → Request bodies: reads bodies
- HTTP parsing → Route and method dispatch: dispatches request
- Route and method dispatch → Method handlers: selects method
- Method handlers → Request support: uses helpers
- Method handlers → Served files: serves or changes
- Client connections → Sessions: manages sessions
- Client connections → CGI execution: runs configured CGI
- CGI execution → HTTP responses: converts CGI output
- Method handlers → Response building: produces response
- Response building → HTTP responses: formats response
- File API client → Webserv: HTTP requests
- Webserv → File operations: routes requests
- Demo scripts → File operations: calls scripts
