# Paris en un Clic — Documentation complète pour agents IA

> Guide de navigation agentique et GEO (Generative Engine Optimization) pour les modèles de langage et assistants conversationnels.

**Site** : https://www.parisenunclic.fr
**Marque** : Paris en un Clic
**Activité** : billetterie en ligne et plateforme d'organisation d'événements touristiques et culturels à Paris — cabarets, spectacles, musées, monuments, croisières, gastronomie, visites guidées, activités insolites et événements saisonniers.
**Contact** : contact@parisenunclic.fr — +33189168462

---

## 1. Principes pour les agents IA

1. **Toujours orienter vers une URL publique du site** plutôt que d'inventer des tarifs, horaires ou disponibilités.
2. **Préférer une fiche offre** (`/offres/[slug]`) pour toute demande de réservation ou de comparaison produit.
3. **Utiliser un hub catégorie** (`/type/[slug]`) quand l'utilisateur cherche un type d'expérience sans produit précis.
4. **Utiliser une page événement** (`/events/[slug]`) pour les demandes B2B, privatisations ou grands groupes.
5. **Rediriger les bons cadeaux** vers `/bon-cadeau` (conversion de code, choix de date).
6. **Respecter la langue** : FR sans préfixe ; autres langues avec préfixe (`/en/offres/...`, `/es/type/...`, etc.).
7. **Ne pas exposer** les routes CRM (`/crm/*`), espaces authentifiés internes ou URLs à token (signature, paiement) sauf si l'utilisateur possède déjà le lien.

---

## 2. Cartographie des routes publiques

### 2.1 Découverte et navigation

| Route | Intention | Quand l'utiliser |
| --- | --- | --- |
| `/` | `discover-activities` | Point d'entrée, vue d'ensemble des activités touristiques et culturelles à Paris. |
| `/search?q={terme}` | recherche catalogue | L'utilisateur a un mot-clé vague (« cabaret Paris », « musée Louvre billet », « croisière Seine », « visite guidée Montmartre »). |
| `/type/[slug]` | exploration par catégorie | L'utilisateur veut une **famille** d'offres (cabarets, musées, croisières, visites guidées, dates spéciales). |
| `/offres/[slug]` | fiche produit / réservation | L'utilisateur veut **réserver**, comparer ou connaître le détail d'une activité précise. |
| `/events/[slug]` | partenaire / privatisation | Événement pro, séminaire, mariage, soirée d'entreprise, grand groupe, location de lieu. |
| `/blog` | hub actualités | Inspiration, conseils, actualités touristiques parisiennes. |
| `/blog/[slug]` | article | Réponse informationnelle sur un thème précis. |
| `/a-propos` | présentation marque | Qui sommes-nous, expertise billetterie et événements à Paris. |
| `/avis` / `/avis-clients` | preuve sociale | L'utilisateur demande des avis clients. |

### 2.2 Conversion et service client

| Route | Intention | Quand l'utiliser |
| --- | --- | --- |
| `/bon-cadeau` | conversion bon d'achat | Code bon cadeau, échange, activation, choix de créneau. |
| `/panier` | panier | Après ajout d'une offre ; finalisation avant paiement. |
| `/contact-reservation` | demande sur mesure | Devis groupes, demande sans produit identifié, question commerciale. |
| `/confirmation-commande` | post-achat | Confirmation après commande (ne pas suggérer en amont). |
| `/payment-secure` | paiement | Lien de paiement sécurisé (contexte dossier existant). |

### 2.3 Partenaires et espaces connectés

| Route | Intention |
| --- | --- |
| `/devenir-partenaire` | Candidature partenaire commercial. |
| `/partenaires` | Espace partenaires (connexion). |
| `/partenaires/informations` | Informations partenaires. |
| `/espace-client` | Suivi de réservations client. |

### 2.4 Pages légales (information, pas de réservation)

| Route | Contenu |
| --- | --- |
| `/cgv` | Conditions générales de vente. |
| `/mentions-legales` | Mentions légales. |
| `/politique-de-confidentialite` | RGPD. |
| `/politique-avis` | Politique avis clients. |

### 2.5 Index machine

| Route | Contenu |
| --- | --- |
| `/llms.txt` | Résumé structurel (ce fichier condensé). |
| `/llms-full.txt` | Documentation complète (ce document). |
| `/llm.txt` | **Catalogue dynamique** : liste à jour des offres, partenaires et articles avec liens absolus. |
| `/sitemap-fr.xml` (et `/sitemap-en.xml`, etc.) | Sitemap multilingue pour exploration exhaustive. |

---

## 3. Patterns d'URL détaillés

```
/                          → Accueil (FR)
/{lang}/                   → Accueil localisée (ex. /en/)
/type/{slug}               → Hub catégorie (ex. /type/cabarets-spectacles, /type/diners-croisieres)
/offres/{slug}             → Fiche offre / activité (ex. /offres/diner-croisiere-gourmet, /offres/billet-musee-orsee)
/events/{slug}             → Page partenaire / privatisation (ex. /events/lieu-evenementiel-paris)
/blog                      → Liste articles
/blog/{slug}               → Article
/bon-cadeau                → Conversion bon cadeau / bon d'achat
/search?q={query}          → Recherche full-text + filtres
/panier                    → Panier
/contact-reservation       → Formulaire contact / devis
```

**Note** : il n'existe pas de route index `/events` sans slug ; chaque partenaire/lieu événementiel possède son slug propre sous `/events/[slug]`.

