Twitch-VOD-Manager/tasks/v5.0.0-roadmap.md
xRangerDE 80b4292405 docs: OAuth storage layer pattern + roadmap Plan 03 DONE
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 22:15:12 +02:00

4.7 KiB

v5.0.0 Roadmap (Reality-Aligned)

Baseline: v4.6.155 Spec: tasks/v5.0.0-goal.md Last verified: 2026-05-11


Reality Check vs. Goal

Beim Vergleich der echten Codebase (src/main.ts 7485 LoC mit 30+ Sektionen) gegen die Goal-Annahmen zeigt sich: einige "neu zu bauenden" Features existieren teilweise schon.

Pillar Goal sagt Reality Restarbeit %
P1 — Live Stream Recording "neu" Auto-Record-Poller, Live-Recording-Events-Log, Live-Chat-Capture existieren ~30% (Polish + Sub-only-Pfad nach OAuth)
P2 — Twitch OAuth "neu" App nutzt nur public Web-Client-ID, keine User-Auth 100%
P3 — SQLite-Migration "Breaking" Config + Queue + Stats sind JSON-Files 100%
P4 — main.ts Split "neu" 7485 LoC Monolith, 30 Sektionen, schon klar getrennt 100% (mechanische Arbeit)
P5 — UI Power-Features "neu" Vanilla DOM, keine Virtualisierung, kein Mini-Player, ein Theme 90%
P6 — Smart-Resume "neu" auto_resume_live_recording Flag existiert, auto_merge_resumed_parts, Crash-Recovery rudimentaer ~60% (Chunk-Hash + Integrity-Check fehlen)
P7 — Scheduled/Auto-Discovery "neu" Auto-VOD-Download-Poller + Live-Status-Batch-Poller schon implementiert ~30% (Top-Clip-Crawler, Follow-Sync fehlen)

Konsequenz: Reihenfolge der Plane orientiert sich am Restarbeits-Volumen und Dependencies.


Execution Order (reordered post Plan 01)

Plan 01: Foundation — Vitest + Pure-Utility-Extraction          [DONE — v5.0.0-alpha.0]
  └─> Plan 02: SQLite-Foundation (P3)                            [DONE — v5.0.0-alpha.1]
       └─> Plan 03: OAuth Foundation Storage (P2)                [DONE — v5.0.0-alpha.2]
            └─> Plan 03b: OAuth Flow Implementation (P2)         [NEXT]
            └─> Plan 04: Live-Recording Polish + Sub-only (P1)
                 ├─> Plan 05: Auto-Discovery Erweiterung (P7)
                 └─> Plan 06: UI Power-Features (P5)
                      └─> Plan 07: Smart-Resume Finalisierung (P6)
                           └─> Plan 08: Architektur-Split Pt. 1 (state-coupled modules)
                                └─> Plan 09: Architektur-Split Pt. 2 (final split)
                                     └─> Plan 10: v5.0.0-rc.1 → GA

Begruendung der Umordnung: Plan 01 hat das Pure-Extraktion-Pattern validiert (Pillar 4 Teil-1). Weiter splitten der state-gekoppelten Module braucht zuerst eine State-Container-Strategie — das ist besser informiert nachdem Features (SQLite, OAuth, Live-Rec) ins System gehen und die echten Querverbindungen sichtbar sind. Bis dahin lebt das Pattern aus Plan 01 weiter (neue Module landen in src/main/{infra,domain}/), nur die alten in main.ts steckenden Stateful-Funktionen bleiben dort.

Plan 02 = Pillar 3 (SQLite). Plan 03 = Pillar 2 (OAuth). Plan 04 = Pillar 1. Plan 05 = Pillar 7. Plan 06 = Pillar 5. Plan 07 = Pillar 6. Plan 08-09 = Pillar 4 Rest. Plan 10 = Release.


Plan Status

# Plan Datei Status
01 Foundation: Vitest + Pure-Utility-Extraction tasks/v5.0.0-plan-01-foundation.md DONE (v5.0.0-alpha.0)
02 SQLite-Foundation (Pillar 3) tasks/v5.0.0-plan-02-sqlite.md DONE (v5.0.0-alpha.1)
03 OAuth Foundation Storage (Pillar 2) tasks/v5.0.0-plan-03-oauth-foundation.md DONE (v5.0.0-alpha.2)
03b OAuth Flow Implementation (Pillar 2) tasks/v5.0.0-plan-03b-oauth-flow.md NEXT
04 Live-Recording Polish (Pillar 1) tasks/v5.0.0-plan-04-live-rec.md nach Plan 03b
05 Auto-Discovery Erweiterung (Pillar 7) tasks/v5.0.0-plan-05-auto-disc.md nach Plan 04
06 UI Power (Pillar 5) tasks/v5.0.0-plan-06-ui-power.md nach Plan 04
07 Smart-Resume Final (Pillar 6) tasks/v5.0.0-plan-07-smart-resume.md nach Plan 06
08 Architektur-Split Pt. 1 (Pillar 4) tasks/v5.0.0-plan-08-split-pt1.md nach Plan 07
09 Architektur-Split Pt. 2 (Pillar 4) tasks/v5.0.0-plan-09-split-pt2.md nach Plan 08
10 Release 5.0.0 GA tasks/v5.0.0-plan-10-release.md nach Plan 09

Versionsstrategie (post Reorder)

Plan abgeschlossen Version
Plan 01 5.0.0-alpha.0 Foundation, vitest + pure modules (DONE)
Plan 02 5.0.0-alpha.1 SQLite Migrator (Breaking, opt-in next-channel)
Plan 03 5.0.0-alpha.2 OAuth
Plan 04 5.0.0-beta.0 Live-Recording Polish + Sub-only
Plan 05 5.0.0-beta.1 Auto-Discovery
Plan 06 5.0.0-beta.2 UI Power
Plan 07 5.0.0-beta.3 Smart-Resume
Plan 08-09 5.0.0-rc.0 / rc.1 Architektur-Split
Plan 10 5.0.0 stable

Pro Plan: ein Release-Tag, Auto-Updater Channel next. 4.6-User bleiben auf stable.