Desarrollo

Arquitectura del código

Mapa de la estructura real del repositorio AstroGuide.

Estructura observada en el repositorio del producto:

AstroGuide/
├── .github/                 # plantillas y workflows de CI / imagen
├── public/                  # logo, captura y texturas
├── src/
│   ├── components/         # vistas 3D, 2D, comparación, demo e interfaz
│   ├── config/             # detección del modo demo
│   ├── data/               # catálogo celeste y pruebas de integridad
│   ├── i18n/               # textos de interfaz y catálogo de idiomas
│   ├── store/              # estado Zustand y pruebas
│   ├── App.tsx
│   ├── index.css
│   └── main.tsx
├── Dockerfile
├── docker-compose.yml
├── nginx.conf
├── vercel.json             # solo build de la demo
└── package.json

DemoExperience solo se renderiza cuando import.meta.env.MODE === 'demo'. El producto normal importa el módulo, pero no muestra ni su insignia ni su bienvenida.

El store Zustand permanece en memoria. resetExploration() restaura la vista 3D, oculta la ficha y vuelve a incluir todos los objetos en la comparación. El idioma se gestiona por separado y se guarda localmente.