Schemer: Basisvariablen-Zuordnung für abgeleitete Variablen veröffentlichen

[jurei733]

Triage-Stand vom 26.05.2026

Der ursprüngliche Zuschnitt als explizites Replay-Ziel bzw. Replay-Anker im Coding-Schema ist nach der Diskussion nicht mehr der bevorzugte Weg.

Der Schemer soll möglichst kein Player-Wissen speichern, also keine Seite, DOM-Position oder Player-spezifischen Anker als zentrale Replay-Adresse. Stattdessen soll er fachlich veröffentlichen, welche Basisvariablen zu einer abgeleiteten Variable gehören. Der Player bzw. Host kann diese Information dann mit seiner eigenen Player-Konfiguration auf sichtbare Elemente, Seiten, Scrollpositionen oder Hervorhebungen abbilden.

Ziel

Für abgeleitete Variablen soll aus dem Schemer heraus klar verfügbar sein, welche Basisvariablen bzw. sichtbaren Quellvariablen fachlich zu dieser abgeleiteten Variable gehören.

Vorgeschlagener Scope

• Kein neues Feld replayAnchor/anchor in VariableCodingData einführen.
• Die bestehende page-Angabe nicht zur zentralen Replay-Adressierung ausbauen.
• Eine Zuordnung veröffentlichen: abgeleitete Variable -> beteiligte Basisvariablen.
• Die Information über das Schemer-Interface bereitstellen, z. B. in vosSchemeChangedNotification oder einer abgestimmten Erweiterung des Schemer-Kontrakts.
• Bestehende Kodierschemata bleiben kompatibel.
• Die eigentliche Anzeige, Seitenauswahl, Scrollposition und Hervorhebung bleiben Aufgabe von Player/Host.

Akzeptanzkriterien

• Für jede abgeleitete Variable kann der Host erkennen, welche Basisvariablen an ihr beteiligt sind.
• Die Information wird im Schemer-Interface stabil veröffentlicht und ist für Player/Host auswertbar.
• Bestehende Kodierschemata ohne diese zusätzliche Information bleiben lad- und speicherbar.
• Der Schemer speichert keine Player-spezifischen Replay-Anker im Coding-Schema.
• Tests decken Laden, Ableiten und Veröffentlichen der Zuordnung ab.

Abhängigkeiten / verwandte Tickets

• Schemer-Interface: Basisvariablen zu abgeleiteten Variablen in vosSchemeChangedNotification liefern verona-interfaces/schemer#4
• Player-Interface: playerConfig um Variablen-Hervorhebung und reduzierte Variablenanzeige erweitern verona-interfaces/player#10
• Aspect-Implementierung: Player-seitige Hervorhebung und reduzierte Anzeige für Variablen unterstützen verona-modules-aspect#1042
• Coding-Box-Integration: Replay-Ziel von Kodier-Variable entkoppeln coding-box#502
• Cross-Repo-Rollout: Cross-Repo-Rollout: Replay-Ziele für abgeleitete Variablen coding-box#503

[schumaki]

Im Schemer ein Eingabefeld bzw. eine Auswahl für das Replay-Ziel anbieten.

Auswahl fände ich besser, da (fehler)sicherer -- man müsste nur sicherstellen, dass alle relevanten Seiten (z. B. auch dauerhaft sichtbare Seiten bei z. B. Markieritems) mit zur Auswahl stehen

Default-Vorschläge:

• Basisvariable: eigener Alias bzw. eigene ID als Replay-Ziel.
• Abgeleitete Variable mit genau einer sichtbaren Quellvariable: diese Quellvariable vorschlagen.
• Abgeleitete Variable mit mehreren Quellen oder ohne eindeutige Quelle: explizite Auswahl verlangen oder Warnung anzeigen.

Finde ich gut als Default!

Da müsste man ggf. nochmal schauen, was im zweiten Fall (Abgeleitete Variable mit genau einer sichtbaren Quellvariable) passiert, wenn sich die Quellvariable ändert -- wird dann der Default automatisch angepasst, oder so gelassen wie davor, oder kommt eine Warnmeldung? --> ggf. dazu noch ein Akzeptanzkriterium formulieren

• Die bestehende Seitenangabe bleibt kompatibel.

Welchen Zweck hat diese Angabe im neuen System? In welchen Fällen würden sich Seitenangabe und Replay-Ziel unterscheiden?

[jurei733]

Nach dem aktuellen Diskussionsstand würde ich diesen Issue nicht mehr als „Replay-Anker im Coding-Schema erfassen“ zuschneiden.

Der Schemer sollte aus meiner Sicht nicht speichern müssen, welche Seite oder welcher DOM-/Player-Anker für das Replay anzuspringen ist. Das wäre wieder Player-Wissen im Coding-Schema. Stattdessen sollte der Schemer nur die fachliche Information liefern, welche Basisvariablen zu einer abgeleiteten Variable gehören.

Konkreter Vorschlag für diesen Issue:

• Kein neues Feld replayAnchor/anchor in VariableCodingData.
• Die bestehende page-Angabe sollte nicht weiter zur zentralen Replay-Adressierung ausgebaut werden.
• Neu benötigt wird eine einfache Zuordnung:
  • abgeleitete Variable -> beteiligte Basisvariablen
• Diese Information sollte über das Schemer-Interface veröffentlicht werden, z. B. als neue Property in vosSchemeChangedNotification.
• Die eigentliche Anzeige, Seitenauswahl, Scrollposition und Hervorhebung übernimmt der Player über eine neue playerConfig.

Damit bleibt das Coding-Schema fachlich und der Player bleibt zuständig für die Darstellung der Unit.

Dazu passend habe ich die Spezifikations-/Implementierungs-Issues aufgeteilt:

• Schemer-Interface: Basisvariablen zu abgeleiteten Variablen in vosSchemeChangedNotification liefern verona-interfaces/schemer#4
• Player-Interface: playerConfig um Variablen-Hervorhebung und reduzierte Variablenanzeige erweitern verona-interfaces/player#10
• Aspect-Implementierung: Player-seitige Hervorhebung und reduzierte Anzeige für Variablen unterstützen verona-modules-aspect#1042