⚙️ 🤖 Feed nicht podcastfähig: Live-Demo auf Juni-Build, Show-Cover 404, Artwork < 1400 px, kein web.url-Guard #64

Closed
opened 2026-11-02 19:46:54 +01:00 by holm · 4 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ████░░░░░░ Mittel: Deploy nachziehen, Show-Cover anlegen, 3 Build-Guards, kleine Template-Korrekturen
Nutzen ██████████ Sehr hoch: ohne diese Punkte nimmt kein Verzeichnis (Apple/Spotify/Podcast Index) den Feed an
Bruchhäufigkeit █████████░ Hoch: jeder Build und jeder Deploy ist betroffen
Nachhaltigkeit █████████░ Hoch: die Guards verhindern, dass der Fehler wiederkommt
Dringlichkeit ███████░░░ Hoch: Holm-Befund „kein echter podcastkompatibler RSS-Feed“

Kontext

#56 (relative Pflicht-URLs) wurde am 2026-07-01 als PASS geschlossen. Es wurde damals nur das Repo-Artefakt geprüft, nicht der ausgelieferte Feed. Außerdem fehlte die Prüfung gegen die Pflichtregeln für Artwork. Dieses Issue schließt diese Lücke.

Geprüft wurde Stand 6cb9983 (rc.11 + #62) per git archive sowie der Live-Endpunkt am 2026-11-02.

Befund

# Schwere Befund Beleg
F1 Blocker Live-Demo liefert noch den Build vom 2026-06-16 (vor #56): <link></link> leer, enclosure url="audio/006.mp3" relativ, itunes:image auf example.org. Das ist der Grund für Holms Beobachtung. curl https://demo.podcast.zentonic.org/feed.xml → last-modified: Tue, 16 Jun 2026 11:45:26 GMT, Caddy
F2 Blocker Show-Artwork https://demo.podcast.zentonic.org/podcast/cover.png → 404. Die Datei gibt es auch im Quellbaum nicht. feed.artwork_url zeigt ins Leere, und der Build prüft das nicht. curl 404; sample_project/ enthält kein Show-Cover
F3 Blocker (Apple) Episoden-Cover sind 600×600 (001–005, mit Alpha) bzw. 512×512 (006). Apple verlangt 1400–3000 px, quadratisch, RGB ohne Alpha. Fürs Show-Artwork ist das Pflicht, für Episoden-Art eine starke Empfehlung. magick identify
F4 Hoch Kein Guard für leere web.url. Der Build erzeugt dann still wieder einen relativen Feed. Genau so ist F1 entstanden. scripts/build.sh:181-207: web_url wird ungeprüft vorangestellt
F5 Hoch Kein Deploy-Pfad im Repo. Wie die Demo auf den Caddy kommt, ist undokumentiert, deshalb blieb sie veraltet. grep deploy/rsync ohne Treffer
F6 Mittel podcast:guid 98462356-… ist nicht spec-konform abgeleitet. Podcast-Index-Spec: UUIDv5(ns ead4c236-…, Feed-URL ohne Schema/Slash) = a3a12323-418a-5b30-80c2-ab46834afaa6 für demo.podcast.zentonic.org/feed.xml. Auch der Build-Fallback hasht web.url statt der Feed-URL. Ein fester Wert ist erlaubt, sollte aber einmalig korrekt erzeugt werden. Jetzt umstellen, solange kein Verzeichnis den Feed kennt. python3 uuid.uuid5
F7 Niedrig <itunes:episode>006</itunes:episode> hat führende Nullen. Apple erwartet eine Ganzzahl → {{ ep.episode | int }}. feed.xml
F8 Niedrig <itunes:explicit>no ist veraltet, Apple/PSP-1 wollen true/false. feed.xml
F9 Niedrig <copyright></copyright> ist leer. Entweder mit {% if %} weglassen oder aus der Config befüllen. feed.xml

Geprüft und in Ordnung

  • XML wohlgeformt; alle 6 Items haben enclosure, guid isPermaLink="false", pubDate (RFC 2822).
  • In rc.11 sind alle URLs absolut (channel link, atom:self, enclosure, item link, itunes:image, chapters, person img).
  • Die echte MP3-Dauer stimmt mit itunes:duration überein: alle 45,0 s (MPEG1 L3, 64 kbps, mono, Info-Header).
  • enclosure length = Dateigröße (6/6).
  • Chapters-JSON version 1.2.0, je 3 Kapitel.
  • Medien-Endpunkte live mit korrektem Content-Type und Range-Support (206).

Auftrag

  1. F4 Build-Guard: Bei leerer oder nicht-https://-web.url bricht der Feed-Build mit einer Meldung ab (--local als ausdrücklicher Ausnahme-Schalter für die file://-Vorschau).
  2. F2 Build-Guard: Ein lokales artwork_url-Ziel muss im Output existieren und ≥1400 px groß sein. Show-Cover (z. B. 3000×3000 PNG/JPEG ohne Alpha) im Sample anlegen und in public/ kopieren.
  3. F3 Sample-Cover in ≥1400 px ohne Alpha neu erzeugen; Build warnt bei < 1400 px.
  4. F6 podcast_guid = a3a12323-418a-5b30-80c2-ab46834afaa6; Fallback-Seed auf Feed-URL ohne Schema und ohne Trailing-Slash umstellen.
  5. F7–F9 Template-Korrekturen.
  6. F5/F1 Deploy-Weg der Demo klären und dokumentieren, dann neu ausrollen.
  7. Abnahme (v00) gegen den Live-Endpunkt, nicht das Repo-Artefakt: Podbase/Cast-Feed-Validator + Podcast-Index-Validator, Artwork-Abruf 200 und ≥1400 px.

Abhängigkeit: Vorher muss der lokale Git-Stand repariert sein, siehe #63 (Seafile hat dev/main auf rc.10 zurückgedreht).

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `████░░░░░░` | Mittel: Deploy nachziehen, Show-Cover anlegen, 3 Build-Guards, kleine Template-Korrekturen | | Nutzen | `██████████` | Sehr hoch: ohne diese Punkte nimmt kein Verzeichnis (Apple/Spotify/Podcast Index) den Feed an | | Bruchhäufigkeit | `█████████░` | Hoch: jeder Build und jeder Deploy ist betroffen | | Nachhaltigkeit | `█████████░` | Hoch: die Guards verhindern, dass der Fehler wiederkommt | | Dringlichkeit | `███████░░░` | Hoch: Holm-Befund „kein echter podcastkompatibler RSS-Feed“ | ## Kontext [#56](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/56) (relative Pflicht-URLs) wurde am 2026-07-01 als PASS geschlossen. Es wurde damals nur das **Repo-Artefakt** geprüft, nicht der **ausgelieferte Feed**. Außerdem fehlte die Prüfung gegen die Pflichtregeln für Artwork. Dieses Issue schließt diese Lücke. Geprüft wurde Stand `6cb9983` (rc.11 + #62) per `git archive` sowie der Live-Endpunkt am 2026-11-02. ## Befund | # | Schwere | Befund | Beleg | |---|---|---|---| | F1 | **Blocker** | Live-Demo liefert noch den **Build vom 2026-06-16** (vor #56): `<link></link>` leer, `enclosure url="audio/006.mp3"` relativ, `itunes:image` auf `example.org`. Das ist der Grund für Holms Beobachtung. | `curl https://demo.podcast.zentonic.org/feed.xml` → `last-modified: Tue, 16 Jun 2026 11:45:26 GMT`, Caddy | | F2 | **Blocker** | Show-Artwork `https://demo.podcast.zentonic.org/podcast/cover.png` → **404**. Die Datei gibt es auch im Quellbaum nicht. `feed.artwork_url` zeigt ins Leere, und der Build prüft das nicht. | `curl` 404; `sample_project/` enthält kein Show-Cover | | F3 | **Blocker (Apple)** | Episoden-Cover sind 600×600 (001–005, mit Alpha) bzw. 512×512 (006). Apple verlangt 1400–3000 px, quadratisch, RGB **ohne Alpha**. Fürs Show-Artwork ist das Pflicht, für Episoden-Art eine starke Empfehlung. | `magick identify` | | F4 | Hoch | **Kein Guard für leere `web.url`.** Der Build erzeugt dann still wieder einen relativen Feed. Genau so ist F1 entstanden. | `scripts/build.sh:181-207`: `web_url` wird ungeprüft vorangestellt | | F5 | Hoch | Kein Deploy-Pfad im Repo. Wie die Demo auf den Caddy kommt, ist undokumentiert, deshalb blieb sie veraltet. | `grep deploy/rsync` ohne Treffer | | F6 | Mittel | `podcast:guid` `98462356-…` ist **nicht** spec-konform abgeleitet. Podcast-Index-Spec: UUIDv5(ns `ead4c236-…`, Feed-URL ohne Schema/Slash) = `a3a12323-418a-5b30-80c2-ab46834afaa6` für `demo.podcast.zentonic.org/feed.xml`. Auch der Build-Fallback hasht `web.url` statt der Feed-URL. Ein fester Wert ist erlaubt, sollte aber einmalig korrekt erzeugt werden. **Jetzt umstellen**, solange kein Verzeichnis den Feed kennt. | `python3 uuid.uuid5` | | F7 | Niedrig | `<itunes:episode>006</itunes:episode>` hat führende Nullen. Apple erwartet eine Ganzzahl → `{{ ep.episode \| int }}`. | feed.xml | | F8 | Niedrig | `<itunes:explicit>no` ist veraltet, Apple/PSP-1 wollen `true`/`false`. | feed.xml | | F9 | Niedrig | `<copyright></copyright>` ist leer. Entweder mit `{% if %}` weglassen oder aus der Config befüllen. | feed.xml | ## Geprüft und in Ordnung - XML wohlgeformt; alle 6 Items haben `enclosure`, `guid isPermaLink="false"`, `pubDate` (RFC 2822). - In rc.11 sind alle URLs absolut (channel link, atom:self, enclosure, item link, itunes:image, chapters, person img). - Die echte MP3-Dauer stimmt mit `itunes:duration` überein: alle 45,0 s (MPEG1 L3, 64 kbps, mono, Info-Header). - `enclosure length` = Dateigröße (6/6). - Chapters-JSON `version 1.2.0`, je 3 Kapitel. - Medien-Endpunkte live mit korrektem Content-Type und Range-Support (206). ## Auftrag 1. **F4** Build-Guard: Bei leerer oder nicht-`https://`-`web.url` bricht der Feed-Build mit einer Meldung ab (`--local` als ausdrücklicher Ausnahme-Schalter für die file://-Vorschau). 2. **F2** Build-Guard: Ein lokales `artwork_url`-Ziel muss im Output existieren und ≥1400 px groß sein. Show-Cover (z. B. 3000×3000 PNG/JPEG ohne Alpha) im Sample anlegen und in `public/` kopieren. 3. **F3** Sample-Cover in ≥1400 px ohne Alpha neu erzeugen; Build warnt bei < 1400 px. 4. **F6** `podcast_guid` = `a3a12323-418a-5b30-80c2-ab46834afaa6`; Fallback-Seed auf Feed-URL ohne Schema und ohne Trailing-Slash umstellen. 5. **F7–F9** Template-Korrekturen. 6. **F5/F1** Deploy-Weg der Demo klären und dokumentieren, dann neu ausrollen. 7. **Abnahme (v00)** gegen den **Live-Endpunkt**, nicht das Repo-Artefakt: Podbase/Cast-Feed-Validator + Podcast-Index-Validator, Artwork-Abruf 200 und ≥1400 px. Abhängigkeit: Vorher muss der lokale Git-Stand repariert sein, siehe [#63](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/63) (Seafile hat `dev`/`main` auf rc.10 zurückgedreht). > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

In Arbeit (v00-Worker w-64)

Worker auf Branch fix/64-feed-podcastfaehig (worktree): F4 → F2/F3 → F6 → F7–F9, danach Sample-Rebuild. v00 nimmt ab und merged. F1/F5 (Deploy der Demo) bleibt offen, bis der Deploy-Weg geklärt ist.

🤖 angelegt von Claude v00 (API/Token holm)

## In Arbeit (v00-Worker w-64) Worker auf Branch `fix/64-feed-podcastfaehig` (worktree): F4 → F2/F3 → F6 → F7–F9, danach Sample-Rebuild. v00 nimmt ab und merged. F1/F5 (Deploy der Demo) bleibt offen, bis der Deploy-Weg geklärt ist. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

F1 Zwischenstand: Demo von Holm per rsync aktualisiert (2026-11-02)

Live feed.xml (last-modified: Mon, 02 Nov 2026 19:02:03 GMT) ist byte-gleich mit sample_project/public/feed.xml auf dev (6cb9983, rc.11-Build vom 2026-07-01). Die URLs sind jetzt absolut, audio/006.mp3 liefert 200.

Weiterhin offen: Show-Cover /podcast/cover.png liefert 404 (F2), die übrigen Punkte F3–F9 sind beim Worker. F5: Der Deploy-Weg ist rsync von Hand, Ziel und Befehl sind noch zu dokumentieren.

🤖 angelegt von Claude v00 (API/Token holm)

## F1 Zwischenstand: Demo von Holm per rsync aktualisiert (2026-11-02) Live `feed.xml` (`last-modified: Mon, 02 Nov 2026 19:02:03 GMT`) ist byte-gleich mit `sample_project/public/feed.xml` auf `dev` (`6cb9983`, rc.11-Build vom 2026-07-01). Die URLs sind jetzt absolut, `audio/006.mp3` liefert 200. Weiterhin offen: Show-Cover `/podcast/cover.png` liefert 404 (F2), die übrigen Punkte F3–F9 sind beim Worker. F5: Der Deploy-Weg ist rsync von Hand, Ziel und Befehl sind noch zu dokumentieren. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

v00-Abnahme Code-Teil: PASS, gemerged nach dev (9e6e7f1)

Selbst geprüft auf fix/64-feed-podcastfaehig (git archive, nicht der Worker-Bericht):

F Beleg
F2 public/cover.png 3000×3000 sRGB, 3 Kanäle, 134 kB. itunes:image → https://demo.podcast.zentonic.org/cover.png
F3 Episoden-Cover 1400×1400, 3 Kanäle, also ohne Alpha. Ep. 006 hat 1,3 MB (PNG-Foto), das ist akzeptabel
F4 Build mit leerer web.url → rc=1 mit Meldung · mit http:// → rc=1 · mit --local → rc=0
F6 <podcast:guid>a3a12323-418a-5b30-80c2-ab46834afaa6
F7–F9 itunes:episode 1–6 · 7× explicit false · <copyright>© 2026 Quinn Pascal
XML wohlgeformt (minidom)

Bleibt offen, bis dieses Issue geschlossen werden kann:

  • F1/F5: Holm rollt per rsync aus. Danach v00-Abnahme gegen den Live-Endpunkt.
  • Die getrackten public/audio/*.mp3 tragen noch das alte eingebettete 600-px-Cover. Ein Rebuild im Haupt-Tree mit Audio-Quellen taggt sie neu. Danach folgt die Löschvorlage Runde 2 aus #63.

Folgebefund (eigenes Issue): relative Gimmick-Links in content:encoded.

🤖 angelegt von Claude v00 (API/Token holm)

## v00-Abnahme Code-Teil: PASS, gemerged nach `dev` (`9e6e7f1`) Selbst geprüft auf `fix/64-feed-podcastfaehig` (`git archive`, nicht der Worker-Bericht): | F | Beleg | |---|---| | F2 | `public/cover.png` 3000×3000 sRGB, 3 Kanäle, 134 kB. `itunes:image` → `https://demo.podcast.zentonic.org/cover.png` | | F3 | Episoden-Cover 1400×1400, 3 Kanäle, also ohne Alpha. Ep. 006 hat 1,3 MB (PNG-Foto), das ist akzeptabel | | F4 | Build mit leerer `web.url` → rc=1 mit Meldung · mit `http://` → rc=1 · mit `--local` → rc=0 | | F6 | `<podcast:guid>a3a12323-418a-5b30-80c2-ab46834afaa6` | | F7–F9 | `itunes:episode` 1–6 · 7× `explicit false` · `<copyright>© 2026 Quinn Pascal` | | XML | wohlgeformt (minidom) | Bleibt offen, bis dieses Issue geschlossen werden kann: - **F1/F5:** Holm rollt per rsync aus. Danach v00-Abnahme gegen den Live-Endpunkt. - Die getrackten `public/audio/*.mp3` tragen noch das alte eingebettete 600-px-Cover. Ein Rebuild im Haupt-Tree mit Audio-Quellen taggt sie neu. Danach folgt die Löschvorlage Runde 2 aus #63. Folgebefund (eigenes Issue): relative Gimmick-Links in `content:encoded`. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

v00-Abnahme live: PASS → geschlossen

Live-Abnahme 2026-11-02 nach Deploy von dev (v00 per rsync, 9 Dateien) mit bash scripts/check.sh https://demo.podcast.zentonic.org/ (a8f90cd): 12 ✓ · 0 ✗ · 1 ⚠ (⚠ = #65).

  • Show-Cover https://demo.podcast.zentonic.org/cover.png 3000×3000 ✓ · podcast:guid a3a12323-… ✓ · alle URLs https ✓ · enclosure length 6/6 ✓
  • F5: deploy.sh gemerged (fe94cb6), Ziel unter [deploy] target, ohne --delete

Folgepunkte: #65 (relative Gimmick-Links), #68 (tag.sh-Retag, MP3-Größe).

🤖 angelegt von Claude v00 (API/Token holm)

## v00-Abnahme live: PASS → geschlossen Live-Abnahme 2026-11-02 nach Deploy von `dev` (v00 per rsync, 9 Dateien) mit `bash scripts/check.sh https://demo.podcast.zentonic.org/` (`a8f90cd`): **12 ✓ · 0 ✗ · 1 ⚠** (⚠ = #65). - Show-Cover `https://demo.podcast.zentonic.org/cover.png` 3000×3000 ✓ · `podcast:guid` a3a12323-… ✓ · alle URLs https ✓ · enclosure length 6/6 ✓ - F5: `deploy.sh` gemerged (`fe94cb6`), Ziel unter `[deploy] target`, ohne `--delete` Folgepunkte: #65 (relative Gimmick-Links), #68 (tag.sh-Retag, MP3-Größe). > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-02 20:34:14 +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#64
No description provided.