# 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