# MUTEC – Museumsguide / Dummy-Ausstellung

Stand: 20.10.2026. Einstieg: MUTEC-Hauptmenü → Education → Museumsguide.
Der Guide ist unabhängig vom LED-Counter verfügbar, auch wenn dort ein Film oder Spiel läuft. Das vorhandene MegBes-Ticket bleibt die einzige Besucher-Anmeldung. Der vierstellige Stationscode ist kein Login-Code.

## Bedienung und Beispielinhalte

Eine Einstellungsseite fragt Sprache (Deutsch, Englisch, Französisch), Filmuntertitel und Textgröße ab. Danach öffnet die Code-Eingabe Texte, Hörbeiträge, Bilder oder Umfragen. Die Beispielsammlung verbindet Krieg, Gesellschaft und Erinnerung. Beispielcodes sind auch unter der Code-Eingabe aufklappbar.

| Code | Herkunft | Inhalt |
| --- | --- | --- |
| 1100 | GKP | Unsere Geschichte |
| 1103 | GKP | Frieden |
| 3509 | GKP | Erinnerung |
| 2018 | GKP | Deutschland 1933 – sieben Medienbeiträge |
| 1003 | GKP | Umfrage: Krieg |
| 3004 | GKP | Umfrage: Demokratie, mit Folgefragen |
| 5000 | BAYAM | Krieg und Frieden |
| 5004 | BAYAM | Fotosammlung zum Krieg 1870/71 |
| 5128 | BAYAM | Gerahmte Erinnerung |
| 5455 | BAYAM | Frieden! |
| 5800 | BAYAM | Wehrpflicht und Militarisierung |

Originaltexte, Originalaudios und Quellenangaben bleiben erhalten. Nicht alle Beiträge liegen in allen Sprachen vor; der Guide kennzeichnet die Ersatzsprache. Lokale Audios bieten Start/Pause, Neustart, Fortschrittsregler und Tempo. Keine automatische Übersetzung oder künstliche Stimme.

## JSON-Kompatibilität und neue Inhalte

`data/config.json` enthält die Registrierung `app.stationJsons` wie BAYAM/GKP. Die Original-JSON-Dateien sind unverändert unter `content/gkp/data/` und `content/bayam/data/` kopiert. Unterstützte Typen: `ati`, `pictureStack`, `poll1`, `poll2` einschließlich bedingter Fragen mit `parent`.

Die optionale Ergänzung `app.assetRoots[Stationscode]` legt die Medienbasis fest. Damit bleiben originale Angaben wie `stations/M32/M32-intro-DE.mp3` unverändert und beide Projekte kollidieren nicht. Ohne `assetRoots` gelten Medienpfade relativ zum Guide-Verzeichnis, wie bei den Vorlagen.

Zum Austauschen: JSON und zugehörige Medien ablegen, Eintrag in `stationJsons` ergänzen, ggf. `assetRoots` setzen. Die `MegBes-Nummer` im JSON muss dem vierstelligen Schlüssel entsprechen. `app.title`, `app.theme` und `app.description` bestimmen Ausstellungstitel und Einführung. Texte werden vor der Anzeige von aktiven HTML-Inhalten bereinigt.

## Echte MegBes-Medienstationen

Die importierten IPs sind bewusst **nicht aktiv geschaltet**. `app.defaultPlayerMode` steht auf `demo`; Beispielauswahl und Audio funktionieren ohne UDP oder Belegung eines Players. Echte Geräte werden ausdrücklich in `app.stationBindings` zugeordnet, z. B.:

```json
"stationBindings": {
  "2018": { "mode": "native", "ip": 232 }
}
```

Die tatsächliche Gerätenummer einsetzen; 232 ist nur die Adresse aus der Vorlage. Keine IP aus einem fremden Projekt ungeprüft übernehmen. `defaultPlayerMode: "native"` würde die originalen IP-Felder allgemein aktivieren und ist erst für eine entsprechend vorbereitete Ausstellung sinnvoll.

