KWest Karz, LLC – Fleet Dashboard Metrics Specification - wwestlake/KwestKarz GitHub Wiki
📘 KWest Karz, LLC – Fleet Dashboard Metrics Specification
Overview
This specification outlines the key performance metrics and visual components to be implemented in the KWest Karz, LLC fleet management dashboard. The dashboard will provide real-time visibility into fleet operations, utilization, revenue, and maintenance status using data stored in the internal API and database system.
🎯 Tier 1: Core Operational Metrics
1. Fleet Utilization Status
- Purpose: Display real-time vehicle availability
- Metric Logic:
- Green: Currently on trip
- Yellow: Available for booking
- Red: Idle > X days (e.g., 7+ days without booking)
- Display: Stacked horizontal bar or donut chart
2. Total Monthly Earnings
- Metric: Sum of earnings for all completed trips in the current calendar month
- Display: Large KPI tile with trend sparkline
3. Utilization Rate
- Metric:
(Total Rented Days / Total Available Days) * 100
- Granularity: Per vehicle and fleet-wide
- Display: Table + heatmap coloring or radial gauge
4. Bookings (Week & Month)
- Metric: Count of all trips starting in the current week/month
- Display: KPI tiles with date range filters
5. Vehicles Below Target ROI
- Logic: Flag vehicles where
Cumulative Earnings < X% of Purchase Price
- Display: List with progress bars toward ROI target
🛠️ Tier 2: Maintenance & Operations
6. Maintenance Due Soon
- Trigger: Last service date + mileage
- Logic: Due if
> 5,000 miles
since last oil change or> 6 months
- Display: List view with due soon/overdue badges
7. Mileage Alerts
- Metric: Vehicles approaching high mileage (e.g., 100K, 120K)
- Use: Identify candidates for decommissioning
- Display: Horizontal bar with threshold warnings
📈 Tier 3: Strategic Forecasting
8. Projected Monthly Revenue
- Formula:
Avg. Daily Rate × Projected Utilization Days
- Forecast Input: Based on current booking trends
- Display: Line chart or bar forecast graph
9. Top Performing Vehicles
- Metric: Highest grossing vehicles this month
- Display: Ranked cards or horizontal bar chart
10. Underperforming Vehicles
- Metric: Lowest earning/utilized vehicles
- Display: Side-by-side with top performers
💡 Optional Smart Metrics
Fleet Turnover Ratio
- Metric:
Total Revenue / Vehicle Purchase Price
- Display: Ratio chart (greater than 1 = profitable)
Break-even Progress Meter
- Metric: Revenue-to-cost percentage per vehicle
- Display: Circular progress or segmented bar
Booking Gap Analysis
- Metric: Average time between rentals
- Display: Table with trend arrows
📌 Dashboard Components Summary
Metric | Type | Display | Priority |
---|---|---|---|
Fleet Utilization | Real-Time Status | Stacked Bar | High |
Total Monthly Earnings | KPI | Tile + Sparkline | High |
Utilization Rate | Efficiency | Heatmap / Table | High |
Bookings | Engagement | KPI Tiles | High |
ROI Flags | Financial Risk | List View | High |
Maintenance Alerts | Operational | List | Medium |
Mileage Warnings | Lifecycle | Progress Bar | Medium |
Forecast Revenue | Predictive | Line Chart | Medium |
Top/Bottom Vehicles | Performance | Bar Charts | Medium |
Break-even Progress | ROI | Progress Circles | Optional |
Fleet Turnover | Profitability | Ratio Graph | Optional |
Booking Gaps | Optimization | Table | Optional |
✅ Next Steps
- Review metric logic with dev team
- Define API endpoints for each metric
- Prioritize Tier 1 metrics for MVP dashboard
- Wireframe UI layout and begin frontend integration