Add real-time progress tracking to inventory sync

[bokelley]

Overview

Adds real-time phase-by-phase progress tracking to inventory sync, replacing generic "Syncing..." with specific phase info and item counts.

Features

1. Phase-by-Phase Progress (6 phases)

• Phase 1: Discovering Ad Units
• Phase 2: Discovering Placements
• Phase 3: Discovering Labels
• Phase 4: Discovering Targeting Keys
• Phase 5: Discovering Audience Segments
• Phase 6: Saving to Database

2. Real-Time Item Counts

Button shows: ⏳ Discovering Ad Units: 243 items (1/6)

• Phase name
• Item count discovered
• Progress (current phase / total phases)

3. "Navigate Away" Message

Shows info alert: "💡 Tip: Feel free to navigate away - the sync continues in the background!"

4. Polling Updates Every 2 Seconds

Frontend polls status endpoint and updates button text in real-time

Technical Implementation

Database:

• Added progress JSONB column to sync_jobs table
• Migration: ed7d05fea3be_add_progress_tracking_to_sync_jobs.py

Backend (gam.py):

• Replace single sync_all() call with phase-by-phase discovery
• Update SyncJob.progress after each phase completion
• Helper function: update_progress(phase, phase_num, total_phases, count)

Frontend (tenant_settings.js):

• Parse progress object from status endpoint
• Update button text with phase info and counts
• Show/hide "navigate away" message
• Clear progress message on completion/error

Status Endpoint:

• Include progress field in response if available
• Format: {"phase": "...", "phase_num": 1, "total_phases": 6, "count": 243}

UX Improvements

Before:

⏳ Syncing...

After:

⏳ Discovering Ad Units: 243 items (1/6)
⏳ Discovering Placements: 67 items (2/6)
⏳ Discovering Labels: 12 items (3/6)
⏳ Discovering Targeting Keys: 145 items (4/6)
⏳ Discovering Audience Segments: 23 items (5/6)
⏳ Saving to Database: 243 items (6/6)

Plus info message: "💡 Feel free to navigate away - the sync continues in the background!"

Testing Notes

• Tested with AccuWeather sync (running in production now)
• Progress updates visible every 2 seconds
• No breaking changes to existing sync functionality
• Migration is additive (new nullable column)

Related

Follow-up to PR #507 (background sync with polling)

🤖 Generated with Claude Code