Back to Documentation
FeaturesUpdated 3/17/2026

Vehicle Health Report

What Vehicle Health Summary Is

A complete digital vehicle inspection system with customer-facing reports and approval workflow - a premium feature that increases service approval rates by 30-50%!

---

Feature Summary

For Mechanics:

1. Complete Inspection UI - 30-point checklist with Pass/Warning/Fail

2. Photo Documentation - Upload photos for each issue

3. Cost Estimates - Parts + labor breakdown

4. Recommendations - What needs to be done and when

5. One-Click Send - Generates report and SMS to customer

For Customers:

1. Beautiful Report Page - Professional, consumer-friendly design

2. Health Score - 0-100 visual indicator of vehicle condition

3. Photo Evidence - See exactly what's wrong

4. Approve/Decline - Digital decision for each service

5. Digital Signature - Type name to sign off

---

Business Value

Metrics:

| Metric | Improvement | Example |

|--------|-------------|---------|

| Approval Rate | +30-50% | 40% → 60% |

| Average Ticket | +15-25% | $500 → $625 |

| Phone Time | -40% | Less explanation needed |

| Customer Trust | Significantly Higher | Transparency wins |

ROI Example:

```

Shop does 20 inspections/month

Average additional service: $300

Approval rate increase: 40% → 60% (20% more approvals)

Extra revenue: 20 × 0.20 × $300 = $1,200/month

```

---

How It Works (End-to-End)

1. Mechanic Completes Inspection

```

Dashboard → Vehicle → Vehicle Inspection Button

Complete 30-point checklist

Mark items as Pass/Warning/Fail

For issues: Add notes, photos, cost estimate

Click "Save & Send to Customer"

```

2. System Generates Report

