# MzadAuto.ma (Moroccan Automotive & Auction Platform)

> MzadAuto is a modern digital platform in Morocco specializing in automotive vehicle auctions, comprehensive car catalog specifications, and an intelligent vehicle comparison engine.

## Core Capabilities
- **Automotive Catalog**: Real-world technical specifications, engine options, horsepower (ch / ch fiscaux), transmissions, safety features, dimensions, and Moroccan market retail prices for verified vehicles.
- **Vehicle Comparator**: Head-to-head automotive side-by-side comparison engine across models, engines, equipment tiers, and performance metrics.
- **Automotive Auctions (Mzad)**: Transparent online bidding platform for verified used and repossessed vehicles in Morocco with KYC compliance, anti-sniping protection, and real-time outbid notifications.
- **Automotive Tools**: Import duty, registration (carte grise), and credit calculation tools tailored to Moroccan automotive regulations.

## Machine-Readable Resources & APIs
- **API Catalog**: `/.well-known/api-catalog` (RFC 9727 Linkset JSON)
- **OpenAPI Specification**: `/api/openapi.json` (OpenAPI 3.0.3)
- **Sitemap Index**: `/sitemap.xml`
- **Health Check**: `/up`

## Public Endpoints
- `GET /catalogue/modeles`: Returns available automotive makes, model names, and slugs for comparison and search.
- `GET /catalogue/search?q={query}`: Search automotive catalog by brand, model, or year.
- `GET /{locale}/comparateur/{slugs}`: Vehicle comparison page for 2 to 3 models (e.g., `dacia-duster-vs-renault-clio`).
- `GET /{locale}`: Localized portal (`/fr`, `/ar`, `/en`).

## Developer & Agent Integration
- Platform: Laravel + Inertia.js (Vue 3 SSR)
- Protocols: RFC 8288 (Web Linking), RFC 9727 (api-catalog discovery)
- Contact: support@mzadauto.ma