veza/docs/SMOKE_TEST_V0901.md

# Smoke Test v0.901 — Marketplace Complet & Analytics Avancés

## Prérequis

- `veza-backend-api` compilé et démarré
- PostgreSQL avec migrations appliquées jusqu'à 128
- `.env` avec `DATABASE_URL`, `JWT_SECRET`
- MaxMind GeoIP2-Lite database téléchargée (pour geography)
- Utilisateur standard + admin avec tokens JWT
- Produits, orders et track plays existants en DB

---

## 1. Wishlist (MK1)

### 1.1 Ajouter à la wishlist

```bash
curl -s -X POST http://localhost:8080/api/v1/marketplace/wishlist/{PRODUCT_ID} \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200/201, produit ajouté
```

### 1.2 Lister la wishlist

```bash
curl -s http://localhost:8080/api/v1/marketplace/wishlist \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200, liste des produits wishlistés
```

### 1.3 Retirer de la wishlist

```bash
curl -s -X DELETE http://localhost:8080/api/v1/marketplace/wishlist/{PRODUCT_ID} \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200, produit retiré
```

### 1.4 Frontend

```bash
# Naviguer vers /marketplace
# Vérifier: icône coeur sur chaque ProductCard
# Cliquer coeur → produit ajouté (coeur rempli)
# Naviguer vers /marketplace/wishlist → produit listé
```

---

## 2. Promotions (MK1)

### 2.1 Créer une promotion

```bash
curl -s -X POST http://localhost:8080/api/v1/marketplace/promotions \
  -H "Authorization: Bearer {SELLER_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "{PRODUCT_ID}", "discount_percent": 30, "starts_at": "2026-02-24T00:00:00Z", "ends_at": "2026-03-01T00:00:00Z"}' | jq .
# Attendu: 201, promotion créée
```

### 2.2 Badge promo visible

```bash
# Frontend: naviguer vers /marketplace
# Vérifier: badge "PROMO -30%" sur le produit en promotion
# Vérifier: prix barré + nouveau prix affiché
```

### 2.3 Page deals

```bash
# Frontend: naviguer vers /marketplace/deals
# Vérifier: uniquement les produits en promotion active
# Vérifier: countdown timer jusqu'à fin de promotion
```

---

## 3. Disputes (MK1)

### 3.1 Ouvrir une dispute

```bash
curl -s -X POST http://localhost:8080/api/v1/marketplace/orders/{ORDER_ID}/dispute \
  -H "Authorization: Bearer {BUYER_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Product files corrupted", "details": "Cannot open the WAV file"}' | jq .
# Attendu: 201, dispute ouverte
```

### 3.2 Admin liste disputes

```bash
curl -s http://localhost:8080/api/v1/admin/disputes \
  -H "Authorization: Bearer {ADMIN_TOKEN}" | jq .
# Attendu: 200, liste des disputes avec status
```

### 3.3 Résoudre une dispute

```bash
curl -s -X POST http://localhost:8080/api/v1/admin/disputes/{DISPUTE_ID}/resolve \
  -H "Authorization: Bearer {ADMIN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"resolution": "refund", "note": "Product was indeed corrupted"}' | jq .
# Attendu: 200, dispute resolved
```

---

## 4. Review Reply (MK1)

### 4.1 Répondre à une review

```bash
curl -s -X POST http://localhost:8080/api/v1/marketplace/reviews/{REVIEW_ID}/reply \
  -H "Authorization: Bearer {SELLER_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"reply": "Thank you for the feedback! I have uploaded a fixed version."}' | jq .
# Attendu: 200, reply ajoutée
```

### 4.2 Reply visible

```bash
# Frontend: naviguer vers /marketplace/products/:id → section reviews
# Vérifier: reply du vendeur affichée sous la review
```

---

## 5. Re-download (MK1)

### 5.1 Télécharger les fichiers achetés

```bash
curl -s http://localhost:8080/api/v1/marketplace/orders/{ORDER_ID}/download \
  -H "Authorization: Bearer {BUYER_TOKEN}" | jq .
# Attendu: 200, { "download_urls": [{ "filename": "...", "url": "signed-s3-url", "expires_in": 300 }] }
```

---

## 6. Taxes (MK1)

### 6.1 Checkout avec taxes

```bash
# Frontend: ajouter un produit au panier, procéder au checkout
# Vérifier: OrderSummary affiche "Tax (20%)" pour un utilisateur FR
# Vérifier: total = subtotal + tax
```

---

## 7. Creator Analytics (AN1)

### 7.1 Géographie

```bash
curl -s http://localhost:8080/api/v1/analytics/geography \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200, { "countries": [{ "code": "FR", "name": "France", "plays": 150 }, ...] }
```

### 7.2 Démographie

```bash
curl -s http://localhost:8080/api/v1/analytics/demographics \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200, breakdown par device_type, os, browser
```

### 7.3 Revenue projection

```bash
curl -s http://localhost:8080/api/v1/analytics/revenue/projection \
  -H "Authorization: Bearer {TOKEN}" | jq .
# Attendu: 200, projections 30/60/90 jours
```

### 7.4 Frontend analytics

```bash
# Naviguer vers /analytics
# Vérifier: onglets Geography (carte), Demographics (donut), Traffic (bar), Revenue (line + projection)
```

---

## 8. Admin Analytics (AN2)

### 8.1 DAU/MAU

```bash
curl -s http://localhost:8080/api/v1/admin/analytics/users \
  -H "Authorization: Bearer {ADMIN_TOKEN}" | jq .
# Attendu: 200, { "dau": 42, "mau": 350, "ratio": 0.12 }
```

### 8.2 Retention

```bash
curl -s http://localhost:8080/api/v1/admin/analytics/retention \
  -H "Authorization: Bearer {ADMIN_TOKEN}" | jq .
# Attendu: 200, { "d1": 0.65, "d7": 0.40, "d30": 0.25 }
```

### 8.3 Transactions

```bash
curl -s http://localhost:8080/api/v1/admin/analytics/transactions \
  -H "Authorization: Bearer {ADMIN_TOKEN}" | jq .
# Attendu: 200, { "total_revenue_cents": ..., "total_orders": ..., "avg_order_cents": ... }
```

---

## 9. Tests automatisés

```bash
cd veza-backend-api && go test ./... -v
cd apps/web && npm run build
```

---

## 10. Documentation

- [ ] `docs/API_REFERENCE.md` sections Wishlist, Promotions, Disputes, Analytics
- [ ] `CHANGELOG.md` contient entrée v0.901
- [ ] `docs/PROJECT_STATE.md` : Dernier tag = v0.901
- [ ] `docs/FEATURE_STATUS.md` : section "Livré en v0.901"
- [ ] `git tag v0.901` créé