Files
whyrating-engine-legacy/web
Alejandro Gutiérrez c8ecb4b98f feat(reviewiq): Add AI synthesis support to dashboard components
Frontend:
- Add Synthesis type with action plan, insights, annotations
- ExecutiveSummary: Accept synthesis prop for AI narrative
- SentimentPie: Accept insight prop for contextual explanation
- IntensityHeatmap: Accept insight + highlightDomain props
- TimelineChart: Accept insight + annotations props
- All components gracefully degrade when synthesis is null

Backend:
- Add Stage 4: Synthesize for generating AI narratives
- Gathers context from classified spans
- Generates executive narrative, section insights, action plan
- Produces timeline annotations and marketing angles
- Stores synthesis in pipeline.executions table

Components show AI insights with purple gradient styling when available,
fall back to existing behavior when synthesis is not yet generated.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 02:59:47 +00:00
..

Google Reviews Scraper - Testing Interface

A Next.js web interface for testing the containerized Google Reviews Scraper API.

Features

  • 🎯 URL Input - Paste any Google Maps business URL
  • 📊 Real-time Status - Live job tracking with polling
  • Performance Metrics - Reviews count, time, speed
  • 📱 Review Display - Beautiful UI for scraped reviews
  • 💾 Export JSON - Download reviews as JSON

Quick Start

1. Start the Scraper API

First, make sure the containerized scraper is running:

cd ..
docker-compose -f docker-compose.production.yml up -d

The API should be running at http://localhost:8000

2. Start the Web Interface

npm install
npm run dev

Open http://localhost:3000

Usage

  1. Paste a Google Maps URL

    https://www.google.com/maps/place/Business+Name/...
    
  2. Click "Scrape"

    • Job is submitted to the API
    • Status updates in real-time
    • Reviews appear when complete
  3. View Results

    • See all scraped reviews
    • Export as JSON
    • View performance metrics

Environment Variables

Create .env.local if you need to customize:

# API URL (default: http://localhost:8000)
NEXT_PUBLIC_API_URL=http://localhost:8000

API Endpoints Used

This interface connects to:

  • POST /scrape - Submit scraping job
  • GET /jobs/{job_id} - Get job status
  • GET /jobs/{job_id}/reviews - Get reviews

Tech Stack

  • Next.js 15 - React framework
  • TypeScript - Type safety
  • Tailwind CSS - Styling
  • API Proxy - Next.js API routes proxy to scraper API

Development

npm run dev       # Start dev server
npm run build     # Build for production
npm run start     # Start production server
npm run lint      # Run ESLint

Notes

  • The interface polls job status every 2 seconds
  • Polling stops when job completes or fails
  • Reviews are fetched with a limit of 1000 by default
  • Export button downloads reviews as formatted JSON