# À Nous la Vie - Documentation complète pour LLM

Version : 1.0
Date : 2025-10-13
Langue principale : Français (fr-FR)
Zone géographique : Finistère (29), Bretagne, France

---

## TABLE DES MATIÈRES

1. Vue d'ensemble de la plateforme
2. Modèle de données
3. Architecture du site
4. Fonctionnalités détaillées
5. Expérience utilisateur
6. Contexte géographique et culturel
7. Modèle économique
8. SEO et discoverability
9. Cas d'usage typiques

---

## 1. VUE D'ENSEMBLE DE LA PLATEFORME

### Mission
À Nous la Vie (ANLV) a pour mission de faciliter l'accès à la culture, au sport et aux loisirs pour les habitants et visiteurs du Finistère. La plateforme agit comme un agrégateur et distributeur de billets pour des activités locales variées.

### Proposition de valeur

**Pour les utilisateurs :**
- Centralisation de toutes les activités du Finistère en un seul endroit
- Tarifs préférentiels via le pass ANLV
- Découverte facilitée d'événements locaux
- Réservation simplifiée avec billetterie électronique
- Recommandations personnalisées

**Pour les organisateurs :**
- Visibilité accrue auprès du public local
- Système de billetterie clé en main
- Gestion des stocks et des offres
- Analytics et suivi des ventes

### Modèle de business
- Vente de pass ANLV (abonnement)
- Commission sur les ventes de billets
- Partenariats avec organisateurs locaux

---

## 2. MODÈLE DE DONNÉES

### 2.1 Activité (Activity)

Une activité représente un événement ou une sortie réservable.

**Champs principaux :**
- `id` : Identifiant unique (UUID)
- `title` : Titre de l'activité
- `slug` : URL-friendly identifier (ex: "concert-jazz-brest-2025")
- `status` : published | draft | archived
- `content` : Description riche en HTML/Markdown
- `information` : Informations pratiques complémentaires

**Dates :**
- `dateCreated` : Date de création
- `dateUpdated` : Dernière modification
- `datePublication` : Date de mise en ligne
- `dateExpiration` : Date de fin de disponibilité à l'achat
- `dateStart` : Date de début de l'événement
- `dateEnd` : Date de fin de l'événement (si applicable)

**Relations :**
- `organizationId` : Organisateur de l'activité
- `placeId` : Lieu de l'activité
- `image` : Image principale (relation vers Directus Files)
- `activityCategories` : Catégories associées (many-to-many)
- `activityOffers` : Offres/billets disponibles (one-to-many)
- `activityDeals` : Bons plans associés (many-to-many)
- `activityRelateds` : Activités similaires suggérées

**Attributs booléens (badges) :**
- `isAccessible` : Accessible aux personnes à mobilité réduite
- `isKidFriendly` : Adapté aux enfants
- `isPopular` : Mis en avant comme populaire
- `isNew` : Nouveau sur la plateforme
- `isLastChance` : Dernière chance de réserver
- `isExpiringSoon` : Expire bientôt

**Limites :**
- `purchaseLimit` : Nombre maximum de billets par commande

### 2.2 Offre d'activité (ActivityOffer)

Une activité peut avoir plusieurs offres (différents types de billets).

**Champs :**
- `id` : Identifiant unique
- `activityId` : Activité parente
- `title` : Nom de l'offre (ex: "Tarif plein", "Tarif réduit", "Enfant")
- `originalPrice` : Prix de référence en centimes (ex: 2500 = 25,00€)
- `price` : Prix grand public en centimes
- `memberPrice` : Prix pour les membres pass ANLV en centimes
- `ticketType` : Type de billet
  - `pdf_stock` : Billet PDF pré-généré avec stock limité
  - `generated` : E-ticket généré à la demande
  - `external` : Redirection vers billetterie externe
- `quantityAvailable` : Stock disponible
- `remainingQuantity` : Stock restant (calculé dynamiquement)
- `dateExpiration` : Date limite d'achat
- `purchaseLimit` : Maximum par commande pour cette offre
- `isExclusive` : Offre exclusive aux membres
- `isMemberOnly` : Uniquement pour les membres
- `externalLink` : URL billetterie externe (si applicable)
- `externalMessage` : Message affiché pour billetterie externe
- `taxRate` : Taux de TVA applicable