Der Guide verwendet den gemeinsamen MUTEC-Kunden und `EXTERNAL_SERVER_URL` aus `../js/project-const.js`, nicht den Backend-Kunden der Herkunftsausstellung. Standard-Endpunkte: `/verify`, `/media-station/status/{IP}`, `/media-station`, `/video-command`. Vor Anmeldung muss IDLE oder OPEN gelten, danach wird REMOTE geprüft; ein HTTP 200 allein genügt nicht. Befehle enthalten `prSc` und `statNoCommands`.

Sprach-/Untertiteloptionen entsprechen den Vorlagen, z. B. `232-deno` ohne, `232-dede` mit Untertiteln. Beitragsstart sendet das originale UDP-Feld mit IP-Präfix; Stop `232-stop`, Stationsausstieg `232-exit` und DELETE `/media-station`. Der Player muss diese vorhandenen Ausstellungssignale unterstützen und bei Ende/Timeout IDLE melden. Ein abgelaufenes Ticket kann keine neuen Stationsbefehle senden; ein Stations-Timeout bleibt daher erforderlich.

Für gekoppelte native Beiträge sind Audio-Spulen/Tempo deaktiviert: Das ursprüngliche Protokoll bietet dafür keinen bestätigten gemeinsamen Zeitgeber. Start/Stop/Neustart übernimmt die Vorgehensweise von BAYAM/GKP; exakte laufende A/V-Synchronisation ist damit nicht zugesichert. Der bestehende MUTEC-HTML-Videoplayer bleibt für synchrones Spulen verfügbar. Dieses Guide-Feature setzt keine neue BrightSign-Plugin-Version voraus.

## Umfragen

`poll.php` prüft ein gültiges MegBes-Ticket, den Stationstyp und die erlaubten Antworten einschließlich sichtbarer Folgefragen. Eine Stimme pro Ticket und Station; erneutes Speichern ändert sie. Es werden nur Summen und die eigene Antwort zurückgegeben. Das rohe Ticket wird nicht gespeichert.

Standard: privater Ordner im PHP-Temp-Verzeichnis, Dateirechte 0600. Für dauerhaften Ausstellungsbetrieb `app.privateStorage` auf einen PHP-schreibbaren absoluten Ordner **außerhalb aller Web-Dokumentwurzeln** setzen, sichern und in die Löschroutine der Ausstellung aufnehmen. Temp-Verzeichnisse können vom Hoster geleert werden. PHP 8.1+ mit cURL wird benötigt; Ticketprüfung ist auf HTTPS-Kunden unter *.megbes.de begrenzt und prüft auch die Zurückweisung eines ungültigen Tickets. Beim späteren Wechsel von tine zu messe auch `guide/data/config.json` anpassen.

## Sitzungsübernahme und Installation

Ein erneuter Scan desselben Tickets im selben Browserprofil übernimmt den Guide samt Station, Beitrag und Audio-Position. Der alte Tab beendet seine Audiowiedergabe und zeigt die bestehende Dankeseite. Audio startet im neuen Tab erst durch Berührung. Native Beiträge starten beim nächsten Anhören von vorn, da keine zuverlässige native Seek-Schnittstelle zugesichert ist.

Die Anpassung erweitert ausschließlich Frontend/Guide und den bestehenden Browser-Sitzungsmanager. Kein Relay-, Electron-, BrightSign- oder MegBes-Backend-Update notwendig. Originalprojekte und synced `sources/` bleiben unverändert.


## Bedienung wie BAYAM/GKP (20.10.2026)

Die Code-Eingabe verwendet eine große Bildschirm-Zifferntastatur mit vier Anzeigefeldern, Löschtaste und Weiter-Pfeil. Der Pfeil ist nur bei registrierten Stationsnummern aktiv. Eine physische Tastatur bzw. Einfügen bleibt möglich.

