Files
whyrating-engine-legacy/web
Alejandro Gutiérrez 8f9dd136cd feat(reviewiq): Redesign dashboard with user-friendly UX
- ExecutiveSummary: Add rating badge with emoji, AI narrative section,
  #1 Problem/#1 Strength cards, domain complaints with progress bars
- SentimentPie: Replace pie chart with card-based design showing
  sentiment score, emoji indicators (😊😟😐🤔), percentages
- IntensityHeatmap: Transform to Praise vs Complaints heatmap with
  friendly domain labels (👥 Staff, 💰 Pricing, etc.)
- URTBarChart: Horizontal progress bars with emojis, health indicators
- TimelineChart: Add view toggles (Sentiment/Volume/Rating), trend
  indicator, fix chronological order (oldest→newest left→right)
- ReviewIQDashboard: Streamline from 11 sections to 5, remove redundancy

Removed redundant components:
- DomainScores (merged into ExecutiveSummary)
- KPISection (stats in header)
- RatingSimulator (in ExecutiveSummary)
- StrengthsWeaknesses (in ExecutiveSummary)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 02:52:13 +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