docs(okf): write overview, architecture, decisions and roadmap

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:18:32 +02:00
1 parent 987a5efba1
commit 557ac1985b
20 files changed
+750 -16

No files matched your search

+32
View File
@@ -0,0 +1,32 @@
---
type: Decision
title: v1 scope
description: What the first public version keeps and what moves to later phases.
tags: [decision, scope, roadmap]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Keep in v1
- First screen: name, role, contact, PDF CV. Never gated behind interaction.
- Life map with plain-word states and a "Push this chapter" button.
- Story cards with real recovery seconds, lesson cards for failed chapters.
- Live states: Completed, Ready, NotReady, CrashLoopBackOff, restart counts.
- Gateway: SSE plus `/fall` with per-chapter cooldown and global rate limit.
- "Someone just knocked down X" messages. Free, the SSE stream carries them.
- Dev view: the raw event stream in a `<pre>`. Also free.
- CI: Snyk, build, deploy, release-please.
# Cut from v1
| Cut | Why | Where it went |
|---|---|---|
| Separate Nuxt pod | Static build served by the gateway is simpler | [Decision](/decisions/static-nuxt-in-gateway.md) |
| Snapshot persistence, offline banner | Downtime accepted for v1 | [Decision](/decisions/accept-downtime-v1.md) |
| MCP endpoint | Cheap to add later, reuses `/fall` | Phase 2 |
| k6 as a CI gate | Needs a staging target first | Phase 2 |
| Full kubectl-style terminal (YAML, probes) | The raw stream covers it | Phase 2 |
| Interactive k6, HPA demo, latency graph | Most work and most abuse risk | Phase 3 |
| Rolling update as "pivot" | Nothing triggers it yet | Not planned |
| client-go informer | Polling every 2 seconds is enough at about 10 pods | When polling falls short |