Bei mehreren Hör-/Textbeiträgen erscheinen einzelne Zeilen mit Titel, Dauer und getrennten Aktionen: Play/Stop und Text auf-/zuklappen. Nur ein Text ist aufgeklappt; bei einem einzelnen Beitrag öffnet er sich sofort. Das Lesen eines anderen Textes verändert die laufende Wiedergabe nicht. Ein neuer Hörbeitrag beendet den bisherigen; die Stopptaste setzt ihn an den Anfang zurück. Der Fortschrittsregler erscheint beim Abspielen in der aktiven Beitragszeile.

Einstellungen ändern Sprache/Untertitel innerhalb derselben Station. Ein Sprachwechsel stoppt die aktuelle Wiedergabe; bei nativer Zuordnung bleibt die Gerätebelegung erhalten und die neue Sprachoption wird übertragen. Beim Verlassen einer laufenden Wiedergabe bzw. einer zugeordneten Medienstation wird nachgefragt. Abbrechen erhält Station und Wiedergabe. Erst Bestätigen führt die bisherige Freigabe aus.


## Gestaltung und Beschriftungen nach Vorlage (20.10.2026)

Der Guide verwendet die helle GKP-Gestaltung: Hintergrund #c8cac7, Kopfbereich #adafaa, Tasten #e2e4e3, Akzent #af2421 sowie die mitgelieferten Univers-Regular-/Bold-Schriften. Die Gestaltung ist auf den Museumsguide begrenzt.

Die Beschriftungen in DE/EN stammen aus GKP data/l10n.json; fehlende Einträge sowie Französisch aus BAYAM data/l10n.json. Dazu gehören „Bitte wählen Sie Ihre Optionen“, „Bitte 4-stellige Nummer eingeben“, „Optionen“, „Schriftgröße“, „Weiter“, „Zurück“, „Bleiben / Verlassen“ sowie die Originalfrage beim Verlassen. Sprache und Schriftgröße werden direkt als Auswahl angezeigt, Untertitel mit Ja/Nein. Die Textansicht verwendet das Dokument-Piktogramm der Vorlage. Quellenangaben sind aufklappbar und bleiben erhalten. Kein fremdes Museumslogo wurde übernommen.


## Grundriss, Rundgänge, Quiz und Sammlung (21.10.2026)

Vier Navigationsbereiche: Stationscode, Grundriss, Rundgänge und Meine Sammlung. Der schematische Demo-Grundriss ordnet alle zwölf Stationen drei Themenräumen zu; er bildet keine realen Räume oder Live-Positionen ab. Jede Station ist direkt antippbar.

Highlights: 1100 → 5004 → 5455 (ca. 12 Minuten). Familientour: 5004 → 5455 → 9001 (ca. 10 Minuten). Wegen der Kriegsthematik wird Begleitung empfohlen. Die Familientour nutzt bestehende Inhalte, keine neu verfassten Kinderfassungen. Vor/zurück, Fortsetzen, Besuchsfortschritt und Abschluss sind integriert. Zeitangaben sind redaktionelle Schätzwerte, keine Messung.

9001 ist eine neue Quizstation mit drei Fragen zu Bildquellen, Erinnerung und friedlicher Verständigung. Jede Antwort erhält eine erklärende Auflösung. Wiederholen und Neustart sind möglich. Alle Ergänzungen sind in DE/EN/FR verfügbar. Originaltexte und Quellen bleiben unverändert.

Favoriten, besuchte Stationen, Rundgang und Quizantworten werden lokal pro SHA-256-Hash des Besuchertickets gespeichert. Das rohe Ticket wird nicht in der Sammlung abgelegt. Keine geräteübergreifende Synchronisierung oder Statistikübermittlung. Bei gesperrtem Browser-Speicher bleibt der Zustand für die laufende Seite erhalten. Es wurde kein QR-Direkteinstieg ergänzt.


## Header und Optionen-Menü (22.10.2026)

