# RaceBook — Motorsport Coaching Platform

> RaceBook is a web application for racing drivers and their coaches. It provides structured tools to log driving sessions, build circuit knowledge, deliver coaching feedback, and track performance improvement over a full racing season.

## What RaceBook Does

RaceBook connects drivers and coaches in a shared digital workspace. The platform closes the coaching feedback loop: drivers log sessions, coaches analyse and respond, both parties track measurable progress over time.

### For Racing Drivers

- **Session and Run Logging**: Record every practice, qualifying, and race session. Each session contains individual runs logged with lap times, tyre compound, setup notes, weather, and self-reflection. Attach telemetry files and onboard video directly to runs.
- **Circuit Notes**: Build a permanent track guide for every circuit. Corner-by-corner notes are pinned to an interactive map. Add brake reference photos. Load your full guide before the next visit at any venue.
- **Self-Assessment**: Rate your own driving across dimensions like braking, throttle application, consistency, and racecraft before reading your coach's feedback. The gap between your self-assessment and the coach's ratings is a learning tool in itself.
- **Focus Areas**: Coaches set specific focus areas per session that carry forward to every subsequent run, building deliberate improvement habits over time.
- **Progress Analytics**: View qualifying pace gaps, race finishing position trends, and qualitative score trajectories across your full season on a single Progress page.
- **Race Preparation**: Structured race prep tools for tyre strategy, starting procedures, and pre-race planning.
- **Coaching Plans and Drills**: Access structured training plans assigned by your coach, including YouTube-linked video drill demonstrations.

### For Racing Coaches

- **Session Reviews**: Access every driver session with full run-level data, self-reflection notes, and attached files. Deliver structured written feedback, link coaching videos, and rate 13 driving performance dimensions.
- **Student Progress Dashboard**: View all coached drivers, their latest sessions, review status, and long-term development trends.
- **Team Management**: Create teams with multiple drivers and coaches. Shared events mean every team member logs to the same race weekend. Assign roles (coach, driver, spectator, admin).
- **Coaching Plans**: Create reusable training plan templates with drills, assign them to individual drivers, and set one-time fees if desired.
- **Public Booking Page**: Each coach gets a public-facing profile page with a bookable services menu. Drivers can book session reviews, 1:1 calls, or other services and pay via Stripe.
- **Calendly Integration**: Coaches can embed a Calendly booking widget on their public page for 1:1 session scheduling.

## Key Features Summary

| Feature | Description |
|---------|-------------|
| Session Logging | Events → Sessions → Individual Runs with lap times, setup, and files |
| Circuit Notes | Interactive track maps with corner notes and photo references |
| Coach Feedback | Structured reviews: written, video, 13-dimension ratings |
| Progress Analytics | Qualifying pace, race positions, qualitative score trends |
| Focus Areas | Persistent coaching targets that appear on every run |
| Training Plans | Coach-assigned plans with YouTube drill videos |
| Teams | Multi-driver shared events with role-based access |
| Public Coach Pages | Bookable coach profiles with Stripe payments |
| Self-Assessment | Driver rates own performance before seeing coach's view |
| Chat | In-app messaging between drivers and coaches |

## Technology

- **Frontend**: React (Vite), Tailwind CSS, shadcn/ui components
- **Backend**: Node.js (Express), PostgreSQL
- **Authentication**: AllSports SSO (OIDC)
- **Payments**: Stripe (coach's own Stripe account)
- **Hosting**: Railway

## Target Users

- Amateur and semi-professional racing drivers in karting, single-seaters, GT, touring cars, endurance racing, and track day driving
- Professional and semi-professional motorsport coaches
- Racing teams managing multiple drivers

## Public Pages

- `/Landing` — Home page with feature overview and pricing
- `/HowItWorks` — Detailed walkthrough for drivers and coaches
- `/Coaches` — Directory of available coaches
- `/PublicCoachPage?slug={slug}` — Individual coach profile and booking page
- `/Blog` — Motorsport coaching and data analysis articles
- `/BlogPost?slug={slug}` — Individual blog articles
- `/BecomeCoach` — Application form for coaches wanting to join RaceBook
- `/PrivacyPolicy` — Full privacy policy

## Contact

For coach enquiries: use the Become a Coach page at /BecomeCoach
For support: contact via the in-app chat once registered