docs(okf): add server memory budget and analytics proposal

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Noel SabiaandClaude Opus 5.5 committed 2026-10-11 14:39:54 +02:00
1 parent 64fef83314
commit 261cf17e52
13 files changed
+178 -12

No files matched your search

+23 -10
View File
@@ -13,18 +13,19 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
|---|---|---|
| 1: Ship the CV | 0.1.0 - 1.0.0 | Public interactive CV on the apex domain |
| 2: Depth | 1.1.0 - 1.7.0 | MCP, k6 release gate, full dev terminal, in-browser language model |
| 3: Pressure and from scratch | 1.8.0 - 1.13.0 | Interactive load test with HPA, chat model, own autograd engine |
| 3: Pressure and from scratch | 1.8.0 - 1.13.0 | Tiny interactive load test with HPA, chat model, own autograd engine |
| Release | Name | Days |
|---|---|---|
| 0.1.0 | Chapter service | 1-2 |
| 0.2.0 | Chapters on k3s | 1-2 |
| 0.2.0 | Chapters on k3s | 2 |
| 0.3.0 | Pipeline | 2 |
| 0.4.0 | Live states | 2-3 |
| 0.5.0 | Knockdown | 1-2 |
| 0.6.0 | First screen | 2 |
| 0.7.0 | Life map | 3 |
| 0.8.0 | Story cards and dev view | 2 |
| 0.9.0 | Analytics | 1 |
| 1.0.0 | Real content, launch | 2-3 |
| 1.1.0 | MCP endpoint | 1 |
| 1.2.0 | k6 release gate | 2 |
@@ -43,6 +44,9 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
Each release is cut by release-please from `feat:` commits. A release is done
when its "done when" check passes on the real cluster, not locally.
Everything runs on a 2 vCPU, 4 GB server shared with Gitea. Every release
stays inside the [memory budget](/architecture/server-budget.md).
---
# Phase 1: Ship the CV
@@ -58,16 +62,18 @@ when its "done when" check passes on the real cluster, not locally.
## 0.2.0 Chapters on k3s
- Namespace `cv`, four placeholder chapters: one Job (`complete`), one each of `healthy`, `not-ready`, `crash`.
- 2 GB swap file, k3s installed with traefik and servicelb disabled and kubelet reservations. See [server budget](/architecture/server-budget.md).
- ResourceQuota (384Mi) and LimitRange on namespace `cv`.
- Four placeholder chapters: one Job (`complete`), one each of `healthy`, `not-ready`, `crash`.
- Services with `publishNotReadyAddresses: true`, resource limits, pod label `cv.noelsabia.dev/chapter`.
- Registry pull from Gitea, `kubectl apply -k deploy/`.
- **Done when:** `kubectl get pods -n cv` shows Completed, Running 1/1, Running 0/1 and CrashLoopBackOff, and a `/fall` from a debug pod raises `restartCount`.
- **Learn:** Deployments, Jobs, probes, Services, kustomize.
- **Learn:** Deployments, Jobs, probes, Services, kustomize, resource limits and quotas.
## 0.3.0 Pipeline
- Gitea workflow: `go test`, `snyk test`, build and push images tagged with the git SHA, `kubectl apply -k`.
- Runner kubeconfig limited to namespace `cv`.
- Runner kubeconfig limited to namespace `cv`. Runner capacity 1, so builds never run in parallel.
- **Done when:** a push to `main` deploys a new image without touching the server by hand.
- **Learn:** Gitea Actions, RBAC for CI, Snyk.
@@ -91,7 +97,7 @@ when its "done when" check passes on the real cluster, not locally.
## 0.6.0 First screen
- Nuxt project, `nuxt generate`, multi-stage Dockerfile that embeds the output in the gateway.
- Nuxt project, `nuxt generate` with `NODE_OPTIONS=--max-old-space-size=512`, multi-stage Dockerfile that embeds the output in the gateway.
- Layer 0: name, role, contact, PDF CV download. Navy `#1A3D64` and white.
- **Done when:** the page loads and the PDF downloads with JavaScript disabled.
- **Learn:** Nuxt static generation, `go:embed`, multi-stage builds.
@@ -111,6 +117,12 @@ when its "done when" check passes on the real cluster, not locally.
- Dev view: the raw stream in a `<pre>`.
- **Done when:** two browsers see each other's knockdowns live.
## 0.9.0 Analytics
- GoatCounter in `cv`, 64Mi limit, SQLite on a `local-path` volume. Needs approval, see [decision](/decisions/goatcounter-over-umami.md).
- Count page views, PDF downloads and falls per chapter.
- **Done when:** a test visit, a PDF download and a fall all show up in GoatCounter.
## 1.0.0 Real content and launch
- Final chapter list, one manifest per chapter, story text, final PDF CV.
@@ -147,7 +159,7 @@ when its "done when" check passes on the real cluster, not locally.
## 1.5.0 LM: model and training
- About 5M-parameter transformer, layers written by hand, gradients from PyTorch (needs approval).
- Training run on the home server CPU, checkpoint saved.
- Training runs on Noel's own computer, not the server. Checkpoint saved.
- **Done when:** samples read like short simple stories.
## 1.6.0 LM: browser inference
@@ -166,19 +178,20 @@ when its "done when" check passes on the real cluster, not locally.
## 1.8.0 Interactive k6
- Fixed k6 script run as a Job with the `grafana/k6` image, capped virtual users and duration.
- Fixed k6 script run as a Job with the `grafana/k6` image, a few virtual users, 30 seconds max, 64Mi limit.
- The server is shared with Gitea: if a run slows Gitea noticeably, cut this release.
- One run at a time across the site. No visitor-supplied parameters.
- The gateway needs `create` on Jobs for this, the first write permission it gets. Limit it to this one Job template.
- **Done when:** a second visitor sees "a test is already running".
## 1.9.0 HPA demo
- HPA on one chapter using metrics-server (ships with k3s), live replica count and latency graph during a k6 run.
- HPA on one chapter using metrics-server (ships with k3s), max 3 replicas, live replica count and latency graph during a k6 run.
- **Done when:** replicas go up during a run and back down after.
## 1.10.0 LM: bigger base model
- Retrain the base model at 15-30M parameters. Check training time on the CPU first.
- Retrain the base model at 15-30M parameters on Noel's own computer. Check training time first.
- **Done when:** samples are clearly better than the 5M model.
## 1.11.0 LM: chat fine-tune