Add OpenAPI client generation and Google Analytics tracking

OpenAPI Integration:
- Embed openapi.json from SaaS app in src-tauri/
- Generate type-safe Rust API client at build time (progenitor)
- Rewrite upload.rs to use generated client instead of manual types
- Add scripts/check_openapi_sync.sh to verify schema is in sync

Google Analytics:
- Add analytics.ts with GA4 initialization and tracking
- Track virtual page views for all screens (permission, selection, progress, etc.)
- Track funnel events (permission required, chats loaded, export started/completed/failed)
- Configure via VITE_GA_MEASUREMENT_ID environment variable

Privacy:
- Add "Privacy & Telemetry" section to README
- Document what data is collected and what is NOT collected
- Be transparent that no chat content or personal data is sent to analytics

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ndbroadbent

.env.example

@@ -0,0 +1,4 @@
+# Google Analytics 4 Measurement ID
+# Get this from: Google Analytics > Admin > Data Streams > Web
+# Format: G-XXXXXXXXXX
+VITE_GA_MEASUREMENT_ID=

README.md

@@ -171,6 +171,28 @@ This project follows strict quality standards:
 
 All checks must pass before committing. Git hooks enforce this automatically.
 
+---
+
+## Privacy & Telemetry
+
+This app collects anonymous usage analytics via Google Analytics to help us improve the user experience.
+
+### What We Collect
+
+- **Screen views**: Which screens you visit (permission, chat selection, progress, success, error)
+- **Funnel events**: Whether you complete the export flow, and where drop-offs occur
+- **Aggregate counts**: Number of chats loaded, number of chats selected for export
+
+### What We Do NOT Collect
+
+- **No chat content**: Your messages are never sent to analytics
+- **No personal data**: No names, phone numbers, or identifiers
+- **No contact information**: Your address book data stays on your device
+
+Analytics data helps us understand which parts of the app work well and where users encounter issues.
+
+---
+
 ## License
 
 GPL-3.0 - See [LICENSE](LICENSE) for details.

scripts/check_openapi_sync.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# Check if openapi.json is in sync with the SaaS app
+#
+# Usage:
+#   ./scripts/check_openapi_sync.sh           # Check against local SaaS
+#   ./scripts/check_openapi_sync.sh --update  # Update from local SaaS
+#
+# This script is meant to be run from the desktop app directory:
+#   /path/to/chat_to_map_desktop/
+#
+# It expects the SaaS app to be at:
+#   /path/to/chat_to_map_saas/static/openapi.json (after build)
+#
+# Or in a worktree setup:
+#   ../static/openapi.json
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DESKTOP_ROOT="$(dirname "$SCRIPT_DIR")"
+DESKTOP_SCHEMA="$DESKTOP_ROOT/src-tauri/openapi.json"
+
+# Try to find the SaaS openapi.json
+# 1. Worktree setup: ../static/openapi.json (desktop is inside saas worktree)
+# 2. Sibling repo: ../chat_to_map_saas/static/openapi.json
+SAAS_SCHEMA=""
+if [[ -f "$DESKTOP_ROOT/../static/openapi.json" ]]; then
+    SAAS_SCHEMA="$DESKTOP_ROOT/../static/openapi.json"
+elif [[ -f "$DESKTOP_ROOT/../../chat_to_map_saas/static/openapi.json" ]]; then
+    SAAS_SCHEMA="$DESKTOP_ROOT/../../chat_to_map_saas/static/openapi.json"
+fi
+
+check_sync() {
+    if [[ ! -f "$DESKTOP_SCHEMA" ]]; then
+        echo -e "${RED}Error: Desktop openapi.json not found at $DESKTOP_SCHEMA${NC}"
+        echo "Run --update to copy it from the SaaS app"
+        exit 1
+    fi
+
+    if [[ -z "$SAAS_SCHEMA" ]]; then
+        echo -e "${YELLOW}Warning: SaaS openapi.json not found${NC}"
+        echo "Expected at:"
+        echo "  - ../static/openapi.json (worktree)"
+        echo "  - ../../chat_to_map_saas/static/openapi.json (sibling)"
+        echo ""
+        echo "Build the SaaS app first: cd <saas> && bun run build"
+        exit 1
+    fi
+
+    if ! diff -q "$DESKTOP_SCHEMA" "$SAAS_SCHEMA" > /dev/null 2>&1; then
+        echo -e "${RED}Error: openapi.json is out of sync!${NC}"
+        echo ""
+        echo "Desktop: $DESKTOP_SCHEMA"
+        echo "SaaS:    $SAAS_SCHEMA"
+        echo ""
+        echo "Run: ./scripts/check_openapi_sync.sh --update"
+        exit 1
+    fi
+
+    echo -e "${GREEN}✅ openapi.json is in sync${NC}"
+}
+
+update_schema() {
+    if [[ -z "$SAAS_SCHEMA" ]]; then
+        echo -e "${RED}Error: SaaS openapi.json not found${NC}"
+        echo "Build the SaaS app first: cd <saas> && bun run build"
+        exit 1
+    fi
+
+    echo "Copying from: $SAAS_SCHEMA"
+    echo "         to: $DESKTOP_SCHEMA"
+    cp "$SAAS_SCHEMA" "$DESKTOP_SCHEMA"
+    echo -e "${GREEN}✅ openapi.json updated${NC}"
+    echo ""
+    echo "Next steps:"
+    echo "  1. cargo build --lib  # Regenerate Rust types"
+    echo "  2. cargo test         # Verify types compile"
+    echo "  3. git add src-tauri/openapi.json"
+    echo "  4. git commit -m 'Update openapi.json from SaaS'"
+}
+
+case "${1:-}" in
+    --update|-u)
+        update_schema
+        ;;
+    --help|-h)
+        echo "Usage: $0 [--update]"
+        echo ""
+        echo "Check or update openapi.json sync with SaaS app."
+        echo ""
+        echo "Options:"
+        echo "  --update, -u  Copy openapi.json from SaaS to desktop"
+        echo "  --help, -h    Show this help"
+        ;;
+    *)
+        check_sync
+        ;;
+esac