Bring FastAPI/React migration to Streamlit feature and design parity

.github/workflows/fastapi-react.yml

@@ -3,6 +3,10 @@ name: FastAPI + React parity checks
 permissions:
   contents: read
 
+concurrency:
+  group: fastapi-react-parity-${{ github.ref }}
+  cancel-in-progress: true
+
 on:
   pull_request:
     paths:
@@ -70,3 +74,115 @@ jobs:
       - name: Production-deps audit
         run: npm run audit
         continue-on-error: true  # dev-dep advisories only; see PARITY_REPORT.md
+
+
+  visual-parity:
+    name: Visual parity evidence
+    runs-on: ubuntu-latest
+    needs: [backend, frontend]
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: fastapi_react/backend/requirements.txt
+      - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: fastapi_react/frontend/package-lock.json
+      - name: Install backend
+        working-directory: fastapi_react/backend
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+      - name: Install Streamlit reference runtime
+        run: pip install -r requirements-web.txt
+      - name: Install frontend and browser
+        working-directory: fastapi_react/frontend
+        run: |
+          npm ci
+          npx playwright install --with-deps chromium
+      - name: Start parity stack
+        env:
+          F1_REPO_ROOT: ${{ github.workspace }}
+          ENABLE_EXPENSIVE_TOOLS: "0"
+          F1_RESEARCH_MODE: "0"
+          STREAMLIT_SERVER_HEADLESS: "true"
+        run: |
+          (cd fastapi_react/backend && uvicorn app.main:app --host 127.0.0.1 --port 8000 > /tmp/f1-backend.log 2>&1 & echo $! > /tmp/f1-backend.pid)
+          (cd fastapi_react/frontend && npm run dev -- --host 127.0.0.1 --port 5173 > /tmp/f1-frontend.log 2>&1 & echo $! > /tmp/f1-frontend.pid)
+          (streamlit run raceAnalysis.py --server.address 127.0.0.1 --server.port 8501 --server.headless true > /tmp/f1-streamlit.log 2>&1 & echo $! > /tmp/f1-streamlit.pid)
+          for i in {1..90}; do
+            if curl -fsS http://127.0.0.1:8000/api/health >/dev/null               && curl -fsS http://127.0.0.1:5173 >/dev/null               && curl -fsS http://127.0.0.1:8501/_stcore/health >/dev/null; then
+              exit 0
+            fi
+            sleep 2
+          done
+          cat /tmp/f1-backend.log || true
+          cat /tmp/f1-frontend.log || true
+          cat /tmp/f1-streamlit.log || true
+          exit 1
+      - name: Capture React reference
+        working-directory: fastapi_react/frontend
+        env:
+          REACT_BASE_URL: http://127.0.0.1:5173
+          REACT_WAIT_MS: "4000"
+        run: npm run capture:react
+      - name: Accessibility audit
+        id: accessibility
+        continue-on-error: true
+        working-directory: fastapi_react/frontend
+        env:
+          REACT_BASE_URL: http://127.0.0.1:5173
+        run: npm run audit:a11y
+      - name: Operational benchmark
+        id: benchmark
+        continue-on-error: true
+        working-directory: fastapi_react/frontend
+        env:
+          BENCH_BASE_URL: http://127.0.0.1:5173
+          BENCH_API_URL: http://127.0.0.1:8000
+        run: npm run benchmark
+      - name: Capture local Streamlit reference
+        id: streamlit_capture
+        continue-on-error: true
+        working-directory: fastapi_react/frontend
+        env:
+          STREAMLIT_BASE_URL: http://127.0.0.1:8501
+          STREAMLIT_WAIT_MS: "5000"
+        run: npm run capture:streamlit
+      - name: Diff screenshots
+        id: visual_diff
+        continue-on-error: true
+        working-directory: fastapi_react/frontend
+        run: npm run capture:diff
+      - name: Upload visual parity evidence
+        if: always()
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: fastapi-react-parity-evidence
+          path: |
+            fastapi_react/parity_evidence/visual
+            fastapi_react/parity_evidence/accessibility.json
+            fastapi_react/parity_evidence/benchmarks.json
+          if-no-files-found: warn
+      - name: Enforce parity evidence gates
+        if: always()
+        env:
+          ACCESSIBILITY_OUTCOME: ${{ steps.accessibility.outcome }}
+          BENCHMARK_OUTCOME: ${{ steps.benchmark.outcome }}
+          STREAMLIT_CAPTURE_OUTCOME: ${{ steps.streamlit_capture.outcome }}
+          VISUAL_DIFF_OUTCOME: ${{ steps.visual_diff.outcome }}
+        run: |
+          failed=0
+          for gate in ACCESSIBILITY_OUTCOME BENCHMARK_OUTCOME STREAMLIT_CAPTURE_OUTCOME VISUAL_DIFF_OUTCOME; do
+            outcome="${!gate}"
+            echo "$gate=$outcome"
+            if [ "$outcome" != "success" ]; then
+              failed=1
+            fi
+          done
+          exit "$failed"

fastapi_react/backend/app/main.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import datetime
 import os
 from typing import Any
 
@@ -22,6 +23,7 @@
 from app.services.data import (
     filter_schema,
     list_data_files,
+    load_main_data,
     model_manifest,
     precomputed,
     query_main,
@@ -81,6 +83,16 @@ def brand_logo() -> FileResponse:
 
 @app.get("/api/meta")
 def meta() -> dict[str, Any]:
+    data = load_main_data()
+    years = data.get("grandPrixYear")
+    race_start_year = int(years.min()) if years is not None and years.notna().any() else 2016
+    current_year = int(years.max()) if years is not None and years.notna().any() else datetime.datetime.now().year
+    candidates = [path for path in DATA_DIR.iterdir() if path.is_file()] if DATA_DIR.exists() else []
+    latest = max(candidates, key=lambda path: path.stat().st_mtime, default=None)
+    last_updated = (
+        datetime.datetime.fromtimestamp(latest.stat().st_mtime).strftime("%Y-%m-%d %I:%M %p")
+        if latest is not None else "No data files found"
+    )
     return {
         "tabs": [
             "Data Explorer", "Analytics", "Current Season", "Next Race",
@@ -89,6 +101,10 @@ def meta() -> dict[str, Any]:
         "models": MODEL_TYPES,
         "expensive_tools_enabled": ENABLE_EXPENSIVE_TOOLS,
         "manual_tools": list(TOOLS),
+        "race_start_year": race_start_year,
+        "current_year": current_year,
+        "last_updated": last_updated,
+        "code_deployed_at": datetime.datetime.now(datetime.UTC).strftime("%Y-%m-%d %H:%M:%S UTC"),
     }
 
 

fastapi_react/backend/app/schemas.py

@@ -15,6 +15,7 @@ class QueryRequest(BaseModel):
     filters: list[FilterSpec] = Field(default_factory=list)
     columns: list[str] | None = None
     sort: list[str] = Field(default_factory=list)
+    ascending: list[bool] | None = None
     descending: bool = False
     offset: int = 0
     limit: int = Field(default=200, ge=1, le=5000)