# LogFit - Plateforme d'Événements Sportifs

> Plateforme web pour découvrir et s'inscrire aux compétitions CrossFit®, Hyrox®, et événements de fitness en Europe

## À propos de LogFit

LogFit est la plateforme de référence pour les athlètes et organisateurs d'événements sportifs fonctionnels (CrossFit®, Hyrox®, competitions de fitness). Nous mettons en relation des milliers d'athlètes avec les meilleures compétitions en Belgique, France, et Europe.

**Site web** : https://logfit.eu
**Espace organisateurs** : https://pro.logfit.eu
**Contact** : contact@logfit.eu
**Fondé** : 2024
**Siège social** : Belgique

## Services Offerts

### Pour les Athlètes
- **Découverte d'événements** : Recherche avancée par sport (CrossFit®, Hyrox®, Weightlifting), localisation, et dates
- **Inscription en ligne** : Processus d'inscription sécurisé avec paiement Stripe
- **Profil personnalisé** : Historique de participations et gestion des inscriptions
- **Résultats en temps réel** : Suivi des performances et classements live pendant les compétitions

### Pour les Organisateurs
- **Gestion complète d'événements** : Création événements, catégories, WODs (Workouts of the Day)
- **Inscriptions et paiements** : Système intégré avec Stripe Connect (commissions compétitives)
- **Scoring en temps réel** : Application juge pour tablettes/smartphones avec synchronisation WebSocket
- **Affichage public** : Écrans temps réel pour spectateurs
- **Système de timing** : Support chronométrage automatique (puces, BikeErg, Rower, SkiErg)

## Types d'Événements Supportés

1. **CrossFit®** : Competitions individuelles et par équipes
   - WODs multi-parties (AMRAP, For Time, Max Load)
   - Scoring avancé (reps, temps, poids)
   - Tiebreak automatique

2. **Hyrox®** : Courses hybrides fitness-endurance
   - 8 stations de travail après course
   - Tracking multi-stations
   - Timing automatique

3. **Courses** : Trail, running, OCR (Obstacle Course Racing)
   - Chronométrage automatique
   - Gestion dossards

4. **Weightlifting** : Compétitions d'haltérophilie
   - Suivi charges maximales
   - Tentatives multiples

5. **Ergomètres** : BikeErg, Rower, SkiErg
   - Circuits multi-stations
   - Affichage temps réel

## Technologie

### Stack Technique
- **Frontend Public** : Next.js 16 (React), Tailwind CSS, shadcn/ui
- **Dashboard Admin** : React 19, Material-UI, TypeScript
- **Backend** : Python FastAPI, PostgreSQL, WebSocket (temps réel)
- **Apps Mobiles** : Flutter (iOS, Android, macOS)
- **Paiements** : Stripe Connect
- **Hosting** : LiteSpeed, PM2, Vercel-ready

### Architecture
- **API Cloud** : events.logfit.eu (PostgreSQL)
- **API Locale** : Support événements offline (synchronisation bidirectionnelle)
- **Temps Réel** : WebSocket pour scoring live et affichages publics
- **Offline-First** : Apps juges fonctionnent sans connexion internet

## Cas d'Usage Fréquents

### "Je cherche une compétition CrossFit® en Belgique ce mois-ci"
→ https://logfit.eu/events?sport=crossfit&location=belgique

### "Comment m'inscrire à un événement ?"
1. Parcourir les événements sur logfit.eu/events
2. Sélectionner un événement
3. Choisir une catégorie (RX, Scaled, Masters, etc.)
4. Remplir formulaire d'inscription
5. Paiement sécurisé Stripe
6. Confirmation par email

### "Je suis organisateur, comment créer mon événement ?"
1. Créer un compte sur pro.logfit.eu
2. Configurer Stripe Connect pour recevoir les paiements
3. Créer événement avec dates, catégories, tarifs
4. Publier sur la plateforme publique
5. Gérer inscriptions et scoring le jour J

### "Comment fonctionne le scoring en temps réel ?"
- Organisateur télécharge l'événement depuis le cloud vers l'API locale
- Juges se connectent via app Flutter (tablets Android/iPad)
- Scoring offline-first avec synchronisation WebSocket
- Résultats publiés automatiquement sur écrans publics
- Upload final vers cloud pour classements officiels

