wip

docs/concept/CONCEPT.md

@@ -0,0 +1,232 @@
+# GridPilot — The Competition Platform for iRacing Leagues  
+*A modern, lightweight platform that gives iRacing league racing structure, identity, and long-term meaning — without taking control away from communities.*
+
+---
+
+# 1. What GridPilot Solves
+
+iRacing’s strength is racing quality, not league infrastructure.  
+Today, league racing suffers from:
+
+- scattered tools (Discord, Sheets, Forms, DMs)
+- zero unified identity for leagues
+- heavy admin workload for every race
+- no automatic standings or result sync
+- no long-term driver identity or career stats
+- no proper team-based competition
+- unstructured protest handling (DMs, screenshots, chaos)
+
+GridPilot becomes the **competition layer** above iRacing.  
+We don’t change racing — we fix everything around it.
+
+---
+
+# 2. Who GridPilot Is For
+
+## League Admins
+Need:
+- easy season setup  
+- automatic result handling  
+- clean standings  
+- a structured complaints/penalty workflow  
+- predictable points systems  
+- modern league presentation  
+- simple driver/team signups  
+- optional session-creation QoL automation  
+
+## Drivers
+Need:
+- easy league discovery  
+- simple registration  
+- clean standings  
+- reliable schedule  
+- personal stats and history  
+- long-term progression  
+- team + individual competition  
+- structured way to file complaints  
+
+Admin + Driver = **GridPilot’s only focus for MVP**.
+
+---
+
+# 3. Core Features (MVP)
+
+## 3.1 League Identity
+- clean public league page  
+- schedule, standings, roster, rules  
+- league branding (logo, colors)  
+- optional custom domain  
+- links to Discord / YouTube / Twitch  
+
+## 3.2 Season Management
+- full calendar for each season  
+- point system presets  
+- drop weeks  
+- team or solo mode  
+- automatic standings  
+
+## 3.3 Driver & Team System
+### Drivers:
+- league join flow  
+- personal stats (per race + lifetime)  
+- progression + history  
+- cross-league identity (v1 basic)
+
+### Teams:
+- create/manage teams  
+- team roster management  
+- real “Constructors Championship” parallel scoring  
+- team standings + history  
+
+(This is a unique selling point: **real team racing in iRacing leagues**.)
+
+---
+
+# 4. Complaints & Penalties (Essential)
+
+A structured system to replace Discord DMs and random drama.
+
+## 4.1 Driver Complaints
+Drivers can file a complaint with:
+- race  
+- involved drivers  
+- timestamp(s)  
+- description  
+- optional replay clip / link  
+
+Keeps everything organized and searchable.
+
+## 4.2 Admin Penalty Tools
+Admins get a review panel:
+- complaint list  
+- timestamps + notes  
+- direct links to replays  
+- quick actions:
+  - no action  
+  - warning  
+  - time penalty  
+  - points deduction  
+  - DQ for race  
+
+## 4.3 Automatic Standings Update
+When a penalty is assigned:
+- driver points update  
+- team points update  
+- classification updates with time penalties  
+- everything logged transparently  
+
+Admins stay in control.  
+Drivers understand the decision.  
+Chaos disappears.
+
+---
+
+# 5. Result Automation (Essential QoL)
+
+- automatically sync race results from iRacing  
+- parse positions, laps, incidents, fastest lap  
+- update standings instantly  
+- eliminate manual CSV uploads or spreadsheets  
+
+This is **core** for both admins and drivers  
+(but not the “main feature” — just feels like magic).
+
+---
+
+# 6. Optional: Session Creation QoL (Not required)
+
+GridPilot can assist admins:
+- create sessions via browser automation  
+- batch-create entire season  
+- consistent settings without errors  
+
+Important:
+**Automation is a helper, not the product.**  
+We never touch gameplay.
+
+---
+
+# 7. Competition Layer
+
+This is what makes GridPilot more than “tools”.
+
+## 7.1 Individual Progression
+Drivers earn:
+- points  
+- standings  
+- history  
+- personal stats  
+- performance trends  
+
+Racing finally has **long-term meaning**.
+
+## 7.2 Team Competition
+Teams accumulate points across races and seasons.  
+Drivers contribute to team success even when racing individually.
+
+The result:
+**iRacing Ligen finally feel like real motorsport championships.**
+
+---
+
+# 8. Safety, Security & Trust
+- zero-knowledge login  
+- we never see or store passwords  
+- browser window visible for login  
+- automation always runs *on the admin’s machine*  
+- no client modification (unlike iRefined)  
+
+Trust and legality are fundamental.
+
+---
+
+# 9. MVP Philosophy
+
+### What we include:
+- Admin QoL tools  
+- Driver identity  
+- Team competition  
+- Standings + automation  
+- Complaints + penalties  
+- League identity + presentation  
+- Session creation helper (optional)
+
+### What we leave out for now:
+- stewards marketplace  
+- streaming tools  
+- monetization  
+- complex global ladder  
+- rating systems  
+- cross-sim functionality  
+- esports organization  
+
+GridPilot starts **simple and solid**.
+
+---
+
+# 10. Long-Term Vision (kept small but real)
+
+GridPilot becomes the central place where:
+- drivers build a career  
+- teams compete across seasons  
+- leagues run without chaos  
+- complaints/penalties stay structured  
+- standings stay consistent  
+- automation reduces work  
+- identity and progression matter  
+
+This is the part that makes us **THE platform**,  
+but we don’t overpromise it on day one.
+
+---
+
+# Summary
+
+**GridPilot simplifies league management —  
+and elevates it from scattered spreadsheets  
+to a modern competition platform.**
+
+Admins get less work.  
+Drivers get more meaning.  
+Teams get real championships.  
+Everyone gets structure instead of chaos.