docs: SAVEPOINT — 5.3.0 im Kanal, Serien-Ablage und Rollen
Ampel / ampel (push) Successful in 1m30s

Zum dritten Mal in dieser Sitzung dasselbe Muster: Die Bausteine lagen
fertig UND getestet da (serienOrdner, matcheEpisoden, episodenUmbenennen,
tvStaffel) und waren nur nicht verbunden. Als Lehre festgehalten.

Offen notiert: Weder Auswahl-Dialog noch Serien-Ablage sind je an echter
Hardware gelaufen, und der extras/-Ordnername ist aus Wissen gesetzt,
nicht gemessen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
2026-09-01 19:40:36 +02:00
co-authored by Claude Opus 5
parent 7ce06889f8
commit 306b090ccf
+76
View File
@@ -1,5 +1,81 @@
# SAVEPOINT — Rippy
## Serien-Staffelablage + Film-Extras — Version 5.3.0 (01.09.2026, nachts)
> Commander: *„Mach das gerne noch mit den Serien."* und *„Für FILME
> sollte so eine auswahl auch gelten z. B. Nur hauptfeature oder
> hauptfeature + extras usw. Rippy muss das auch selbst zusammenbasteln."*
### DAS MUSTER DIESER SITZUNG — zum dritten Mal
Auch hier lagen die Teile **fertig und getestet** herum und waren nur
nicht verbunden: `serienOrdner()`, `matcheEpisoden()`,
`episodenUmbenennen()` (`ablage/struktur.ts`) und `tvStaffel()`
(`metadaten/tmdb.ts`). Deshalb landeten Folgen unter `Filme/`, und
Jellyfin sah lauter Einzelfilme statt einer Staffel.
Vorher schon so gefunden: `titelInfoLesen()` (rief niemand auf) und die
Preset-Empfehlung (lief, war aber unsichtbar). **Lehre für die nächste
Sitzung: Bevor etwas neu gebaut wird, erst nachsehen, ob es schon da ist
und nur der Draht fehlt.** Der Docker-Zweig hat viel vorgelegt, was beim
v5-Neubau mitkam, aber nie angeschlossen wurde.
### Die Rolle bestimmt das Ziel
Jeder Titel im Auftrag trägt eine `TitelRolle` (EINE Definition in
`gemeinsam/nachrichten.ts`):
```
hauptfilm -> Filme/<Titel> (Jahr)/<Titel> (Jahr).mkv
extra -> Filme/<Titel> (Jahr)/extras/…
folge -> Serien/<Titel>/Season NN/… S01E02.mkv
```
* Rippy schlägt vor (Serie → Folge, Film → Hauptfilm, Rest → Extra), der
Dialog lässt es je Titel ändern. Neuer Schnellwahl-Knopf
„Hauptinhalt + Extras".
* Die Zuordnung Datei→Rolle ist **exakt, nicht aus Dateinamen geraten**:
Je makemkvcon-Lauf kommt genau ein Titel dazu, und genau der bekommt
die Rolle seines Auftragseintrags (`rolleJeDatei`).
* Der `extras/`-Ordner entsteht nur, wenn es wirklich Extras gibt.
### Episoden-Nummern: bewusst zurückhaltend
`RipAuftragTitel.dauerS` reist mit, die Staffel-Laufzeiten kommen über
einen **injizierten** Rückruf (`episodenLaufzeiten`, im Kern aus
`tvStaffel`) — so bleibt die Pipeline ohne Netz prüfbar.
`matcheEpisoden()` benennt **nur bei EINDEUTIGER Zuordnung** um. Sonst
behalten die Dateien ihre MakeMKV-Namen, und Rippy nennt den Grund
(„keine Staffel-Laufzeiten von TMDb" bzw. „nicht eindeutig"). Lieber gar
nicht als falsch — ARMs offene Wunde #395 war genau dieses Ratespiel.
Die Staffel kommt aus dem Disc-Titel (`discZusatzAbtrennen`, seit 5.1.1),
sonst 1.
### Setup 5.3.0
* **131 526 532 Bytes**, SHA-256
`A4613214F18481B03D6D11DDAE4344C8537A12825C086E89039380C62767043F`
* Paket-Smoke GRÜN (`version=5.3.0`), **257 Tests**, Ampel GRÜN
(`7ce0688`), im Release `aktuell` anonym gegengeprüft.
### ⚠ Offen — beides braucht Hand am Gerät
* **Weder Auswahl-Dialog noch Serien-Ablage sind je an echter Hardware
gelaufen.** Logik getestet, Verkabelung typgeprüft; der erste echte
Durchlauf steht aus. Das Laufwerk war im 5042-Zustand und sollte nach
dem halbstündigen Hämmern nicht weiter belastet werden.
* **Der `extras/`-Ordnername ist aus Wissen gesetzt, NICHT gemessen.**
Ob Jellyfin ihn als Zugaben liest, kann nur die Bibliothek des
Commanders beantworten. Falls nicht: `featurettes` oder
`behind the scenes` sind die Alternativen.
* Bei zwei ähnlich langen Spartacus-Folgen wird die Episoden-Zuordnung
vermutlich NICHT eindeutig — dann liegen sie richtig einsortiert im
Staffelordner, heißen aber noch wie MakeMKV sie nannte. Das ist das
gewollte Verhalten, kein Fehler.
---
## Titelauswahl + Defekt-Wächter — Version 5.2.0 (01.09.2026, nachts)
> Commander: *„es fehlt generell noch komplett die auswahl WAS man rippen