SOLVER-Update: Fragmentzugriff und Fallback-Syntax für aktuelle GS-Kodierung

[jurei733]

Ziel

Koordinations-/Tracker-Issue für das kurzfristige SOLVER-Update, damit die aktuelle GS-Kodierung das neue Verhalten möglichst schon nutzen kann.

Dieses Issue ersetzt nicht die bestehenden fachlichen Einzelissues, sondern bündelt das minimale Umsetzungspaket und grenzt nachgelagerte UX-/Komfortthemen ab.

Umsetzungspaket für die aktuelle GS-Kodierung

• Schemer SOLVER: Kodierung von Formeln #141 Fragmentzugriff im Solver unterstützen: ${VAR[i]} greift auf Fragment i der Quellvariable zu.
• SOLVER: Explizite Behandlung leerer Quellwerte/Fragmente konfigurieren #161 Fallback-/Empty-/Non-numeric-Policy im Solver umsetzen und dokumentieren.
• Instruktionen für manuelles Kodieren auch für „falsch - AUTOMATISCH“ #165 Instruktionen für manuelles Kodieren bei falsch - AUTOMATISCH für SOLVER-Variablen ergänzen.

Fachlich bestätigte Semantik

Fragmentzugriff und Abwärtskompatibilität

• ${VAR} bleibt wie bisher und nutzt den kompletten Wert der Quellvariable.
• ${VAR[i]} greift auf Fragment i der Quellvariable zu, z. B. Zähler/Nenner aus einer Formel.
• Ohne Zusatz bleibt das Verhalten konservativ: leer, fehlend oder nicht numerisch auswertbar führt zu DERIVE_ERROR.
• ${VAR} entspricht ${VAR:ERROR:ERROR}.

Fallback-Syntax

• Erstes Element nach dem Doppelpunkt = Verhalten bei leerem/fehlendem Wert.
• Zweites Element nach dem Doppelpunkt = Verhalten bei nicht-numerischem Wert.
• INC ist nur das Kürzel innerhalb des Solver-Ausdrucks.
• INC führt fachlich zu CODING_INCOMPLETE auf der Solver-Variable, analog dazu, dass keine automatische Regel eines Codes greift.
• INC ist keine inhaltliche Falsch-Kodierung.

Beispiele:

• ${VAR:INC:INC}: leer/fehlend und nicht-numerisch führen kontrolliert zu CODING_INCOMPLETE.
• ${VAR:ERROR:INC}: leer/fehlend bleibt Fehler, nicht-numerisch führt kontrolliert zu CODING_INCOMPLETE.
• ${VAR:0:ERROR}: leer/fehlend wird als 0 behandelt, nicht-numerisch bleibt Fehler.
• Allgemein ${VAR:n:ERROR} bzw. ${VAR:n} mit numerischem Wert n: leer/fehlend wird als n behandelt, nicht-numerisch bleibt Fehler.
• ${VAR:n:INC}: leer/fehlend wird als n behandelt, nicht-numerisch führt zu CODING_INCOMPLETE.
• ${VAR:INC:ERROR} bzw. ${VAR:INC}: leer/fehlend führt zu CODING_INCOMPLETE, nicht-numerisch bleibt Fehler.
• ${VAR:ERROR:n}: leer/fehlend bleibt Fehler, nicht-numerisch wird als n behandelt.

UI-Ergänzung für falsch - AUTOMATISCH

Für #165:

• Feld Instruktionen für manuelles Kodieren nur bei SOLVER-Variablen für den automatischen Falsch-Code anzeigen.
• Default: Alle anderen Antworten.
• Tooltip/Hinweis ergänzen, dass INC im Ausdruck für Solver dazu führen kann, dass eine manuelle Instruktion gebraucht wird.
• Bei Nicht-SOLVER-Variablen bleibt das Feld ausgeblendet, damit es dort nicht verwirrt.

Nicht blockierend / später

Diese UX-/Komfortthemen sind sinnvoll, aber nicht Teil des kurzfristigen Minimalpakets für die aktuelle GS-Kodierung:

• Solver-Ausdruck im Dialog mit Beispielwerten testen #162 Solver-Ausdruck im Dialog mit Beispielwerten testen.
• Infobox oder Link zu math.js-Syntaxbeispielen für Solver-Ausdrücke #163 Infobox oder Link zu math.js-Syntaxbeispielen für Solver-Ausdrücke.
• Warnung bei nicht ausgewählten Variablen im Solver-Ausdruck #164 Warnung bei nicht ausgewählten Variablen im Solver-Ausdruck.

