- 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
79 lines
2.2 KiB
Markdown
79 lines
2.2 KiB
Markdown
# Vehicle Database Dashboard
|
|
|
|
A web-based dashboard for searching and filtering vehicle data from your database.
|
|
|
|
## Features
|
|
|
|
- Filter vehicles by brand, model, year, and engine
|
|
- Responsive web interface with Bootstrap
|
|
- Real-time filtering and search
|
|
- Detailed vehicle information display
|
|
- Modern UI with cards and badges
|
|
|
|
## Prerequisites
|
|
|
|
- Python 3.x
|
|
- Flask (installed via `sudo apt-get install python3-flask`)
|
|
- SQLite database with vehicle data (created in the vehicle_database directory)
|
|
|
|
## Setup
|
|
|
|
1. Make sure you have the vehicle database created in the `../vehicle_database/vehicle_database.db` path
|
|
2. Install Flask: `sudo apt-get install python3-flask`
|
|
3. Run the dashboard server: `python3 server.py`
|
|
|
|
## Usage
|
|
|
|
1. Start the server:
|
|
```bash
|
|
cd dashboard
|
|
python3 server.py
|
|
```
|
|
|
|
2. Open your web browser and navigate to `http://localhost:5000`
|
|
|
|
3. Use the filters on the left panel to search for vehicles:
|
|
- Select a brand from the dropdown
|
|
- Select a model (based on the selected brand)
|
|
- Select a year
|
|
- Select an engine type
|
|
- Click "Search Vehicles" to apply filters
|
|
|
|
4. The results will appear in the right panel with detailed information
|
|
|
|
## API Endpoints
|
|
|
|
The dashboard uses the following API endpoints:
|
|
|
|
- `GET /api/brands` - Get all vehicle brands
|
|
- `GET /api/models?brand=[brand]` - Get models for a specific brand
|
|
- `GET /api/years` - Get all years
|
|
- `GET /api/engines` - Get all engines
|
|
- `GET /api/vehicles?[filters]` - Search vehicles with optional filters
|
|
|
|
## File Structure
|
|
|
|
```
|
|
dashboard/
|
|
├── index.html # Main dashboard page
|
|
├── dashboard.js # Frontend JavaScript
|
|
├── server.py # Flask backend
|
|
├── requirements.txt # Python dependencies
|
|
├── start_dashboard.sh # Startup script
|
|
└── README.md # This file
|
|
```
|
|
|
|
## Customization
|
|
|
|
You can customize the dashboard by:
|
|
|
|
- Modifying the CSS styles in index.html
|
|
- Adding more filters in the JavaScript
|
|
- Changing the layout in index.html
|
|
- Adding more vehicle details in the display
|
|
|
|
## Troubleshooting
|
|
|
|
- If the server won't start, make sure the vehicle database exists
|
|
- If filters don't populate, check that the database has data
|
|
- If the page doesn't load, verify that Flask is installed correctly |