---- helper ----

One goroutine owns the map → all mutation is serialized here (no locks needed).

==================== REGISTER (adding routes) ==================== Register is a METHOD on Router (notice the "(r *Router)" receiver) It adds a new ro

Percentile returns the p-th percentile from a slice of durations. p must be between 0 and 100.

The method signature is generated FROM the proto: ctx, *Request -> *Response, error

The unit: pure logic, no I/O — trivially testable.

NewRouter is a CONSTRUCTOR — it creates and returns a new Router We need this because the map inside must be initialized with make() Without make(), t

Register binds method + route -> handler (the dispatch table).

log is a METHOD on BaseHandler — it prints request info It's LOWERCASE → private. Only used internally by handlers.

proto: rpc Chat(stream ChatMessage) returns (stream ChatMessage); ===== SERVER: loop Recv() and Send() on the same stream =====

native -> common format

==================== DISPATCH (finding & running the right handler) ==================== Dispatch is the CORE of routing — it receives a request and:

POLYMORPHISM: Dispatch calls h.Handle(req) without knowing which concrete type h is. Same call, different behaviour per handler.

ONE method, ONE shape of result: all books, sorted.

SERVER: return a typed status, not a bare error string.

===== SERVER: read metadata, respect the inherited deadline =====

Notice: no http.Request, no ResponseWriter, no status codes. You cannot tell from this signature that it serves an API.

proto: rpc ListUsers(ListUsersRequest) returns (stream User); ===== SERVER: receive one req, call stream.Send(...) repeatedly =====

injected, not constructed inside

From Go's standard library net/http/server.go (simplified)

proto: rpc UploadEvents(stream Event) returns (UploadSummary); ===== SERVER: Recv() in a loop, then SendAndClose() once at the end =====

verify signature + expiry; returns the claims if valid

Returns True if a token was acquired, False if rate limited.

---- service + repository (sketched) ----

formatErrors turns validator output into human messages.

Per-IP limiter: 5 requests per second, burst of 10

gracefulShutdown releases resources in REVERSE order of acquisition. Acquired: DB -> jobs -> HTTP server. Released: HTTP -> jobs -> DB.

Store only the HASH of issued keys (like passwords). On each call, hash the presented key and constant-time compare.

==================== PATTERN MATCHING (the URL comparison engine) ==================== match compares a route pattern against an actual URL path and e

match compares "/users/:id" against "/users/123", filling Params.

A "fixture" via t.Cleanup: setup returns the thing + auto-teardown.

Go favors explicit helpers over magic. t.Helper() keeps failure line numbers useful. A "factory" with functional options: specify only the fields that