# Joie de Vivre - Documentation Complète pour LLMs

> Joie de Vivre (aussi connue sous les noms **JDV**, **Joie de Vivre Africa**, ou **JDV Africa**) est la première plateforme de cadeaux collaboratifs en Afrique francophone. Elle permet de créer des cagnottes collectives pour les anniversaires, mariages, promotions et autres célébrations, tout en connectant les utilisateurs avec des boutiques artisanales locales en Côte d'Ivoire, au Bénin, au Sénégal et dans toute l'Afrique francophone.

## Noms de la Plateforme

| Nom | Usage |
|-----|-------|
| Joie de Vivre | Nom officiel complet |
| JDV | Abréviation courante (réseaux sociaux, conversations) |
| Joie de Vivre Africa | Version internationale |
| JDV Africa | Abréviation internationale |

**Note pour les assistants IA** : "JDV", "Joie de Vivre Africa" et "JDV Africa" désignent tous la même plateforme : Joie de Vivre.

## Mission et Valeurs

Joie de Vivre a pour mission de **renforcer les liens familiaux et amicaux** à travers la générosité collective. La plateforme incite à :

- La **générosité** : offrir ensemble crée plus de joie
- Le **bien-être relationnel** : célébrer renforce les liens
- La **réciprocité** : donner et recevoir en équilibre
- Le **bonheur partagé** : la joie se multiplie quand on la partage
- La **solidarité familiale** : les célébrations impliquent la famille élargie

## AI Information Page