### 2.3 Organisation (Organization)

Représente un organisateur d'activités (théâtre, salle de concert, association, etc.).

**Champs :**
- `id` : Identifiant unique
- `name` : Nom de l'organisation
- `type` : Type d'organisation
- `logo` : Logo (relation vers Directus Files)
- `categoryId` : Catégorie principale
- Relations : `activities`, `deals`, `places`

### 2.4 Lieu (Place)

Lieu physique où se déroule une activité.

**Champs :**
- `id` : Identifiant unique
- `title` : Nom du lieu (ex: "Théâtre de Cornouaille")
- `location` : Coordonnées GPS (JSON: {x: longitude, y: latitude})
- Relations : `activities`, `organizations`

**Format de géolocalisation :**
```json
{
  "x": -4.0978,  // longitude
  "y": 47.9950   // latitude
}
```

### 2.5 Catégorie (Category)

Taxonomie des activités et organisations.

**Champs :**
- `id` : Identifiant unique
- `title` : Nom de la catégorie
- `slug` : URL slug
- `icon` : Nom de l'icône
- `sort` : Ordre d'affichage

**Exemples de catégories :**
- Culture (spectacles, expositions, cinéma)
- Sport (activités sportives, randonnées)
- Loisirs (escape game, parcs, ateliers)
- Famille (activités enfants, sorties familiales)
- Nature (balades, découverte environnement)
- Gastronomie (restaurants, dégustations)

### 2.6 Deal (Bon plan)

Offres spéciales réservées aux membres.

**Champs :**
- `id` : Identifiant unique
- `title` : Titre du deal
- `description` : Description
- `image` : Visuel
- `organizationId` : Organisation proposant le deal
- `dateStart` : Date de début de validité
- `dateEnd` : Date de fin de validité
- Relations : `activities` (deals liés à des activités)

### 2.7 Utilisateur (User)

**Données principales :**
- `id` : Identifiant unique
- `email` : Email
- `name` : Nom complet
- `emailVerified` : Email vérifié (booléen)
- `image` : Photo de profil
- `createdAt` : Date d'inscription

**Relations :**
- `accounts` : Comptes liés (Google, etc.) via Better Auth
- `sessions` : Sessions actives
- `orders` : Commandes passées
- `activityViews` : Historique de consultation
- `searchHistory` : Historique de recherche
- `userOrganizations` : Organisations gérées (admin)
- `dealLikes` : Deals favoris
- `dealViews` : Deals consultés

### 2.8 Commande (Order)

**Champs :**
- `id` : Identifiant unique
- `userId` : Client
- `activityId` : Activité commandée
- `totalPrice` : Prix total en centimes
- `status` : Statut de la commande
  - `pending` : En attente de paiement
  - `paid` : Payée
  - `cancelled` : Annulée
  - `refunded` : Remboursée
- `stripePaymentIntentId` : ID Stripe
- `createdAt` : Date de commande
- Relations : `orderActivityOffers` (détail des offres), `tickets`

### 2.9 Billet (Ticket)

Deux types de billets :

**TicketGenerated** : E-ticket généré dynamiquement
- `id`, `userId`, `activityOfferId`, `orderId`
- `qrCode` : Code QR unique pour validation
- `status` : `active` | `used` | `cancelled`
- `usedAt` : Date d'utilisation

**TicketOriginal** : Billet PDF pré-existant
- `id`, `activityOfferId`, `orderId`
- `pdfFile` : Référence au PDF
- `isUsed` : Booléen

---

## 3. ARCHITECTURE DU SITE

### 3.1 Structure des URLs

**Pages publiques :**
- `/` - Homepage
- `/ou-sortir` - Agenda des activités (avec filtres)
- `/recherche?q={query}` - Recherche textuelle
- `/activite/{slug}` - Page détail activité
- `/activite/panier` - Panier d'achat
- `/activite/panier/success` - Confirmation de commande
- `/obtenir-mon-pass` - Page pass ANLV
- `/articles` - Blog/actualités
- `/article/{slug}` - Article individuel