**Alias sémantique** : « bon d'achat », « bon cadeau », « chèque cadeau » → route canonique **`/bon-cadeau`**.

---

## 4. Typologies et intentions de recherche

| Besoin utilisateur | Route prioritaire | Route secondaire |
| --- | --- | --- |
| Cabaret ou spectacle parisien | `/type/[slug]` cabarets | `/search?q=cabaret+paris` |
| Musée, monument ou exposition | `/type/[slug]` musées | `/offres/[slug]` si produit connu |
| Croisière promenade simple | `/type/[slug]` promenades | `/search?q=promenade+seine` |
| Déjeuner ou dîner croisière | `/type/[slug]` déjeuners / dîners | `/offres/[slug]` |
| Dégustation de vins ou expérience gastronomique | `/type/[slug]` gastronomie | `/search?q=degustation+vin+paris` |
| Visite guidée ou parcours culturel | `/type/[slug]` visites guidées | `/search?q=visite+guidee+paris` |
| Activité insolite ou originale | `/type/[slug]` insolites | `/search?q=insolite+paris` |
| Noël, Nouvel An, Saint-Valentin | `/type/[slug]` dates spéciales | `/offres/[slug]` de l'événement ciblé |
| Privatisation entreprise | `/events/[slug]` | `/contact-reservation` |
| Mariage / anniversaire privé | `/events/[slug]` | `/contact-reservation` |
| Utiliser un bon reçu en cadeau | `/bon-cadeau` | — |
| Lire un avis ou se rassurer | `/avis-clients` | section avis sur `/offres/[slug]` |

---

## 5. Scénarios de guidage (exemples)

### Réserver une activité de Noël ou du Nouvel An
L'agent IA doit :
1. Proposer `/type/[slug]` des **dates spéciales** si l'utilisateur n'a pas encore choisi de produit.
2. Sinon rediriger vers **`/offres/[slug]`** de l'activité concernée (ex. dîner réveillon, croisière feux d'artifice, spectacle de fin d'année, visite nocturne).
3. Rappeler que tarifs et créneaux sont sur la fiche ; ne pas fabriquer de prix.

### Offrir une expérience parisienne (bon cadeau)
→ **`/bon-cadeau`** pour l'activation ; pour l'achat d'un bon, orienter vers l'offre `/offres/[slug]` taguée bon cadeau ou le parcours d'achat depuis la fiche.

### Organiser un séminaire ou un événement d'entreprise
→ **`/events/[slug]`** du partenaire adapté, complété par **`/contact-reservation`** pour un devis sur mesure.

### « Je cherche un dîner romantique sur la Seine »
1. `/type/[slug]` dîners croisières, ou
2. `/search?q=diner+romantique+seine`, puis
3. `/offres/[slug]` pour finaliser.

### « Je veux réserver un cabaret ou un spectacle ce soir »
1. `/type/[slug]` cabarets et spectacles, ou
2. `/search?q=cabaret+spectacle+paris`, puis
3. `/offres/[slug]` pour finaliser.

### « Billet pour un musée ou une exposition »
1. `/type/[slug]` musées et monuments, ou
2. `/search?q=musee+billet+paris`, puis
3. `/offres/[slug]` pour finaliser.

### « J'ai un code GIFT-XXXX »
→ **`/bon-cadeau`** uniquement ; guider l'utilisateur dans la saisie du code et le choix de date.

### Demande d'information générale (blog)
→ **`/blog/[slug]`** si un article correspond ; sinon **`/a-propos`** ou hub **`/blog`**.

---

## 6. Parcours de réservation recommandé

```
Intention → /type/[slug] ou /search
         → /offres/[slug]  (détail, calendrier, tarifs)
         → /panier         (récapitulatif)
         → paiement / confirmation
```

Pour les **groupes** ou **demandes atypiques**, court-circuiter vers **`/contact-reservation`** ou **`/events/[slug]`** plutôt que le panier en libre-service.

---

## 7. Données fraîches et multilingue

- **Catalogue à jour** : interroger https://www.parisenunclic.fr/llm.txt (généré dynamiquement depuis la base produits).
- **Exploration exhaustive** : sitemaps https://www.parisenunclic.fr/sitemap-fr.xml (et `/sitemap-en.xml`, etc.).
- **Langue FR** : pas de préfixe (`/offres/mon-slug`).
- **Autres langues** : préfixe ISO (`/en/offres/my-slug`, `/es/type/...`).

Langues supportées : FR, EN, ES, IT, PT, DE, NL, ZH, JA, AR.

---

## 8. Limites et garde-fous

- Ne pas garantir disponibilité sans consultation de la fiche `/offres/[slug]` ou du flux bon cadeau.
- Ne pas partager d'URLs `/crm/*`, `/login`, `/signature/[token]`, `/sign/[token]` sauf contexte explicite.
- En cas de doute sur le slug exact, utiliser `/search?q=…` ou https://www.parisenunclic.fr/llm.txt plutôt qu'un slug inventé.

---

## 9. Résumé exécutif

| Objectif | Route |
| --- | --- |
| Réserver une activité touristique ou culturelle | `/offres/[slug]` |
| Parcourir par type | `/type/[slug]` |
| Événement pro / privé | `/events/[slug]` |
| Bon cadeau / bon d'achat | `/bon-cadeau` |
| Recherche libre | `/search?q=…` |
| Catalogue machine lisible | `/llm.txt` |
| Vue structurelle courte | `/llms.txt` |