docs: create roadmap (8 phases)

.planning/STATE.md

@@ -0,0 +1,66 @@
+# Project State
+
+## Project Reference
+
+See: .planning/PROJECT.md (updated 2026-02-23)
+
+**Core value:** When an F1 session is live, users open one URL and immediately see working streams — no hunting for links.
+**Current focus:** Phase 1 — Infrastructure and Deployment
+
+## Current Position
+
+Phase: 1 of 8 (Infrastructure and Deployment)
+Plan: 0 of TBD in current phase
+Status: Ready to plan
+Last activity: 2026-02-23 — Roadmap created, phase structure derived from 19 v1 requirements
+
+Progress: [░░░░░░░░░░] 0%
+
+## Performance Metrics
+
+**Velocity:**
+- Total plans completed: 0
+- Average duration: —
+- Total execution time: 0 hours
+
+**By Phase:**
+
+| Phase | Plans | Total | Avg/Plan |
+|-------|-------|-------|----------|
+| - | - | - | - |
+
+**Recent Trend:**
+- Last 5 plans: —
+- Trend: —
+
+*Updated after each plan completion*
+
+## Accumulated Context
+
+### Decisions
+
+Decisions are logged in PROJECT.md Key Decisions table.
+Recent decisions affecting current work:
+
+- [Init]: Custom per-site extractors over headless browser — more efficient and reliable
+- [Init]: No authentication — security by obscurity (private URL) is sufficient
+- [Init]: Proxy streams through service — hides CDN source, enables unified player
+- [Research]: Use yt-dlp as Python library (primary), httpx+BeautifulSoup (custom extractors), Playwright (last resort)
+- [Research]: APScheduler in-process — avoids Celery overhead for 2 periodic jobs
+- [Research]: Phase 2 (Extractor) and Phase 5 (Coverage expansion) need site-specific research during planning
+
+### Pending Todos
+
+None yet.
+
+### Blockers/Concerns
+
+- [Pre-Phase 3]: Target streaming sites not yet specified — Phase 3 planning requires site list and DevTools reverse-engineering session before extractors can be scoped
+- [Pre-Phase 3]: Must test extractor access from production K8s cluster network — datacenter IPs may be pre-blocked by streaming sites
+- [Pre-Phase 2]: Validate jolpica API availability and rate limits before depending on it for schedule data
+
+## Session Continuity
+
+Last session: 2026-02-23
+Stopped at: Roadmap created — all 19 v1 requirements mapped across 8 phases
+Resume file: None