**Pages authentifiées :**
- `/mon-compte` - Dashboard utilisateur
- `/mon-compte/informations` - Profil
- `/mon-compte/commandes` - Historique commandes
- `/mon-compte/billets` - Mes billets
- `/mon-compte/favoris` - Deals favoris
- `/mon-compte/pass` - Gestion du pass

**Pages admin (organisations) :**
- `/mon-organisation` - Dashboard organisation
- `/mon-organisation/activites` - Gestion activités
- `/mon-organisation/statistiques` - Analytics

**Système :**
- `/connexion` - Login
- `/inscription` - Sign up
- `/sitemap.xml` - Sitemap dynamique
- `/robots.txt` - Robots
- `/llms.txt` - Description pour LLM (ce fichier)
- `/api/*` - API routes (tRPC)

### 3.2 Navigation principale

**Menu principal :**
1. Où sortir ? → `/ou-sortir`
2. Catégories → Dropdown avec toutes les catégories
3. Articles → `/articles`
4. Mon pass → `/obtenir-mon-pass`
5. Mon compte → `/mon-compte` (si connecté)

**Footer :**
- À propos
- CGV / Mentions légales
- Politique de confidentialité
- Contact
- FAQ
- Partenaires

### 3.3 Technologies et stack

**Frontend (Next.js App Router) :**
- Framework : Next.js 15
- UI : React 18, TypeScript
- Styling : Tailwind CSS
- State : Zustand
- Forms : React Hook Form
- API client : tRPC
- SEO : next/metadata, JSON-LD schemas

**Backend (packages/api) :**
- Framework : Hono
- API : tRPC (type-safe)
- ORM : Drizzle
- Database : MySQL
- Auth : Better Auth
- Payments : Stripe
- Email : Resend
- Storage : Directus (images)

**Packages partagés :**
- `@repo/database` : Schémas Drizzle
- `@repo/api` : Logique métier et routers tRPC
- `@repo/auth` : Configuration Better Auth
- `@repo/design-system` : Composants UI
- `@repo/payments` : Intégration Stripe
- `@repo/email` : Templates emails
- `@repo/seo` : Utilitaires SEO et JSON-LD
- `@repo/shared-utils` : Helpers communs

---

## 4. FONCTIONNALITÉS DÉTAILLÉES

### 4.1 Découverte d'activités

**Homepage (`/`) :**
- Section "Pour vous" : Recommandations basées sur l'historique (si connecté)
- Section "Cette semaine" : Activités des 7 prochains jours
- Section "Dernière chance" : Activités dont la date d'expiration approche
- Section "Dernière minute" : Ajouts récents
- Section "Nouveautés" : Flag `isNew = true`
- Carrousel de catégories : Navigation rapide
- Section deals : Bons plans pour membres
- Section articles : Derniers contenus éditoriaux

**Page agenda (`/ou-sortir`) :**
- Vue calendrier/liste des activités
- Filtres disponibles :
  - Dates : aujourd'hui, cette semaine, ce mois, dates personnalisées
  - Catégories : multi-sélection
  - Lieu : sélection de villes/zones
  - Attributs : accessible, enfants, nouveau
  - Prix : fourchette de prix
- Tri : date, popularité, prix
- Pagination ou infinite scroll
- Export calendrier (iCal) [fonctionnalité future]

**Recherche (`/recherche`) :**
- Recherche full-text sur :
  - Titres d'activités
  - Descriptions
  - Noms d'organisations
  - Lieux
  - Catégories
- Suggestions auto-complètes
- Historique de recherche (si connecté)
- Résultats avec highlighting des termes
- Filtres appliqués en temps réel

### 4.2 Page détail activité

**Structure de `/activite/{slug}` :**

**Breadcrumbs :** Accueil > Où sortir ? > {Titre activité}

**Hero section :**
- Image principale grande taille
- Titre + badges (nouveau, dernière chance, accessible, enfants)
- Dates de l'événement
- Lieu avec lien vers carte
- Organisation organisatrice (nom + logo)

**Section informations pratiques :**
- Adresse complète
- Horaires
- Durée (si applicable)
- Contact organisateur
- Accessibilité détaillée
- Recommandations (âge, tenue, etc.)

