# Faisal Car Bazar — Product Requirements (Living Doc)

## Original Problem Statement
Build a modern, premium, responsive and SEO-friendly website for **Faisal Car Bazar**, a used-car dealership in Nagpur.
- Phone: +91 98230 78626
- Address: Telephone Exchange Square, Gangabai Ghat Rd, beside Indian Oil Petrol Pump, Block Number 8, Mangalwari, Nagpur, Maharashtra 440008
- Map: https://maps.app.goo.gl/J4QBVcebRtYeh9gw7

## User Choices (locked Feb 2026)
- Color palette: deep crimson red + cream/gold + dark charcoal (luxury dark theme)
- Admin: default `admin@faisalcarbazar.com` / `Admin@123`
- Image storage: Emergent Object Storage
- Owner profile: editable from admin (admin can update name, photo, bio later)
- Sample inventory: 10 cars + 9 gallery items seeded

## Architecture
- **Frontend**: React 19 + React Router 7 + Tailwind + Shadcn UI + Sonner toasts + Lucide icons
- **Backend**: FastAPI + Motor (MongoDB) + JWT auth (bcrypt) + Emergent Object Storage
- **Fonts**: Cormorant Garamond (display), Outfit (body)
- **Auth**: Single admin (seeded on startup), JWT (7-day expiry) stored in `localStorage.fcb_admin_token`

## Implemented (Feb 2026)
- Public pages: Home, Inventory (filter+sort+search+pagination, 15/page), Car Detail, Gallery (lightbox + category filter), About (owner profile + stats), Contact (form + embedded Google map), Services (8 services), Sell Your Car (form + multi-image upload)
- Admin: Login, Overview (5 stat tiles), Cars CRUD (modal form with image upload via Emergent Object Storage), Gallery CRUD, Owner profile editor
- Cross-cutting: Sticky glass navbar, floating WhatsApp button with pulse, footer with newsletter, SEO meta tags + JSON-LD AutoDealer schema, mobile-responsive throughout
- 26/26 backend tests pass + all frontend flows verified by testing agent

## User Personas
- **Buyer**: Browses inventory, filters by budget/brand/fuel, requests WhatsApp enquiry, optionally fills contact form.
- **Seller**: Submits car details + photos via Sell Your Car form to get a valuation.
- **Owner / Admin**: Manages inventory, gallery and owner-profile updates via the admin console.

## Backlog (P1 / P2)
- **P1**: Admin views for incoming Sell submissions + Contact messages list (data already collected in DB; backend list endpoints exist).
- **P1**: Replace localStorage JWT with HttpOnly cookies for stronger security.
- **P2**: Filter UI: chip-style active filters preview, "save search" feature.
- **P2**: Car detail page: similar cars suggestions, share buttons.
- **P2**: Multi-language support (English / Marathi / Hindi).
- **P2**: Lead-source tracking on every WhatsApp click for analytics.

## Test Credentials
See `/app/memory/test_credentials.md`.

## Important File Locations
- Backend: `/app/backend/{server.py,auth.py,storage.py,seed_data.py}`
- Frontend pages: `/app/frontend/src/pages/*.jsx`
- Frontend components: `/app/frontend/src/components/*.jsx`
- API client + constants: `/app/frontend/src/lib/api.js`