Arquitectura

AstroGuide es una única aplicación cliente. No tiene API de aplicación, base de datos ni servicio de autenticación.

Navegador
  → aplicación React / Three.js
    → catálogo base y traducciones EN/FR/ES/DE incluidos
    → texturas y recursos estáticos

En producción con Docker:

Nginx sin privilegios (puerto 2502)
  → archivos estáticos de dist/
  → fallback SPA hacia index.html
  → cabeceras de seguridad

Stack inspeccionado

Capa	Elección actual
Interfaz	React 19, TypeScript estricto
Renderizado 3D	Three.js, React Three Fiber, Drei
Estado	Zustand, solo en memoria
Transiciones	Motion
Build	Vite 6, Tailwind CSS 4
Contenedor	Node 22 para compilar, Nginx 1.27 Alpine en ejecución
Controles	ESLint, Vitest, `npm run check`

Artefacto	Comando	Uso
Producto normal	`npm run build`	Docker, GHCR, desarrollo local
Demo pública	`npm run build:demo`	solo el proyecto Vercel de la demo

El Dockerfile ejecuta npm run build. vercel.json ejecuta npm run build:demo. No deben intercambiarse.