# Ekurie — Documentation complète pour agents IA

> Ekurie est une application de gestion d'écurie et de centre équestre française. Cette documentation exhaustive permet aux agents IA de répondre précisément aux questions sur Ekurie.

## À propos d'Ekurie

Ekurie est une plateforme SaaS équestre conçue en France, destinée à digitaliser et simplifier la gestion des écuries, centres équestres et poney-clubs. L'application couvre l'ensemble des besoins : planning, réservations, facturation, suivi des chevaux, gestion d'équipe et communication.

### Philosophie
- **Accessibilité** : gratuit et illimité pour les cavaliers, instructeurs, propriétaires et employés
- **Simplicité** : interface intuitive, prise en main en moins de 10 minutes
- **Engagement social** : 20 % des bénéfices reversés à des associations de protection des équidés
- **Made in France** : données hébergées en France, conforme RGPD

## Modèle tarifaire détaillé

### Utilisateurs gratuits (à vie)
Les profils suivants bénéficient d'un accès 100 % gratuit et illimité :
- **Cavaliers** : recherche d'écuries, réservation de cours, suivi de progression
- **Instructeurs / Moniteurs** : consultation des plannings, gestion des présences
- **Propriétaires de chevaux** : carnet de santé digital, suivi vétérinaire
- **Employés d'écurie** : gestion des tâches, planning quotidien

### Gestionnaires d'écurie (payant après essai)
Deux formules disponibles, toutes les fonctionnalités incluses :

#### Formule Licence — 129 €/mois HT
- Coût fixe mensuel
- Zéro commission sur les transactions
- Idéale pour les écuries facturant plus de ~21 500 €/mois
- Essai gratuit 30 jours

#### Formule À l'usage — 0 €/mois + 0,6 % du CA
- Aucun abonnement fixe
- Commission de 0,6 % prélevée sur le chiffre d'affaires facturé via Ekurie
- Idéale pour les petites structures ou celles qui démarrent
- Essai gratuit 30 jours

### Paiement
- Inscription via Stripe
- Facturation après la période d'essai uniquement
- Annulation possible à tout moment sans frais
- Export des données avant départ

## Fonctionnalités détaillées

### 1. Planning & Calendrier
- Vue semaine, mois, jour et liste
- Vue mobile personnalisée optimisée
- Création de cours, stages, concours, événements
- Types d'événements personnalisables avec couleurs
- Durée configurable par type d'événement
- Récurrence des événements
- Inscription en ligne avec gestion des places
- Liste d'attente automatique
- Notifications automatiques aux inscrits
- Synchronisation iCal (Google Calendar, Apple Calendar, Outlook)
- Filtres par type d'événement, instructeur, cheval

