Add MVP completion checklist

documentations/refactor/21-mvp-completion-checklist.md

@@ -0,0 +1,75 @@
+# MVP Completion Checklist
+
+## Status
+
+The local-first Web UI MVP is now functionally assembled. The app can ingest
+OpenF1 data into the SQLite domain store, serve local-first Race Hub and
+navigation APIs, render the React Race Hub/Data Library/Live Timing routes, and
+serve the built React app from Go web mode when `frontend/dist` is present.
+
+This document replaces the temporary agent handoff prompts as the main
+checkpoint for what has been completed and what remains.
+
+## Completed
+
+- Live SignalR code extracted into `internal/live` and reused by TUI and Web
+  mode.
+- SQLite domain store added for local historical data.
+- Session, meeting, and weekend ingestion paths added with dry-run support.
+- Optional analytics ingestion failures are partial, not hard blockers.
+- Local-first Race Hub API added with dataset availability metadata.
+- Local-first season, meeting, and weekend navigation APIs added.
+- React + TypeScript frontend added with TanStack Query and Router.
+- Race Hub route added for classification, grid, strategy, positions, laps,
+  race control, weather, and dataset status.
+- Data Library route added for local season/weekend coverage and CLI guidance.
+- Live Timing route added for current backend live snapshot/SSE state.
+- Go web mode serves the built React app from `frontend/dist` and falls back to
+  embedded legacy assets when no build is present.
+
+## Verification Commands
+
+Run these before cutting an MVP tag or handing the repo to another agent:
+
+```bash
+go test ./internal/live ./internal/store ./internal/ingest ./internal/query ./internal/web
+npm test -- --run --prefix frontend
+npm run build --prefix frontend
+npm run test:e2e
+```
+
+For a local manual smoke test:
+
+```bash
+go run ./scripts/seed-e2e-db/main.go --db /tmp/boxbox-mvp.db
+BOXBOX_DISABLE_LIVE=1 go run ./cmd/main.go --web --db /tmp/boxbox-mvp.db --port 18080
+BOXBOX_API_PORT=18080 npm run dev --prefix frontend -- --host 127.0.0.1 --port 15173 --strictPort
+```
+
+Then open:
+
+- `http://127.0.0.1:15173/race-hub?session_key=9472`
+- `http://127.0.0.1:15173/data-library`
+- `http://127.0.0.1:15173/live`
+
+## Remaining Post-MVP Work
+
+- Add real visual-regression checks for the React screens.
+- Improve high-density mobile/iPad behavior for Live Timing and Race Hub tables.
+- Add persisted live-event capture and reconciliation only after defining the
+  live storage model.
+- Add track outline ingestion/read models to the React app if the local data
+  source is reliable enough.
+- Expand from weekend/session ingestion toward safe full-season backfill.
+- Add Command Center, Drivers, Standings, and Settings as separate product
+  phases.
+- Revisit static archive feasibility after source mapping is proven.
+
+## Notes
+
+- `--ingest-year` currently discovers season meetings and sessions. Use
+  `--ingest-meeting <meeting_key>` for full weekend ingestion.
+- The React app should continue avoiding direct OpenF1 reads. New Web UI routes
+  should call local-first Go APIs.
+- The TUI live mode remains intentionally preserved. Historical Web UI parity
+  with the TUI is not required for this MVP.