**Section offres/tarifs :**
- Liste des offres disponibles
- Tableau : Titre offre | Prix public | Prix membre | Stock
- Sélecteur de quantité par offre
- Bouton "Ajouter au panier"
- Message si offre exclusive membre (CTA vers pass)
- Lien externe si billetterie externe

**Section description :**
- Contenu riche (HTML) de l'activité
- Peut inclure : images, vidéos, listes, citations
- Section "Informations" (champ texte libre)

**Section localisation :**
- Carte interactive (Google Maps / OpenStreetMap)
- Marker sur le lieu exact
- Possibilité d'ouvrir dans app de navigation

**Sections suggérées :**
- "Activités similaires" : Basé sur catégories et lieu
- "Deals associés" : Bons plans de l'organisateur
- "Articles liés" : Contenus éditoriaux en rapport

**Call-to-action pass :**
- Encart promo pour le pass ANLV
- Mise en avant des économies possibles

**Données structurées :**
- JSON-LD Event schema complet
- BreadcrumbList schema
- Organization schema
- Place schema avec GeoCoordinates

### 4.3 Panier et achat

**Panier (`/activite/panier`) :**
- Liste des offres ajoutées avec quantités
- Affichage des prix : public ou membre selon statut
- Calcul total en temps réel
- Possibilité de modifier quantités ou supprimer
- Code promo (si applicable)
- Bouton "Procéder au paiement"
- Si non membre : CTA vers pass avec calcul d'économies

**Tunnel de paiement :**
1. Vérification connexion (login/signup requis)
2. Récapitulatif commande
3. Informations de facturation (pré-remplies si compte)
4. Paiement Stripe (carte bancaire, Apple Pay, Google Pay)
5. Confirmation et génération de billets

**Page succès (`/activite/panier/success`) :**
- Confirmation visuelle
- Numéro de commande
- Récapitulatif de l'achat
- Accès immédiat aux billets
- Email de confirmation envoyé
- CTA : voir mes billets, retour à l'accueil

### 4.4 Système de pass ANLV

**Page `/obtenir-mon-pass` :**
- Explication de la proposition de valeur du pass
- Liste des avantages :
  - Tarifs préférentiels sur toutes les activités
  - Accès aux deals exclusifs
  - Priorité sur certains événements
  - Support client dédié
- Tarifs du pass (mensuel/annuel)
- FAQ détaillée avec schema FAQPage
- Formulaire de souscription
- Paiement récurrent via Stripe

**Fonctionnement :**
- Abonnement avec renouvellement automatique
- Gestion dans Mon Compte > Mon pass
- Possibilité de pause ou résiliation
- Badge "Membre" visible sur le profil

### 4.5 Espace utilisateur

**Dashboard (`/mon-compte`) :**
- Vue d'ensemble : prochaines activités, billets à venir
- Statistiques personnelles (nombre de sorties, économies)
- Shortcuts vers sections principales

**Mes billets :**
- Liste de tous les billets (passés et à venir)
- Filtres : à venir / passés / tous
- Pour chaque billet :
  - QR code ou PDF téléchargeable
  - Informations activité
  - Date et lieu
  - Statut (actif, utilisé, annulé)
- Ajout au Wallet (Apple/Google)

**Mes commandes :**
- Historique complet
- Détail de chaque commande
- Factures téléchargeables
- Statut (payée, en attente, annulée, remboursée)
- Action : demande de remboursement (selon politique)

**Mes favoris :**
- Deals likés
- Possibilité de retirer des favoris
- Notifications quand deal expire bientôt

**Informations personnelles :**
- Édition profil (nom, email, photo)
- Préférences (catégories favorites, notifications)
- Localisation (pour recommandations)
- Connexions sociales (Google, etc.)

**Mon pass :**
- Statut du pass (actif, expiré, en pause)
- Date de renouvellement
- Historique des paiements pass
- Gestion de l'abonnement
- Économies réalisées grâce au pass

### 4.6 Deals et bons plans

**Fonctionnement :**
- Réservés aux membres du pass ANLV
- Affichés sur homepage et dans section dédiée
- Peuvent être liés à des activités spécifiques
- Types de deals :
  - Réduction sur entrée/service
  - Offre 2 pour 1
  - Avantage chez partenaire (restaurant, commerce)
  - Tarif préférentiel permanent

