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

@@ -0,0 +1,26 @@
---
type: Decision
title: Static Nuxt served by the gateway
description: Nuxt is generated to static files and embedded in the gateway image instead of running as its own pod.
tags: [decision, nuxt, go]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Decision
Build with `nuxt generate`, embed the output in the gateway with `go:embed`.
# Why
- One less Deployment, no Node runtime in the cluster.
- One public service, same origin for the site and `/api`, so no CORS.
- The life map can still render from its data file when the live stream fails.
# Cost
Frontend and gateway release together in one image.
# Revisit when
The site needs server-side rendering per request.