Codebase guide

Package map

Package	Layer	Purpose
`internal/server`	L1	HTTP/1.1 (`fasthttp`), TLS, route matching
`internal/storage`	L2	Hot store, warm tier, WAL, SIEVE
`internal/cache`	L3	RFC 9111 state machine and handler
`internal/origin`	L4	Upstream pools, health checks, origin clients
`internal/cluster`	L5	memberlist gossip, hash ring, peer fetch
`internal/admin`	L6	Admin HTTP API
`internal/observability`	L7	Metrics, logs, access log

| pkg/api | public | Wire types shared by SDK and admin | | pkg/bouineapi | public | Go SDK |

Good first tasks

Add an admin API test.
Add a cache engine table case.
Improve a runbook page.
Add a benchmark for a hot path before changing it.

Before changing cache behavior

Add a unit test in internal/cache.
Run make conformance.
Run make bench if the change touches hit-path code.
Update docs if operator-visible behavior changes.

Edit this page on GitHub

Prev

Next

从 Varnish 迁移