KwestKarz — Fleet Section Functional Specification

Purpose:

The Fleet section manages permanent/static information about vehicles owned or managed within the KwestKarz system.

This section is not for tracking maintenance events, bookings, or transactional data. It is solely for entering, viewing, and managing core information about vehicles.

---

Core Concepts:

Concept	Description
Fleet = "Garage"	A list of all cars in the business
Each Vehicle	Is an entity with permanent attributes
NOT in Fleet	Oil Changes, Tires, Repairs, Inspections — those belong in Maintenance section

---

Features of the Fleet Section:

1. Vehicle Listing Page

• Paginated list of vehicles
• Searchable
• Filter by:
  • Year
  • Make
  • Model
  • VIN
  • License Plate
• Sort by:
  • Year
  • Make
  • Model
  • Name

2. Add Vehicle Form

Fields:

Field	Notes
Name	Friendly name (ex: "William's Blazer")
Make	Chevy, Ford, etc
Model	Blazer, Focus, etc
Year	Integer
Color	Red, Black, Silver etc
Paint Code	Optional
Package	Optional (LT, LT2 etc)
VIN	Required, 17 characters
License Plate	Required
License State	Optional

3. Edit Vehicle

• Edit any existing vehicle details
• VIN is immutable (optional to lock it down after creation)

4. Delete Vehicle

• Admin / Owner only
• Confirm before delete
• Cannot delete if vehicle has associated Maintenance records (optional safety net)

5. Search / Filter

Must be a really good search:

• Instant results
• Supports partial VIN, Make, Model, Name
• Optional advanced search filters later (ex: Year range, Color, State etc)

6. Vehicle Details Page

• Click on a car → See full detail view
• Later we can hang things off this like:
  • Maintenance history
  • Expenses
  • Insurance info
  • Photos
  • File uploads
  • Notes section

---

Roles & Permissions:

Role	Permissions in Fleet
Admin	Full CRUD
Owner	Full CRUD
Employee	View Only (no Add, Edit, Delete)

---

Future Ideas (Not now — just park these)

• Import/Export to CSV
• VIN Decode API integration
• Vehicle Photos gallery
• PDF generation (like a vehicle sheet)
• Owner's Manual upload
• Auto Market Value tracking