WIP: Подкасты — исходный GitHub PR, перенесённый на federation (только для справки, MR-0) #1

Draft
sanapach wants to merge 1 commits from sanapach/furumi-tui:podcasts/prototype into federation
pull from: sanapach/furumi-tui:podcasts/prototype
Member

Серия «Подкасты»: MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · MR-0 Furumi/furumi-tui#1 (этот) · MR-T1 Furumi/furumi-tui#2 · MR-T2 Furumi/furumi-tui#3 · MR-T3 Furumi/furumi-tui#4 · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже.

⚠️ Черновик для справки, не для merge

Это исходный GitHub PR «Add podcast RSS subscriptions with streaming playback», перенесённый на актуальную ветку federation. MR нужен только как основа и ссылка для ревью: здесь видно, откуда берутся RSS-парсер, HTTP-плеер и UI.

Мержить его не нужно. Его заменяет серия MR из плана PODCASTS_PLAN.md (MR-T1, MR-F1, MR-F2, MR-T2, MR-F3, MR-T3, а также MR-W1–W3 в furumi-web). MR закрывается, когда вливается MR-T2.

Что сделано

  • Cherry-pick коммита 20167c5 из исходного PR на origin/federation @ 292f17f. Автор коммита сохранён. Merge-коммит bc023aa из GitHub-ветки не переносился.
  • Разрешены конфликты с коммитами, которые появились в federation позже:
    • 2253ec7 / 0ad3844 (простая визуализация статуса). В Runtime оставлены оба набора полей: status_visualizer и подкастовые podcasts / playback_seq. В handle_app_event оставлены обе группы веток: StatusVisualizationReady и Podcast*.
    • 7f0ca29 / 3e46f21 (обогащение карточек артиста и релиза). В update_tests.rs сохранены и тесты enrichment, и тесты подкастов.
    • 292f17f (статус MODE, версия 0.3.5). Конфликтов не было.
  • Функционально прототип не менялся. На текущем стабильном тулчейне он собирается без правок, поэтому отдельный коммит с адаптацией не понадобился.

Что есть в прототипе: вкладка Podcasts (клавиша 6), подписка по URL ленты, RSS/Atom-парсер (quick-xml, encoding_rs), каталог выпусков с поиском и сортировкой, потоковое воспроизведение по HTTP с Range-перемоткой, фоновое обновление лент (условные запросы), локальная база podcasts.sqlite3.

Что меняют последующие MR (по PODCASTS_PLAN.md)

  • Идентичность и очередь (Р2, Р5; MR-F1, MR-T2). Отрицательные ID выпусков и URL в file_path убираются полностью. Вместо них вводятся устойчивые podcast_id / episode_id (blake3 от канонического URL и GUID, с документированным правилом на случай, когда GUID нет) и явный источник PlaybackTrack.source / TrackItem.podcast.
  • Локальное хранилище (Р3; MR-F2, MR-T2). Вместо собственной базы прототипа появляется furumi_library::podcasts::PodcastStore с миграциями. Миграция импортирует базу этого PR, старые таблицы переименовываются, а не удаляются. Добавляются сезоны, регистр прогресса и сеансы прослушивания. Отписка не удаляет данные.
  • Синхронизация (Р4; MR-F1, MR-T2). Протокол device sync v4: подписки, публикация, прогресс и сеансы синхронизируются между устройствами. Для пиров ниже v4 включается отсечка, источник версии пира исправляется.
  • Позиция вкладки (Р8; MR-T1). Новый порядок вкладок: 1 Library, 2 Playlists, 3 Queue, 4 Podcasts, 5 Settings, 6 Logs. В keymap.toml появляется маркер version = 2 и миграция пользовательских keymap в памяти.
  • Приватность (Р6, Р7; MR-T2, MR-F3, MR-T3). Любая подписка по умолчанию приватная. Выпуски не попадают в Jam-снимки. Публикация в федерации возможна только по явному переключателю и идёт через отдельный подписанный оверлей podcast_dht. Перед публикацией выводится предупреждение о токенах в URL.