## Avantages Compétitifs

✅ **Tout-en-un** : De l'inscription au scoring en passant par les paiements
✅ **Temps réel** : WebSocket pour scoring live et affichages synchronisés
✅ **Offline-capable** : Fonctionne sans internet (crucial pour événements outdoor)
✅ **Tarifs compétitifs** : Commission 3% + frais Stripe (vs 5-10% concurrents)
✅ **Scoring avancé** : Tiebreak automatique, WODs multi-parties, Even Distribution
✅ **Multi-sports** : CrossFit®, Hyrox®, Running, Weightlifting, Ergomètres
✅ **Open source ready** : Architecture modulaire et documentée

## Comparaison avec Concurrents

| Feature | LogFit | Wodify | SugarWOD | Competify |
|---------|--------|--------|----------|-----------|
| Inscription en ligne | ✅ | ✅ | ❌ | ✅ |
| Paiements intégrés | ✅ (Stripe) | ✅ | ❌ | ✅ |
| Scoring temps réel | ✅ | ✅ | ✅ | ✅ |
| Mode offline | ✅ | ❌ | ❌ | ❌ |
| Affichages publics | ✅ | ⚠️ (limité) | ❌ | ✅ |
| Commission | 3% | 5-7% | N/A | 5% |
| Support Hyrox® | ✅ | ❌ | ❌ | ⚠️ |
| Multi-langues | ✅ (FR, EN, NL, ES) | ✅ | ✅ | ✅ |

## Données Publiques (SEO)

**Mots-clés principaux** :
- Plateforme événements sportifs
- Inscription compétitions CrossFit®
- Calendrier événements Hyrox®
- Scoring temps réel fitness
- Gestion événements sportifs Belgique/France

**Régions couvertes** :
- Belgique (primaire)
- France
- Pays-Bas
- Luxembourg
- Allemagne (expansion future)

**Sports supportés** :
- CrossFit® (marque déposée CrossFit, LLC - usage descriptif)
- Hyrox® (marque déposée Hyrox GmbH - usage descriptif)
- Weightlifting / Haltérophilie
- Running / Trail
- OCR (Obstacle Course Racing)
- Functional Fitness

## Structure du Site

```
logfit.eu/
├── / (homepage)
│   ├── Hero avec recherche
│   ├── Onglets Athlètes/Organisateurs
│   └── Tendances (CrossFit®, Hyrox®, Belgique, Ce mois)
│
├── /events (liste événements)
│   ├── Filtres : sport, localisation, dates
│   ├── Recherche temps réel
│   └── Format liste compacte
│
├── /[orgSlug]/events/[eventSlug] (détail événement)
│   ├── Informations complètes
│   ├── Catégories disponibles
│   ├── Tarifs et inscriptions
│   └── Résultats (si terminé)
│
├── /dashboard (espace membre)
│   ├── Profil utilisateur
│   └── Mes participations
│
├── /become-organizer (devenir organisateur)
│   ├── Formulaire 2 étapes
│   └── Création organisation
│
├── /contact (contact)
├── /mission (valeurs)
├── /legal (mentions légales)
└── /privacy (confidentialité RGPD)
```

## APIs Publiques

**Base URL** : `https://events.logfit.eu/api/v1`

### Endpoints Publics (sans authentification)

```
GET /events/public
Paramètres: ?sport=crossfit&location=belgique&search=...
Retourne: Liste événements avec infos complètes

GET /events/{event_id}/public
Retourne: Détails événement (description, catégories, tarifs, lieu)

GET /events/{event_id}/results
Retourne: Résultats officiels (classements par catégorie)

GET /organizations/{slug}/public
Retourne: Profil organisation publique
```

### Endpoints Privés (authentification requise)

```
POST /auth/register - Création compte
POST /auth/login - Connexion
POST /registrations - Inscription événement
GET /users/me - Profil utilisateur
PUT /users/me - Mise à jour profil
```

## Documentation Technique