Hauptauswahl: Media / Edu / Games / Guide. Der Guide hat einen eigenen Reiter und bleibt auch bei belegtem Counter erreichbar. Projektname im Header unter der Marke; „Zur Auswahl“ oben rechts; Optionen immer links unter dem Titel. Navigation und Einstellungen liegen im von links einschiebbaren Menü. Das Burger-Symbol im Menü hat dieselbe Position wie im Seitenheader. Schließen über Burger, Hintergrund, Escape oder Wischen nach links; Öffnen auch mit einer Wischbewegung vom linken Bildschirmrand. Abbrechen der Optionen verändert gespeicherte Einstellungen und laufende Medien nicht. Weiter übernimmt die Optionen wie bisher. Verlassen einer laufenden Station über die Navigation erfordert weiterhin Bestätigung.


## Infokarten und Audio-Text-Elemente (22.10.2026)

Beim Guide-Einstieg erscheinen zwei Infokarten aus den Bedienungshinweisen (Stationsnummern, Audioausgabe/Lautstärke). Hinweise bleiben im Optionen-Menü. Sprache wird im Menü sofort als Vorschau angezeigt; Speichern übernimmt, Schließen verwirft ungespeicherte Änderungen. Stationswechsel setzen die Seite zuverlässig nach oben.

Merken und Zurück teilen sich eine Zeile. Die separate Stationsnummer entfällt. ATI-Reihen: Titel/Laufzeit, Play, Textschalter; darunter der Fortschrittsbalken im gleichen grauen Kasten. Laufzeiten stammen aus Audio-Metadaten, nicht aus Dauer-Feldern. Keine abgelaufene Zeit und keine Tempoauswahl. Native Stationen behalten ihre Spulsperre.

Schematischer Demo-Grundriss mit Raumwänden, Türen und zwölf nummerierten Stationspunkten. Punkt wählen zeigt Stationsname und separaten Öffnen-Button. Keine Behauptung realer Raumpositionen.


## Fortschritt, Umfragen und Rundgangstatus (27.10.2026)

Audiofortschritt ist eine reine Fortschrittsanzeige ohne Seek-Steuerung. Laufzeit nur im Beitragskopf. Play und Textsymbol haben gleiche Höhe; offener Text rot, geschlossener grau. Stationsauswahl im Plan öffnet einen modalen Dialog.

Umfragefragen rendern bereinigtes HTML (z. B. Zeilenumbrüche), Ergebnisse zeigen pro Frage Stimmen/Anteil und Balken. Standard-Speicher ist jetzt dirname(__DIR__,3)/.mutec-guide-private außerhalb der Dokumentwurzel statt PHP-Temp. Vorhandene Temp-Antworten werden beim ersten Zugriff auf eine noch leere Stationsdatei unter Dateisperren kopiert; Originaldateien bleiben erhalten. Bereits gelöschte Antworten können nicht wiederhergestellt werden. Pro Ticket und Station bleibt eine änderbare Antwort gespeichert, nur Ticket-Hash wird abgelegt. Für die Messe ist so eine fortlaufende Demo-Auswertung möglich; ein späterer Veranstaltungsreset ist eine separate bewusste Aktion.

Ein aktiver Rundgang zeigt auf allen Guide-Seiten einen anhaftenden Status mit Name und Besuchsfortschritt. Manuelle Codes zählen mit, wenn sie zum Rundgang gehören. Fremde Stationen werden als außerhalb markiert; der Rundgang bleibt erhalten. Rückkehr und Verlassen sind jederzeit explizit möglich.


## GKP Das Jahr 1933 (01.11.2026)

Station 2018 ersetzt 2017 in Registrierung, Beispielauswahl und Grundriss. Original-JSON und alle 14 M33-Audios (DE/EN) aus GKP werden unverändert verwendet. Reihenfolge: Einführung, Hitler wird Reichskanzler, Reichstagsbrandverordnung, Tag von Potsdam, Gleichschaltung der Länder, Verfolgung von Juden, Einheit von Partei und Staat. Film1–Film7 an .66, Sprach-/Untertitelendungen und Stop 66-All bleiben gleich. Audio wartet auf canplay und erfolgreiche HTTP-Antwort, bevor es von vorn startet. Veraltete gespeicherte Stationsansichten landen wieder in der Guide-Übersicht; der alte Code wird nicht neu registriert.
