# GridPilot — In-Depth Stats & Scoring  
*A modern statistics and scoring engine that gives meaning, context, and clarity to every race, every season, and every driver.*

---

# 1. Purpose of GridPilot Stats  
iRacing’s official results are powerful, but extremely limited:  
- no career progression  
- no cross-season view  
- no team context  
- no advanced analytics  
- no identity  

GridPilot turns league racing into a structured competitive ecosystem by adding **deep, consistent, cross-league analytics** that drivers, teams, and admins can all rely on.

---

# 2. Core Data We Track

GridPilot automatically imports race metadata from iRacing and expands it into a full statistical model.

### **Per Race**
- finishing position  
- starting position  
- positions gained/lost  
- incidents  
- best lap  
- average lap pace (optional if telemetry available)  
- laps completed  
- penalties applied  
- classification after penalties  

### **Per Driver (Season)**
- points  
- average finish  
- consistency rating  
- race attendance  
- clean race percentage  
- total incidents  
- incidents per lap  
- podiums  
- wins  
- DNF count  
- performance trend  

### **Per Team (Season)**
- total team points  
- points contribution per driver  
- average team finish  
- number of drivers scoring  
- team attendance  
- team success over time  

### **All-Time Stats**
- total races  
- total wins  
- total podiums  
- historical point totals  
- incident history  
- class-specific stats (e.g., GT4, F4, F3)  
- multi-league performance overview  

These stats give GridPilot the ability to create meaningful identity and competitive depth.

---

# 3. Scoring Engine (Flexible + Transparent)

Each league defines its scoring rules, but GridPilot standardizes them into clear, consistent structures.

### **Supported Scoring Models**
- Formula-style points (F1, F2, F3, F4, GP2, etc.)  
- Endurance-style points  
- Fixed points per position  
- Bonus points:
  - fastest lap  
  - pole position  
  - clean race  
  - most positions gained  

### **Drop Weeks**
- configurable number of drops  
- visual indicator for dropped results  
- fully automated recalculation  

### **Team Scoring**
A true Constructors-style model:
- multiple drivers score per race  
- flexible configuration (best 2 scores, all scores, custom rules)  
- team standings calculated instantly  
- team stats update automatically  

---

# 4. Driver Performance Metrics (Advanced)

GridPilot doesn’t just store results — it analyzes them.

### **Key Driver Metrics**
- **Consistency Score**  
  Statistical deviation of finishing positions over time.  
  Lower = more consistent.

- **Pace Index** (optional if telemetry available)  
  Comparison of average lap times vs. field median.

- **Clean Driving Score**  
  Incidents per race + severity weighting.

- **Racecraft Score**  
  Positions gained/lost vs. incident involvement.

- **Progression Score**  
  Improvement across a season, shown as a trendline.

- **Clutch Factor**  
  Performance in high-pressure scenarios (late-season races, close battles).

### **Visibility**
All metrics appear on:
- driver profile  
- season detail page  
- league overview  
- team contribution breakdown  

Drivers finally see **how** they drive — not just where they finish.

---

# 5. Team Metrics (Depth That Makes Teams Matter)

Teams get **quantitative identity**.

### **Team Performance Metrics**
- team points  
- team pace  
- average finishing position  
- contribution per driver  
- lineup efficiency (who delivers consistent points)  
- recruitment performance (improvement after roster changes)  
- team form (last 5 races)

### **Team Contribution Breakdown**
Each driver has:
- points contributed  
- percentage of team output  
- consistency  
- clean driving impact  
- reliability (attendance)  

This creates real internal and external rivalries.

---

# 6. Season Intelligence

GridPilot gives leagues a complete analytical picture:

### **Season Insights**
- top improvers  
- most consistent drivers  
- hard chargers  
- clean drivers  
- most valuable drivers (team scoring)  
- pace distribution  
- incident hotspots  
- attendance map  

### **League Health Metrics**
- retention  
- average field size  
- finishing rate  
- incident averages  
- multi-class balancing  

Admins get clarity without spreadsheets.

---

# 7. Classification Adjustments (Penalties Included)

Results are never final until all penalties are processed.

GridPilot automatically handles:

- time penalties (+5s / +10s / +30s / custom)  
- points deductions  
- disqualifications (race-level)  
- attendance penalties (if used)  
- warning tracking  

After admin decisions:
- standings recalculate  
- driver stats update  
- team stats update  
- classification changes are logged  
- penalty history is visible  

No manual recalculation.  
No mistakes.  
No drama.

---

# 8. Global Scoring Vision (Future-Friendly)

GridPilot tracks:
- per-league points  
- per-season points  
- all-time points  
- team points  
- class-based points  

This allows future scaling into:
- global leaderboards  
- cross-league rankings  
- multi-class ladders  
- team world rankings  

We don’t implement everything on day one —  
but the **data model is built for it**.

---

# 9. Why GridPilot Stats Matter

For Drivers:
- proof of skill  
- motivation  
- long-term identity  
- visible improvement  
- fairness & transparency  

For Teams:
- real constructors competition  
- driver scouting  
- lineup planning  
- prestige and pride  

For Admins:
- no spreadsheets  
- no miscalculations  
- clarity for the community  
- instant transparency  
- professionalism  

For Leagues:
- structure  
- identity  
- competitiveness  
- return of drivers season after season

---

# Summary

GridPilot’s scoring and analytics system turns scattered league racing into a **structured competitive ecosystem**:

- complete results  
- meaningful metrics  
- constructors-style team scoring  
- clean & consistent standings  
- penalty-aware classification  
- multi-season depth  
- driver identity  
- team identity  
- league clarity  

This is the **foundation** that makes GridPilot more than a tool —  
it becomes the home of competition in iRacing league racing.