refactor: Timeline-Labels als eigenes Modell

Das Einsammeln der Labels für die Zeitachse liegt in
`src/whiteboard/view/timeline_label_model.gd`. Die Logik ist subtiler, als sie
aussieht: Sie läuft über die Abschnitte statt über die Wiedergabe-Einträge,
damit Marken ohne Standzeit sichtbar bleiben, und ein Segment ohne eigenes
Label erbt die Beschriftung seiner Elementgruppe.

- `collect(routine)` liefert Element- und Kür-Labels plus Gesamtdauer.
- `_refresh_timeline_labels` ist auf drei Zeilen geschrumpft und setzt nur
  noch die Zeitachse.
- Abgesichert durch die Wiedergabetests, die die Labels der Zeitachse prüfen.

Controller: 8.194 -> 8.154 Zeilen. Suite grün.
This commit is contained in:
torsten 2026-11-13 14:44:45 +01:00
parent a403270643
commit e47b8e0a9a
5 changed files with 76 additions and 48 deletions

View file

@ -4,7 +4,7 @@ Stand: 2026-11-13
Ziel: Der Controller war mit **9.092 Zeilen und 465 Funktionen** der größte
Baustein im Projekt; die Roadmap nennt < 1.500 Zeilen pro Datei. Nach den
Etappen 1–10 sind es 8.194 Zeilen. Diese Notiz
Etappen 1–11 sind es 8.154 Zeilen. Diese Notiz
hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite
passiert und nicht als Big Bang.
@ -37,7 +37,8 @@ passiert und nicht als Big Bang.
| `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 |
| `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ |
| `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ |
| Playback-Rest | Musik, Timeline-Labels, 3D-Anbindung | ~360 | Canvas, Audio | offen |
| `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ |
| Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen |
| `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 |
Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung,
@ -185,6 +186,19 @@ ohne Control-Basis kann in einem HBox nicht sinnvoll Kindknoten aufnehmen.
verschmolzen; die Zeitachse (`timeline_label_lane`) bleibt beim Controller,
weil sie zu den Timeline-Labels gehört.
### 11. `TimelineLabelModel` ✅
Das Einsammeln der Timeline-Labels liegt in
`src/whiteboard/view/timeline_label_model.gd`. Es ist subtiler, als es aussieht:
Es läuft über die Abschnitte (nicht über die Wiedergabe-Einträge), damit
Marken ohne Standzeit sichtbar bleiben, und ein Segment ohne eigenes Label
erbt die Beschriftung seiner Elementgruppe — so wird eine Sequenz einmal
benannt. Abgesichert durch die Wiedergabetests, die die Labels der Zeitachse
prüfen.
**Offen:** der Label-Dialog (Anlegen/Bearbeiten/Löschen) und die Musik
(Laden, Konvertierung, Synchronisation).
## Nächster Durchgang: weitere Node-Schnitte
Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest,

View file

@ -270,10 +270,10 @@ Schritte.
- [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync,
Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500
Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.194 Zeilen; `HelpContent`, `SeasonComparisonText`,
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext`,
`SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel` und
`PlaybackPanel` (Node-Schnitte) ausgelagert.
`SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`,
`PlaybackPanel` und `TimelineLabelModel` ausgelagert.
- [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf,
Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und
`tools/check_export.sh`.

View file

@ -4148,50 +4148,10 @@ func _sort_timeline_labels() -> void:
func _refresh_timeline_labels() -> void:
if timeline_label_lane == null:
return
# Walk the authored routine like the playback timeline does. Using the
# segments directly (instead of only the timed playback entries) also
# keeps element markers with zero stand time visible.
var element_labels: Array[Dictionary] = []
var total := 0.0
if _routine != null:
for section: RoutineSection in _routine.sections:
if section == null:
continue
var group_starts: Dictionary[String, ResolvedElement] = {}
for element: ResolvedElement in section.get_elements():
if not element.segments.is_empty():
group_starts[element.segments[0].segment_id] = element
for segment: PathSegment in section.segments:
if segment == null:
continue
var text := segment.label.strip_edges()
if text.is_empty() and group_starts.has(segment.segment_id):
text = group_starts[segment.segment_id].get_caption().strip_edges()
if not text.is_empty():
element_labels.append({
"time_seconds": total,
"text": text,
})
total += maxf(
segment.get_effective_duration_seconds(),
0.0
)
var custom_labels: Array[Dictionary] = []
if _routine != null:
for entry: Dictionary in _routine.timeline_labels:
var text := str(entry.get("text", "")).strip_edges()
if text.is_empty():
continue
custom_labels.append({
"time_seconds": float(entry.get("time_seconds", 0.0)),
"text": text,
})
var labels := TimelineLabelModel.collect(_routine)
timeline_label_lane.set_timeline(
element_labels,
custom_labels,
labels["elements"],
labels["custom"],
_playback_total_duration
)

View file

@ -0,0 +1,53 @@
class_name TimelineLabelModel
extends RefCounted
## Collects the labels shown on the playback timeline.
##
## Pure: the routine goes in, the two label lists and the total duration come
## out. Walks the authored sections (not the timed playback entries), so
## element markers with zero stand time stay visible. A segment without its own
## label falls back to the caption of its element group, so a sequence group is
## named once.
## Returns `{"elements": Array, "custom": Array, "duration": float}`. Each
## entry is `{"time_seconds": float, "text": String}`.
static func collect(routine: Routine) -> Dictionary:
var element_labels: Array[Dictionary] = []
var total := 0.0
if routine != null:
for section: RoutineSection in routine.sections:
if section == null:
continue
var group_starts: Dictionary[String, ResolvedElement] = {}
for element: ResolvedElement in section.get_elements():
if not element.segments.is_empty():
group_starts[element.segments[0].segment_id] = element
for segment: PathSegment in section.segments:
if segment == null:
continue
var text := segment.label.strip_edges()
if text.is_empty() and group_starts.has(segment.segment_id):
text = group_starts[segment.segment_id].get_caption().strip_edges()
if not text.is_empty():
element_labels.append({
"time_seconds": total,
"text": text,
})
total += maxf(segment.get_effective_duration_seconds(), 0.0)
var custom_labels: Array[Dictionary] = []
if routine != null:
for entry: Dictionary in routine.timeline_labels:
var text := str(entry.get("text", "")).strip_edges()
if text.is_empty():
continue
custom_labels.append({
"time_seconds": float(entry.get("time_seconds", 0.0)),
"text": text,
})
return {
"elements": element_labels,
"custom": custom_labels,
"duration": total,
}

View file

@ -0,0 +1 @@
uid://bi7a47b46qnej