Initial commit: Sistema Autoparts DB
- Base de datos SQLite con información de vehículos - Dashboard web con Flask y Bootstrap - Scripts de web scraping para RockAuto - Interfaz CLI para consultas - Documentación completa del proyecto Incluye: - 12 marcas de vehículos - 10,923 modelos - 10,919 especificaciones de motores - 12,075 combinaciones modelo-año-motor
This commit is contained in:
425
docs/DATABASE.md
Normal file
425
docs/DATABASE.md
Normal file
@@ -0,0 +1,425 @@
|
||||
# Documentación de Base de Datos - Autoparts DB
|
||||
|
||||
## 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.
|
||||
|
||||
```sql
|
||||
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.
|
||||
|
||||
```sql
|
||||
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.
|
||||
|
||||
```sql
|
||||
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.
|
||||
|
||||
```sql
|
||||
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.
|
||||
|
||||
```sql
|
||||
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
|
||||
|
||||
```sql
|
||||
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
|
||||
|
||||
```sql
|
||||
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
|
||||
|
||||
```sql
|
||||
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
|
||||
|
||||
```sql
|
||||
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
|
||||
|
||||
```sql
|
||||
SELECT *
|
||||
FROM engines
|
||||
WHERE power_hp >= 300
|
||||
ORDER BY power_hp DESC;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Mantenimiento
|
||||
|
||||
### Backup de la Base de Datos
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
```sql
|
||||
-- Analizar tablas para optimizar consultas
|
||||
ANALYZE;
|
||||
|
||||
-- Reconstruir índices
|
||||
REINDEX;
|
||||
|
||||
-- Compactar base de datos
|
||||
VACUUM;
|
||||
```
|
||||
|
||||
### Verificar Integridad
|
||||
|
||||
```sql
|
||||
PRAGMA integrity_check;
|
||||
PRAGMA foreign_key_check;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Conexión desde Python
|
||||
|
||||
```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
|
||||
|
||||
```bash
|
||||
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
|
||||
|
||||
```bash
|
||||
sqlite3 vehicle_database.db <<EOF
|
||||
.mode csv
|
||||
.import brands.csv brands
|
||||
.import models.csv models
|
||||
.import engines.csv engines
|
||||
EOF
|
||||
```
|
||||
Reference in New Issue
Block a user