# geektutu/7days-golang architecture

> Architecture diagram of the GitHub repository geektutu/7days-golang, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/geektutu/7days-golang
- Repository: https://github.com/geektutu/7days-golang

## Overview

This repository is a collection of small Go implementations, not one application. Its principal user-facing flows are HTTP requests through Gee, cache lookups through GeeCache, ORM operations against SQL databases, and RPC calls through GeeRPC. The README also documents WebAssembly demos; the tree contains Gee-Bolt examples as well. Most implementation detail is unsampled, so links between those subsystems are limited to documented capabilities or the shown cache example.

Main entry points: [`gee-cache/day7-proto-buf/geecache/geecache.go`](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/geecache.go) (Cache group), [`gee-orm/day7-migrate/session/record.go`](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/session/record.go) (Session operations), [`gee-rpc/day7-registry/server.go`](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/server.go) (RPC server), [`gee-web/day7-panic-recover/gee/gee.go`](https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/gee.go) (HTTP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Gee Web"]
  node_gee_entry["HTTP server<br/>[gee.go]"]
  node_gee_router["Trie router<br/>[router.go]"]
  node_gee_context["Request context<br/>[context.go]"]
  node_gee_middleware["Middleware and recovery<br/>[recovery.go]"]
  node_gee_templates["Template support<br/>[gee.go]"]
end

subgraph group_cache["GeeCache"]
  node_cache_api["Cache API<br/>[main.go]"]
  node_cache_group["Cache group<br/>[geecache.go]"]
  node_cache_lru[("LRU storage<br/>[lru.go]")]
  node_cache_peers["Peer selection<br/>[consistenthash.go]"]
  node_cache_transport["Peer transport<br/>[http.go]"]
  node_cache_codec["Protobuf protocol<br/>[geecachepb.proto]"]
  node_cache_flight["Request coalescing<br/>[singleflight.go]"]
  node_cache_source[("Backing data getter<br/>[main.go]")]
end

subgraph group_orm["GeeORM"]
  node_orm_api["ORM entry point<br/>[geeorm.go]"]
  node_orm_session["Session operations<br/>[record.go]"]
  node_orm_schema["Schema mapping<br/>[schema.go]"]
  node_orm_clause["SQL clauses<br/>[generator.go]"]
  node_orm_tx["Transactions<br/>[transaction.go]"]
  node_orm_migrate["Database migration<br/>[geeorm.go]"]
end

subgraph group_rpc["GeeRPC"]
  node_rpc_client["RPC client<br/>[client.go]"]
  node_rpc_discovery["Discovery and balancing<br/>[xclient.go]"]
  node_rpc_registry[("Service registry<br/>[registry.go]")]
  node_rpc_server["RPC server<br/>[server.go]"]
  node_rpc_service["Service registration<br/>[service.go]"]
  node_rpc_codec["Message codec<br/>[codec.go]"]
  node_rpc_http["HTTP transport<br/>[server.go]"]
end

subgraph group_wasm["WebAssembly Demos"]
  node_wasm_hello["Hello World demo<br/>[main.go]"]
  node_wasm_functions["Register functions demo<br/>[main.go]"]
  node_wasm_dom["DOM manipulation demo<br/>[main.go]"]
  node_wasm_callback["Callback demo<br/>[main.go]"]
end

subgraph group_bolt["Gee Bolt"]
  node_bolt_pages[("Page storage<br/>[page.go]")]
end

node_browser(("HTTP client"))
node_sql_db[("SQL database")]
node_rpc_actor(("RPC caller"))

node_browser -->|"sends request"| node_gee_entry
node_gee_entry -->|"routes request"| node_gee_router
node_gee_router -->|"dispatches handler"| node_gee_context
node_gee_context -->|"runs middleware"| node_gee_middleware
node_gee_entry -.->|"renders templates"| node_gee_templates
node_browser -->|"requests key"| node_cache_api
node_cache_api -->|"gets value"| node_cache_group
node_cache_group -.->|"stores entries"| node_cache_lru
node_cache_group -.->|"selects peer"| node_cache_peers
node_cache_group -.->|"fetches remotely"| node_cache_transport
node_cache_transport -.->|"encodes messages"| node_cache_codec
node_cache_group -.->|"coalesces requests"| node_cache_flight
node_cache_group -->|"loads misses"| node_cache_source
node_cache_api -->|"returns value"| node_browser
node_rpc_actor -->|"invokes method"| node_rpc_client
node_rpc_client -.->|"selects endpoint"| node_rpc_discovery
node_rpc_discovery -.->|"queries services"| node_rpc_registry
node_rpc_client -.->|"sends call"| node_rpc_server
node_rpc_server -->|"dispatches method"| node_rpc_service
node_rpc_server -->|"reads and writes"| node_rpc_codec
node_rpc_server -->|"serves HTTP transport"| node_rpc_http
node_orm_api -.->|"runs operations"| node_orm_session
node_orm_session -.->|"maps records"| node_orm_schema
node_orm_session -.->|"builds SQL"| node_orm_clause
node_orm_session -.->|"runs transactions"| node_orm_tx
node_orm_api -.->|"migrates schema"| node_orm_migrate
node_orm_session -.->|"executes queries"| node_sql_db

click node_gee_entry "https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/gee.go"
click node_gee_router "https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/router.go"
click node_gee_context "https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/context.go"
click node_gee_middleware "https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/recovery.go"
click node_gee_templates "https://github.com/geektutu/7days-golang/blob/master/gee-web/day6-template/gee/gee.go"
click node_cache_api "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/main.go"
click node_cache_group "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/geecache.go"
click node_cache_lru "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/lru/lru.go"
click node_cache_peers "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go"
click node_cache_transport "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/http.go"
click node_cache_codec "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto"
click node_cache_flight "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go"
click node_cache_source "https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/main.go"
click node_orm_api "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/geeorm.go"
click node_orm_session "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/session/record.go"
click node_orm_schema "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/schema/schema.go"
click node_orm_clause "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/clause/generator.go"
click node_orm_tx "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/session/transaction.go"
click node_orm_migrate "https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/geeorm.go"
click node_rpc_client "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/client.go"
click node_rpc_discovery "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/xclient/xclient.go"
click node_rpc_registry "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/registry/registry.go"
click node_rpc_server "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/server.go"
click node_rpc_service "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/service.go"
click node_rpc_codec "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/codec/codec.go"
click node_rpc_http "https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/server.go"
click node_wasm_hello "https://github.com/geektutu/7days-golang/blob/master/demo-wasm/hello-world/main.go"
click node_wasm_functions "https://github.com/geektutu/7days-golang/blob/master/demo-wasm/register-functions/main.go"
click node_wasm_dom "https://github.com/geektutu/7days-golang/blob/master/demo-wasm/manipulate-dom/main.go"
click node_wasm_callback "https://github.com/geektutu/7days-golang/blob/master/demo-wasm/callback/main.go"
click node_bolt_pages "https://github.com/geektutu/7days-golang/blob/master/gee-bolt/day3-tree/page.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_gee_entry,node_gee_router,node_gee_context,node_gee_middleware,node_gee_templates,node_browser toneBlue
class node_cache_api,node_cache_group,node_cache_lru,node_cache_peers,node_cache_transport,node_cache_codec,node_cache_flight,node_cache_source,node_sql_db toneAmber
class node_orm_api,node_orm_session,node_orm_schema,node_orm_clause,node_orm_tx,node_orm_migrate toneMint
class node_rpc_client,node_rpc_discovery,node_rpc_registry,node_rpc_server,node_rpc_service,node_rpc_codec,node_rpc_http toneRose
class node_wasm_hello,node_wasm_functions,node_wasm_dom,node_wasm_callback,node_rpc_actor toneIndigo
class node_bolt_pages toneTeal
```

## Components

### Gee Web

- [HTTP server](https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/gee.go): `gee-web/day7-panic-recover/gee/gee.go`
- [Trie router](https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/router.go): `gee-web/day7-panic-recover/gee/router.go`
- [Request context](https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/context.go): `gee-web/day7-panic-recover/gee/context.go`
- [Middleware and recovery](https://github.com/geektutu/7days-golang/blob/master/gee-web/day7-panic-recover/gee/recovery.go): `gee-web/day7-panic-recover/gee/recovery.go`
- [Template support](https://github.com/geektutu/7days-golang/blob/master/gee-web/day6-template/gee/gee.go): `gee-web/day6-template/gee/gee.go`

### GeeCache

- [Cache API](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/main.go): `gee-cache/day7-proto-buf/main.go`
- [Cache group](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/geecache.go): `gee-cache/day7-proto-buf/geecache/geecache.go`
- [LRU storage](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/lru/lru.go): `gee-cache/day7-proto-buf/geecache/lru/lru.go`
- [Peer selection](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go): `gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go`
- [Peer transport](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/http.go): `gee-cache/day7-proto-buf/geecache/http.go`
- [Protobuf protocol](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto): `gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto`
- [Request coalescing](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go): `gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go`
- [Backing data getter](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf/main.go): `gee-cache/day7-proto-buf/main.go`

### GeeORM

- [ORM entry point](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/geeorm.go): `gee-orm/day7-migrate/geeorm.go`
- [Session operations](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/session/record.go): `gee-orm/day7-migrate/session/record.go`
- [Schema mapping](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/schema/schema.go): `gee-orm/day7-migrate/schema/schema.go`
- [SQL clauses](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/clause/generator.go): `gee-orm/day7-migrate/clause/generator.go`
- [Transactions](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/session/transaction.go): `gee-orm/day7-migrate/session/transaction.go`
- [Database migration](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate/geeorm.go): `gee-orm/day7-migrate/geeorm.go`

### GeeRPC

- [RPC client](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/client.go): `gee-rpc/day7-registry/client.go`
- [Discovery and balancing](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/xclient/xclient.go): `gee-rpc/day7-registry/xclient/xclient.go`
- [Service registry](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/registry/registry.go): `gee-rpc/day7-registry/registry/registry.go`
- [RPC server](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/server.go): `gee-rpc/day7-registry/server.go`
- [Service registration](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/service.go): `gee-rpc/day7-registry/service.go`
- [Message codec](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/codec/codec.go): `gee-rpc/day7-registry/codec/codec.go`
- [HTTP transport](https://github.com/geektutu/7days-golang/blob/master/gee-rpc/day7-registry/server.go): `gee-rpc/day7-registry/server.go`

### WebAssembly Demos

- [Hello World demo](https://github.com/geektutu/7days-golang/blob/master/demo-wasm/hello-world/main.go): `demo-wasm/hello-world/main.go`
- [Register functions demo](https://github.com/geektutu/7days-golang/blob/master/demo-wasm/register-functions/main.go): `demo-wasm/register-functions/main.go`
- [DOM manipulation demo](https://github.com/geektutu/7days-golang/blob/master/demo-wasm/manipulate-dom/main.go): `demo-wasm/manipulate-dom/main.go`
- [Callback demo](https://github.com/geektutu/7days-golang/blob/master/demo-wasm/callback/main.go): `demo-wasm/callback/main.go`

### Gee Bolt

- [Page storage](https://github.com/geektutu/7days-golang/blob/master/gee-bolt/day3-tree/page.go): `gee-bolt/day3-tree/page.go`

### Other components

- **HTTP client**
- **SQL database**
- **RPC caller**

## Connections

- HTTP client → HTTP server: sends request (evidence: `README.md`)
- HTTP server → Trie router: routes request
- Trie router → Request context: dispatches handler
- Request context → Middleware and recovery: runs middleware
- HTTP server → Template support: renders templates (evidence: `README.md`)
- HTTP client → Cache API: requests key (evidence: `gee-cache/day7-proto-buf/main.go`)
- Cache API → Cache group: gets value (evidence: `gee-cache/day7-proto-buf/main.go`)
- Cache group → LRU storage: stores entries (evidence: `README.md`)
- Cache group → Peer selection: selects peer (evidence: `README.md`)
- Cache group → Peer transport: fetches remotely (evidence: `README.md`)
- Peer transport → Protobuf protocol: encodes messages (evidence: `README.md`)
- Cache group → Request coalescing: coalesces requests (evidence: `README.md`)
- Cache group → Backing data getter: loads misses (evidence: `gee-cache/day7-proto-buf/main.go`)
- Cache API → HTTP client: returns value (evidence: `gee-cache/day7-proto-buf/main.go`)
- RPC caller → RPC client: invokes method (evidence: `README.md`)
- RPC client → Discovery and balancing: selects endpoint (evidence: `README.md`)
- Discovery and balancing → Service registry: queries services (evidence: `README.md`)
- RPC client → RPC server: sends call (evidence: `README.md`)
- RPC server → Service registration: dispatches method (evidence: `gee-rpc/day7-registry/server.go`)
- RPC server → Message codec: reads and writes (evidence: `gee-rpc/day7-registry/server.go`)
- RPC server → HTTP transport: serves HTTP transport (evidence: `gee-rpc/day7-registry/server.go`)
- ORM entry point → Session operations: runs operations (evidence: `README.md`)
- Session operations → Schema mapping: maps records (evidence: `README.md`)
- Session operations → SQL clauses: builds SQL (evidence: `README.md`)
- Session operations → Transactions: runs transactions (evidence: `README.md`)
- ORM entry point → Database migration: migrates schema (evidence: `README.md`)
- Session operations → SQL database: executes queries (evidence: `README.md`)
