Autoparts-DB/docs/DATABASE.md

Documentación de Base de Datos - Nexus Autoparts

Resumen

La base de datos utiliza SQLite 3 y está diseñada con un esquema normalizado para gestionar información de vehículos de manera eficiente.

Archivo: vehicle_database/vehicle_database.db

Estadísticas Actuales

Tabla	Registros
brands	12
models	10,923
engines	10,919
years	~35
model_year_engine	12,075

---

Diagrama Entidad-Relación

┌──────────────┐
│    brands    │
├──────────────┤
│ id (PK)      │
│ name         │
│ country      │
│ founded_year │
│ created_at   │
└──────┬───────┘
       │
       │ 1:N
       │
┌──────▼───────────────┐
│       models         │
├──────────────────────┤
│ id (PK)              │
│ brand_id (FK)        │───────────────────────┐
│ name                 │                       │
│ body_type            │                       │
│ generation           │                       │
│ production_start_year│                       │
│ production_end_year  │                       │
│ created_at           │                       │
└──────────────────────┘                       │
                                               │
┌──────────────────────┐                       │
│       years          │                       │
├──────────────────────┤                       │
│ id (PK)              │───────────────┐       │
│ year                 │               │       │
│ created_at           │               │       │
└──────────────────────┘               │       │
                                       │       │
┌──────────────────────┐               │       │
│      engines         │               │       │
├──────────────────────┤               │       │
│ id (PK)              │───────┐       │       │
│ name                 │       │       │       │
│ displacement_cc      │       │       │       │
│ cylinders            │       │       │       │
│ fuel_type            │       │       │       │
│ power_hp             │       │       │       │
│ torque_nm            │       │       │       │
│ engine_code          │       │       │       │
│ created_at           │       │       │       │
└──────────────────────┘       │       │       │
                               │       │       │
                               │ N:1   │ N:1   │ N:1
                               │       │       │
                        ┌──────▼───────▼───────▼──────┐
                        │      model_year_engine      │
                        ├─────────────────────────────┤
                        │ id (PK)                     │
                        │ model_id (FK)               │
                        │ year_id (FK)                │
                        │ engine_id (FK)              │
                        │ trim_level                  │
                        │ drivetrain                  │
                        │ transmission                │
                        │ created_at                  │
                        └─────────────────────────────┘

---

Definición de Tablas

Tabla: brands

Almacena información de los fabricantes de vehículos.

