docs/podcasts.md: Plan für Strom, Merkliste, Wiedergabeliste und Abo-Stufen

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/podcasts.md

@@ -0,0 +1,85 @@
+# Podcasts: Strom, Merkliste, Wiedergabeliste
+
+The plan agreed on 2026-10-19 (with the user, from their listening history). It replaces
+the inbox model ("Neu" to work through, "Folgen" beside it, one queue that is both a store
+and the play order). Server: diora-web (podcasts/). The podcast UI is diora-android's
+`web-native/static/native-podcast.js`, copied into `static/podcasts/` — built there.
+
+## Why
+
+- The subscriptions (about 540) are a self-chosen part of the podcast world: episodes to see
+  go by and dip into now and then — not a list to work through. "Neu" had 3360 unplayed
+  episodes; nobody works through that.
+- The queue held 74 episodes (100+ hours): a store of "want to hear some day", yet the
+  player played it in order as if it were the play order.
+- In AntennaPod "download automatically" and "add to queue automatically" were one thing
+  for the user: a regular podcast is one whose new episodes are on the phone. diora split
+  them (177 feeds downloading, 8 queueing).
+- "Silent" subscriptions came from AntennaPod fetching every feed on the phone, slowly. The
+  server fetches all feeds anyway now (conditional, every 15 minutes).
+
+## The lists
+
+**Wiedergabeliste** — short, what plays next. The player goes through it in order and
+**stops when it is empty** (it does not take from the Merkliste). Every episode in it is
+downloaded. Filled by hand: ▶ on an episode (plays it, puts it first), or "In die
+Wiedergabeliste" from the Merkliste or the Strom.
+
+**Merkliste** — long, "want to hear". It may grow; it **never expires**. Grouped by podcast,
+each podcast **collapsible** (newest first inside). New episodes of Stamm subscriptions land
+here and are downloaded; so is what the user adds with ＋. An episode played from it moves
+to the front of the Wiedergabeliste; finished, it leaves both.
+
+When an episode leaves both lists (heard, removed), its download is deleted (setting
+`delete_dequeue`). Downloads follow the lists, not the subscriptions.
+
+## Subscriptions: three levels
+
+| level | new episodes | today's mapping |
+|---|---|---|
+| **Stamm** | into the Merkliste and downloaded (per feed: or straight into the Wiedergabeliste — an option, used by none yet) | `new_episodes='queue'` (8) plus the regularly heard ones (about 50, list below) |
+| **Strom** (default) | in the Strom; nothing to work through, nothing downloaded | `'inbox'`, and the former silent `'ignore'` ones |
+| **Auf Abruf** | not in the Strom; on the podcast's page and in search | — (for exceptions) |
+
+The per-feed "download automatically" switch goes: Stamm means it.
+
+**Fetch interval** per subscription: *Automatisch* (by publishing rhythm, `interval_days`:
+daily publishers hourly, rare ones daily), *stündlich*, *täglich*, *wöchentlich*. The former
+silent subscriptions become Strom with *täglich*.
+
+## The Strom (replaces "Neu" and "Folgen")
+
+All episodes of all Strom and Stamm subscriptions, by period (Heute, Gestern, Diese Woche,
+…), rarely publishing podcasts first (as built 2026-10-19). Each podcast appears **once per
+period, always bundled**: its newest episode, and "+n ›" for the others. Episodes new since
+they were last seen carry a **small mark** (no counts). Per episode: ▶ (Wiedergabeliste,
+first), ＋ (Merkliste), ★. Filters stay: Favoriten, Verlauf, Angefangen, Gehört.
+
+Tabs: **Wiedergabeliste · Merkliste · Strom · Abos**.
+
+Browsing within the subscriptions (themes, people, similar episodes, search) — later, to be
+thought through.
+
+## Moving over
+
+- Today's queue (74) becomes the Merkliste; the Wiedergabeliste starts empty.
+- Stamm: the 8 automatic subscriptions and the regularly heard ones (≥ 8 episodes a year or
+  ≥ 3 in 90 days, 2026-10-19): Ones and Tooze, Die Neuen Zwanziger – Der Salon, Surplus,
+  The Deprogram, junge Welt – Tagesüberblick, Speakeasy-Bar, jwpod – Forschung, RLS
+  Audiodokumente, The Reaction Pod, Geschichten aus der Geschichte, Märkte Mächte Emissionen,
+  friendlyjordies, Second Thought, Neben der Spur, Forschungsquartett, GegenStandpunkt –
+  Artikel, Hörsaal, Hakim, Marxistische Vorträge, Blätter, Kontextfenster, New Left Review,
+  Kommunisten Kneipe, Jung & Naiv, HealthyGamerGG, Dekarldent, Daily Dose Of Dekarldent,
+  Eine Stunde History, Übertage, Eigentlich, Zwischen Zwei Deckeln, UNFASSBAR, Über Rechts,
+  TitosLeftLung, New Books in History, ARTEde, Irgendwas mit ARTE, Zwei wie Pech & Schwafel,
+  Geschichte der kommenden Welten, Vollbild, Zeitfragen, Zeitfragen. Feature, Die Filmanalyse,
+  Reaction, Wirtschaft am Mittag.
+- Everything else: Strom; the silent ones with *täglich*.
+
+## Order of work
+
+1. Wiedergabeliste and Merkliste (server: a second list, moving the queue over, the player's
+   order; UI: two tabs, grouped Merkliste).
+2. The three levels and the fetch interval; downloads following the lists.
+3. The Strom replacing "Neu" and "Folgen".
+4. Browsing — after more thought.