# Apex Track Experience Vehicle Database Reference

## File Locations

| Copy | Path | Purpose |
|------|------|---------|
| **Canonical** | `/root/docker/docuseal/data/vehicles.json` | The pretty-printed comprehensive version (~2,277 lines, 47 makes, 373 models) |
| **Dev/Mockup** | `/root/portal-mockup/vehicles.json` | Flat-format version used in portal mockups (~234 lines, simpler structure) |
| **Live served** | `https://core.itpropartner.com/vehicles.json` | Served via Caddy from `/var/www/static/vehicles.json` — the DocuSeal form fetches this URL |

## Schema

```json
{
  "Make Name": {
    "Model Name": {
      "YYYY": HP,
      "YYYY+1": HP
    }
  }
}
```

- Years are **strings**, not integers (`"2024"` not `2024`)
- Makes are capitalized English names: `"Mercedes-AMG"`, `"Gordon Murray Automotive"`
- Each model entry lists year-HP pairs; a model existing at one HP doesn't mean it exists at that HP for all years

## Coverage Rules

- **Years:** 2015+ for production cars
- **Threshold:** 400+ HP (though this scout focuses on 500+ HP for the Apex Track Experience)
- **All makes globally** — including Chinese, Korean, boutique
- **All body styles** — coupe, sedan, SUV, pickup, convertible, wagon

## Currently Missing (As of Jul 11, 2026)

### Entire Makes Not in DB (needs new key added):
- Denza (BYD sub-brand, Denza Z at 1,582 hp)
- Gordon Murray Automotive (T.33 at 615 hp, T.33 Spider at 607 hp)
- Zenvo (Aurora at 1,850 hp)
- AC Cars (Cobra GT Coupe at 720 hp)
- McMurtry (Speirling Pure at 1,000 hp)
- Apollo (Evo at 789 hp)
- Ruf (B8 prototype at 1,000+ hp, pre-production)
- Sanrivatti (hypercar, 1,000+ hp, startup/development stage)
- Toyota (GR GT at 641 hp)
- Renault (5 Turbo 3E at 555 hp)

### Models Missing Under Existing Makes:
- Ferrari: 12Cilindri (819hp), 12Cilindri Manuale (819hp), 296 Speciale (869hp), 296 Speciale Aperta (869hp), Amalfi (631hp), 849 Testarossa (1,036hp)
- Aston Martin: DB12 S (690hp), DBX S (717hp), Vantage S, Valiant (735hp), Vanquish Volante (824hp)
- Pagani: Huayra 70 Derecho (852hp), Utopia Roadster (864hp)
- Bentley: Supersports (657hp), Torcal EV SUV (~1,139hp)
- Maserati: MC20 GT2 Stradale (631hp), MCPura (621hp)
- Mercedes-AMG: PureSpeed (577hp), CLA 45 4Matic+ Electric (680hp), GT 63 S E Performance Coupe 2-door (805hp), GT 4-Door Coupe EV (1,153hp, 2027)
- BMW: M5 G90 2025+ (717hp — separate from older 617hp M5), M5 Touring G99 (717hp), iX5, i3 50 xDrive
- Porsche: N/A (comprehensive)
- GMC: Hummer EV 3X Pickup 2026 (1,160hp — DB has earlier years at 830-1000hp, needs 2026 entry added)
- Ford: Mustang GTD (815hp)
- Dodge: Charger Daytona Scat Pack EV (670hp), Charger Daytona R/T EV (536hp)
- Ram: 1500 TRX SRT 777hp (2027), 1500 SRT Rumble Bee Hellcat (2027)
- Cadillac: Lyriq-V (615hp, 2026), Optiq-V (519hp, 2026)
- Chevrolet: Blazer EV SS (615hp, 2025), Corvette ZR1X (2027, 1,250hp)
- Genesis: G80 Magma (525hp)
- Audi: Nuvolari (1,001hp)
- Polestar: 6 (884hp)
- Jaguar: Type 01 GT (986+ hp)
- Hyundai: N Vision 74 (~800hp)
- Alfa Romeo: 33 Stradale (620hp gas / 750hp EV)
- Bugatti: Tourbillon (1,775hp)
- Rimac: Nevera R (2,107hp)
- Hennessey: Venom F5-M Evolution (2,031hp — base Venom F5 is in DB at 1,817hp)

### Spec Corrections Needed:
- Aston Martin Valhalla: DB says 998hp → should be 1,064hp