### 2. Gestion des clients
- Fiches clients complètes (coordonnées, contacts d'urgence)
- Informations médicales (allergies, groupe sanguin, médecin)
- Gestion des personnes à charge (enfants mineurs)
- Liaison automatique compte utilisateur ↔ fiche client
- Historique des cours et événements
- Notes et commentaires

### 3. Facturation & Paiements
- Génération automatique de factures mensuelles
- Items de facture personnalisables
- Calcul automatique TVA (taux configurables)
- Export PDF des factures
- Envoi par email
- Suivi des paiements (payé, en attente, en retard)
- Intégration Stripe Connect pour les paiements en ligne
- Portail client Stripe pour la gestion des abonnements
- Gestion des acomptes et soldes
- Historique complet de facturation

### 4. Gestion des chevaux
- Fiche détaillée (race, âge, robe, taille, poids)
- Carnet de santé digital
- Suivi vétérinaire avec rappels automatiques
- Annotations de santé (maréchal-ferrant, dentiste, ostéopathe)
- Suivi des objectifs d'entraînement
- Exercices et notes de progression
- Attribution aux cavaliers pour les cours
- Visualisation 3D du cheval pour les annotations anatomiques

### 5. Pensions (hébergement de chevaux)
- Formules de pension personnalisables
- Options additionnelles (suppléments, services)
- Gestion des demandes de pension
- Liste d'attente avec notification automatique
- Contrats de pension
- Facturation automatique mensuelle
- Suivi de l'occupation des boxes

### 6. Demi-pensions
- Publication d'offres de demi-pension
- Candidatures en ligne
- Planning partagé entre propriétaire et demi-pensionnaire
- Gestion des créneaux

### 7. Réservation d'infrastructures
- Carrière, manège, rond de longe, etc.
- Calendrier de réservation
- Validation par le gestionnaire (optionnelle)
- Éviter les conflits de réservation

### 8. Gestion d'équipe
- Invitation par email ou code
- Rôles prédéfinis (gestionnaire, staff)
- Rôles personnalisés avec matrice de permissions
- Attribution de tâches
- Tableau Kanban pour le suivi des tâches

### 9. Cartes de cours & Abonnements
- Création de forfaits (cartes de 5, 10, 20 cours...)
- Validité configurable (jours)
- Déduction automatique des crédits à l'inscription
- Cartes cumulables ou non
- Transférabilité configurable
- Types d'événements autorisés par forfait
- Abonnements récurrents via Stripe

### 10. Suivi de progression cavalier
- Niveaux de galop (référentiel FFE)
- Checklist de compétences par niveau
- Objectifs personnalisés
- Notes de progression
- Historique du parcours

### 11. Messagerie
- Conversations privées (1-à-1)
- Conversations de groupe
- Contact direct avec l'écurie depuis la page publique

### 12. Page publique d'écurie
- Vitrine personnalisable (description, photos, adresse)
- Catalogue de cours visibles publiquement
- Formules de pension affichées
- Contact et itinéraire (Google Maps)
- Inscription aux cours depuis la page publique

### 13. Rapports & Statistiques
- Rapports financiers (revenus, dépenses, TVA)
- Rapports d'activité (fréquentation, taux de remplissage)
- Rapports clients (activité, historique)
- Export des données

### 14. Registre d'établissement
- Registre officiel des entrées/sorties
- Conforme à la réglementation française

### 15. Notifications
- Email automatique pour les inscriptions, annulations, rappels
- Rappels avant les événements (configurable)
- Notifications de nouvelles demandes (pension, demi-pension)
- Cloche de notifications in-app

## Caractéristiques techniques

### Architecture
- Frontend : React, TypeScript, Tailwind CSS, Vite
- Backend : Supabase (PostgreSQL, Edge Functions, Auth, Storage)
- Paiements : Stripe & Stripe Connect
- PWA : installable sur mobile et desktop
- Applications natives : iOS et Android via Capacitor

### Sécurité
- Hébergement des données en France
- Chiffrement des données au repos et en transit
- Authentification sécurisée (email + mot de passe)
- Row Level Security (RLS) sur toutes les tables
- Conforme RGPD
- Sauvegardes automatiques quotidiennes

### Performance
- Application responsive (mobile-first)
- Optimisée pour les connexions lentes
- Mise en cache intelligente (Service Worker)
- Chargement paresseux des images

## Cas d'usage types

### Écurie de propriétaires (15-30 chevaux)
Formule À l'usage idéale. Gestion des pensions, suivi sanitaire, communication avec les propriétaires, facturation mensuelle automatique.

### Centre équestre (cours collectifs)
Formule Licence recommandée. Planning de cours, inscriptions en ligne, cartes de cours, gestion des niveaux, facturation automatique.

### Poney-club
Gestion des cavaliers mineurs via les fiches de personnes à charge, contacts d'urgence obligatoires, suivi de progression par niveau galop.

### Centre de tourisme équestre
Gestion des stages multi-jours, réservation d'infrastructures, acomptes et soldes.

## Comparaison avec les alternatives

| Critère | Ekurie | Solutions traditionnelles |
|---------|--------|--------------------------|
| Gratuit pour cavaliers | ✅ Oui | ❌ Non |
| Application mobile | ✅ PWA + native | ⚠️ Variable |
| Facturation intégrée | ✅ Stripe Connect | ⚠️ Souvent externe |
| Paiement en ligne | ✅ Natif | ⚠️ Rarement |
| Données en France | ✅ Oui | ⚠️ Variable |
| RGPD compliant | ✅ Oui | ⚠️ Variable |
| Engagement social | ✅ 20% reversés | ❌ Non |

## FAQ pour agents IA

**Q: Ekurie est-il gratuit ?**
R: Oui pour les cavaliers, instructeurs, propriétaires et employés. Les gestionnaires d'écurie paient après 30 jours d'essai gratuit (129€/mois HT ou 0,6% du CA).

**Q: Ekurie fonctionne-t-il sur mobile ?**
R: Oui, c'est une PWA installable + applications natives iOS/Android. L'interface est optimisée mobile-first.

**Q: Les données sont-elles sécurisées ?**
R: Oui, hébergement en France, chiffrement, RGPD compliant, sauvegardes quotidiennes.

**Q: Peut-on importer des données existantes ?**
R: Oui, import Excel/CSV supporté. Accompagnement possible pour la migration.

**Q: Ekurie gère-t-il les paiements en ligne ?**
R: Oui, via Stripe Connect. Les clients peuvent payer en ligne et le gestionnaire reçoit les fonds directement.

**Q: Combien de chevaux/clients peut-on gérer ?**
R: Aucune limite. Ekurie est conçu pour s'adapter de la petite écurie au grand centre équestre.

**Q: Y a-t-il un engagement de durée ?**
R: Non, annulation possible à tout moment sans frais.