From 1bb23901ebec33605eee7c82ec3345b94ef31b9a Mon Sep 17 00:00:00 2001 From: TapTap Date: Sun, 15 Nov 2026 21:06:32 +0000 Subject: [PATCH] docs: record the client side of the mood-first redesign [skip ci] --- docs/mood-first-client.md | 48 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 docs/mood-first-client.md diff --git a/docs/mood-first-client.md b/docs/mood-first-client.md new file mode 100644 index 0000000..833c84a --- /dev/null +++ b/docs/mood-first-client.md @@ -0,0 +1,48 @@ +# Mood-first redesign — client notes + +The canonical design and decision log lives in the server repo: + +- local: `/home/taptap/AudioManager/docs/design/mood-first.md` +- web: https://gitea.tap-tap.win/TapTap/AudioManager/src/branch/main/docs/design/mood-first.md + +Read that first. This file only records the client-side consequences. + +## What the client becomes + +- Moods are the only content model. No Library, no Longform, no mounted music. +- All music is downloaded on the server from YouTube; the client searches and + adds songs to a mood. +- A mood has **songs** (collection) and **recommendations** (auto-downloaded, + playable in radio, not permanent until added). +- Playback mixes collection and ready recommendations using `collectionPercent`. +- A mood needs at least one song to play. + +## Screens + +`Moods | MoodDetail | Search | Downloads | Settings` + +- **Moods**: mood list, create, global search. +- **MoodDetail**: songs, add music, recommendations (Add / Not interested / + Retry), next batch, mood settings (query, genres, collectionPercent, + recommendationCount 0–30, refreshHours). +- **Search**: remote YouTube search, results over 10 minutes hidden, add to the + current or a chosen mood, already-downloaded/in-mood badges, paste URL. +- **Downloads**: device-side offline files, delete/clear, storage usage. +- **Settings**: server/account/devices/logout (no scan UI). + +Remove `LibraryScreen` and all longform UI. + +## State/API changes + +- Remove `library`, `longform`, `longformResults`, `longformProgress`, + `musicResults`, local `searchResults`, `playAll`, `playLongform*`, + `resumeLongform`, longform progress reporting. +- Add remote search state (`searchResults`, `searchTargetMoodId`), add/remove + song, recommendation add/reject/retry, mood song counts. +- `CachedState` becomes version 2 with moods + mood details only; invalidate old + caches. +- `SongDto` gains `videoId` and `thumbnail`; loses folder/album-id/path/genres. +- Cover art is song-keyed: `coverUrl(songId)`. +- Playback snapshot/history, desktop seek, Android media session, sleep timer + and device downloads remain. +- Offline mood playback uses device downloads and cached mood details.