docs: create sprint-002 specification and mark all tasks as completed

This commit is contained in:
Gan, Jimmy
2026-07-11 13:45:29 +08:00
parent 022b024603
commit b81f6ef775
2 changed files with 35 additions and 1 deletions
+1 -1
View File
@@ -1 +1 @@
sprint-001-sync-reliability.md
sprint-002-ux-search-metadata.md
@@ -0,0 +1,34 @@
# Sprint 002 — UX Overhaul, Full-Text Search & Metadata Enrichment
**Goal:** Overhaul the t-youtube reading experience by completing the search workflow, adding transcript visibility, fetching duration/views metadata, and implementing cursor-based/offset pagination (infinite scroll).
---
## [x] T2.1 — Full-Text Search Frontend Integration
- **Files:** `frontend/src/routes/YoutubeDashboard.svelte`
- **Done means:** Search queries directly populate the main video list in the sidebar (rather than a temporary dropdown), and clearing the search resets the view.
- **Verify by:**
1. Type search query -> video list dynamically updates with FTS results from backend.
2. Click a search result -> detail view loads it.
3. Clear query/blur search -> list reverts to standard tab view.
## [x] T2.2 — Transcript Accordion in Details View
- **Files:** `frontend/src/routes/YoutubeDashboard.svelte`
- **Done means:** Add an expandable accordion below the "AI Digest" section to view the raw video transcript. If transcript is long, render in scrollable container.
- **Verify by:**
1. Click video with transcript -> "Show Full Transcript" accordion appears.
2. Click to expand -> raw transcript displays correctly.
## [x] T2.3 — Ingest Duration and View Count Metadata
- **Files:** `backend/fetcher.py`, `backend/tests/test_fetcher.py`
- **Done means:** Update `fetcher.py` videos.list API call to request `part="snippet,contentDetails,statistics"`. Parse ISO 8601 duration into integer seconds, and store duration + view count in SQLite db. Update unit tests to include mock response fields.
- **Verify by:**
1. Run `./run_tests.sh` to ensure fetcher tests pass.
2. Sync subscriptions -> inspect database to confirm `duration` and `view_count` are populated for new videos.
## [x] T2.4 — Cursor/Offset Pagination (Infinite Scroll)
- **Files:** `backend/main.py`, `frontend/src/routes/YoutubeDashboard.svelte`
- **Done means:** Add pagination queries to `/api/videos` backend endpoint (e.g. `offset` and `limit`). In Svelte frontend, implement scroll listener on the sidebar video list to trigger next page load when reaching bottom.
- **Verify by:**
1. Load pending tab -> initially loads 50 videos.
2. Scroll to bottom of sidebar -> next 50 videos append automatically.