# harshit3011/custom-http-server-go architecture

> Architecture diagram of the GitHub repository harshit3011/custom-http-server-go, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshit3011/custom-http-server-go
- Repository: https://github.com/harshit3011/custom-http-server-go

## Overview

This repository is a small custom HTTP/1.1 server. A client connection is accepted by the server entry point, parsed into a request, dispatched through registered routes and middleware, and written back as an HTTP response; parse failures are converted to error responses at the entry point. The README also documents logging, request IDs, metrics, panic recovery, and graceful shutdown, which are implemented or configured in the sampled entry point and middleware. The server package is an empty placeholder. The graph reflects sampled source and README claims; no separate server-package behavior is shown.

Main entry points: [`cmd/server/main.go`](https://github.com/harshit3011/custom-http-server-go/blob/main/cmd/server/main.go) (Server Entry), [`router/router.go`](https://github.com/harshit3011/custom-http-server-go/blob/main/router/router.go) (Router), [`response/response.go`](https://github.com/harshit3011/custom-http-server-go/blob/main/response/response.go) (Response Writer), [`middleware/middleware.go`](https://github.com/harshit3011/custom-http-server-go/blob/main/middleware/middleware.go) (Middleware Stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Connection Runtime"]
  node_entry["Server Entry<br/>[main.go]"]
  node_httpwire["HTTP Response Output<br/>[main.go]"]
end

subgraph group_protocol["HTTP Parsing"]
  node_parser["Request Parser<br/>[request.go]"]
end

subgraph group_dispatch["Route Dispatch"]
  node_router["Router<br/>[router.go]"]
end

subgraph group_response["Response Handling"]
  node_response["Response Writer<br/>[response.go]"]
end

subgraph group_observability["Middleware"]
  node_middleware["Middleware Stack<br/>[middleware.go]"]
  node_metrics["Request Metrics<br/>[middleware.go]"]
end

node_client(("HTTP Client"))

node_client -->|"opens TCP connection"| node_entry
node_entry -->|"registers routes"| node_router
node_entry -->|"configures middleware"| node_router
node_entry -->|"parses request"| node_parser
node_entry -->|"dispatches request"| node_router
node_router -->|"wraps handler"| node_middleware
node_router -->|"creates response"| node_response
node_middleware -->|"updates response"| node_response
node_entry -->|"formats parse errors"| node_response
node_entry -->|"serializes response"| node_httpwire
node_httpwire -->|"writes HTTP response"| node_client
node_entry -->|"snapshots metrics"| node_metrics

click node_entry "https://github.com/harshit3011/custom-http-server-go/blob/main/cmd/server/main.go"
click node_parser "https://github.com/harshit3011/custom-http-server-go/blob/main/parser/request.go"
click node_router "https://github.com/harshit3011/custom-http-server-go/blob/main/router/router.go"
click node_middleware "https://github.com/harshit3011/custom-http-server-go/blob/main/middleware/middleware.go"
click node_metrics "https://github.com/harshit3011/custom-http-server-go/blob/main/middleware/middleware.go"
click node_response "https://github.com/harshit3011/custom-http-server-go/blob/main/response/response.go"
click node_httpwire "https://github.com/harshit3011/custom-http-server-go/blob/main/cmd/server/main.go"

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_entry,node_httpwire,node_client toneBlue
class node_parser toneAmber
class node_router toneMint
class node_response toneRose
class node_middleware,node_metrics toneIndigo
```

## Components

### Connection Runtime

- [Server Entry](https://github.com/harshit3011/custom-http-server-go/blob/main/cmd/server/main.go): `cmd/server/main.go`
- [HTTP Response Output](https://github.com/harshit3011/custom-http-server-go/blob/main/cmd/server/main.go): `cmd/server/main.go`

### HTTP Parsing

- [Request Parser](https://github.com/harshit3011/custom-http-server-go/blob/main/parser/request.go): `parser/request.go`

### Route Dispatch

- [Router](https://github.com/harshit3011/custom-http-server-go/blob/main/router/router.go): `router/router.go`

### Response Handling

- [Response Writer](https://github.com/harshit3011/custom-http-server-go/blob/main/response/response.go): `response/response.go`

### Middleware

- [Middleware Stack](https://github.com/harshit3011/custom-http-server-go/blob/main/middleware/middleware.go): `middleware/middleware.go`
- [Request Metrics](https://github.com/harshit3011/custom-http-server-go/blob/main/middleware/middleware.go): `middleware/middleware.go`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Server Entry: opens TCP connection (evidence: `cmd/server/main.go`)
- Server Entry → Router: registers routes (evidence: `cmd/server/main.go`)
- Server Entry → Router: configures middleware (evidence: `cmd/server/main.go`)
- Server Entry → Request Parser: parses request (evidence: `cmd/server/main.go`)
- Server Entry → Router: dispatches request (evidence: `cmd/server/main.go`)
- Router → Middleware Stack: wraps handler (evidence: `router/router.go`)
- Router → Response Writer: creates response (evidence: `router/router.go`)
- Middleware Stack → Response Writer: updates response (evidence: `middleware/middleware.go`)
- Server Entry → Response Writer: formats parse errors (evidence: `cmd/server/main.go`)
- Server Entry → HTTP Response Output: serializes response (evidence: `cmd/server/main.go`)
- HTTP Response Output → HTTP Client: writes HTTP response (evidence: `cmd/server/main.go`)
- Server Entry → Request Metrics: snapshots metrics (evidence: `cmd/server/main.go`)
