Files
OKF_CV_Website/architecture/frontend.md
T
Noel SabiaandClaude Opus 5.5 64fef83314 docs(okf): move bundle to repo root and retire brief
The brief is fully captured in the bundle; it stays in git history.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 14:22:03 +02:00

1.5 KiB

type, title, description, tags, status, generated
type title description tags status generated
Frontend Frontend Nuxt site generated to static files and served by the gateway, with three audience layers fed by one SSE stream.
architecture
nuxt
design
stable
by at
claude-code/claude-opus-5-5 2026-10-11T12:15:30Z

Build

nuxt generate produces static, prerendered files. A multi-stage Docker build runs it in a Node stage and copies the output into the gateway's Go stage for go:embed. No Node process runs in the cluster.

Layers

Layer Audience Content Needs live cluster
0: First screen HR Name, role, contact, PDF CV download No
1: Life map Non-technical Chapters in plain words, "Push this chapter", story cards Yes, degrades to static
2: Dev view Developers Raw SSE events in a <pre> Yes

Content

Chapter text (title, dates, story, setback, recovery, lesson) lives in the Nuxt repo as one data file. The key is the chapter name, the same value as the pod label cv.noelsabia.dev/chapter. The gateway knows nothing about stories.

Behavior without the live stream

If /api/events fails, the life map renders from the data file with a small "live cluster offline" note. No error page.

Plain-word states

State Shown as
Completed finished
Running, Ready active
Running, NotReady unfinished
CrashLoopBackOff failed, lesson learned
Restarting after a push recovering

Design

Terminal feel, navy #1A3D64 and white, logo with a "broken pieces" look. Drafted with Stitch prompts.