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:
79
dashboard/README.md
Normal file
79
dashboard/README.md
Normal file
@@ -0,0 +1,79 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user