docs(okf): write overview, architecture, decisions and roadmap
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
987a5efba1
commit
557ac1985b
20 files changed
+750
-16
No files matched your search
@@ -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 |
|
||||
Reference in new issue
Block a user