**Actions utilisateur :**
- Voir détail du deal
- Liker / mettre en favori
- Utiliser : affichage QR code ou code promo
- Tracking des vues et likes

### 4.7 Articles et contenu éditorial

**Section articles (`/articles`) :**
- Blog avec contenus sur :
  - Guides des sorties (ex: "Top 10 des activités à Brest")
  - Interviews d'organisateurs
  - Actualités culturelles du Finistère
  - Tutoriels (comment bien profiter du pass, etc.)
  - Reportages sur événements
- Filtres par catégorie et date
- Recherche textuelle

**Page article (`/article/{slug}`) :**
- Contenu riche avec images
- Auteur et date de publication
- Liens vers activités mentionnées
- CTA vers réservation
- Partage sur réseaux sociaux
- Commentaires (si activés)

### 4.8 Notifications et engagement

**Push notifications (PWA) :**
- Nouvelle activité dans catégorie favorite
- Rappel activité réservée (J-1, H-2)
- Deal expirant bientôt
- Offre exclusive pour membre
- Confirmation de commande

**Emails transactionnels :**
- Confirmation d'inscription
- Réinitialisation mot de passe
- Confirmation de commande avec billets
- Rappel d'événement
- Renouvellement pass
- Newsletter hebdomadaire (opt-in)

---

## 5. EXPÉRIENCE UTILISATEUR

### 5.1 Parcours utilisateur typiques

**Scénario 1 : Visiteur découvre une activité**
1. Arrivée sur homepage via Google "activités Finistère"
2. Scroll et découverte des sections
3. Clic sur une activité "Cette semaine"
4. Consultation de la page détail
5. Ajout d'une offre au panier
6. Proposition de créer un compte
7. Inscription rapide
8. Paiement
9. Réception email avec billet PDF
10. Participation à l'activité

**Scénario 2 : Membre cherche sortie ce week-end**
1. Connexion à l'app
2. Consultation section "Pour vous" (personnalisée)
3. Utilisation filtres : "Ce week-end" + "Famille"
4. Découverte d'une activité adaptée enfants
5. Vérification prix membre (réduit)
6. Ajout au panier
7. Paiement rapide (CB enregistrée)
8. E-ticket ajouté au Wallet
9. Réception notification push J-1
10. Présentation du QR code à l'entrée

**Scénario 3 : Touriste planifie séjour**
1. Recherche Google "que faire à Quimper"
2. Arrivée sur article ANLV "Top 10 Quimper"
3. Lecture de l'article, découverte de 3 activités intéressantes
4. Consultation de l'agenda pour les dates de séjour
5. Sélection de 2 activités
6. Ajout au panier
7. Constat d'économies possibles avec le pass
8. Souscription pass + achat activités
9. Réception des billets
10. Utilisation pendant le séjour

### 5.2 Responsive design

- **Mobile-first** : Interface optimisée pour smartphones
- **PWA** : Installable sur écran d'accueil
- **Tablette** : Layout adapté
- **Desktop** : Expérience enrichie avec cartes plus grandes

### 5.3 Accessibilité

- Conformité WCAG 2.1 niveau AA
- Navigation clavier complète
- Labels ARIA sur éléments interactifs
- Contraste de couleurs suffisant
- Textes alternatifs sur images
- Indication des activités accessibles PMR
- Lecteurs d'écran supportés

### 5.4 Performance

- Core Web Vitals optimisés :
  - LCP (Largest Contentful Paint) < 2.5s
  - FID (First Input Delay) < 100ms
  - CLS (Cumulative Layout Shift) < 0.1
- Server-Side Rendering (SSR) pour SEO
- Image optimization (Next.js Image)
- Code splitting et lazy loading
- Service Worker pour PWA et cache

---

## 6. CONTEXTE GÉOGRAPHIQUE ET CULTUREL

### 6.1 Le Finistère (29)

**Géographie :**
- Département le plus occidental de la France
- Façade atlantique, péninsules et îles
- 283 communes
- Principales villes : Brest (140k hab.), Quimper (63k), Concarneau, Morlaix

**Caractéristiques :**
- Forte identité bretonne
- Langue : français + breton (minoritaire)
- Patrimoine maritime important
- Tourisme côtier (été)
- Festivals nombreux (Vieilles Charrues, Cornouaille, etc.)