Совместимость и версии

  • Версия crate не менялась (0.3.5 из federation). Зависимости: music-dht 0.5.0, furumi-library 0.2.0 (без изменений), добавлены quick-xml 0.41 и encoding_rs 0.8.
  • Cargo.lock и [patch]. Неопубликованный frid этому MR не нужен: он собирается против опубликованных на crates.io music-dht 0.5.0 и furumi-library 0.2.0, [patch.crates-io] для frid нет. В Cargo.lock добавлены только quick-xml и encoding_rs. Перегенерировать lock не нужно (MR не для merge).
  • Протокол синхронизации и wire-форматы не менялись: прототип ничего не синхронизирует.

Как проверено

macOS (Darwin 25.5.0), rustc 1.100.0 (stable):

cargo fmt --all -- --check   # без замечаний
cargo check --all-targets    # OK, 0 предупреждений
cargo test --all-targets     # 225 passed; 0 failed; 6 ignored
cargo clippy --all-targets   # 20 предупреждений (bin) / 22 (test): тот же набор, что на базе 292f17f, новых нет

Игнорируемые тесты — ручные: podcasts::tests::manual_feed, podcasts::tests::manual_stream, interop-тест устройств, smoke-тест ONNX и два бенчмарка визуализаторов. Тесты подкастов работают с локальным тестовым HTTP-сервером (src/podcasts/test_server.rs), без внешней сети.

Ограничения

  • Проверено только на macOS, Linux и Windows не проверялись. Ручная проверка в запущенном TUI не проводилась.
  • Все архитектурные недостатки прототипа, перечисленные выше, оставлены намеренно: их исправляет серия MR.

Зависимости от других MR

Не зависит ни от чего. Ветка Sanapach/furumi-tui:podcasts/prototype (один коммит 0da9862 поверх federation @ 292f17f) → Furumi/furumi-tui:federation. Служит справкой для MR-T1, MR-F1, MR-F2 и MR-T2. Закрывается без merge после merge MR-T2.

🤖 Generated with Claude Code

