GeoGraSim Style-Guide (Admin)

🔑 Lizenzen 🧩 Module 🎮 Level 👤 Admins Logout
🎨 Bildstil 🌿 Bild-Farbpalette 🧩 UI-Farbtokens 📊 Leistungs-Skala 🎩 Kopfzeile 📐 Layout & Spacing 🔤 Typografie 🖼️ Bildformate 📱 iPad-Patterns 🗣️ Sprache

Style-Guide

Verbindliche Stil-Referenz für alle GeoGraSim-Module. Klick auf Farbfelder oder „Kopieren" überträgt den Wert in die Zwischenablage. Diese Seite ist die Single-Source-of-Truth — wenn du etwas änderst, musst du es hier auch aktualisieren.

DALL-E / Bildgenerierung

Offizieller Prompt-Block

Verbatim verwenden, NICHT umformulieren. Bei jedem Bild diesen Block voranstellen, danach nur den Szenen-Teil ergänzen.

Flat Scandinavian illustration, wide panoramic landscape filling the entire 16:9 frame edge-to-edge, painted style with clean vector shapes, dark forest green (#1f4b37) and sage green (#4a7c4e) tones, yellow-mustard (#e8c547) accents, beige (#e8e4d8) buildings and valleys, white highlights. No text, no watermark, no logos, no borders, no frame.

Eckdaten

FeldWert
Modelldall-e-3
Splash-Auflösung1792 × 1024 (16:9 panoramisch)
Glossar-Bilder1792 × 1024, standard quality
Avatar-Bilder1024 × 1024, kreisrund maskiert via CSS
FormatPNG
API-KeyOPENAI_API_KEY in App/.env.local (nicht im Git)

Tabu

keine Schrift im Bild keine Logos keine Wasserzeichen keine Rahmen / Borders

Single-Source-of-Truth

Lauffähiger Referenz-Generator: App/sims/logistik/scripts/generate-splash-images.sh (Variable PROMPT_BASE). Bei Pipeline-Fragen dort als Vorlage abschauen.

Why

Konsistenz über alle Module. Die Sims stehen auf der Schülerseite nebeneinander; wenn ein Modul aus dem Stil ausbricht, fällt es sofort auf. Gilt nicht nur für Splashes, sondern auch für Spielfeld-Hintergründe, Sprites, Marker-Icons, Bewertungs-Visuals.

Bild-Farbpalette (verbindlich für DALL-E + Sprites + SVGs)

Klick auf eine Karte kopiert den Hex-Wert.

Forest green#1f4b37
Sage green#4a7c4e
Yellow-mustard#e8c547
Beige#e8e4d8
Weiß-Highlights#ffffff
UI-Farbtokens (CSS-Variablen aus design-system.css)

Diese Tokens nutzen alle Plattform-UIs (Cockpits, Admin, Wrapper, Modale). In Sims als var(--ggs-fjord) referenzieren.

Akzent (Fjord)

--ggs-fjord#4a7c8a
--ggs-fjord-dark#1f4e5a
--ggs-fjord-light#dae8ec

Erfolg (Moss)

--ggs-moss#5a8a5e
--ggs-moss-dark#3a6b3e
--ggs-moss-light#dcead0

Warnung & Fehler

--ggs-orange / warning#e8833a
--ggs-coral / danger#c85c4a
--ggs-coral-light#f0d0ca

Neutral & Sand

--ggs-bg#f5f2eb
--ggs-bg-dark#e8e4d8
--ggs-sand#e8d5b5
--ggs-sand-dark#c4a97a
--ggs-border#e0ddd4

Text

--ggs-text#2a2a2a
--ggs-text-muted#8a8a8a
--ggs-text-light#b0b0b0

Komplette CSS-Variable als Block

--ggs-fjord:        #4a7c8a;
--ggs-fjord-dark:   #1f4e5a;
--ggs-fjord-light:  #dae8ec;
--ggs-moss:         #5a8a5e;
--ggs-moss-dark:    #3a6b3e;
--ggs-moss-light:   #dcead0;
--ggs-sand:         #e8d5b5;
--ggs-sand-dark:    #c4a97a;
--ggs-coral:        #c85c4a;
--ggs-coral-light:  #f0d0ca;
--ggs-orange:       #e8833a;
--ggs-bg:           #f5f2eb;
--ggs-bg-dark:      #e8e4d8;
--ggs-white:        #ffffff;
--ggs-text:         #2a2a2a;
--ggs-text-muted:   #8a8a8a;
--ggs-text-light:   #b0b0b0;
--ggs-border:       #e0ddd4;
--ggs-success:      #5a8a5e;
--ggs-warning:      #e8833a;
--ggs-danger:       #c85c4a;
--ggs-info:         #4a7c8a;
Leistungs-Skala — 5 Stufen (Standard für ALLE Sims)

EINE Skala für Schülerleistung überall im Programm: Prozentwert (0–100) + dünner Balken in der Ampelfarbe. Sterne entfallen. Die Grenzen 50 / 80 / 90 sind zugleich die Triage-Grenzen (ab 90 % „Fordern", ab 80 % „Läuft gut", ab 50 % „Begleiten", darunter „Fördern"), damit Balkenfarbe und Feld immer übereinstimmen. Quelle in Code: pctColor() = _tagTraffic().

≥ 90 %sehr gut  #1f7a3d
90 %
80–89 %gut  #7cb342
80 %
60–79 %solide  #f9c33b
60 %
50–59 %wackelig  #ef8b2c
50 %
< 50 %kritisch  #d8453a
40 %

Triage-Felder (aus % × Fleiß)

< 50 % → Fördern (Hilfe) · 50–79 % → Begleiten · 80–89 % → Läuft gut · ≥ 90 % → Fordern (mehr herausfordern) — jeweils nur, wenn aktiv gearbeitet wurde, sonst „inaktiv".

Fördern Begleiten Läuft gut Fordern inaktiv

CSS-Variablen

--ggs-perf-5: #1f7a3d;  /* ≥ 90 %  sehr gut  */
--ggs-perf-4: #7cb342;  /* 80–89 % gut       */
--ggs-perf-3: #f9c33b;  /* 60–79 % solide    */
--ggs-perf-2: #ef8b2c;  /* 50–59 % wackelig  */
--ggs-perf-1: #d8453a;  /* < 50 %  kritisch  */
/* Triage */
--ggs-triage-foerdern:  #b04a3e;
--ggs-triage-begleiten: #9a6a12;
--ggs-triage-gut:       #3a6b3e;
--ggs-triage-inaktiv:   #8a8a8a;

Vorschau der Zuordnung je Sim: Lehrer-View Parameter-Überblick.

Kopfzeile — Vereinheitlichung (3 Entwürfe)

Eine Standard-Kopfzeile für ALLE Sims: Kreis-Logo (ohne Schriftzug) · 🏠 Home · Sim-Titel + Kontext (Level/Phase) — rechts ⏱ Tempo (nur Echtzeit-Sims) · 🎵 Musik · 🔊 Ton · 🔄 Neustart · ℹ️ Hilfe · 📖 Glossar (target="_blank"). Lehrplan entfällt. Musik überall (Klima-Track als Platzhalter).

Fahre mit der Maus über Entwurf C, um den Halbtransparent-Effekt (voll bei Hover) zu sehen. Die Stufen hinter der Zeile deuten den Sim-Inhalt an — so sieht man, wie viel jede Variante verdeckt.

A — Durchgehend (wie Klimawächter)

Klar abgegrenzter Balken. Sehr eindeutig, verdeckt aber einen festen Streifen des Hauptfensters.

📱 iPad-Landscape (~1024 px)
SIM-INHALT
🌍 KlimawächterLevel 2

B — Schwebend (wie Landwirtschaft) · Atlas-Empfehlung

Einzelne Elemente „schweben" über dem Inhalt. Wirkt leichter, verdeckt weniger, zeigt mehr vom Hauptfenster.

📱 iPad-Landscape (~1024 px)
SIM-INHALT
🌍 KlimawächterLevel 2
🖥️ Full-HD PC (1920 px — mehr Platz zwischen den Elementen)
SIM-INHALT
🌍 KlimawächterLevel 2

C — Schwebend + halbtransparent (voll bei Hover)

Wie B, aber die Elemente sind halbtransparent und werden erst bei Maus-Berührung voll sichtbar — maximaler Blick auf den Inhalt. (Am iPad: „voll" per Antippen.)

📱 iPad-Landscape (~1024 px) — Maus drüber = voll
SIM-INHALT
🌍 KlimawächterLevel 2
Aufbau (alle Varianten gleich): links Kreis-Logo · 🏠 Home · Titel + Kontext — rechts ⏱ Tempo (nur Echtzeit-Sims: Klima, Fluss, Tourismus, Logistik) · 🎵 Musik · 🔊 Ton · 🔄 Neustart · ℹ️ Hilfe · 📖 Glossar (neuer Tab). Sim-eigene KPIs (Budget, Jahr …) bleiben in einer eigenen Unterzeile, nicht in der Markenzeile.
Layout & Spacing
TokenWertVerwendung
--ggs-gap-xs4 pxInline-Abstände, Pill-Padding
--ggs-gap-sm8 pxButton-Innenabstand, Form-Felder
--ggs-gap-md16 pxCard-Innenabstand, Standard-Layout
--ggs-gap-lg24 pxSektion-Abstand
--ggs-gap-xl32 pxHero-Bereiche
--ggs-radius-sm6 pxPills, kleine Buttons
--ggs-radius-md12 pxKarten, Modale
--ggs-radius-lg16 pxHero-Cards, große Modale
--ggs-radius-pill999 pxPills, Avatar-Kreise
--ggs-shadow-sm0 1px 3px rgba(0,0,0,.08)Karten
--ggs-shadow-md0 2px 8px rgba(0,0,0,.12)Modale, schwebende Layers
--ggs-shadow-lg0 4px 16px rgba(0,0,0,.16)Tooltips, Spectator-Banner
Typografie
TokenWert
--ggs-font'Inter', system-ui, -apple-system, sans-serif
--ggs-font-mono'JetBrains Mono', 'Fira Code', monospace

Größenrichtlinien

Bildformate & Pfade
TypMaßePfad
Modul-Card-Image (Cockpit)≈ 800 × 450 (16:9)App/assets/img/sim-NN-<slug>.png
Glossar-Bild1792 × 1024App/assets/img/glossar/<slug>.png
Glossar-SVG (Schemata)vektorApp/assets/img/glossar/<slug>-schema.svg
Splash (Sim-Intro)1792 × 1024App/sims/<slug>/assets/splash-*.png
Avatar (User)1024 × 1024App/assets/img/avatars/avatar-<slug>.png
Logo (SVG)vektorApp/assets/img/geograsim_t.svg

Avatar-Slugs (30 Stück, 3 Gruppen)

iPad-Patterns (Hauptzielgerät: iPad Landscape 1180 × 820)
Sprache (Lernarbeit-Lexikon)

Niemals „spielen / Spiel / Spieler*in" verwenden. GeoGraSim ist Lernarbeit nach Wygotski, kein Spiel.

StattVerwende
spielenarbeiten mit · bearbeiten
SpielSimulation · Modul
Spieler*inBearbeiter*in · Schüler*in
SpielrundeDurchgang
Game OverDurchgang beendet

Ausnahme: in Code-Variablen (state.gameOver, player_progress) ist „game/player" als technischer Begriff unkritisch — Hauptsache an der UI nicht sichtbar.