**Culture locale :**
- Fest-noz (fêtes de nuit traditionnelles)
- Musique bretonne
- Gastronomie : crêpes, fruits de mer, cidre
- Patrimoine : calvaires, enclos paroissiaux
- Sports : voile, surf, football

### 6.2 Tissu culturel et associatif

**Types d'organisateurs sur ANLV :**
- Théâtres municipaux
- Salles de spectacles privées
- Associations culturelles
- Clubs de sport
- Musées et centres d'art
- Cinémas indépendants
- Organisateurs d'événements
- Parcs et sites touristiques
- Restaurants et bars culturels

**Saisonnalité :**
- Été : pic touristique, festivals, activités plein air
- Hiver : théâtre, cinéma, activités indoor
- Toute l'année : expositions, concerts, sport

### 6.3 Public cible démographique

**Résidents permanents :**
- Familles avec enfants
- Jeunes adultes 18-35 ans
- Seniors actifs
- Étudiants (Brest, Quimper)

**Visiteurs :**
- Touristes français (été)
- Touristes internationaux (UK, Allemagne)
- Résidents secondaires

**Profils socio-économiques :**
- Classes moyennes majoritaires
- Sensibilité à la culture locale
- Recherche de qualité/authenticité
- Sensibles aux tarifs attractifs

---

## 7. MODÈLE ÉCONOMIQUE

### 7.1 Sources de revenus

**Pass ANLV :**
- Abonnement mensuel ou annuel
- Récurrence prévisible
- Conversion progressive des utilisateurs gratuits

**Commission sur ventes :**
- Pourcentage sur chaque billet vendu
- Variable selon partenariat avec organisateur

**Partenariats organisateurs :**
- Formules premium avec mise en avant
- Services additionnels (analytics avancés, support)

### 7.2 Pricing

**Activités :**
- Prix fixés par les organisateurs
- Deux tarifs : public et membre
- Écart typique : 10-30% de réduction membre
- Gamme de prix : 5€ à 50€ majoritairement

**Pass ANLV :**
- Abonnement avec engagement ou sans
- Rentable dès 2-3 activités par mois

### 7.3 Valeur pour organisateurs

- Visibilité sur plateforme centralisée
- Accès à base d'utilisateurs qualifiés
- Billetterie simplifiée (PDF ou e-tickets)
- Paiement sécurisé géré
- Reporting et statistiques
- Pas de développement technique nécessaire

---

## 8. SEO ET DISCOVERABILITY

### 8.1 Stratégie SEO traditionnelle

**Mots-clés principaux :**
- "activités Finistère"
- "que faire à [ville]" (Brest, Quimper, etc.)
- "événements Bretagne"
- "sortir dans le 29"
- "agenda culturel Finistère"
- "spectacles [ville]"
- "[catégorie] Finistère" (concert, théâtre, exposition, etc.)

**On-page SEO :**
- Titres optimisés avec localisation
- Meta descriptions uniques et engageantes
- URLs lisibles avec slugs (ex: /activite/concert-jazz-brest-juillet)
- Balises H1-H6 structurées
- Images avec attributs alt descriptifs
- Liens internes riches

**Structured data (JSON-LD) :**
- Schema.org Event sur toutes les activités
- Organization schema pour organisateurs
- Place schema avec géolocalisation
- BreadcrumbList pour navigation
- FAQPage sur pages d'information
- CollectionPage sur page agenda
- WebSite schema avec SearchAction

**Technical SEO :**
- Sitemap XML dynamique (/sitemap.xml)
- Robots.txt optimisé
- SSR pour indexation complète
- Canonical URLs
- Pagination correcte
- Mobile-friendly (responsive + PWA)
- HTTPS obligatoire
- Core Web Vitals optimisés

### 8.2 SEO pour moteurs émergents

**Perplexity, ChatGPT, Claude, etc. :**
- Fichier `/llms.txt` (ce document)
- Contenu structuré et sémantique
- Descriptions riches et contextuelles
- Données structurées complètes
- Métadonnées enrichies
- Breadcrumbs pour contexte de navigation
- FAQs intégrées avec schema