> **Серия «Подкасты»:** MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · **MR-0 Furumi/furumi-tui#1** (этот) · MR-T1 Furumi/furumi-tui#2 · MR-T2 Furumi/furumi-tui#3 · MR-T3 Furumi/furumi-tui#4 · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже. ## ⚠️ Черновик для справки, не для merge Это **исходный GitHub PR** [«Add podcast RSS subscriptions with streaming playback»](https://github.com/Furumi-stack/furumi-tui/pull/1), перенесённый на актуальную ветку `federation`. MR нужен только как основа и ссылка для ревью: здесь видно, откуда берутся RSS-парсер, HTTP-плеер и UI. **Мержить его не нужно.** Его заменяет серия MR из плана `PODCASTS_PLAN.md` (MR-T1, MR-F1, MR-F2, MR-T2, MR-F3, MR-T3, а также MR-W1–W3 в furumi-web). MR закрывается, когда вливается MR-T2. ## Что сделано - Cherry-pick коммита `20167c5` из исходного PR на `origin/federation` @ `292f17f`. Автор коммита сохранён. Merge-коммит `bc023aa` из GitHub-ветки не переносился. - Разрешены конфликты с коммитами, которые появились в `federation` позже: - `2253ec7` / `0ad3844` (простая визуализация статуса). В `Runtime` оставлены оба набора полей: `status_visualizer` и подкастовые `podcasts` / `playback_seq`. В `handle_app_event` оставлены обе группы веток: `StatusVisualizationReady` и `Podcast*`. - `7f0ca29` / `3e46f21` (обогащение карточек артиста и релиза). В `update_tests.rs` сохранены и тесты enrichment, и тесты подкастов. - `292f17f` (статус MODE, версия 0.3.5). Конфликтов не было. - Функционально прототип не менялся. На текущем стабильном тулчейне он собирается без правок, поэтому отдельный коммит с адаптацией не понадобился. Что есть в прототипе: вкладка Podcasts (клавиша `6`), подписка по URL ленты, RSS/Atom-парсер (quick-xml, encoding_rs), каталог выпусков с поиском и сортировкой, потоковое воспроизведение по HTTP с Range-перемоткой, фоновое обновление лент (условные запросы), локальная база `podcasts.sqlite3`. ## Что меняют последующие MR (по `PODCASTS_PLAN.md`) - **Идентичность и очередь (Р2, Р5; MR-F1, MR-T2).** Отрицательные ID выпусков и URL в `file_path` убираются полностью. Вместо них вводятся устойчивые `podcast_id` / `episode_id` (blake3 от канонического URL и GUID, с документированным правилом на случай, когда GUID нет) и явный источник `PlaybackTrack.source` / `TrackItem.podcast`. - **Локальное хранилище (Р3; MR-F2, MR-T2).** Вместо собственной базы прототипа появляется `furumi_library::podcasts::PodcastStore` с миграциями. Миграция импортирует базу этого PR, старые таблицы переименовываются, а не удаляются. Добавляются сезоны, регистр прогресса и сеансы прослушивания. Отписка не удаляет данные. - **Синхронизация (Р4; MR-F1, MR-T2).** Протокол device sync v4: подписки, публикация, прогресс и сеансы синхронизируются между устройствами. Для пиров ниже v4 включается отсечка, источник версии пира исправляется. - **Позиция вкладки (Р8; MR-T1).** Новый порядок вкладок: `1` Library, `2` Playlists, `3` Queue, `4` Podcasts, `5` Settings, `6` Logs. В `keymap.toml` появляется маркер `version = 2` и миграция пользовательских keymap в памяти. - **Приватность (Р6, Р7; MR-T2, MR-F3, MR-T3).** Любая подписка по умолчанию приватная. Выпуски не попадают в Jam-снимки. Публикация в федерации возможна только по явному переключателю и идёт через отдельный подписанный оверлей `podcast_dht`. Перед публикацией выводится предупреждение о токенах в URL. ## Совместимость и версии - Версия crate не менялась (`0.3.5` из `federation`). Зависимости: `music-dht 0.5.0`, `furumi-library 0.2.0` (без изменений), добавлены `quick-xml 0.41` и `encoding_rs 0.8`. - **`Cargo.lock` и `[patch]`.** Неопубликованный frid этому MR не нужен: он собирается против опубликованных на crates.io `music-dht 0.5.0` и `furumi-library 0.2.0`, `[patch.crates-io]` для frid нет. В `Cargo.lock` добавлены только `quick-xml` и `encoding_rs`. Перегенерировать lock не нужно (MR не для merge). - Протокол синхронизации и wire-форматы не менялись: прототип ничего не синхронизирует. ## Как проверено macOS (Darwin 25.5.0), rustc 1.100.0 (stable): ``` cargo fmt --all -- --check # без замечаний cargo check --all-targets # OK, 0 предупреждений cargo test --all-targets # 225 passed; 0 failed; 6 ignored cargo clippy --all-targets # 20 предупреждений (bin) / 22 (test): тот же набор, что на базе 292f17f, новых нет ``` Игнорируемые тесты — ручные: `podcasts::tests::manual_feed`, `podcasts::tests::manual_stream`, interop-тест устройств, smoke-тест ONNX и два бенчмарка визуализаторов. Тесты подкастов работают с локальным тестовым HTTP-сервером (`src/podcasts/test_server.rs`), без внешней сети. ## Ограничения - Проверено только на macOS, Linux и Windows не проверялись. Ручная проверка в запущенном TUI не проводилась. - Все архитектурные недостатки прототипа, перечисленные выше, оставлены намеренно: их исправляет серия MR. ## Зависимости от других MR Не зависит ни от чего. Ветка `Sanapach/furumi-tui:podcasts/prototype` (один коммит `0da9862` поверх `federation` @ `292f17f`) → `Furumi/furumi-tui:federation`. Служит справкой для MR-T1, MR-F1, MR-F2 и MR-T2. Закрывается без merge после merge MR-T2. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
sanapach added 1 commit 2026-11-20 13:22:56 +00:00
(cherry picked from commit 20167c5b5e2a55b1965fe7f7a095b909ce2d9267)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
sanapach changed title from Add podcast RSS subscriptions with streaming playback to WIP: Подкасты — исходный GitHub PR, перенесённый на federation (только для справки, MR-0) 2026-11-20 13:34:50 +00:00
This pull request has changes conflicting with the target branch.
  • CHANGELOG.md
  • Cargo.toml
  • src/app/action.rs
  • src/app/event.rs
  • src/app/mod.rs
  • src/app/podcast_runtime.rs
  • src/app/popup.rs
  • src/app/state.rs
  • src/app/update.rs
  • src/app/update_tests.rs
This pull request is marked as a work in progress.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gt.hexor.cy/sanapach/furumi-tui podcasts/prototype:sanapach-podcasts/prototype
git checkout sanapach-podcasts/prototype
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Furumi/furumi-tui#1