CREATE TABLE brands (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL UNIQUE,
    country TEXT,
    founded_year INTEGER,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Campo	Tipo	Restricciones	Descripción
id	INTEGER	PK, AUTO	Identificador único
name	TEXT	NOT NULL, UNIQUE	Nombre de la marca
country	TEXT	-	País de origen
founded_year	INTEGER	-	Año de fundación
created_at	TIMESTAMP	DEFAULT NOW	Fecha de creación

Índices:

• idx_brands_name en name

---

Tabla: models

Almacena información de los modelos de vehículos.

CREATE TABLE models (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    brand_id INTEGER NOT NULL,
    name TEXT NOT NULL,
    body_type TEXT,
    generation TEXT,
    production_start_year INTEGER,
    production_end_year INTEGER,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (brand_id) REFERENCES brands(id),
    UNIQUE(brand_id, name, generation)
);

Campo	Tipo	Restricciones	Descripción
id	INTEGER	PK, AUTO	Identificador único
brand_id	INTEGER	FK, NOT NULL	Referencia a brands
name	TEXT	NOT NULL	Nombre del modelo
body_type	TEXT	-	Tipo de carrocería
generation	TEXT	-	Generación del modelo
production_start_year	INTEGER	-	Año inicio producción
production_end_year	INTEGER	-	Año fin producción
created_at	TIMESTAMP	DEFAULT NOW	Fecha de creación

Valores de body_type:

• Sedan, Coupe, Hatchback, SUV, Crossover, Truck, Van, Wagon, Convertible

Índices:

• idx_models_brand_id en brand_id
• idx_models_name en name

---

Tabla: engines

Almacena especificaciones técnicas de los motores.

CREATE TABLE engines (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    displacement_cc INTEGER,
    cylinders INTEGER,
    fuel_type TEXT,
    power_hp INTEGER,
    torque_nm INTEGER,
    engine_code TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    UNIQUE(name, engine_code)
);

Campo	Tipo	Restricciones	Descripción
id	INTEGER	PK, AUTO	Identificador único
name	TEXT	NOT NULL	Nombre descriptivo
displacement_cc	INTEGER	-	Cilindrada en cc
cylinders	INTEGER	-	Número de cilindros
fuel_type	TEXT	-	Tipo de combustible
power_hp	INTEGER	-	Potencia en HP
torque_nm	INTEGER	-	Torque en Nm
engine_code	TEXT	-	Código del fabricante
created_at	TIMESTAMP	DEFAULT NOW	Fecha de creación

Valores de fuel_type:

• Gasoline, Diesel, Hybrid, Electric, Plug-in Hybrid, Flex Fuel

Índices:

• idx_engines_name en name
• idx_engines_code en engine_code

---

Tabla: years

Tabla de referencia para años de producción.

CREATE TABLE years (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    year INTEGER NOT NULL UNIQUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Campo	Tipo	Restricciones	Descripción
id	INTEGER	PK, AUTO	Identificador único
year	INTEGER	NOT NULL, UNIQUE	Año
created_at	TIMESTAMP	DEFAULT NOW	Fecha de creación

---

Tabla: model_year_engine

Tabla de unión que relaciona modelos, años y motores.

CREATE TABLE model_year_engine (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model_id INTEGER NOT NULL,
    year_id INTEGER NOT NULL,
    engine_id INTEGER NOT NULL,
    trim_level TEXT,
    drivetrain TEXT,
    transmission TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (model_id) REFERENCES models(id),
    FOREIGN KEY (year_id) REFERENCES years(id),
    FOREIGN KEY (engine_id) REFERENCES engines(id),
    UNIQUE(model_id, year_id, engine_id, trim_level)
);

Campo	Tipo	Restricciones	Descripción
id	INTEGER	PK, AUTO	Identificador único
model_id	INTEGER	FK, NOT NULL	Referencia a models
year_id	INTEGER	FK, NOT NULL	Referencia a years
engine_id	INTEGER	FK, NOT NULL	Referencia a engines
trim_level	TEXT	-	Nivel de equipamiento
drivetrain	TEXT	-	Tipo de tracción
transmission	TEXT	-	Tipo de transmisión
created_at	TIMESTAMP	DEFAULT NOW	Fecha de creación

Valores de drivetrain:

• FWD (Front-Wheel Drive), RWD (Rear-Wheel Drive), AWD (All-Wheel Drive), 4WD (Four-Wheel Drive)

Valores de transmission:

• Manual, Automatic, CVT, DCT, AMT

Índices:

• idx_mye_model_id en model_id
• idx_mye_year_id en year_id
• idx_mye_engine_id en engine_id

---

Consultas Comunes

Obtener todos los vehículos de una marca

SELECT
    b.name AS brand,
    m.name AS model,
    y.year,
    e.name AS engine,
    mye.trim_level,
    mye.drivetrain,
    mye.transmission
FROM model_year_engine mye
JOIN models m ON mye.model_id = m.id
JOIN brands b ON m.brand_id = b.id
JOIN years y ON mye.year_id = y.id
JOIN engines e ON mye.engine_id = e.id
WHERE b.name = 'Toyota'
ORDER BY m.name, y.year;

Buscar vehículos por año

SELECT
    b.name AS brand,
    m.name AS model,
    e.name AS engine,
    e.power_hp,
    mye.trim_level
FROM model_year_engine mye
JOIN models m ON mye.model_id = m.id
JOIN brands b ON m.brand_id = b.id
JOIN years y ON mye.year_id = y.id
JOIN engines e ON mye.engine_id = e.id
WHERE y.year = 2020;

Obtener especificaciones de motor

SELECT
    name,
    displacement_cc,
    cylinders,
    fuel_type,
    power_hp,
    torque_nm,
    engine_code
FROM engines
WHERE cylinders = 6
ORDER BY power_hp DESC;

Contar modelos por marca

SELECT
    b.name AS brand,
    COUNT(DISTINCT m.id) AS model_count
FROM brands b
LEFT JOIN models m ON b.id = m.brand_id
GROUP BY b.id
ORDER BY model_count DESC;

Buscar motores por potencia

SELECT *
FROM engines
WHERE power_hp >= 300
ORDER BY power_hp DESC;

---

Mantenimiento

Backup de la Base de Datos

# Crear backup
sqlite3 vehicle_database.db ".backup 'backup.db'"

# O usando cp
cp vehicle_database.db vehicle_database_backup_$(date +%Y%m%d).db

Optimización

-- Analizar tablas para optimizar consultas
ANALYZE;

-- Reconstruir índices
REINDEX;

-- Compactar base de datos
VACUUM;

Verificar Integridad

PRAGMA integrity_check;
PRAGMA foreign_key_check;

---

Conexión desde Python

import sqlite3

# Conectar a la base de datos
conn = sqlite3.connect('vehicle_database/vehicle_database.db')
conn.row_factory = sqlite3.Row  # Permite acceso por nombre de columna

# Crear cursor
cursor = conn.cursor()

# Ejecutar consulta
cursor.execute("""
    SELECT b.name, m.name, y.year
    FROM model_year_engine mye
    JOIN models m ON mye.model_id = m.id
    JOIN brands b ON m.brand_id = b.id
    JOIN years y ON mye.year_id = y.id
    WHERE b.name = ?
""", ('Toyota',))

# Obtener resultados
for row in cursor.fetchall():
    print(f"{row['name']} - {row['name']} ({row['year']})")

# Cerrar conexión
conn.close()

---

Migración de Datos

Exportar a CSV

sqlite3 -header -csv vehicle_database.db "SELECT * FROM brands;" > brands_export.csv
sqlite3 -header -csv vehicle_database.db "SELECT * FROM models;" > models_export.csv
sqlite3 -header -csv vehicle_database.db "SELECT * FROM engines;" > engines_export.csv

Importar desde CSV

sqlite3 vehicle_database.db <<EOF
.mode csv
.import brands.csv brands
.import models.csv models
.import engines.csv engines
EOF