Architektur

AstroGuide ist eine einzelne Clientanwendung. Es gibt weder Anwendungs-API noch Datenbank oder Authentifizierungsdienst.

Browser
  → React-/Three.js-Anwendung
    → gebündelter Basiskatalog und EN/FR/ES/DE-Übersetzungen
    → statische Texturen und Assets

In der Docker-Produktion:

Nginx ohne Root-Rechte (Port 2502)
  → statische Dateien aus dist/
  → SPA-Fallback auf index.html
  → Sicherheits-Header

Geprüfter Stack

Ebene	Aktuelle Wahl
Oberfläche	React 19, striktes TypeScript
3D-Rendering	Three.js, React Three Fiber, Drei
Zustand	Zustand, nur im Arbeitsspeicher
Übergänge	Motion
Build	Vite 6, Tailwind CSS 4
Container	Node 22 für den Build, Nginx 1.27 Alpine zur Laufzeit
Prüfungen	ESLint, Vitest, `npm run check`

Artefakt	Befehl	Verwendung
Normales Produkt	`npm run build`	Docker, GHCR, lokale Entwicklung
Öffentliche Demo	`npm run build:demo`	ausschließlich Demo-Projekt auf Vercel

Das Dockerfile führt npm run build aus. vercel.json führt npm run build:demo aus. Diese Befehle dürfen nicht vertauscht werden.