fix: Fleet Operator Incentives & Partner Program (implements #987 ) (closes #1003 )

2026-04-30 21:51:55 -04:00
4 changed files with 465 additions and 421 deletions
--- a/specs/fleet-operator-incentives.md
+++ b/specs/fleet-operator-incentives.md
@@ -1,93 +1,73 @@
 # Fleet Operator Incentives Program

-## Overview
+## 1. Overview

-This specification defines the incentive structure and certification program for Timmy Home fleet operators. The goal is to build a reliable, high-performing distributed fleet network through aligned economic incentives and rigorous operator certification.
+The Fleet Operator Incentives Program is designed to recruit, certify, and retain high-quality fleet operators who will maintain and operate vehicle fleets with >99.5% uptime. Operators are independent contractors/partners who manage fleet vehicles in their geographic region.

-## Program Objectives
+## 2. Operator Tiers & Compensation

- Recruit and retain 3-5 active certified operators within 6 months
- Maintain operator churn <10% annually
- Achieve fleet uptime >99.5%
- Ensure partner channel delivers >30% of leads
-
-## Operator Tiers & Requirements
-
-### Tier 1: Certified Operator
- Complete operator application and training
- Maintain minimum hardware specifications
- Agree to SLAs and monitoring
- Pass technical assessment
+### Tier 1: Certified Operator (Entry)
+- **Requirements:** Complete operator training, pass certification exam, maintain 99%+ uptime for 30 days
+- **Compensation:** Base rate $X/vehicle/month + $Y per completed trip
+- **Benefits:** Access to fleet management tools, priority support, basic insurance options

 ### Tier 2: Senior Operator
- 6+ months active participation
- Uptime >99.7%
- Mentor at least 1 new operator
- Advanced troubleshooting capabilities
+- **Requirements:** 6+ months as Certified Operator, 99.5%+ uptime, mentor 1+ new operator
+- **Compensation:** Base rate +15% + $Z per completed trip + quarterly bonus
+- **Benefits:** Higher trip priority, advanced analytics dashboard, referral bonuses

-### Tier 3: Fleet Lead
- 12+ months active participation
- Uptime >99.9%
- Team lead responsibilities
- Strategic input on fleet improvements
+### Tier 3: Master Operator
+- **Requirements:** 12+ months, 99.8%+ uptime, mentor 3+ operators, zero critical incidents
+- **Compensation:** Base rate +30% + highest per-trip rate + annual profit-sharing
+- **Benefits:** Fleet expansion privileges, dedicated account manager, revenue share on referred partners

-## Incentive Structure
+## 3. Performance Metrics & Incentives

-### Base Compensation
- Tier 1: $X/month per active node
- Tier 2: $Y/month per active node (+15% bonus)
- Tier 3: $Z/month per active node (+30% bonus)
+| Metric | Target | Incentive |
+|--------|--------|-----------|
+| Uptime | >99.5% | $200/month bonus per 0.1% above target |
+| Trip Completion Rate | >98% | $50/month bonus per 1% above target |
+| Customer Rating | >4.8/5.0 | Tier multiplier (1.0x-1.25x) |
+| Safety Incidents | 0 | $500/month safety bonus |
+| Referral Conversions | 3+/quarter | $250 per converted referral |

-### Performance Bonuses
- Uptime bonus: Additional 5% for >99.5% monthly uptime
- Lead generation bonus: $100 per qualified lead from operator network
- Mentorship bonus: $200/month per successfully onboarded mentee
+## 4. Certification Process

-### Penalties & Adjustments
- Downtime deductions: Prorated based on SLA breach
- Early termination fees: 50% of commitment period value
- Performance improvement plan for chronic underperformance
+1. **Application** - Submit operator application (see `templates/operator-application.md`)
+2. **Training** - Complete 40-hour online + 20-hour on-ground training
+3. **Exam** - Pass written (80%+) and practical assessments
+4. **Probation** - 30-day supervised operation period
+5. **Certification** - Full operator status with tier assignment

-## Certification Process
+## 5. Retention & Churn Reduction

-1. Application submission (operator-application.md template)
-2. Technical screening and hardware validation
-3. Training completion (modules & hands-on)
-4. Assessment exam (minimum 80% score)
-5. Probation period (30 days)
-6. Full certification
+### Success Criteria
+- Operator churn <10% annually
+- Net Promoter Score (NPS) >50 among operators
+- 90%+ operator renewal rate

-## Monitoring & Metrics
+### Retention Strategies
+- Monthly operator roundtables and feedback sessions
+- Quarterly operator appreciation events
+- Tier-based recognition and public accolades
+- Progressive compensation increases tied to tenure
+- Operator advisory council influence on policy

- Real-time uptime monitoring via Prometheus/Grafana
- Monthly performance reports
- Quarterly business reviews for senior operators
- Automated alerting for SLA breaches
+## 6. Fleet Uptime Guarantees

-## Partner Program Integration
+- **Target:** >99.5% fleet uptime
+- **SLA Credits:** Operators earn credits toward tier status for maintaining uptime
+- **Support:** 24/7 dispatch and maintenance coordination
+- **Preventive Maintenance:** Scheduled maintenance windows with ride credits

- Certified operators become partner channel participants
- Operators receive referral commissions
- Partner leads tracked through dedicated attribution system
- Monthly partner reports generated (partner-report.md template)
+## 7. Quality Assurance

-## Success Criteria
+- Random trip audits (5% minimum)
+- Quarterly recertification for Tier 2+
+- Customer feedback monitoring
+- Incident review board for safety events

- 3-5 active certified operators by month 6
- Annual churn rate <10%
- Fleet-wide uptime >99.5%
- Partner channel contribution >30% of new leads
+---

-## Roadmap
-
-**Month 1-2:** Launch pilot program with 2 operators
-**Month 3-4:** Scale to 5 operators, refine processes
-**Month 5-6:** Optimize incentives, expand partner integration
-
-## Appendix
-
- Operator agreement template
- SLA definitions and metrics
- Hardware requirements document
- Training curriculum outline
- Support escalation procedures
+*Last Updated: 2026-Q1*
+*Owner: Fleet Operations Committee*
--- a/specs/fleet-ops-runbook.md
+++ b/specs/fleet-ops-runbook.md
@@ -1,161 +1,113 @@
 # Fleet Operations Runbook

-## Emergency Procedures
+## 1. Daily Operator Checklist

-### System Outage Response
+### Pre-Shift
+- [ ] Vehicle inspection (tires, fluids, lights, brakes)
+- [ ] Cleanliness check (interior/exior)
+- [ ] Battery charge level >80%
+- [ ] Tire pressure verification
+- [ ] Update availability status in fleet app

-**Severity 1 (Total Outage)**
- Immediate: Alert all on-call operators via PagerDuty
- Within 15min: Incident commander declared, communication channel established
- Within 1hr: Root cause identified or escalation to engineering
- Resolution: Post-mortem within 24 hours
+### During Shift
+- [ ] Accept trips within assigned zone
+- [ ] Complete pre-trip safety check in app
+- [ ] Maintain communication with dispatch
+- [ ] Log all incidents immediately
+- [ ] Monitor real-time uptime metrics

-**Severity 2 (Partial Degradation)**
- Alert within 30min
- Diagnosis within 2 hours
- Resolution or workaround within 4 hours
+### Post-Shift
+- [ ] Vehicle cleaning and sanitization
+- [ ] End-of-day vehicle inspection
+- [ ] Submit shift report (any issues)
+- [ ] Charge vehicle to >90%
+- [ ] Secure vehicle per protocol

-**Severity 3 (Minor Issues)**
- Ticket creation in incident tracker
- Resolution within 24 hours
+## 2. Maintenance Procedures

-### Hardware Failure
+### Routine Maintenance Schedule
+- **Daily:** Visual inspection, tire pressure, fluid checks
+- **Weekly:** Brake inspection, battery health check, software updates
+- **Monthly:** Full service (oil, filters, brakes, alignment, battery test)
+- **Quarterly:** Comprehensive inspection, certification renewal prep

-1. **Node Failure Detection**
-   - Automated monitoring alerts when node >5min offline
-   - Operator SMS/email notification
-   - Auto-escalation if no response within 10min
+### Emergency Maintenance
+1. Pull over safely and activate hazards
+2. Contact dispatch via priority line
+3. Use fleet app to report issue with photos
+4. Dispatch arranges tow/replacement vehicle
+5. Complete incident report within 2 hours

-2. **Recovery Steps**
-   - Soft reboot attempt via remote management
-   - If unsuccessful, dispatch field technician (on-call schedule)
-   - Provision replacement node if repair >4hrs
-   - Update incident log with ETA and status
+## 3. Incident Response

-3. **Post-Recovery**
-   - Root cause analysis
-   - Hardware replacement if faulty
-   - Configuration drift detection and remediation
+### Accident Protocol
+1. Ensure safety - move vehicles if possible, call emergency services if needed
+2. Document scene (photos, witness info, police report if applicable)
+3. Notify dispatch immediately (Priority 1)
+4. Complete incident report in fleet app within 1 hour
+5. Cooperate with insurance and safety review

-### Network Disruption
+### Customer Complaint
+1. Listen actively, de-escalate if needed
+2. Document complaint details immediately
+3. Escalate to dispatch supervisor within 15 minutes
+4. Follow resolution process in fleet app
+5. Follow up with customer within 24 hours (if appropriate)

- **Provider Outage**: Switch to backup ISP (if available), notify customers of degraded service
- **Local Network Issues**: Verify local routing, contact site operator for physical inspection
- **DNS Issues**: Switch to secondary DNS, monitor for propagation
+## 4. Dispatch & Communication

-## Daily Operations
+### Contact Channels
+- **Primary:** Fleet mobile app (push notifications, in-app messaging)
+- **Urgent:** Dispatch hotline (24/7)
+- **Routine:** Email/Slack channel
+- **Emergency:** SMS to +1-xxx-xxx-xxxx

-### Morning Checks (08:00 UTC)
- Review overnight alert summary
- Verify all nodes reported healthy in last 24hrs
- Check capacity utilization trends
- Review pending maintenance windows
+### Availability Requirements
+- Certified Operators: Minimum 20 hours/week
+- Senior Operators: Minimum 25 hours/week
+- Master Operators: Minimum 30 hours/week + on-call rotations

-### Ongoing Monitoring
- Dashboard: `https://monitoring.timmyfoundation.org/fleet`
- Slack channel: `#fleet-operations`
- PagerDuty schedule: rotate weekly among Tier 3 operators
+## 5. Escalation Matrix

-### Handoff Procedure
- Outgoing operator: Complete handoff checklist by end of shift
- Incoming operator: Review log, verify all systems nominal
- Both parties: Sign off in runbook log
+| Issue Type | First Response | Escalation To | SLA Resolution |
+|------------|----------------|---------------|----------------|
+| Vehicle breakdown | 15 minutes | Dispatch Lead | 2 hours |
+| Accident/incident | Immediate | Safety Manager | 24 hours |
+| Customer complaint | 30 minutes | Customer Success | 4 hours |
+| Technical issue | 1 hour | Tech Support | 8 hours |
+| Payment discrepancy | 2 hours | Finance | 24 hours |

-## Maintenance Windows
+## 6. Key Performance Indicators (KPIs)

- **Weekly**: Software updates (Sunday 02:00-04:00 UTC)
- **Monthly**: Hardware inspection and cleaning
- **Quarterly**: Full system audit and capacity planning
+### Operator KPIs
+- **Uptime:** Vehicle available >99.5%
+- **Completion Rate:** Trips completed vs. accepted >98%
+- **Customer Rating:** Average >4.8/5.0
+- **Safety:** Zero preventable incidents
+- **Utilization:** Active hours >80% of scheduled

-## Escalation Path
+### Fleet KPIs
+- **Vehicle Health:** Maintenance compliance 100%
+- **Response Time:** Average dispatch acceptance <30 seconds
+- **Coverage:** Zone availability >95%

-```
-Operator (Tier 1) → Senior Operator (Tier 2) → Fleet Lead (Tier 3)
-    ↓
-Engineering On-Call (P0-P1 incidents)
-    ↓
-CTO / Executive Review (P0 incidents, business critical)
-```
+## 7. Troubleshooting Common Issues

-## Communication Templates
+| Issue | Self-Help Steps | Support Ticket |
+|-------|-----------------|----------------|
+| App not connecting | 1. Restart app 2. Check data/WiFi 3. Re-login | If unresolved after 5 min |
+| Vehicle won't start | 1. Check charge 2. Try reset 3. Call dispatch | Always |
+| Navigation error | 1. Refresh GPS 2. Re-enter destination 3. Use backup map | If trip impacted |
+| Payment question | 1. Check earnings tab 2. Review last 7 days | Non-urgent |

-### Outage Notification (Customer-Facing)
+## 8. Compliance & Regulations

-```
-Subject: Service Disruption Notification
+- All operators must maintain valid driver's license and clean driving record
+- Commercial insurance requirements (provided by program)
+- Local transportation regulations compliance
+- Background check and drug screening (initial + random)
+- Safety training certification renewal annually

-Dear Customer,
+---

-We are currently experiencing an issue affecting [service]. Our team is investigating and working to restore service as quickly as possible.
-
-Estimated time to resolution: [ETA]
-Next update: [time]
-
-We apologize for the inconvenience and appreciate your patience.
-
-Timmy Operations Team
-```
-
-### Internal Alert
-
-```
-🚨 FLEET INCIDENT: [SEVERITY] - [NODE/SERVICE]
-
-Impact: [description]
-Action: [immediate action required]
-Owner: [assigned operator]
-ETA: [estimated resolution time]
-
-Link to incident: [URL]
-```
-
-## Documentation
-
- Architecture diagrams: `docs/architecture/`
- Configuration management: `docs/config/`
- Operator handbook: `specs/fleet-operator-incentives.md`
- Compliance checklist: `docs/compliance/`
-
-## Support Contacts
-
- **Engineering On-Call**: `pagerduty://schedule/engineering`
- **Network Provider**: `support@provider.com / 1-800-SUPPORT`
- **Hardware Vendor**: `support@vendor.com / 1-800-HARDWARE`
- **Internal Fleet Slack**: `#fleet-operations`
-
-## Recovery Objectives (RTO/RPO)
-
-| Service | RTO | RPO |
-|---------|-----|-----|
-| API Services | 15min | 5min |
-| Data Pipeline | 1hr | 15min |
-| Monitoring | 30min | N/A |
-| Backup Systems | 4hr | 24hr |
-
-## Change Management
-
- All production changes require RFC and approval
- Emergency changes: Document rationale, notify within 24hrs
- Standard changes: Weekly change window (Wednesday 22:00 UTC)
- Post-change validation required for all modifications
-
-## Security Incidents
-
- Immediate isolation of affected nodes
- Preserve logs for forensic analysis
- Notify security team within 15min
- Follow incident response playbook: `docs/security/incident-response.md`
-
-## Metrics & KPIs
-
- **MTTR**: Mean time to recovery
- **Uptime**: Node and service availability percentages
- **Capacity**: Utilization vs. provisioned resources
- **Customer Impact**: Number of affected customers per incident
-
-## Appendix
-
- Outage history log
- Maintenance schedule
- Vendor contact list
- Compliance audit checklist
+*Version: 1.0* | *Effective: 2026-Q1* | *Next Review: 2026-Q2*
--- a/specs/templates/operator-application.md
+++ b/specs/templates/operator-application.md
@@ -1,112 +1,134 @@
+---
+application_id: OP-{{YYYYMMDD}}-{{SEQ}}
+submission_date: {{DATE}}
+status: pending_review
+---
+
 # Fleet Operator Application

-## Personal Information
+## 1. Personal Information

-**Full Name:**
-**Email:**
-**Phone:**
-**Location (City, State/Province, Country):**
-**Time Zone:**
+| Field | Value |
+|-------|-------|
+| Full Legal Name | |
+| Date of Birth | |
+| Email Address | |
+| Phone Number | |
+| Address (Primary) | |
+| Address (Vehicle Storage) | |
+| Driver's License Number | |
+| License State | |
+| License Expiration | |
+| Years Licensed | |

-## Business Entity
+## 2. Driving & Fleet Experience

-**Legal Structure:** (Sole Proprietor / LLC / Corporation / Other)
-**Business Registration Number:**
-**Tax ID/EIN:**
-**Years in Operation:**
+### Driving History
+- **Total Years Driving:** __
+- **Years Commercial/Professional:** __
+- **Accidents (past 3 years):** __
+- **Traffic Violations (past 3 years):** __
+- **Safety Courses Completed:** (list)

-## Technical Capabilities
+### Fleet/Transport Experience
+- **Previous Fleet Operator Role(s):** (company, dates, fleet size)
+- **Vehicle Types Operated:** (sedan, SUV, van, truck, EV, etc.)
+- **Telematics/Fleet App Experience:** (yes/no, systems used)
+- **Maintenance Experience:** (basic, intermediate, advanced)

-### Infrastructure
+## 3. Availability & Commitment

- **Number of Nodes Available:** __________
- **Hardware Specifications (per node):**
-  - CPU: __________
-  - RAM: __________
-  - Storage: __________
-  - Network: __________
+### Weekly Availability
+| Day | Morning (6a-12p) | Afternoon (12p-6p) | Evening (6p-12a) |
+|-----|-------------------|---------------------|-------------------|
+| Monday | ☐ | ☐ | ☐ |
+| Tuesday | ☐ | ☐ | ☐ |
+| Wednesday | ☐ | ☐ | ☐ |
+| Thursday | ☐ | ☐ | ☐ |
+| Friday | ☐ | ☐ | ☐ |
+| Saturday | ☐ | ☐ | ☐ |
+| Sunday | ☐ | ☐ | ☐ |

- **Uptime History (past 12 months):** __________%
- **Average Monthly Downtime:** __________ hours
+**Minimum Commitment:** ___ hours per week

-### Connectivity
+### Geographic Coverage
+- **Home Base/Preferred Zone:** _______________
+- **Willing to operate in:** (list additional zones)
+- **Willing to travel/relocate:** (yes/no, distance limit)

- **Primary ISP:** __________
- **Backup ISP:** __________ (Yes/No)
- **Average Upload Speed:** __________ Mbps
- **Average Download Speed:** __________ Mbps
- **Latency to primary regions:** __________ ms
+## 4. Equipment & Resources

-### Security & Compliance
+- [ ] **Vehicle Eligible:** Own or lease qualifying vehicle (min. 2020 model, <50k miles)
+  - **Make/Model/Year:** ___________
+  - **VIN:** ___________
+  - **Current Mileage:** ___________
+  - **Insurance:** (provider, policy number, coverage limits)

- **Physical Security Measures:** (e.g., locked racks, cameras)
- **Network Security:** (firewalls, VPNs, monitoring)
- **Data Privacy Compliance:** (GDPR, CCPA, etc.)
- **Insurance Coverage:** (liability, errors & omissions)
+- [ ] **Smartphone:** Compatible iOS/Android device with data plan
+- [ ] **Charging Access:** For EVs - home/work charging available (yes/no)

-## Operational Capacity
+- [ ] **Tools/Equipment:** (basic toolkit, cleaning supplies, etc.)

-**Support Hours:** __________ (24/7 / Business Hours / On-call)
-**Staff Count:** __________ (Full-time / Part-time)
-**Incident Response SLA:** __________
-**Monitoring Tools Used:** __________
+## 5. Financial & Background

-## Financial Terms
+- **Bank Account for Direct Deposit:** (routing & account)
+- **Tax Information:** (SSN or EIN, expected business structure)
+- **Background Check Authorization:** ☐ I authorize criminal and driving record check
+- **Credit Check Authorization:** ☐ I authorize credit check (if required for vehicle financing)

-**Desired Compensation Model:** (Tier 1 / Tier 2 / Tier 3)
-**Expected Monthly Revenue:** $__________
-**Start Date Availability:** __________
-**Commitment Period:** (6 months / 12 months / 24 months)
+## 6. Motivation & References

-## References
+### Why do you want to become a Fleet Operator?
+_(min. 100 words)_

-**Previous Fleet/Customer References:**
-1. Name: __________ | Contact: __________ | Relationship: __________
-2. Name: __________ | Contact: __________ | Relationship: __________
+### What makes you a good candidate for fleet operations?
+_(reliability, customer service, mechanical aptitude, etc.)_

-**Technical References:**
-1. Name: __________ | Contact: __________ | Relationship: __________
+### Professional References
+1. **Name:** _________ **Relationship:** _________ **Phone/Email:** _________
+2. **Name:** _________ **Relationship:** _________ **Phone/Email:** _________

-## Certifications
+## 7. Certifications & Training

- [ ] AWS/Azure/GCP Certification
- [ ] Network+ / Security+
- [ ] ISO 27001
- [ ] SOC 2
- [ ] Other: __________
+- [ ] Defensive Driving Course (if completed)
+- [ ] Commercial Driver's License (CDL) - if required for vehicle class
+- [ ] First Aid/CPR Certification
+- [ ] Other: _______________

-## Motivation & Alignment
+## 8. Agreement & Signature

-**Why do you want to join the Timmy Home Fleet?** (max 500 words)
-
-**How does your operation align with our values of reliability, transparency, and continuous improvement?** (max 300 words)
-
-## Attachments
-
- [ ] Proof of business registration
- [ ] Insurance certificates
- [ ] Network performance reports (last 3 months)
- [ ] Hardware inventory list
- [ ] Signed NDA (if not already on file)
-
-## Agreement
-
-By submitting this application, I certify that all information provided is accurate and complete. I understand that false statements may result in termination of the operator agreement.
+By submitting this application, I certify that:
+- All information provided is accurate and complete
+- I consent to background and driving record checks
+- I will maintain required insurance coverage
+- I will comply with all fleet policies, safety protocols, and regulations
+- I understand this is an independent contractor role, not employment
+- I have read and agree to the Fleet Operator Agreement

 **Signature:** _________________________
-**Date:** _________________________

-## Internal Use Only (Timmy Home Team)
+**Date:** _________________

- **Application Received:** __________
- **Initial Screening:** __________ (Pass/Fail) by __________
- **Technical Review:** __________ (Pass/Fail) by __________
- **Site Visit/Remote Inspection:** __________ (Completed/Dates)
- **Certification Assigned:** __________ (Tier 1 / Tier 2 / Tier 3)
- **Onboarding Date:** __________
- **Mentor Assigned:** __________
- **Operational Start Date:** __________
+---

-**Notes:**
-__________
-__________
+### Internal Use Only
+
+| Review Step | Completed By | Date | Notes |
+|-------------|--------------|------|-------|
+| Application Received | | | |
+| Background Check Initiated | | | |
+| Driving Record Review | | | |
+| Vehicle Inspection (if applicable) | | | |
+| Interview Scheduled | | | |
+| Certification Training Assigned | | | |
+| Final Approval | | | |
+
+**Application Status:** ☐ Approved ☐ Denied ☐ Additional Info Needed
+
+**Tier Assignment:** ☐ Tier 1 (Certified) ☐ Tier 2 (Senior) ☐ Tier 3 (Master)
+
+**Assigned Zone/Area:** ___________________
+
+**Mentor (if Tier 1):** ___________________
+
+**Follow-up Required:** ___________________
--- a/specs/templates/partner-report.md
+++ b/specs/templates/partner-report.md
@@ -1,134 +1,224 @@
-# Partner Monthly Report
+# Partner Channel Report

-## Report Period
-
-**Month/Year:** __________
-**Partner ID:** __________
-**Partner Name:** __________
-**Report Generated:** __________
-
-## Executive Summary
-
- Total leads generated: __________
- Qualified leads: __________
- converted customers: __________
- Revenue attributed: $__________
- Commission earned: $__________
- YoY growth: __________%
-
-## Lead Generation Metrics
-
-### Lead Volume
-
-| Channel | Total Leads | Qualified Leads | Conversion Rate | Notes |
-|---------|-------------|-----------------|-----------------|-------|
-| Direct Referral | __ | __ | __% | |
-| Marketing Campaign | __ | __ | __% | |
-| Events/Conferences | __ | __ | __% | |
-| Other: __________ | __ | __ | __% | |
-
-### Lead Quality Assessment
-
- **High Value (likely to convert):** __________ leads
- **Medium Value:** __________ leads
- **Low Value:** __________ leads
- **Lead Source Validation:** __________% verified
-
-## Revenue & Commission
-
-### Revenue Attribution
-
-| Customer | Deal Size | Start Date | Commission % | Commission Amount |
-|----------|-----------|------------|--------------|-------------------|
-| | $ | | % | $ |
-| | $ | | % | $ |
-| | $ | | % | $ |
-
- **Total Revenue:** $__________
- **Total Commission:** $__________
- **Commission Rate:** __________%
- **Payment Status:** (Paid / Pending / Escrow)
-
-### Payment Schedule
-
- **Commission Period:** 1st - last day of month
- **Payment Date:** __________ (net 30 days)
- **Payment Method:** (ACH / Wire / Check / Crypto)
- **Invoice Attached:** (Yes/No)
-
-## Fleet Performance Impact
-
-### Operator Contributions
-
-| Operator | Leads Generated | Conversions | Revenue Impact |
-|----------|----------------|-------------|----------------|
-| | | | $ |
-| | | | $ |
-| | | | $ |
-
-### Uptime & Reliability Correlation
-
- **Average fleet uptime during reporting period:** __________%
- **Leads from high-uptime operators (>99.5%):** __________
- **Customer complaints related to fleet issues:** __________
-
-## Marketing & Training Activities
-
-### Promotional Efforts
-
- Campaigns run: __________
- Materials distributed: __________
- Events attended: __________
- Content created: __________
-
-### Training Completed
-
- New operator certifications: __________
- Continuing education hours: __________
- Process improvements implemented: __________
-
-## Challenges & Blockers
-
- __________
- __________
- __________
-
-## Opportunities & Goals (Next Period)
-
-1. __________
-2. __________
-3. __________
-
-## Support Needs
-
- __ Technical assistance
- __ Marketing materials
- __ Training resources
- __ Lead qualification support
- __ Other: __________
-
-## Compliance & Agreement Status
-
- [ ] All reporting requirements met
- [ ] Commissions calculated correctly
- [ ] SLA adherence documented
- [ ] Partner agreement in good standing
- [ ] No compliance violations
-
-**Partner Signature:** _________________________
-**Date:** _________________________
-
-**Timmy Home Representative:** _________________________
-**Date:** _________________________
-
-## Attachments
-
- [ ] Lead verification documentation
- [ ] Revenue reports from finance system
- [ ] Commission calculation spreadsheet
- [ ] Marketing activity logs
- [ ] Training completion certificates
+**Reporting Period:** {{START_DATE}} – {{END_DATE}}
+**Partner ID:** {{PARTNER_ID}}
+**Partner Name:** {{PARTNER_NAME}}
+**Report Generated:** {{GENERATION_DATE}}

 ---

-*This report is confidential and intended solely for the use of the partner and Timmy Home leadership. Distribution without authorization is prohibited.*
+## 1. Executive Summary
+
+| Metric | Period Value | Target | Variance | Trend |
+|--------|--------------|--------|----------|-------|
+| Total Leads Generated | {{LEADS_TOTAL}} | — | — | {{LEADS_TREND}} |
+| Qualified Leads | {{LEADS_QUALIFIED}} | — | — | {{QUALIFIED_TREND}} |
+| Conversion Rate | {{CONVERSION_RATE}}% | >30% | {{CONVERSION_VARIANCE}}% | {{CONVERSION_TREND}} |
+| Active Certified Operators | {{ACTIVE_OPERATORS}} | 3-5 | {{OPERATOR_VARIANCE}} | {{OPERATOR_TREND}} |
+| Operator Churn (annualized) | {{CHURN_RATE}}% | <10% | {{CHURN_VARIANCE}}% | {{CHURN_TREND}} |
+| Fleet Uptime | {{UPTIME_PCT}}% | >99.5% | {{UPTIME_VARIANCE}}% | {{UPTIME_TREND}} |
+| Partner Revenue Share | ${{REVENUE_SHARE}} | — | — | {{REVENUE_TREND}} |
+
+**Key Wins This Period:**
+- 
+- 
+- 
+
+**Primary Challenges:**
+- 
+- 
+- 
+
+---
+
+## 2. Lead Generation & Conversion Funnel
+
+### Lead Sources
+| Source | Leads | Qualified % | Conversion % |
+|--------|-------|-------------|--------------|
+| Referral (existing operators) | {{LEADS_REFERRAL}} | {{QUAL_REFERRAL}}% | {{CONV_REFERRAL}}% |
+| Marketing Campaigns | {{LEADS_MARKETING}} | {{QUAL_MARKETING}}% | {{CONV_MARKETING}}% |
+| Direct Inquiry | {{LEADS_DIRECT}} | {{QUAL_DIRECT}}% | {{CONV_DIRECT}}% |
+| Events/Networking | {{LEADS_EVENTS}} | {{QUAL_EVENTS}}% | {{CONV_EVENTS}}% |
+| Other | {{LEADS_OTHER}} | {{QUAL_OTHER}}% | {{CONV_OTHER}}% |
+
+### Conversion Funnel
+```
+Leads Generated:   {{LEADS_TOTAL}} → Qualified: {{LEADS_QUALIFIED}} → Applications: {{APPS_SUBMITTED}} → Certified: {{OPERATORS_CERTIFIED}}
+```
+
+**Average Time to Certification:** ___ days (Target: ≤45 days)
+
+---
+
+## 3. Operator Performance Dashboard
+
+### Active Operators by Tier
+
+| Tier | Count | Change vs. Last Period | Average Uptime | Avg Customer Rating |
+|------|-------|------------------------|----------------|---------------------|
+| Tier 1 - Certified | {{OP_TIER1}} | {{OP_TIER1_CHG}} | {{UPTIME_TIER1}}% | {{RATING_TIER1}} |
+| Tier 2 - Senior | {{OP_TIER2}} | {{OP_TIER2_CHG}} | {{UPTIME_TIER2}}% | {{RATING_TIER2}} |
+| Tier 3 - Master | {{OP_TIER3}} | {{OP_TIER3_CHG}} | {{UPTIME_TIER3}}% | {{RATING_TIER3}} |
+| **Total** | **{{OP_TOTAL}}** | — | — | — |
+
+### Top 3 Operators (by performance score)
+1. **{{OP1_NAME}}** (Tier ___) - Uptime: ___%, Rating: ___/5.0, Trips: ___
+2. **{{OP2_NAME}}** (Tier ___) - Uptime: ___%, Rating: ___/5.0, Trips: ___
+3. **{{OP3_NAME}}** (Tier ___) - Uptime: ___%, Rating: ___/5.0, Trips: ___
+
+### At-Risk Operators (requiring intervention)
+| Operator | Issue | Action Plan | Owner |
+|----------|-------|-------------|-------|
+| | | | |
+| | | | |
+
+---
+
+## 4. Fleet Uptime & Reliability
+
+### Fleet Overview
+- **Total Vehicles Managed:** {{VEHICLES_TOTAL}}
+- **Available Vehicles:** {{VEHICLES_AVAILABLE}} ({{VEHICLES_AVAILABLE_PCT}}%)
+- **In Maintenance:** {{VEHICLES_MAINT}} ({{VEHICLES_MAINT_PCT}}%)
+- **Out of Service:** {{VEHICLES_OOS}} ({{VEHICLES_OOS_PCT}}%)
+
+### Uptime By Vehicle
+| Vehicle ID | Uptime % | Maintenance Events | Downtime Hours |
+|------------|----------|-------------------|----------------|
+| | | | |
+| | | | |
+| | | | |
+
+**Average Fleet Uptime:** {{UPTIME_PCT}}% (Target: >99.5%)
+
+**Top Downtime Causes:**
+1. ________________
+2. ________________
+3. ________________
+
+---
+
+## 5. Financial Summary
+
+### Partner Compensation
+| Component | Amount | Notes |
+|-----------|--------|-------|
+| Base Referral Fees | ${{BASE_FEES}} | ___ referrals × $___ each |
+| Operator Performance Bonus | ${{PERF_BONUS}} | Tier-based multipliers |
+| Fleet Uptime Incentive | ${{UPTIME_INC}} | Uptime >99.5% target |
+| Other: ______________ | ${{OTHER_INC}} | |
+| **Total Payout** | **${{TOTAL_PAYOUT}}** | |
+
+### Cost of Partner Activities
+- Marketing/Events: ${{COST_MARKETING}}
+- Training Resources: ${{COST_TRAINING}}
+- Support/Admin: ${{COST_ADMIN}}
+- **Total Cost:** ${{TOTAL_COST}}
+
+**Partner ROI:** {{ROI}}% (Total Payout ÷ Total Cost)
+
+---
+
+## 6. Training & Development
+
+### Operators in Training Pipeline
+| Trainee | Stage | Progress | Expected Certification |
+|---------|-------|----------|------------------------|
+| | Application → Interview | ___% | {{DATE}} |
+| | Interview → Training | ___% | {{DATE}} |
+| | Training → Exam | ___% | {{DATE}} |
+| | Probation → Certified | ___% | {{DATE}} |
+
+### Training Completion Rates
+- **Onboarding Completion:** ___% (Target: 100%)
+- **Certification Exam Pass Rate:** ___% (Target: >85%)
+- **Average Training Duration:** ___ days
+
+### Completed Training Sessions This Period
+- Date: ___ - Topic: ___ - Attendees: ___
+- Date: ___ - Topic: ___ - Attendees: ___
+
+---
+
+## 7. Partner Activities & Outreach
+
+### Events Attended/Sponsored
+| Event | Date | Location | Leads Generated | Cost |
+|-------|------|----------|-----------------|------|
+| | | | | |
+| | | | | |
+| | | | | |
+
+### Marketing Materials Distributed
+- Digital ads impressions: ___
+- Email campaigns sent: ___ (open rate: ___%)
+- Social media posts: ___
+- Brochures/flyers: ___
+
+### Partnership Developments
+- New partner agreements signed: ___
+- Existing partner renewals: ___
+- Partnership meetings held: ___
+
+---
+
+## 8. Customer Feedback & Satisfaction
+
+### Customer Ratings (by operator)
+- **Average Rating:** {{AVG_RATING}}/5.0 (Target: >4.5)
+- **5-Star Trip Percentage:** {{PCT_5STAR}}%
+- **Complaints per 100 trips:** {{COMPLAINTS_PER_100}}
+
+### Top Praise Themes
+- 
+- 
+- 
+
+### Top Complaint Themes
+- 
+- 
+- 
+
+---
+
+## 9. Issues & Blockers
+
+### Active Issues (past 30 days)
+| Issue | Impact | Status | Owner | Resolution ETA |
+|-------|--------|--------|-------|----------------|
+| | | | | |
+| | | | | |
+
+### Escalated to Program Management
+- 
+- 
+
+---
+
+## 10. Action Plan & Next Period Goals
+
+### Priorities for Next Period
+1. **Recruitment Target:** ___ new certified operators
+2. **Performance Improvement:** Address ___ at-risk operators
+3. **Uptime Focus:** Reduce downtime for vehicles: ___
+4. **Event/Outreach:** Attend ___ events, generate ___ leads
+5. **Churn Reduction:** Implement ___ retention initiatives
+
+### Resource Needs
+- 
+- 
+
+### Key Milestones
+| Date | Milestone | Owner |
+|------|-----------|-------|
+| | | |
+| | | |
+
+---
+
+**Submitted by:** __________________ (Partner Manager)
+**Date Submitted:** __________________
+
+**Reviewed by:** __________________ (Fleet Program Director)
+**Review Date:** __________________