Car Market Node.js

System Architecture & Core Pillars

Car Market combines a decoupled Node.js & Express REST API with an asynchronous, high-speed React (Vite) Single Page Application to deliver sub-second search times and smooth seller workflows.

┌─────────────────────────────────────────────────────────────────────────────┐
│                    Car Market Full-Stack Architecture                       │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │
           ┌───────────────────────────┼───────────────────────────┐
           ▼                           ▼                           ▼
  🔍 Smart Search Engine       📸 Media & Seller Hub       🛡️ Trust, Safety & GDPR
  • Dual-handle DB sliders      • 15-photo Drag & Drop      • Queue-based moderation
  • Brand ➔ Model cascade      • SortableJS cover select   • Full-res ad inspection
  • Zero-result prevention      • Automated WebP (Sharp)        • GDPR Art. 17 & 20
  • Real-time stock counts      • YouTube & Shorts embed       • JWT & Bcrypt security
            

1. Intelligent Search Engine & Dynamic Filtering

The marketplace search engine uses database-bound limits to provide instant query refinement and eliminate dead-end search paths:

• Database-Bound Dual Sliders (rc-slider): Price, Kilometer, and Year sliders automatically calculate their boundaries from the actual lowest and highest vehicle values stored in the MySQL database.
• Smart Cascading Brand ➔ Model Selectors:
  • Zero-Result Prevention: The public search filter only displays brands and models that currently have active, approved vehicles in stock.
  • Live Inventory Count Badges: Real-time counter displayed next to each option (e.g. Renault (4) ➔ Clio V (2)).
• Technical Attribute Filters: Filter by vehicle category (Automobiles, Motorcycles, Commercial), body type (Sedan, SUV, Break, Coupe, Convertible, 4x4), fuel types (Petrol, Diesel, Hybrid, Electric, LPG, Hydrogen), and transmission (Manual, Automatic).
• Asynchronous Sorting: Sort listings instantly by latest additions, price ascending/descending, mileage, or model year.

2. Detailed Vehicle Product Sheet & Multimedia Experience

The detailed vehicle view (/vehicule/:slugOrId) is organized into a high-conversion 2-column layout:

3. Seller Ad Publishing & Image Processing Pipeline

Car Market equips private and professional sellers with intuitive tools and automated asset optimization:

• Complete Automotive Taxonomy (120 Brands & 1,890+ Models): Full catalog available during listing creation, ensuring accurate categorization.
• Profile Gatekeeper Check: Restricts announcement publication until the seller has completed their profile (first name, last name, verified phone number).
• Drag & Drop Image Reordering (SortableJS): Upload up to 15 images simultaneously and drag thumbnails to choose the primary cover photo ⭐ Cover.
• Sharp Automated WebP Conversion: Incoming JPEG, PNG, or HEIC files are converted on the server into modern .webp format at 80% compression with EXIF orientation correction.
• "Mes Annonces" (My Listings) Workspace: Dedicated dashboard with status tabs (All, Live / En ligne, Under Review / En attente), inline edit triggers, and deletion tools.

4. Quality Assurance & Admin Moderation Dashboard

To eliminate spam, fraudulent listings, and low-quality photos, the platform implements an administrative review queue:

5. Enterprise-Grade Security & European GDPR Compliance

Car Market strictly adheres to European General Data Protection Regulation standards (EU 2016/679):

• Stateless JWT Authentication: Bearer token security with Bcrypt password hashing (minimum 8 characters, mixed case, digits, and special characters).
• Data Portability (GDPR Article 20): Instant one-click export (/api/gdpr/export) delivering a structured JSON file with all user profile metadata and vehicle history.
• Right to Erasure / "Right to be Forgotten" (GDPR Article 17): One-click permanent account deletion that purges user data and deletes all physical image files from the server storage.

6. Technical Feature Matrix