# MC Cars — Local Testing Protocol

> This document records the exact steps taken to verify the MC Cars stack is operational.
> Run these steps after every stack spin-up to confirm baseline functionality.

---

## Prerequisites

- Docker Engine with Compose v2
- Clean data directory: `rm -rf data/db data/storage data/n8n && mkdir -p data/{db,storage,n8n}`

---

## 1. Spin Up the Stack

```bash
docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build
```

Wait ~30 seconds for migrations to complete, then verify:

```bash
docker compose -f docker-compose.yml -f docker-compose.local.yml ps
```

Expected: all 14 services running (db healthy, kong healthy).

---

## 2. Verify API Responds

```bash
curl -s http://localhost:55580/index.html | head -5
```
Expected: HTML response with `<!DOCTYPE html>`

```bash
curl -s -H "apikey: $ANON_KEY" "http://localhost:55521/rest/v1/vehicles?select=brand,model"
```
Expected: `[{"brand":"Ferrari","model":"296 GTB"}]`

---

## 3. Playwright End-to-End Tests

### 3.1 Public Website — Verify Access & Ferrari

1. Navigate to `http://localhost:55580/index.html`
2. Verify page loads with title "MC Cars · Sportwagenvermietung Steiermark"
3. Verify hero section is visible
4. Verify "1" car count in stats section
5. Verify Ferrari 296 GTB card is visible with:
   - Image: "Ferrari 296 GTB"
   - Specs: 830 PS, 330 km/h, 2.9s
   - Price: € 850 / pro Tag
   - Buttons: "Details" and "Buchen"

### 3.2 Playwright — Make a Reservation

1. Scroll to/click "Buchen" section
2. Select "Ferrari 296 GTB" from vehicle dropdown
3. Click "Individuell" (custom dates) button
4. Set Start date: `2026-06-20`
5. Set End date: `2026-06-22`
6. Click "Weiter" (Weiter button, ref=e146)
7. Verify step 2 ("Kontaktdaten") is shown
8. Verify pricing sidebar shows:
   - "Ferrari 296 GTB · 2 Tage"
   - "Wochenendtage (2 × € 1100)" → "€ 2.200"
   - "MwSt. (20%)" → "€ 440"
   - "Gesamtbetrag" → "€ 2.640"
   - "Kaution" → "€ 5.000"
9. Fill Name: `Jose Lago`
10. Fill Email: `jose@lago.dev`
11. Fill Phone: `+43 660 1234567`
12. Click "Weiter" to go to step 3
13. Click "Anfrage absenden" (submit button)
14. Verify toast notification: "Danke! Wir melden uns in Kürze per E-Mail."
15. Verify form reset (vehicle dropdown back to "Fahrzeug wählen")

### 3.3 Admin Portal — Verify Lead Appears

1. Navigate to `http://localhost:55581/admin.html`
2. Verify login page loads with title "Admin · MC Cars"
3. Fill email: `admin@mccars.local`
4. Fill password: `mc-cars-admin`
5. Click "Anmelden"
6. Verify password rotation screen ("Passwort setzen") appears
7. Set new password: `NewMcCars2026!` (twice)
8. Click "Speichern"
9. Verify admin dashboard loads with hash `#leads`
10. Verify tabs: "Leads 1", "Kunden 0", "Bestellungen 0", "Fahrzeuge", "Einstellungen"
11. Verify the lead appears in "Aktive Leads" table with:
    - **Eingang:** 17.05.26, 13:34 (current date/time)
    - **Name/E-Mail:** Jose Lago · jose@lago.dev
    - **Fahrzeug:** Ferrari 296 GTB
    - **Zeitraum:** 2026-06-20 → 2026-06-22
    - **Gesamtbetrag:** € 2.640
    - **Status:** new
    - **Actions:** Details, Qualifizieren, Ablehnen

---

## 4. Spin Down & Cleanup

```bash
docker compose -f docker-compose.yml -f docker-compose.local.yml down
```

Clean data directory for next test run:

```bash
rm -rf data/db/* 2>/dev/null
# Note: data/db/ directory may need sudo to fully remove (owned by Docker bind mount UID)
```

---

## Expected Results Summary

| Check | Expected |
|-------|----------|
| All services running | Yes (14 services) |
| Public website loads | Yes, 200 OK |
| API returns vehicles | Yes, Ferrari 296 GTB |
| Booking form works | Yes, 3-step wizard |
| Server-side pricing | Yes, € 2.640 for weekend |
| Booking submission | Yes, success toast shown |
| Admin login | Yes, password rotation enforced |
| Lead visible in admin | Yes, all fields correct |
