wip

docs/concept/DRIVERS.md

@@ -0,0 +1,236 @@
+# GridPilot for Drivers  
+*A clean competition platform that gives iRacing drivers structure, clarity, and long-term identity — without the chaos of Discord, spreadsheets, or scattered tools.*
+
+---
+
+## 1. Why GridPilot Matters for Drivers
+
+iRacing’s official races are fun, but they’re anonymous.  
+Community leagues are exciting, but they’re chaotic and inconsistent.
+
+Drivers want:
+- clear schedules  
+- consistent standings  
+- honest competition  
+- long-term stats  
+- team identity  
+- simple sign-ups  
+- structured complaints  
+- a place to follow their own racing journey  
+
+GridPilot gives drivers the **missing competitive layer** on top of iRacing leagues.
+
+---
+
+## 2. Your Driver Profile
+
+Every GridPilot driver gets a modern profile that shows who they are across leagues.
+
+### **Profile includes**
+- name, number, country  
+- leagues you’re currently racing in  
+- season standings (driver + team)  
+- race history  
+- long-term point totals  
+- finishing positions  
+- incident trends  
+- performance stats (e.g., avg finish, win rate)  
+- optional team membership  
+
+### **Why it’s different**
+For the first time, your results aren’t stuck in individual Discords or spreadsheets.
+
+Your **racing identity lives in one place**.
+
+---
+
+## 3. League Discovery — Find Where You Belong
+
+GridPilot makes it easy to find leagues that fit your schedule, skill level, and car preferences.
+
+### **Search filters**
+- car class  
+- time of day  
+- weekday/weekend  
+- competition level  
+- league size  
+- region  
+
+### **League pages show**
+- schedule  
+- standings  
+- rules & format  
+- car/track list  
+- roster  
+- sign-ups  
+
+No more scrolling through dead Discord ads or random forum posts.  
+You actually *see* what you’re joining.
+
+---
+
+## 4. Joining a League — Simple & Fast
+
+A driver-first flow:
+
+1. Pick a league  
+2. Review schedule & format  
+3. Join solo or select a team  
+4. See upcoming races instantly  
+5. Start collecting points
+
+No forms.  
+No spreadsheets.  
+No “talk to the admin.”  
+Just click and race.
+
+---
+
+## 5. Race Day Clarity
+
+GridPilot gives drivers everything they need to show up ready:
+
+- upcoming race timer  
+- track, car, session settings  
+- lobby info (password, link, format)  
+- previous race results  
+- standings impact preview  
+- weather / dynamic info (if available)  
+
+Drivers stop asking the admin:  
+> “Hey, what’s the track this week?”
+
+---
+
+## 6. Automatic Race Results
+
+After the race, GridPilot automatically pulls iRacing’s results:
+
+### **You get**
+- final classification  
+- gained/lost positions  
+- incidents  
+- fastest laps  
+- points earned  
+- drop-week changes  
+
+No more:
+- waiting for an admin  
+- refreshing Discord  
+- reading screenshots  
+- guessing standings  
+
+Standings update themselves the moment results hit iRacing.
+
+---
+
+## 7. Long-Term Progression
+
+Drivers always wanted more than “just racing.”  
+GridPilot gives:
+
+### **Season history**
+- every race  
+- every point  
+- every position change  
+
+### **Career overview**
+- races completed  
+- podiums  
+- wins  
+- average finish  
+- trendline performance  
+
+### **Multi-league identity**
+Your GridPilot profile grows as you race in multiple leagues and seasons.
+
+This makes league racing finally feel **meaningful**.
+
+---
+
+## 8. Team Racing — Real Constructors-Style Competition
+
+GridPilot supports **real team racing**, not the one-driver-per-team limitation of most leagues.
+
+### **How it works**
+- each team registers multiple drivers  
+- drivers race in parallel  
+- all points contribute to the team championship  
+- teams gain prestige over multiple seasons  
+
+### **For drivers**
+You can:
+- join a team  
+- help your team climb the standings  
+- show your contribution in your profile  
+- build real rivalries over time  
+
+This creates a feeling of *real motorsport* instead of isolated races.
+
+---
+
+## 9. Complaints & Penalties Made Simple
+
+Drivers finally get a **structured** way to submit complaints.
+
+### **Submit complaint**
+- pick the race  
+- pick involved drivers  
+- add timestamps  
+- add description  
+- optional replay clip / YouTube link  
+
+### **Admin sees a simple review panel.**  
+No lost DMs, no arguments across Discord, no chaos.
+
+### **Standings update automatically after penalties.**  
+No manual math.  
+No spreadsheet edits.
+
+Drivers get transparency.  
+Admins get speed.
+
+---
+
+## 10. The Experience for Drivers
+
+GridPilot gives drivers:
+
+- fewer distractions  
+- less confusion  
+- no spreadsheet hell  
+- proper standings  
+- identity that grows  
+- team fantasy + real competition  
+- simple joining  
+- long-term motivation  
+- reliable information  
+- structured dispute resolution  
+
+League racing finally feels like a **proper season**, not a patchwork process.
+
+---
+
+## 11. What GridPilot *does not* do (important)
+
+- doesn’t manage your Discord social life  
+- doesn’t auto-join races for you  
+- doesn’t replace iRacing  
+- doesn’t enforce drama rules  
+- doesn’t simulate or interfere with gameplay  
+
+GridPilot strengthens what drivers already enjoy —  
+and eliminates everything that frustrates them.
+
+---
+
+# Summary
+
+GridPilot for Drivers is about three things:
+
+1. **Clarity** — know where, when, and what you’re racing.  
+2. **Progression** — see your improvement and career.  
+3. **Competition** — battle in leagues and teams that feel like real motorsport.
+
+The platform gives drivers exactly what they’re missing today:  
+a central, modern home for their league racing identity.