Files
OKF_CV_Website/architecture/index.md
T
Noel Sabia f0a9d58cff docs(okf): switch reverse proxy to Caddy across bundle
own-proxy decision, terraform provisioner, system diagram, gateway SSE notes, server-budget comment and roadmap 0.4.0 now use Caddy with ACME-managed TLS instead of nginx plus certbot
2026-10-15 14:44:49 +02:00

1.1 KiB

Architecture

  • System - All runtime components of the v1 site and how a request and a knockdown flow through them.
  • Chapter service - One small Go binary whose health behavior is set by the MODE env var; every life chapter runs it.
  • Gateway - The only public service; serves the static site, streams chapter states over SSE, and forwards rate-limited knockdowns.
  • Frontend - Nuxt site generated to static files and served by the gateway, with three audience layers fed by one SSE stream.
  • Server and memory budget - The CV shares a 2 vCPU, 4 GB server with Gitea and a small webapp, so every workload gets a hard memory cap.
  • Delivery - Gitea Actions on the home server scan, build, push to the Gitea registry, deploy with kubectl, and version with release-please.
  • Terraform provisioning - Terraform rebuilds the server, swap, k3s, Caddy and DNS from nothing; nothing inside the cluster.
  • In-browser language model - A tiny language model trained by Noel that runs entirely in the visitor's browser and shows its internals live.