# Queen City Auto Parts — PRD

## Overview
Centralized operating system for Queen City Auto Parts — a premium auto parts sourcing platform.

## Design System (LOCKED)
- Background: #0B0B0B | Section: #121212 | Card: #1E1E1E | Border: #2A2A2A
- Text: #FFFFFF / #9A9A9A | Accent: #007BFF | Hover: #0056CC | Success: #28A745
- Font: Inter (Bold headers, tight spacing) | No gradients | Max 4px radius
- Brand: "QUEEN CITY AUTO" | Tagline: "Precision Parts. No Guesswork."

## Tech Stack
- Frontend: React, Tailwind CSS, shadcn/ui | Backend: FastAPI, Motor, MongoDB
- Payments: Stripe | VIN: NHTSA API | Domain: queencityautoparts.com

## Completed Features
- **Homepage**: Hero with dominant VIN search, manual Year/Make/Model search, trust bar, product grid
- **Sticky Header**: VIN search bar center, nav links, Login/Dashboard
- **Inventory**: Search + filter grid (condition, category, price, year, make, model)
- **Find Part**: VIN decode auto-fill, request form, success state
- **Customer Dashboard**: Overview stats, My Garage (CRUD + VIN), Quotes, Orders, Invoices (Stripe Pay), Shipments
- **Admin CRM**: Overview, Pipeline (9 stages), Customers (profiles), Sourcing Hub (FB/Junkyard/Notes), Requests, Orders, Invoices, Shipments, Leads
- **Auth**: User register/login, Admin login
- **Stripe**: Checkout sessions, polling, webhooks
- **All pages**: How It Works, For Mechanics, About, Contact — all redesigned

## Phase 3 — Next
- Email automation (Resend/SendGrid)
- SMS (Twilio-ready)
- Multi-user shop accounts
- Analytics dashboard
- Cloud file storage (Cloudinary/S3)
