# Begriffe & Glossar

<p class="callout info">Schnelles Nachschlagen zentraler Begriffe rund um das scenario.app-Storyboard.</p>

## Grundbegriffe

**Projekt**  
Container für alle Inhalte (Szenen, Medien, Einstellungen) eines Spiels/Erlebnisses.

**Canvas**  
<span style="white-space: pre-wrap;">Arbeitsfläche, auf der du </span>**Szenen**<span style="white-space: pre-wrap;"> als Kacheln platzierst und verbindest.</span>

**Szene (Node)**  
Inhaltseinheit mit Text/Medien/Interaktionen. Hat Ein- und Ausgänge zu anderen Szenen.

**Vorschau**  
Laufzeit-Simulation deines Projekts. Hier testest du Flows, QR/Waypoint, Medien.

**Feature**  
Erweiterter Funktionsbaustein in einer Szene (z. B. Waypoint, Dialog V2, 360°, Embedded Video/Audio).

**Compiler / Runtime**  
Compiler erzeugt das lauffähige Paket (Web/App); Runtime führt die Logik clientseitig aus.

---

## Elemente &amp; Knoten

**Kachel**  
Visuelle Repräsentation einer Szene auf dem Canvas. Doppelklick → Editor.

**Pin / Connector**  
Andockpunkt an der Kachel für Verbindungen (Pfeile) zu Ziel-Szenen.

**Verbindung (Edge)**  
Kante zwischen zwei Szenen. Kann Bedingungen haben (QR, Geo, Inventar, Timer …).

**Startszene**  
Die erste Szene von deinem Szenario muss immer \[\[Start\]\] heißen. Die Szene mit dem Titel \[\[End\]\] beendet das Spiel.

---

## Navigation &amp; Logik

**Button-Weiterleitung**  
Interaktion innerhalb einer Szene, die zu einer Ziel-Szene führt.

**Bedingung**  
Regel, die erfüllt sein muss, damit eine Verbindung aktiv wird (z. B. „QR gescannt“).

**Timer / Delay**  
Zeitbasierte Bedingung. Schaltet erst nach Ablauf X frei oder zeigt Hinweise an.

**Variablen / Flags**  
<span style="white-space: pre-wrap;">Zustände im Spiel (z. B. </span>`<span class="editor-theme-code">hasKey=true</span>`). Steuern Sichtbarkeit/Verlauf.

---

## Ortsbezogene Funktionen

**Waypoint (Geolocation)**  
Erkennt Betreten eines Geo-Radius (lat/lng + Meter). Löst Verzweigungen aus.

**Geofence**  
Der definierte Radius um einen Punkt; innerhalb davon gilt „am Ort“.

**Simulationsposition**  
<span style="white-space: pre-wrap;">Virtuelle Position in der </span>**Vorschau**, um Waypoints ohne GPS vor Ort zu testen.

---

## Codes &amp; Tags

**QR-Code**  
Optischer Code, der beim Scannen eine Verzweigung oder Aktion auslöst.

**NFC-Tag**  
Kontaktloser Tag, der beim Antippen (Gerät) einen Flow triggert.

---

## Medien

**Posterbild**  
Vorschaubild einer Szene (wird in Kachel/Listen angezeigt).

**Embedded Video/Audio**  
Medien, die innerhalb der Szene abgespielt werden (mp4/YouTube; mp3/Wavesurfer).

**Untertitel**  
Zeitbasierte Texte für Audio/Video. Unterstützt Mehrsprachigkeit.

---

## Dialog &amp; 360°

**Dialog V2**  
Sequenzieller Dialog mit Rollen, Avatar, Farben und Verzweigungen.

**Pano360**  
360-Grad-Bild/Scene mit Hotspots. Unterstützt Navigations-/Info-Hotspots.

---

## Gamification &amp; Inventar

**Punkte &amp; Badges**  
Belohnungssystem. Wird beim Abschluss von Aufgaben/Szenen vergeben.

**Inventar (virtuell)**  
Sammelbare Items, die Logik/Verlauf beeinflussen (z. B. Schlüssel, Hinweise).

---

## Internationalisierung (i18n)

**Locale / Sprache**  
Projekt- bzw. Nutzer-Sprache. Inhalte können pro Sprache gepflegt werden.

**Fallback**  
Ersatzsprache, wenn ein Text in der Ziel-Locale fehlt.

---

## Betrieb &amp; Release

**Build / Release**  
Erzeugtes Paket aus dem Compiler, das veröffentlicht/getestet werden kann.

**Debug-Modus**  
Erweiterte Protokolle &amp; UI zum Fehlersuchen in Vorschau/Laufzeit.

**Changelog**  
Dokumentierte Änderungen pro Version (Features, Fixes, Breaking Changes).

---

## Administration

**Rollen &amp; Rechte**  
Zugriffskontrolle für Bearbeiten, Veröffentlichen, Admin-Funktionen.

**Organisation**  
Team/Unternehmen mit Lizenz, Nutzern, Projekten und ggf. Abrechnung.

---

## Abkürzungen

- **QR**<span style="white-space: pre-wrap;"> – Quick Response Code</span>
- **NFC**<span style="white-space: pre-wrap;"> – Near Field Communication</span>
- **GPS**<span style="white-space: pre-wrap;"> – Global Positioning System</span>
- **i18n**<span style="white-space: pre-wrap;"> – Internationalization (Internationalisierung)</span>
- **CI**<span style="white-space: pre-wrap;"> – Corporate Identity (Branding/Design)</span>
- **UX/UI**<span style="white-space: pre-wrap;"> – User Experience / User Interface</span>

---

## Konventionen (Empfehlungen)

- **Szenennamen:**<span style="white-space: pre-wrap;"> kurz &amp; eindeutig, z. B. </span>`<span class="editor-theme-code">Start</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">Bruecke_Nacht</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">Station_01</span>`.
- **Medien:**<span style="white-space: pre-wrap;"> web-optimiert, sprechende Dateinamen (</span>`<span class="editor-theme-code">station01_poster.webp</span>`).
- **Farben/Design:**<span style="white-space: pre-wrap;"> zentral definieren (CI), nicht pro Szene neu erfinden.</span>
- **Verbindungen:**<span style="white-space: pre-wrap;"> lieber </span>**kurze Pfade**<span style="white-space: pre-wrap;"> + häufig testen, statt lange Ketten.</span>

---

## Siehe auch

\[\[Schnellstart\]\] • \[\[Szenen &amp; Storyboard\]\] • \[\[Karten &amp; Wegpunkte\]\] • \[\[Features/Waypoint\]\] • \[\[Features/QR &amp; NFC\]\] • \[\[Hacks &amp; Tipps\]\]