```

Database creates:

  • vehicle_inspections record
  • service_recommendations records
  • Unique 32-char token
  • SMS sent to customer:

    "Hi John! Your 2020 Toyota Camry inspection is ready.

    3 item(s) need attention. View: servicelog.app/report/abc123"

    ```

    3. Customer Reviews & Decides

    ```

    Customer clicks link

    Sees health score (e.g., 72/100)

    Reviews each issue with photos

    Clicks Approve or Decline

    Types name as digital signature

    Submission saved to database

    ```

    4. Mechanic Gets Notified

    ```

    Database updated:

  • customer_decision = "approved" or "declined"
  • customer_decision_at = timestamp
  • digital_signature = customer name
  • Mechanic sees approvals in dashboard

    Can proceed with approved work

    ```

    ---

    SMS Integration

    Message Template:

    ```

    Hi {customer_name}! Your {vehicle_name} inspection is ready.

    {count} item(s) need attention. View report & approve services:

    {report_url}

    -{shop_name}

    ```

    Example:

    ```

    Hi John! Your 2020 Toyota Camry inspection is ready. 3 item(s)

    need attention. View report & approve services:

    https://servicelog.app/report/a1b2c3d4e5f6g7h8

  • Mike's Auto Repair
  • ```

    Compliance:

    ✅ Prior consent obtained (service form)

    ✅ Shop identification included

    ✅ Professional tone

    ✅ Clear call-to-action

    ✅ Opt-out available (Reply STOP)

    ---

    UI/UX Highlights

    Mechanic UI:

  • Auto-calculated health score - Real-time 0-100
  • Visual summary - Passed/Monitor/Critical counts
  • Photo upload - Multiple photos per issue
  • Cost breakdown - Parts + labor fields
  • Required notes - Can't save without description
  • Professional design - Clean, modern interface
  • Customer UI:

  • No login required - Token-based access (frictionless)
  • Mobile-optimized - Works on any phone
  • Large visuals - Easy to read health score
  • Photo gallery - Click to enlarge
  • Simple decisions - Big approve/decline buttons
  • Digital signature - Type name to sign
  • Summary section - Total estimated, approved amounts
  • ---

    Security Features

    Access Control:

  • ✅ Token is only way to access report
  • ✅ No customer account needed (frictionless)
  • ✅ Link expires after 30 days
  • ✅ Mechanic can only see their own inspections
  • ✅ Row Level Security protects all data
  • Data Privacy:

  • ✅ Customer info encrypted at rest
  • ✅ Photos in Supabase Storage
  • ✅ RLS policies on all tables
  • ✅ No public indexing of reports
  • ---

    Health Score Calculation

    ```typescript

    Score = ((Passed × 100) + (Warnings × 50) + (Fails × 0)) / Total Items

    Example:

  • 24 passed: 24 × 100 = 2400
  • 4 warnings: 4 × 50 = 200
  • 2 fails: 2 × 0 = 0
  • Total: 30 items
  • Score = (2400 + 200 + 0) / 30 = 86.7 ≈ 87/100

    ```

    Score Labels:

    | Score | Label | Color |

    |-------|-------|-------|

    | 80-100 | Excellent | 🟢 Green |

    | 60-79 | Good | 🟡 Yellow |

    | 40-59 | Fair | 🟠 Orange |

    | 0-39 | Needs Attention | 🔴 Red |

    ---

    Testing Checklist

    Mechanic Flow:

  • [ ] Run database migration
  • [ ] Create storage bucket
  • [ ] Open vehicle detail page
  • [ ] Click "Vehicle Inspection"
  • [ ] Complete 30-point checklist
  • [ ] Mark 2-3 items as Warning/Fail
  • [ ] Add notes for each issue
  • [ ] Upload photos (test with phone)
  • [ ] Add cost estimates
  • [ ] Click "Save & Send to Customer"
  • [ ] Verify inspection saved in database
  • [ ] Get report token from database
  • Customer Flow:

  • [ ] Open report URL in incognito window
  • [ ] Verify health score displays correctly
  • [ ] Check photos load properly
  • [ ] Click "Approve" on one item
  • [ ] Type name as signature
  • [ ] Submit decision
  • [ ] Verify decision saved in database
  • [ ] Check inspection status updated
  • [ ] Test "Decline" on another item
  • [ ] Test "Approve All" button
  • SMS Flow:

  • [ ] Configure shop profile with name/phone
  • [ ] Complete inspection
  • [ ] Send report via SMS (use mock mode for testing)
  • [ ] Verify message format correct
  • [ ] Test link works on mobile device
  • ---

    Use Cases

    1. Brake Service

    Scenario: Customer comes for oil change, mechanic finds worn brakes

    Mechanic Input:

  • Item: Front Brake Pads
  • Status: Fail
  • Notes: "Only 2mm remaining. Metal-to-metal contact starting."
  • Photos: Close-up of pad thickness gauge
  • Recommendation: "Replace front brake pads immediately"
  • Estimate: $80 parts + $120 labor = $200
  • Customer Sees:

  • Photo showing 2mm remaining
  • Clear explanation of danger
  • Professional recommendation
  • Fair pricing
  • Result: Customer approves on the spot

    2. Tire Replacement

    Scenario: Annual inspection, tires getting low

    Mechanic Input:

  • Item: Rear Tire Tread
  • Status: Warning
  • Notes: "5/32\" remaining. Below recommended 6/32\"."
  • Photos: Tread depth gauge showing measurement
  • Recommendation: "Plan replacement within 3 months"
  • Estimate: $600 for set of 4
  • Customer Sees:

  • Visual proof of tread depth
  • Timeline recommendation
  • Can budget accordingly
  • Result: Customer approves for future, schedules now

    3. Suspension Work

    Scenario: Customer reports noise, mechanic finds worn bushings

    Mechanic Input:

  • Item: Control Arm Bushings
  • Status: Fail
  • Notes: "Cracked and deteriorated. Causing clunking noise."
  • Photos: Cracked bushing, arrow showing damage
  • Recommendation: "Replace control arms for safety and comfort"
  • Estimate: $450 parts + $280 labor = $730
  • Customer Sees:

  • Clear damage in photos
  • Explanation of symptoms
  • Safety implication
  • Result: Customer understands urgency, approves work

    ---

    Future Enhancements

    Phase 2 (Next Sprint):

  • [ ] Email reports (PDF attachment)
  • [ ] Customer dashboard (view all vehicle reports)
  • [ ] Multi-vehicle reports (fleet accounts)
  • [ ] Service package bundles
  • [ ] Financing integration (for $1000+ repairs)
  • [ ] Review request after approval
  • Phase 3 (Future):

  • [ ] AI-powered issue detection from photos
  • [ ] Automated labor estimates (integration with labor books)
  • [ ] Parts availability check
  • [ ] Scheduling integration (book approved work)
  • [ ] Warranty tracking
  • [ ] Photo annotations (arrows, circles, text)
  • ---

    Best Practices

    For Mechanics:

    1. Take clear photos - Good lighting, close-up, use flash

    2. Be specific - "3mm remaining" not "worn"

    3. Provide timelines - "Replace within 1,000 miles" or "Immediate"

    4. Fair pricing - Competitive, transparent estimates

    5. Professional language - Build trust with clear communication

    For Shops:

    1. Use on every service - Make it standard operating procedure

    2. Train all mechanics - Consistent quality across team

    3. Follow up - Call customers who haven't viewed in 24hrs

    4. Track metrics - Monitor approval rate improvements

    5. Market the feature - Tell customers about this premium service

    ---

    Summary

    This is a complete vehicle health report system that:

    ✅ Increases service approval rates by 30-50%

    ✅ Builds customer trust through transparency

    ✅ Reduces phone time with clear communication

    ✅ Creates professional, dealership-level experience

    ✅ Generates significant additional revenue

    ✅ Provides digital records for liability protection

    ✅ Mobile-optimized for customers

    ✅ Secure with token-based access

    This feature alone justifies upgrading to the Pro plan!

    ---

    Dash
    Customers
    Revenue
    Guide
    Not Found