Autoparts-DB/dashboard

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:

   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