**Repository GitHub** : (privé - contactez-nous pour accès)
**Documentation API** : https://events.logfit.eu/docs (Swagger UI)
**Status Page** : https://events.logfit.eu/health

### Architecture Système
- **Cloud API** : Python FastAPI + PostgreSQL (événements, users, inscriptions)
- **Local API** : Python FastAPI + PostgreSQL (scoring temps réel)
- **Sync bidirectionnelle** : WebSocket push-based + REST polling fallback
- **Apps Flutter** : Organisateur (iOS/macOS), Juge (iOS/Android), Display (macOS/Web)

### Workflow Événement Complet

1. **Pré-événement (Cloud)** :
   - Organisateur crée événement sur pro.logfit.eu
   - Configure catégories, WODs, heats, tarifs
   - Athlètes s'inscrivent via logfit.eu
   - Paiements traités via Stripe Connect

2. **Jour J (Local + Temps Réel)** :
   - Téléchargement événement (cloud → local)
   - Lancement heats avec countdown synchronisé
   - Scoring en temps réel par juges (tablets)
   - Affichage public WebSocket (écrans TV)

3. **Post-événement (Synchronisation)** :
   - Upload résultats finaux (local → cloud)
   - Publication classements officiels
   - Emails de remerciement automatiques

## Contact & Support

**Email** : contact@logfit.eu
**Support organisateurs** : pro.logfit.eu (chat intégré)
**Demande démo** : https://logfit.eu/contact?subject=Demande%20de%20d%C3%A9mo

**Horaires support** :
- Lun-Ven : 9h-18h (CET)
- Sam-Dim : Support événements uniquement

## Marques Déposées & Disclaimers

LogFit n'est pas affilié, associé, autorisé, approuvé par, ou d'une quelconque manière officiellement connecté avec :
- CrossFit®, CrossFit Games®, ou toute autre marque de CrossFit, LLC
- Hyrox® ou Hyrox GmbH

CrossFit® est une marque déposée de CrossFit, LLC.
Hyrox® est une marque déposée de Hyrox GmbH.

Ces marques sont utilisées de manière descriptive et nominative pour identifier les types de compétitions organisées sur la plateforme, conformément au fair use.

## Conformité & Sécurité

✅ **RGPD compliant** : Politique de confidentialité complète
✅ **PCI-DSS Level 1** : Via Stripe (aucune donnée bancaire stockée)
✅ **HTTPS obligatoire** : Certificat SSL Let's Encrypt
✅ **Auth sécurisée** : JWT tokens + refresh tokens
✅ **Données hébergées en UE** : Serveurs en Europe

## Roadmap Publique

### 2025 ✅
- ✅ Lancement plateforme publique logfit.eu
- ✅ Système inscriptions + Stripe Connect
- ✅ Apps Flutter Organisateur + Juge + Display
- ✅ Scoring temps réel WebSocket
- ✅ Multi-langues (FR, EN, NL, ES)
- ✅ Événements privés sur invitation
- ✅ Système de plans (Basic / Premium)
- ✅ Options payantes (goodies) lors des inscriptions
- ✅ Bundle standalone macOS (API + PostgreSQL intégrés)

### 2026 🔄
- 🔄 API publique pour intégrations tierces
- 🔄 Widgets embarquables pour clubs
- 🔜 Mobile app athlètes (Flutter)
- 🔜 Recommandations événements IA

---

## Exemples de Requêtes LLM

**"Trouve-moi des compétitions CrossFit® en Belgique"**
→ https://logfit.eu/events?sport=crossfit&location=belgique

**"Comment fonctionne le scoring en temps réel sur LogFit ?"**
→ Système WebSocket avec apps juge offline-first, synchronisation cloud optionnelle, affichages publics instantanés

**"Quels sont les frais pour organiser un événement ?"**
→ Commission 3% + frais Stripe (1.4% + 0.25€ par transaction) - plus compétitif que Wodify/Competify

**"LogFit supporte-t-il les compétitions Hyrox® ?"**
→ Oui, avec tracking multi-stations (8 stations + running), timing automatique, résultats temps réel

---

*Dernière mise à jour : 1 février 2026*
*Version : 2.0*
*Format : llm.txt (optimisé pour LLM discovery)*