**Principe GEO (Generative Engine Optimization) :**
- Contenu rédigé pour être cité/résumé par IA
- Phrases courtes et claires
- Informations factuelles vérifiables
- Contexte géographique explicite
- Dates et horaires précis
- Prix transparents et à jour
- Liens vers sources primaires

### 8.3 Local SEO

**Google My Business :**
- Fiche entreprise ANLV
- Avis utilisateurs
- Localisation Finistère

**Géolocalisation :**
- Toutes les activités avec coordonnées GPS
- Schemas Place avec latitude/longitude
- Recherche par proximité possible
- Intégration cartes pour UX et SEO

**Citations locales :**
- Mentions dans médias bretons
- Partenariats avec offices de tourisme
- Événements locaux

---

## 9. CAS D'USAGE TYPIQUES

### 9.1 Requêtes LLM attendues

**Exemples de questions auxquelles ANLV peut répondre :**

"Quoi faire ce week-end à Brest ?"
→ Rediriger vers /ou-sortir avec filtre Brest + dates week-end

"Activités pour enfants dans le Finistère"
→ Lister activités avec flag `isKidFriendly`

"Concert de jazz à Quimper en juillet"
→ Recherche catégorie musique + lieu Quimper + mois juillet

"Tarif réduit pour spectacles en Bretagne"
→ Expliquer le pass ANLV et ses avantages

"Comment réserver une activité sur ANLV ?"
→ Expliquer parcours : recherche > détail > panier > paiement > billet

"Différence entre billet PDF et e-ticket"
→ Expliquer les types de billets (pdf_stock vs generated)

"Activités accessibles PMR dans le 29"
→ Filtrer sur `isAccessible = true`

"Quand expire mon billet ?"
→ Expliquer que le billet est valable pour la date de l'événement (`dateStart`)

"Puis-je annuler ma réservation ?"
→ Renvoyer vers politique d'annulation (CGV)

"Quels sont les événements populaires du moment ?"
→ Activités avec `isPopular = true` ou tri par nombre de vues

### 9.2 Scénarios d'intégration LLM

**Assistant vocal :**
"Ok Google, trouve-moi un spectacle ce soir à Brest"
→ L'assistant peut interroger ANLV via API et lire les résultats

**Chatbot sur site :**
Widget de chat pour aider à la recherche d'activités

**Recommandation personnalisée :**
"Basé sur tes sorties précédentes (historique), voici 3 activités qui pourraient t'intéresser"

**Planification de séjour :**
"Je viens 3 jours à Quimper début août, propose-moi un programme"
→ LLM peut agréger plusieurs activités ANLV + infos touristiques

**Comparaison de prix :**
"Est-ce que le pass ANLV est rentable pour moi ?"
→ Calcul basé sur fréquence de sorties estimée

---

## 10. DONNÉES COMPLÉMENTAIRES POUR CONTEXTE

### 10.1 Volume de contenu (estimation)

- **Activités** : 100-500 activités actives en permanence (variable selon saison)
- **Organisations** : 50-200 organisateurs partenaires
- **Catégories** : 10-15 catégories principales
- **Lieux** : 50-100 lieux récurrents
- **Articles** : 20-50 articles de blog

### 10.2 Fréquence de mise à jour

- **Activités** : Ajouts quotidiens/hebdomadaires selon saison
- **Deals** : Mises à jour mensuelles
- **Articles** : 1-2 nouveaux articles par semaine
- **Sitemap** : Régénération automatique à chaque ajout/modif

### 10.3 Langues et internationalisation

- **Langue principale** : Français (fr-FR)
- **Langue secondaire** : Anglais (en) pour touristes [futur]
- **Support breton** : Possible pour contenu spécifique [futur]

### 10.4 Versions de la plateforme

- **Web** : Next.js responsive (desktop, tablet, mobile)
- **PWA** : Progressive Web App installable
- **Apps natives** : iOS et Android [futur]

---

## 11. CONTACT ET SUPPORT TECHNIQUE

Pour toute question technique sur l'intégration ou l'utilisation des données ANLV dans un contexte LLM ou autre, contacter le support via l'espace Mon Compte.

---

## CHANGELOG

- 2025-10-13 : Création de la documentation complète pour LLM (v1.0)

---

FIN DU DOCUMENT