# ScaleExplorer — Full Documentation for LLMs

> Compare anything — discover dimensions, weights, speeds and more.

Website: https://scaleexplorer.com
Language: French (UI), data is multilingual

## Overview

ScaleExplorer is a collaborative measurement comparison platform. Users search for any real-world object, and the system resolves its dimensions (height, weight, speed, area, etc.) using AI. Each search enriches a shared database, making future comparisons richer.

## Database Stats

- Total items: 362
- All items have multiple measurements (height, weight, speed, etc.)

## Top Items by Popularity

  - 🗼 Tour Eiffel (/item/tour-eiffel) [bâtiment]
  - ✈️ Boeing 747 (/item/boeing-747) [véhicule]
  - 🍕 Pizza (/item/pizza) [nourriture]
  - 🚢 Titanic (/item/titanic) [véhicule]
  - ⛰️ Mont Everest (/item/mont-everest) [nature]
  - 🐈 Chat domestique (/item/chat-domestique) [animal]
  - 🍆 Pénis humain (/item/penis-humain) [personne]
  - 🐆 Chat sauvage (/item/chat-sauvage) [animal]
  - 🐳 Baleine bleue (/item/baleine-bleue) [animal]
  - 🍆 Pénis (/item/penis) [personne]
  - 💬 Discussion en ligne (chat) (/item/discussion-en-ligne-chat) [technologie]
  - 🚢 Porte-avions (/item/porte-avions) [véhicule]
  - 🚗 Voiture (/item/voiture) [véhicule]
  - 🎮 PlayStation 5 (/item/playstation-5) [technologie]
  - 🥫 Canette de boisson (/item/canette-de-boisson) [objet]
  - 🖊️ Stylo à bille (/item/stylo-a-bille) [objet]
  - 🏢 Tour Part-Dieu (/item/tour-part-dieu) [bâtiment]
  - 🪖 Char d'assaut (/item/char-dassaut) [véhicule]
  - 🐉 Immeuble en forme de dragon (/item/immeuble-en-forme-de-dragon) [bâtiment]
  - 🥄 Cuillère (/item/cuillere) [objet]
  - ⚛️ Atome (/item/atome) [nature]
  - 🧠 Cerveau humain (/item/cerveau-humain) [personne]
  - 🏠 Maison individuelle (/item/maison-individuelle) [bâtiment]
  - 💩 Excrément (/item/excrement) [nature]
  - 🌕 Lune (/item/lune) [nature]
  - 🌌 Vide (Espace) (/item/vide-espace) [nature]
  - 🌍 Terre (/item/terre) [nature]
  - 🍞 Pain (/item/pain) [nourriture]
  - 🏢 Empire State Building (/item/empire-state-building) [bâtiment]
  - 🐞 Coccinelle (insecte) (/item/coccinelle-insecte) [animal]

## Pages & Routes

### Homepage (`/`)
Interactive search: type anything → AI resolves the object → choose a measurement → see comparisons with other objects of the same type.

### Item Page (`/item/{slug}`)
Dedicated page for each item. Shows:
- All measurements (clickable to compare)
- Inline comparison results
- Battle links with popular items (SEO maillage)
- Related items

### Battle Mode (`/battle`)
Compare two objects side by side. Features:
- AI-powered search for both objects
- Visual bar comparison
- Ratio display
- Share button (generates SEO URL)

### Battle Page (`/battle/{slugA}-vs-{slugB}`)
Static SEO page for a specific battle. Server-rendered with:
- Full comparison visualization
- Side-by-side measurements
- Links to both item pages
- Other battle suggestions

### Scale Quest (`/game`)
Quiz game: guess the dimensions of random objects.
- Multiple choice (4 options)
- Timer-based scoring
- Streak bonuses
- Share score on social

## API Reference

### Search / Resolve

```
GET /api/resolve?q={query}
```
Search existing items by name or slug. Returns array of matching items.

```
POST /api/resolve
Content-Type: application/json
{"query": "Tour Eiffel"}
```
AI-powered resolution. If the item doesn't exist in DB, uses Gemini to resolve dimensions and adds it to the database.

Response:
```json
{
  "items": [{
    "id": 1,
    "slug": "tour-eiffel",
    "name": "Tour Eiffel",
    "emoji": "🗼",
    "category": "monument",
    "description": "...",
    "measurements": [
      {"type": "height", "label": "Hauteur", "value": 330, "unit": "m", "display": "330 m"},
      {"type": "weight", "label": "Poids", "value": 7300, "unit": "t", "display": "7 300 t"}
    ],
    "primaryDimensionM": 330,
    "funFact": "..."
  }]
}
```

### Trending Items

```
GET /api/items/trending?limit=10
```
Returns most searched/battled items.

### Compare Items

```
GET /api/items/compare?value=330&unit=m&type=height&exclude=tour-eiffel&limit=24
```
Finds items with comparable measurements of the same type. Returns ratio and display text.

### Quiz Questions

```
GET /api/game/questions?count=10
```
Random quiz questions from the database.

## Measurement Types

| Type | Unit | Example |
|------|------|---------|
| height | m | Hauteur d'un bâtiment |
| length | m | Longueur d'un véhicule |
| width | m | Largeur d'un terrain |
| weight | kg/t | Poids d'un animal |
| speed | km/h | Vitesse max |
| area | m²/km² | Surface |
| volume | m³/L | Volume |
| capacity | personnes | Capacité d'accueil |
| temperature | °C | Température |
| power | kW/ch | Puissance |
| price | € | Prix |
| age | ans | Âge / durée de vie |
| population | hab | Population |
| altitude | m | Altitude |
| depth | m | Profondeur |
| consumption | L/100km | Consommation |
| calories | kcal | Calories |
| noise | dB | Niveau sonore |

## Technical Stack

- Next.js (React)
- PostgreSQL (Neon)
- Drizzle ORM
- AI: Google Gemini (for object resolution)
- Hosted on Vercel