Akzeptanzkriterien für dieses Tracker-Issue

• Die für die GS-Kodierung relevanten SOLVER-Änderungen sind in den Einzelissues umgesetzt oder klar als umgesetzt markiert.
• Die bestätigte Semantik ist in SOLVER: Explizite Behandlung leerer Quellwerte/Fragmente konfigurieren #161 dokumentiert.
• Die UI-Ergänzung für manuelle Instruktionen ist in Instruktionen für manuelles Kodieren auch für „falsch - AUTOMATISCH“ #165 dokumentiert bzw. umgesetzt.
• Die UX-/Komfortthemen Solver-Ausdruck im Dialog mit Beispielwerten testen #162–Warnung bei nicht ausgewählten Variablen im Solver-Ausdruck #164 sind als nachgelagert eingeordnet.

[jurei733]

Statusupdate zum Umsetzungspaket:

• Schemer SOLVER: Kodierung von Formeln #141 Fragmentzugriff im Solver ist in iqb-berlin/responses umgesetzt und mit Add solver fragment access responses#87 gemerged.
  • ${VAR} bleibt abwärtskompatibel und nutzt weiterhin den kompletten Wert der Quellvariable.
  • ${VAR[i]} greift auf Fragment i der Quellvariable zu.
  • Leer/fehlend/nicht numerisch bleibt im aktuellen Schritt konservativ DERIVE_ERROR.

Noch offen bzw. nicht Teil von responses#87:

• SOLVER: Explizite Behandlung leerer Quellwerte/Fragmente konfigurieren #161 Fallback-/Empty-/Non-numeric-Policy, also Syntax wie ${VAR:INC:INC} oder ${VAR:0:ERROR}.
• Instruktionen für manuelles Kodieren auch für „falsch - AUTOMATISCH“ #165 UI-Ergänzung für manuelle Instruktionen bei SOLVER-Variablen in coding-components.
• Release von @iqb/responses und anschließender Dependency-Bump in coding-components.

Wichtig: Es wurde noch keine neue @iqb/responses-Version veröffentlicht. Für coding-components ist die Änderung erst nach Release und Dependency-Bump verfügbar.

[jurei733]

Aktueller Stand zum Umsetzungspaket:

• Schemer SOLVER: Kodierung von Formeln #141 Fragmentzugriff im Solver ist in iqb-berlin/responses umgesetzt und mit Add solver fragment access responses#87 gemerged.
• SOLVER: Explizite Behandlung leerer Quellwerte/Fragmente konfigurieren #161 Fallback-/Empty-/Non-numeric-Policy ist in iqb-berlin/responses umgesetzt und mit Support solver placeholder policies responses#88 gemerged.
  • Die bestätigte Semantik ist damit auf responses-Master enthalten, inkl. ${VAR[i]}, ${VAR[i]:n}, ${VAR[i]:INC}, ${VAR[i]:ERROR:n}, ${VAR[i]:n:INC} usw.
• Instruktionen für manuelles Kodieren auch für „falsch - AUTOMATISCH“ #165 UI-Ergänzung für manuelle Instruktionen bei RESIDUAL_AUTO für SOLVER-Variablen ist in coding-components umgesetzt und mit Add manual instructions for automatic residual solver codes #179 gemerged.

Noch offen für die tatsächliche Nutzung in coding-components:

• Es braucht noch eine neue veröffentlichte @iqb/responses-Version, die die Merges aus Add solver fragment access responses#87 und Support solver placeholder policies responses#88 enthält.
• Der aktuell auf npm sichtbare Stand ist weiterhin @iqb/responses@5.1.0 mit gitHead 8b1a3171fd1667319c18c58a457c6f07d0eb0c08 und liegt damit vor den Solver-Merges vom 16.06.2026.
• Danach muss coding-components diese neue Version per Dependency-Bump samt Lockfiles konsumieren.

Damit sind die fachlichen und UI-seitigen Implementierungen gemerged, aber dieses Tracker-Issue sollte aus meiner Sicht offen bleiben, bis Release und Dependency-Bump erledigt sind.