Fehlerbehebung

Die Seite antwortet nicht

1. Prüfe den Port: 2502 für Docker, 2499 für Vite.
2. Untersuche den Container:

docker compose ps
docker compose logs --tail 100 astroguide

3. Der Healthcheck ruft http://127.0.0.1:2502/ innerhalb des Containers auf. Ein Fehlschlag weist auf Nginx, nicht auf den Browser.

Schwarzer Bildschirm oder fehlende 3D-Szene

• WebGL muss verfügbar sein;
• ein aggressiver Inhaltsblocker kann Module stören;
• außerhalb der 3D-Ansicht stoppt das Rendering absichtlich: wechsle zurück zur 3D-Erkundung.

Die Konsolenwarnung zu THREE.Clock ist bekannt und allein kein Fehler.

docker compose up schlägt fehl

• Host-Port belegt: Ändere nur den linken Host-Port und behalte rechts den Projekt-Port bei;
• fehlendes Lockfile oder fehlendes npm ci --include=optional beim lokalen Build;
• unzureichende Berechtigung zum Starten von Docker.

Die Demo zeigt keine Startseite

Wahrscheinlich läuft das normale Produkt (npm run dev oder das GHCR-Image). Kennzeichnung und Startseite existieren nur in dev:demo und build:demo.

Qualität des Checkouts

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