Dépannage

La page ne répond pas

1. Vérifiez le port : 2502 pour Docker, 2499 pour Vite.
2. Contrôlez le conteneur :

docker compose ps
docker compose logs --tail 100 astroguide

3. Le healthcheck interroge http://127.0.0.1:8080/ à l'intérieur du conteneur. Un échec healthy indique Nginx, pas votre navigateur.

Écran noir ou scène 3D absente

• WebGL doit être disponible ;
• un bloqueur agressif peut casser les modules ;
• hors vue 3D, le rendu est volontairement arrêté : revenez à l'exploration 3D.

L'avertissement THREE.Clock dans la console est connu et n'est pas, à lui seul, une panne.

docker compose up échoue

• port hôte déjà pris : changez 2502:8080 en 8088:8080 ;
• lockfile ou npm ci --include=optional manquant lors d'un build local ;
• droits insuffisants pour lancer Docker.

La démo n'affiche pas l'accueil

Vous êtes probablement sur le produit normal (npm run dev ou image GHCR). Le badge et l'accueil n'existent que dans dev:demo / build:demo.

Qualité du checkout

npm run check
npm audit --audit-level=high