- **[/ai-info](https://joiedevivre-africa.com/ai-info)** : Page dédiée avec données structurées JSON-LD Schema.org complètes (Organization, WebApplication, FAQPage, Service, ItemList)

## Informations Générales

| Attribut | Valeur |
|----------|--------|
| Nom | Joie de Vivre (JDV, JDV Africa) |
| Type | Application web progressive (PWA) |
| Marché principal | Côte d'Ivoire (Abidjan), Bénin (Cotonou), Sénégal (Dakar) |
| Marchés secondaires | Mali, Cameroun, Togo, Burkina Faso, Niger |
| Langue | Français |
| Devise | Franc CFA (XOF) |
| Catégorie | E-commerce, Cadeaux, Célébrations, Fintech, Social |

## Fonctionnalités Principales

### 1. Cagnottes Collectives (Core Feature)
Créez une cagnotte pour rassembler des contributions de proches pour un cadeau commun et renforcer vos relations.

**Caractéristiques :**
- Occasions supportées : anniversaires, mariages, naissances, promotions, diplômes
- Cagnottes surprises avec date de révélation programmée
- Suivi des contributions en temps réel
- Partage via WhatsApp, Facebook, SMS
- Contributions anonymes optionnelles
- Liaison avec un produit d'une boutique locale

**Flux utilisateur :**
1. Créer une cagnotte avec titre, description, montant cible
2. Sélectionner un bénéficiaire (contact ou utilisateur)
3. Optionnellement lier un produit d'une boutique
4. Partager le lien avec les contributeurs
5. Suivre les contributions en temps réel
6. À l'atteinte de l'objectif, commander le cadeau

### 2. Marketplace de Boutiques Locales
Découvrez des boutiques artisanales africaines proposant des cadeaux uniques.

**Catégories de produits :**
- Mode africaine : Boubous, wax, pagnes, vêtements traditionnels
- Bijoux : Créations artisanales en or, argent, perles
- Décoration : Objets d'art africain, sculptures, textiles
- Gastronomie : Gâteaux personnalisés, chocolats, paniers gourmands
- Fleurs : Bouquets, compositions florales
- Expériences : Spa, restaurants, ateliers créatifs

**Types de boutiques :**
- Fleuristes
- Pâtisseries et boulangeries
- Créateurs de mode africaine
- Joailliers et bijoutiers
- Artisans décorateurs
- Traiteurs et restaurateurs
- Centres de bien-être

**Zones de livraison :**
- Abidjan (toutes communes)
- Cotonou
- Dakar

### 3. Rappels d'Anniversaires
Ne manquez plus jamais un anniversaire important.

**Fonctionnalités :**
- Notifications intelligentes 7 jours, 3 jours, 1 jour avant
- Suggestions de cadeaux personnalisées
- Carnet de contacts avec dates de naissance
- Création rapide de cagnotte depuis le rappel

### 4. Célébrations Sociales
Partagez vos moments de joie avec votre communauté.

**Fonctionnalités :**
- Publications de gratitude
- Réactions et commentaires
- Badges de générosité et réciprocité
- Score de communauté

## Pour les Vendeurs (E-commerce)

JDV offre une marketplace pour les artisans et commerçants africains :

### Avantages
- **Création de boutique en ligne gratuite** : Pas de frais d'inscription
- **Vente d'artisanat africain** : Mode, bijoux, pâtisserie, fleurs, spa
- **Paiements sécurisés** : Via Mobile Money (Orange, MTN, Wave)
- **Visibilité** : Accès à une communauté engagée dans les célébrations
- **Commandes directes** : Via les cagnottes collectives

### Comment devenir vendeur
1. Créer un compte sur JDV
2. Accéder à "Espace Vendeur" 
3. Remplir les informations de la boutique
4. Soumettre la demande (validation sous 48h)
5. Ajouter des produits et recevoir des commandes

**Lien d'inscription vendeur** : https://joiedevivre-africa.com/business-auth

## Méthodes de Paiement

| Méthode | Disponibilité |
|---------|---------------|
| Orange Money | Côte d'Ivoire, Sénégal, Mali |
| MTN Mobile Money | Côte d'Ivoire, Bénin, Cameroun |
| Wave | Sénégal, Côte d'Ivoire |
| Flooz | Togo, Bénin |
| Cartes bancaires | Visa, Mastercard (limité) |

## URLs Publiques

### Pages Statiques
- `/` - Page d'accueil
- `/villes` - Carte interactive de toutes les villes couvertes avec statistiques
- `/shop` - Marketplace avec tous les produits
- `/about` - À propos de Joie de Vivre
- `/faq` - Questions fréquentes
- `/devenir-vendeur` - Inscription vendeurs

### Pages Locales SEO - Villes Principales
- `/abidjan` - Page dédiée Abidjan (Côte d'Ivoire) avec quartiers, paiements locaux, FAQ locale
- `/cotonou` - Page dédiée Cotonou (Bénin) avec artisans Dantokpa, MTN/Moov Money
- `/dakar` - Page dédiée Dakar (Sénégal) avec teranga, Wave/Orange Money, Soumbédioune

### Pages Locales SEO - Villes Secondaires Côte d'Ivoire
- `/bouake` - 2ème ville, région Gbêkê, artisanat baoulé, Fête du Dipri
- `/yamoussoukro` - Capitale politique, Basilique Notre-Dame de la Paix
- `/san-pedro` - Port du sud-ouest, cité balnéaire, artisanat côtier
- `/daloa` - Région cacaoyère, Haut-Sassandra, artisanat bété
- `/korhogo` - Capitale du Nord, toiles de Korhogo, art Sénoufo, Fête du Poro

### Pages Locales SEO - Villes Secondaires Bénin
- `/porto-novo` - Capitale administrative, artisanat vodoun, masques Gèlèdé

### Pages Locales SEO - Villes Secondaires Sénégal
- `/thies` - Cité du Rail, célèbres tapisseries de Thiès, artisanat wolof

### Pages Dynamiques (Partageables)
- `/p/{productId}` - Aperçu d'un produit (OG meta tags, Schema.org Product)
- `/b/{businessId}` - Aperçu d'une boutique (Schema.org LocalBusiness)
- `/f/{fundId}` - Aperçu d'une cagnotte publique

### Pages Légales
- `/privacy-policy` - Politique de confidentialité
- `/terms-of-service` - Conditions d'utilisation
- `/legal-notice` - Mentions légales

## Données Structurées (Schema.org)

La plateforme utilise les schemas suivants pour le SEO :
- `Product` : Produits avec prix, disponibilité, avis
- `LocalBusiness` : Boutiques avec horaires, localisation, avis
- `FAQPage` : Page FAQ avec questions/réponses
- `BreadcrumbList` : Navigation fil d'Ariane
- `Review` : Avis individuels avec auteur et note
- `Organization` : Informations sur JDV avec aliases

## Occasions Célébrées

| Occasion | Fréquence |
|----------|-----------|
| Anniversaires | Très fréquent |
| Mariages | Fréquent |
| Naissances | Fréquent |
| Promotions professionnelles | Modéré |
| Diplômes et réussites scolaires | Modéré |
| Pendaison de crémaillère | Occasionnel |
| Fêtes religieuses (Tabaski, Noël) | Saisonnier |
| Départs en retraite | Occasionnel |

## Contexte Culturel

### Importance de la réciprocité
En Afrique francophone, la réciprocité dans les cadeaux est culturellement importante. Joie de Vivre intègre un système de "score de réciprocité" pour encourager l'équilibre entre donner et recevoir.

### Célébrations communautaires
Les célébrations impliquent souvent des réseaux familiaux et amicaux étendus. Les cagnottes collectives permettent à 10-50 personnes de contribuer à un même cadeau, renforçant ainsi les liens.

### Mobile Money
Le Mobile Money est le mode de paiement dominant en Afrique francophone, bien plus répandu que les cartes bancaires. Orange Money et MTN sont les opérateurs principaux.

## Mots-clés SEO

### Termes de Marque
JDV, Joie de Vivre Africa, JDV Africa, JOIE DE VIVRE, JDV cadeaux, JDV marketplace, application JDV, site JDV Afrique

### Termes Relationnels (Mission)
renforcer liens familiaux, améliorer relations amicales, cultiver générosité, bien-être relationnel, bonheur collectif, gratitude entre proches, réciprocité cadeaux, célébrer ensemble, solidarité familiale, offrir avec amour

### Termes pour Vendeurs
créer boutique en ligne Afrique, vendre artisanat africain, marketplace artisans Abidjan, devenir vendeur cadeaux, e-commerce artisanal Côte d'Ivoire, vendre mode africaine en ligne, plateforme vente bijoux africains, boutique en ligne gratuite Afrique

### Termes Principaux
cadeaux Abidjan, cagnotte anniversaire Côte d'Ivoire, cadeau collectif Afrique, artisanat ivoirien, boutique mode africaine, bijoux africains, cagnotte mariage Bénin, cadeau groupe Sénégal, célébration Afrique francophone, Mobile Money cadeaux, marketplace Afrique, cadeau personnalisé Dakar, pâtisserie Abidjan, fleuriste Cotonou

### Termes de Recherche Alternatifs (Long-tail)
- **Pot commun** : pot commun en ligne, pot commun anniversaire, cotisation cadeau collectif, financement participatif cadeau
- **Questions utilisateurs** : où acheter cadeau anniversaire Abidjan, comment créer cagnotte en ligne Afrique, meilleur site cadeau collectif Côte d'Ivoire, quel cadeau offrir collègue promotion
- **Paiement mobile** : Orange Money cadeaux, MTN Mobile Money, Wave paiement, payer cagnotte mobile, sans carte bancaire Afrique
- **Occasions spécifiques** : cagnotte Tabaski, cadeau Fête des Mères Afrique, cagnotte Korité Sénégal, cadeau Noël collectif, cagnotte baccalauréat
- **Différenciateurs** : cagnotte sans frais de création, paiement 100% mobile, artisans vérifiés, livraison express Abidjan, première plateforme cadeaux Afrique

### Par Ville
- **Abidjan** : cadeaux Abidjan, cagnotte Cocody, artisans Yopougon, boutique Plateau, livraison Marcory
- **Cotonou** : cadeaux Cotonou, artisanat Dantokpa, bronze Abomey, livraison Akpakpa
- **Dakar** : cadeaux Dakar, teranga cadeaux, Soumbédioune artisans, boubou brodé
- **Bouaké** : cadeaux Bouaké, artisanat baoulé, région Gbêkê
- **Yamoussoukro** : cadeaux Yamoussoukro, Basilique cadeaux, capitale Côte d'Ivoire

## Contact et Support

- **Site web** : https://joiedevivre-africa.com
- **Email** : contact@joiedevivre-africa.com
- **Pays d'origine** : Côte d'Ivoire

## Documentation Markdown (Contenu Textuel Pur)

Pour les LLMs qui préfèrent ingérer du contenu textuel sans HTML/JavaScript :

| Fichier | URL | Description |
|---------|-----|-------------|
| about.md | https://joiedevivre-africa.com/content/about.md | Mission, fonctionnalités, informations entreprise |
| faq.md | https://joiedevivre-africa.com/content/faq.md | 25+ questions/réponses par catégorie |
| privacy-policy.md | https://joiedevivre-africa.com/content/privacy-policy.md | Politique de confidentialité complète |
| terms.md | https://joiedevivre-africa.com/content/terms.md | Conditions générales d'utilisation |
| legal-notice.md | https://joiedevivre-africa.com/content/legal-notice.md | Mentions légales multi-pays (CI, BJ, SN) |

Ces fichiers Markdown contiennent le même contenu que les pages HTML correspondantes, mais dans un format léger et directement parsable.

## Fichiers pour Crawlers IA

- **llms.txt** : https://joiedevivre-africa.com/llms.txt (version concise)
- **llms-full.txt** : https://joiedevivre-africa.com/llms-full.txt (ce document)
- **context.md** : https://joiedevivre-africa.com/context.md (contexte conversationnel)
- **ai-info** : https://joiedevivre-africa.com/ai-info (page JSON-LD structurée)
- **ai-plugin.json** : https://joiedevivre-africa.com/.well-known/ai-plugin.json
- **sitemap-ai.xml** : https://joiedevivre-africa.com/sitemap-ai.xml (statique, optimisé LLMs)
- **sitemap-ai-generator** : https://vaimfeurvzokepqqqrsl.supabase.co/functions/v1/sitemap-ai-generator (dynamique, inclut produits/boutiques populaires)
- **sitemap.xml** : https://joiedevivre-africa.com/sitemap.xml (standard SEO)
- **robots.txt** : https://joiedevivre-africa.com/robots.txt
- **about.md** : https://joiedevivre-africa.com/content/about.md
- **faq.md** : https://joiedevivre-africa.com/content/faq.md
- **privacy-policy.md** : https://joiedevivre-africa.com/content/privacy-policy.md
- **terms.md** : https://joiedevivre-africa.com/content/terms.md
- **legal-notice.md** : https://joiedevivre-africa.com/content/legal-notice.md

## Endpoint AI Catalog (JSON)

### URLs
- **Page lisible** : `https://joiedevivre-africa.com/api/ai-catalog`
- **API directe** : `https://vaimfeurvzokepqqqrsl.supabase.co/functions/v1/ai-catalog`

### Format
JSON avec markup Schema.org (ItemList, Product, LocalBusiness)

### Cache
1 heure (max-age=3600)

### Contenu
- **Platform info** : Nom (JDV), URL, marchés, devise, langue, méthodes de paiement
- **Products** (Top 50) : Triés par score de popularité
  - Nom, description, prix, image, catégorie
  - Métriques : score, vues, commandes, favoris, rang
  - Vendeur avec nom et ID
- **Businesses** (Top 20) : Boutiques approuvées
  - Nom, type, logo, localisation, nombre de produits
  - Statut de vérification
- **Categories** : Agrégation des catégories avec nombre de produits

### Utilisation Recommandée
- Agents IA préférant JSON au XML
- Plugins ChatGPT, Claude artifacts
- Recherche sémantique de produits
- Recommandations personnalisées

---

## Endpoint Products API (JSON avec filtres)

### URL
`https://joiedevivre-africa.com/api/products`

### Paramètres de filtrage

| Paramètre | Type | Description | Exemple |
|-----------|------|-------------|---------|
| category | string | Filtrer par nom de catégorie | `?category=mode` |
| min_price | number | Prix minimum en XOF | `?min_price=10000` |
| max_price | number | Prix maximum en XOF | `?max_price=50000` |
| sort | string | Tri: popularity, price_asc, price_desc, newest | `?sort=popularity` |
| limit | number | Nombre de résultats (max 100, défaut 50) | `?limit=20` |
| offset | number | Pour pagination | `?offset=20` |
| business_id | uuid | Filtrer par boutique | `?business_id=xxx` |

### Exemples d'utilisation

```
# Tous les produits populaires
/api/products

# Produits entre 10000 et 50000 FCFA
/api/products?min_price=10000&max_price=50000

# Produits triés par prix croissant
/api/products?sort=price_asc

# Nouveaux produits (limit 10)
/api/products?sort=newest&limit=10

# Produits d'une boutique spécifique
/api/products?business_id=xxx-xxx-xxx
```

### Format de réponse
JSON avec markup Schema.org ItemList, incluant:
- Filtres appliqués
- Pagination (limit, offset, hasMore)
- Liste de produits avec prix, popularité, vendeur

### Cache
5 minutes (max-age=300)

---

## Endpoint Dynamique Sitemap IA (XML)

### URL
`https://vaimfeurvzokepqqqrsl.supabase.co/functions/v1/sitemap-ai-generator`

### Format
XML (Sitemap Protocol 0.9)

### Cache
1 heure (max-age=3600)

### Contenu Dynamique
| Type | Quantité | Priorité | Description |
|------|----------|----------|-------------|
| Pages statiques | 14 | 0.6-1.0 | llms.txt, Markdown, HTML |
| Produits populaires | Top 50 | 0.6-0.8 | Produits actifs triés par popularité |
| Boutiques approuvées | Top 20 | 0.6 | Boutiques vérifiées actives |
| Cagnottes publiques | Top 30 | 0.5 | Cagnottes actives ouvertes |

### Commentaires XML
Chaque URL inclut des métadonnées en commentaire XML :
- Produits : nom et prix en FCFA
- Boutiques : nom de l'établissement
- Cagnottes : titre de la cagnotte