⚙️ 🤖 Umzugsfester Output + rock-solid Player (Audio relativ, Basis-URL, Umzugsscript, Stream-vorbereitet) #130

Closed
opened 2026-11-04 18:37:01 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand █████░░░░░ Mittel — build.sh-URL-Logik, Player-JS, Umzugsscript, Check
Nutzen ████████░░ Hoch — Archive bleiben ohne Publisher-Lauf umziehbar; Player hängt nicht mehr an der Domain
Bruchhäufigkeit ██████░░░░ Mittel — heute: alte Domain weg → Player stumm
Nachhaltigkeit █████████░ Sehr hoch — statischer Output überlebt den Publisher
Dringlichkeit ████░░░░░░ Mittel — nach #128 (gleiche Templates/Player-JS)

Ziel (Holm 2026-11-04, Frage 66: „umzugsfester Output ist gesetzt. rock-solid player ebenfalls.“)

Statischen Output irgendwann woanders ablegen, ohne den Publisher erneut laufen zu lassen (z. B. Archiv zu alt für aktuelle Publisher-Versionen).

Befund (gemessen an sample_project/public, rc.18)

Teil heute
Navigation, CSS, JS, Cover relativ (#56) — umzugsfest
Player <audio src> in Index/Folgen absolut https://<domain>/audio/… (aus web.url/audio_base_url) → nach Abschalten der alten Domain stumm
404.html wurzelfeste base_href aus web.url
feed.xml, sitemap.xml, robots.txt, og/twitter, canonical, JSON-LD absolut (Standard verlangt es; Apps/Crawler führen kein JS aus)
MP3-ID3 Domain im Tag — kosmetisch, nie per Textersatz anfassen

Umsetzung

  1. Audio im HTML relativ (audio/<slug>.mp3), wenn kein externes audio_base_url/audio.url (CDN, archive.org) gesetzt ist; Feed-Enclosures bleiben absolut.
  2. Player bekommt die Basis-URL (z. B. data-base am Root bzw. document.baseURI) und baut volle URLs selbst aus relativen Pfaden — für Share-Links, Media Session, Download-Link, Persistenz (ztPlayer, #119: gespeicherte Positionen nach Umzug nicht verwaisen lassen → Schlüssel relativ zum Slug, nicht zur absoluten URL).
  3. Rock-solid Player: Fehlerzustände sichtbar (Quelle nicht erreichbar → Meldung statt Stille), Wiederaufnahme nach Netzabbruch, SPA-Swap (#58) ohne Zustandsverlust; vorhandene SPA-Tests (scripts/check/spa-*.mjs) erweitern.
  4. Vorbereitung Stream-Quelle (später™): Quellen-Abstraktion im Player, damit später neben Folgen-MP3 auch eine Feed-/Stream-URL (z. B. Icecast-Live, [stream] url) bedient werden kann — jetzt nur die Schnittstelle (Quelltyp episode/stream, kein Seek/keine Dauer bei stream), kein Live-Feature.
  5. Umzugsscript im Output: Build legt umzug.sh (Bash + sed, ohne Publisher) und eine Zeile mit der Build-Basis-URL in den Output; ersetzt alte gegen neue Basis-URL nur in *.html *.xml *.txt *.json *.webmanifest, nie in Binärdateien; Trockenlauf zeigt Trefferzahl je Datei. Deploy überträgt es nicht oder es ist harmlos (Entscheid bei Umsetzung, dokumentieren).
  6. Check: zpub check meldet absolute Eigen-Domain-URLs in HTML außerhalb der erlaubten Meta-Tags.
  7. Doku: docs/deploy.md „Umzug ohne Publisher“, docs/player.md.

Abnahme

  • sample_project bauen, Output in anderes Verzeichnis/andere Domain (lokaler Server) kopieren → Player spielt ohne Umzugsscript; nach umzug.sh alt neu zeigen Feed/Sitemap/og auf neu, MP3 unverändert (sha256)
  • 404.html nach Umzug funktionsfähig
  • SPA-Tests grün

Schwächster Punkt

404.html braucht eine wurzelfeste Basis (beliebige Pfade) — ohne Umzugsscript bleibt sie an der alten Domain. Und: gespeicherte Player-Positionen im localStorage sind pro Origin; nach Domainwechsel startet jeder Hörer neu (nicht lösbar, nur dokumentieren).

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `█████░░░░░` | Mittel — build.sh-URL-Logik, Player-JS, Umzugsscript, Check | | Nutzen | `████████░░` | Hoch — Archive bleiben ohne Publisher-Lauf umziehbar; Player hängt nicht mehr an der Domain | | Bruchhäufigkeit | `██████░░░░` | Mittel — heute: alte Domain weg → Player stumm | | Nachhaltigkeit | `█████████░` | Sehr hoch — statischer Output überlebt den Publisher | | Dringlichkeit | `████░░░░░░` | Mittel — nach #128 (gleiche Templates/Player-JS) | ## Ziel (Holm 2026-11-04, Frage 66: „umzugsfester Output ist gesetzt. rock-solid player ebenfalls.“) Statischen Output irgendwann woanders ablegen, **ohne** den Publisher erneut laufen zu lassen (z. B. Archiv zu alt für aktuelle Publisher-Versionen). ## Befund (gemessen an sample_project/public, rc.18) | Teil | heute | |---|---| | Navigation, CSS, JS, Cover | relativ (#56) — umzugsfest | | Player `<audio src>` in Index/Folgen | **absolut** `https://<domain>/audio/…` (aus `web.url`/`audio_base_url`) → nach Abschalten der alten Domain stumm | | 404.html | wurzelfeste base_href aus `web.url` | | feed.xml, sitemap.xml, robots.txt, og/twitter, canonical, JSON-LD | absolut (Standard verlangt es; Apps/Crawler führen kein JS aus) | | MP3-ID3 | Domain im Tag — kosmetisch, nie per Textersatz anfassen | ## Umsetzung 1. **Audio im HTML relativ** (`audio/<slug>.mp3`), wenn kein externes `audio_base_url`/`audio.url` (CDN, archive.org) gesetzt ist; Feed-Enclosures bleiben absolut. 2. **Player bekommt die Basis-URL** (z. B. `data-base` am Root bzw. `document.baseURI`) und baut volle URLs selbst aus relativen Pfaden — für Share-Links, Media Session, Download-Link, Persistenz (`ztPlayer`, #119: gespeicherte Positionen nach Umzug nicht verwaisen lassen → Schlüssel relativ zum Slug, nicht zur absoluten URL). 3. **Rock-solid Player:** Fehlerzustände sichtbar (Quelle nicht erreichbar → Meldung statt Stille), Wiederaufnahme nach Netzabbruch, SPA-Swap (#58) ohne Zustandsverlust; vorhandene SPA-Tests (scripts/check/spa-*.mjs) erweitern. 4. **Vorbereitung Stream-Quelle (später™):** Quellen-Abstraktion im Player, damit später neben Folgen-MP3 auch eine Feed-/Stream-URL (z. B. Icecast-Live, `[stream] url`) bedient werden kann — jetzt nur die Schnittstelle (Quelltyp `episode`/`stream`, kein Seek/keine Dauer bei `stream`), kein Live-Feature. 5. **Umzugsscript im Output:** Build legt `umzug.sh` (Bash + sed, ohne Publisher) und eine Zeile mit der Build-Basis-URL in den Output; ersetzt alte gegen neue Basis-URL nur in `*.html *.xml *.txt *.json *.webmanifest`, nie in Binärdateien; Trockenlauf zeigt Trefferzahl je Datei. Deploy überträgt es nicht oder es ist harmlos (Entscheid bei Umsetzung, dokumentieren). 6. **Check:** `zpub check` meldet absolute Eigen-Domain-URLs in HTML außerhalb der erlaubten Meta-Tags. 7. **Doku:** docs/deploy.md „Umzug ohne Publisher“, docs/player.md. ## Abnahme - sample_project bauen, Output in anderes Verzeichnis/andere Domain (lokaler Server) kopieren → Player spielt ohne Umzugsscript; nach `umzug.sh alt neu` zeigen Feed/Sitemap/og auf neu, MP3 unverändert (sha256) - 404.html nach Umzug funktionsfähig - SPA-Tests grün ## Schwächster Punkt 404.html braucht eine wurzelfeste Basis (beliebige Pfade) — ohne Umzugsscript bleibt sie an der alten Domain. Und: gespeicherte Player-Positionen im localStorage sind pro Origin; nach Domainwechsel startet jeder Hörer neu (nicht lösbar, nur dokumentieren). > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Erledigt — gemergt nach dev (cdcb96b, Screenshots 1dc64eb)

Abnahme Beleg
Player spielt nach Umzug ohne Script Worker: Output nach anderem Pfad/Origin kopiert, check.sh 58 ✓ 0 ✗ inkl. „Audio relativ, spielt hier“ und Unterseite seite/2.html (../audio/004.mp3) in Chromium + Firefox
umzug.sh Trockenlauf ändert nichts; mit -w: Feed, Enclosures, Sitemap, og:*, robots auf neu, MP3-sha256 unverändert, 404 unter neuem Pfad funktionsfähig
Fehlerzustände Quelle 404 → „⚠ audio nicht erreichbar, ▶ versucht es erneut“; offline → „⚠ offline — warte auf netz …“, danach weiter (Chromium per CDP)
zpub check neue Prüfung „Umzugsfest“: alter Build ✗ (63 absolute Eigen-URLs), neuer ✓
Feed/Sitemap ohne Umzug byte-gleich zu vorher
v00-Stichprobe src="audio/006.mp3" relativ; umzug.sh im Output, Trockenlauf 139 Ersetzungen in 20 Dateien; zpub check 16 ✓ 0 ✗ 0 ⚠; docs-drift 0

Festlegungen Worker: 404.html nutzt nur den Pfad von web.url (Domainwechsel ohne Script ok); umzug.sh ersetzt auch in *.md; schreiben nur mit -w; deploy.sh überträgt umzug.sh/umzug-basis.txt mit; Stream-Knopf läuft über die neue Quellen-Schnittstelle (loadStream).

Grenzen: Feed-Abonnenten brauchen beim Domainwechsel einen 301 am alten Server; Positionen in sessionStorage gelten je Origin; Wiederverbindung nach Netzabbruch nur in Chromium manuell geprüft.

🤖 angelegt von Claude v00 (API/Token holm)

## Erledigt — gemergt nach dev (cdcb96b, Screenshots 1dc64eb) | Abnahme | Beleg | |---|---| | Player spielt nach Umzug ohne Script | Worker: Output nach anderem Pfad/Origin kopiert, `check.sh` 58 ✓ 0 ✗ inkl. „Audio relativ, spielt hier“ und Unterseite `seite/2.html` (`../audio/004.mp3`) in Chromium + Firefox | | `umzug.sh` | Trockenlauf ändert nichts; mit `-w`: Feed, Enclosures, Sitemap, og:*, robots auf neu, MP3-sha256 unverändert, 404 unter neuem Pfad funktionsfähig | | Fehlerzustände | Quelle 404 → „⚠ audio nicht erreichbar, ▶ versucht es erneut“; offline → „⚠ offline — warte auf netz …“, danach weiter (Chromium per CDP) | | `zpub check` | neue Prüfung „Umzugsfest“: alter Build ✗ (63 absolute Eigen-URLs), neuer ✓ | | Feed/Sitemap ohne Umzug | byte-gleich zu vorher | | v00-Stichprobe | `src="audio/006.mp3"` relativ; `umzug.sh` im Output, Trockenlauf 139 Ersetzungen in 20 Dateien; `zpub check` 16 ✓ 0 ✗ 0 ⚠; docs-drift 0 | Festlegungen Worker: 404.html nutzt nur den Pfad von `web.url` (Domainwechsel ohne Script ok); `umzug.sh` ersetzt auch in `*.md`; schreiben nur mit `-w`; `deploy.sh` überträgt `umzug.sh`/`umzug-basis.txt` mit; Stream-Knopf läuft über die neue Quellen-Schnittstelle (`loadStream`). Grenzen: Feed-Abonnenten brauchen beim Domainwechsel einen 301 am alten Server; Positionen in sessionStorage gelten je Origin; Wiederverbindung nach Netzabbruch nur in Chromium manuell geprüft. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-04 19:21:55 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#130
No description provided.