motovaultpro/data/make-model-import/QUICK_START.md

Quick Start Guide - Automotive Vehicle Database

Database Status: ✅ OPERATIONAL

• 30,066 engines
• 828 transmissions
• 1,122,644 vehicle configurations
• 47 years (1980-2026)
• 53 makes
• 1,741 models
• 98.9% transmission linking success

---

Access the Database

docker exec -it mvp-postgres psql -U postgres -d motovaultpro

---

Essential Queries

1. Get All Available Years

SELECT * FROM available_years;

2. Get Makes for a Specific Year

SELECT * FROM get_makes_for_year(2024);

3. Get Models for Year + Make

SELECT * FROM get_models_for_year_make(2024, 'Ford');

4. Get Trims for Year + Make + Model

SELECT * FROM get_trims_for_year_make_model(2024, 'Ford', 'f-150');

5. Get Complete Vehicle Details

SELECT * FROM complete_vehicle_configs
WHERE year = 2024
  AND make = 'Ford'
  AND model = 'f-150'
LIMIT 10;

---

Refresh the Database

# Re-generate SQL files from JSON source data
python3 etl_generate_sql.py

# Re-import into database
./import_data.sh

---

Files Overview

File	Purpose	Size
etl_generate_sql.py	Generate SQL import files from JSON	~20KB
import_data.sh	Import SQL files into database	~2KB
migrations/001_create_vehicle_database.sql	Database schema	~8KB
output/01_engines.sql	Engine data (id, name only)	~632KB
output/02_transmissions.sql	Transmission data (id, type only)	~21KB
output/03_vehicle_options.sql	Vehicle configurations	~51MB
Total Output		~52MB

---

Database Schema

engines
├── id (PK)
└── name (e.g., "V8 3.5L Turbo", "L4 2.0L")

transmissions
├── id (PK)
└── type (e.g., "8-Speed Automatic", "6-Speed Manual")

vehicle_options
├── id (PK)
├── year (1980-2026)
├── make (Title Case: "Ford", "Acura", "Land Rover")
├── model
├── trim
├── engine_id (FK → engines)
└── transmission_id (FK → transmissions)

---

Performance

• Query Time: < 50ms (composite indexes)
• Database Size: ~250MB (with indexes)
• SQL Import Files: ~52MB total
• Batch Insert Size: 1,000 records per batch

---

Support

• Full Documentation: See ETL_README.md
• Implementation Details: See IMPLEMENTATION_SUMMARY.md