Hilfe-System und Erklärvideos im Portal

Kunden übersehen Funktionen, das Portal ist komplex. Das Hilfe-System liefert deshalb Anleitungen: ⓘ-Knöpfe an Karten der Zentrale (nur für uns) und Kunden-Anleitungen im Portal, dazu seit Oktober ein kurzes Erklärvideo je Portalbereich, das in der Hilfe-Leiste (Simki) fest oben über dem Anleitungstext sitzt. Die Videos selbst entstehen im Videostudio (siehe erklaervideo-studio).

• Hilfe-System v1 live seit 20.08.2026 (Hub v0.216.0): Markdown unter hub/hilfe/<schluessel>.{admin,kunde}.md, Zentrale-Modal über /api/hilfe/<schluessel>, Portal über /portal/hilfe/<schluessel> (liefert nur .kunde.md).
• 14.09.: „Kurz erklärt“ auf jeder Portalseite und 13 Kunden-Anleitungen (v0.297.6), Hilfe als seitliche Leiste (v0.297.7/8).
• 09.10.: Serie von 16 Erklärvideos komplett und live (Willkommen plus 15 Bereiche), 45 bis 74 s, dunkel, Peter Stern als Stimme, echtes SimGym-Portal mit Beispieldaten. Kosten rund 1.540 ElevenLabs-Credits, 0 Bild-Credits.
• 10.10. (v0.375.0, Commit 8fb8a90): Videos in der Hilfe-Leiste als fester Block .phlf-video unter dem scrollenden Anleitungstext, mit Poster und Abspielknopf, am Handy als schmale Zeile. Inzwischen live (Hub stand am 11.10. auf v0.379.0).
• 11.10. (v0.380.0, Commit d01832e): Videoblock nach oben in die Blase gezogen, Anleitungstext scrollt darunter. Am Desktop (ab 641 px) öffnet der Tipp das Video groß in einem dunklen Fenster in der Bildschirmmitte (.phlf-kino, bis 1040 px breit, Esc, ✕ oder Klick daneben schließt). Am Handy spielt es weiter in der Blase. Alle 16 Videos hängen am passenden Seitenschlüssel. Live seit 11.10. (Deploy #215, René hat den Rollout freigegeben).
• Nicht gebaut: Tracking „gesehen je Konto“, automatisches Overlay beim ersten Login.

• René im SimGym-Portal den Hilfe-Griff öffnen und prüfen: Video oben, Text darunter scrollbar, Klick öffnet das Fenster in der Mitte (v0.380.0 live).
• René Videos ansehen, Go für Hub-Auftrag Tracking (Tabelle „gesehen je Konto“, Audit-Ereignisse) und Overlay beim ersten Login.
• René Push sim-ops (Commit 39e8fcc nicht gepusht, fremde ungepushte Commits davor); Wiki-Push offen.
• René Kunden-Anleitungen einmal quer lesen (Texte der Etappe 1 stammen von Agenten, Stand 14.09., ob inzwischen gelesen: prüfen).
• ich Platzstatus und Bestellungen haben Video, aber keine .kunde.md (Kurztext als Platzhalter), Anleitungen nachschreiben.

• 2026-08-20: Pflege-Regel: Wer eine Zentrale-Karte oder ein Tool baut oder ändert, zieht hub/hilfe/<schluessel>.admin.md im selben Commit nach (und .kunde.md bei Portal-Karten) und setzt data-hilfe="<schluessel>" am <h3> der Karte.
• Harte Trennung: Kunden bekommen nur .kunde.md.
• 2026-10-09: Stil der Videos von René abgenommen (dunkel, Länge, Reihenfolge), Go für die Serie. Nie echte Kundendaten zeigen, nur Beispieldaten.
• Serienschema 5 Absätze, Sprechtext aus der Kunden-Anleitung, Du-Form.
• Videos liegen unter /brand/erklaervideos/portal-<schluessel>.mp4 (uebersicht zeigt willkommen).

1. 11.10.2026
   Video oben in der Blase, Desktop-Fenster in der Bildschirmmitte, Hub v0.380.0 (d01832e), live (Deploy #215).
2. 10.10.2026
   Hilfe-Leiste mit Videoblock unten, Hub v0.375.0 (8fb8a90), später ausgerollt.
3. 09.10.2026
   Serie komplett, 16 Videos, sim-ops 39e8fcc (nur erklaervideos/), Info-Mail an service@. Konzept und Prototyp Leads am selben Tag (010d6e2).
4. 14.09.2026
   Kurz erklärt und 13 Kunden-Anleitungen (518bbbf, 7298f8b), Hilfe-Leiste (5dfe901, 567024c).
5. 20.08.2026
   Hilfe-System v1 (Hub v0.216.0, d513dbc), Portal-Fenster verschiebbar (v0.216.1).

• Hilfe-Dateien: /root/sim-ops/hub/hilfe/*.admin.md und *.kunde.md; Code hub/src/hilfeCore.ts, hub/src/hilfe.ts (hilfeVideo()), Leiste portalHilfe() in hub/src/portal.ts.
• Videos und Übersicht: /root/sim-ops/hub/public/brand/erklaervideos/ (videos.json, portal-*.mp4).
• Videoprojekte: /root/motion/portal-<key>-erklaervideo mit PROJEKTSTAND.md; Vorlage /root/motion/_studio/vorlage-portal; Pipeline plan.json, _studio/werkzeug/portal-video.py, lib/portal.js; Lehren in LEHREN.md.
• Wiki: 40-Projekte/Hilfe-System Zentrale und Portal Konzept.md.
• Zentrale: ⓘ-Knöpfe an Karten (Terminquellen, Studio-Software, Leads, Vertrags-Anbieter, Kursplan, Repos u. a.).